You are viewing a plain text version of this content. The canonical link for it is here.
Posted to user@jspwiki.apache.org by Brian Burch <Br...@PingToo.com> on 2010/08/25 19:31:52 UTC

Re: Photo Collection plugin - new version

On 15/08/10 15:58, Fritz Schneider wrote:
> I have it installed, and it works fine.
> Thanks again,
> Fritz

I have just uploaded version 3 of the PhotoCollection plugin jar. The 
significant changes are in three areas:

1. Multiple image file types are now supported via either the plugin 
invocation, or across the entire photo collection. I have updated the 
description on the wiki to describe this feature. (I have scanned some 
prints and documents as png files and didn't want to convert them to jpegs).

2. I found several quirks in the way friendly page titles were generated 
and have improved the algorithm.

3. While working on point 2, I found several situations where the 
algorithm that generated the associated wiki page name lost information 
about the file path that would have helped the friendly page title 
logic. Reluctantly, I decided to make a non-backward-compatible change. 
In many cases existing wiki pages will be named exactly as before, but 
it is possible for existing pages to "apparently" disappear!

The types of paths that will map differently are:
File path --------original wikiname -------- new wikiname
   abcd/2xyz          Abcd2xyz                   Abcd_2xyz
   abc3/2xyz          Abc32xyz                   Abc3_2xyz
   abcD/2xyz          AbcD2xyz                   AbcD_2xyz
   abcD/Wxyz          AbcDWxyz                   AbcD_Wxyz

If (when) you implement the new jar, please check your wiki to see 
whether any pages that previously existed are no longer found. You only 
need to manually rename the "old" page and it will magically reappear. 
Here is the procedure:

1. do a wiki search for the page under its original name using an 
appropriate wildcard, e.g. 2010*.

2. follow the search hit to display the original page.

3. click on the "info" tab of the page.

4. update the page name with underscores, e.g. preceding a file path 
element that starts with a digit, or following one with a trailing 
uppercase character).

5. click the rename button.

6. Refresh the page representing the higher level collection and the 
link should change to successfully locate the renamed page.


Sorry for any inconvenience. I think you will find your page titles look 
much nicer and it would be better to convert before you create too many 
pages! Don't forget to make a backup before you start work!

Regards,

Brian

Re: Photo Collection plugin - new version

Posted by Brian Burch <Br...@PingToo.com>.
On 26/08/10 07:26, Fritz Schneider wrote:
> After renaming my pages, I have it up and running.

Yes, your wiki titles now look much more readable. However, I did notice 
this page:

http://www.peacham.com/ccla/Wiki.jsp?page=AlbInstallation_3-The%20Reception

with the title "Album Installation 3- The Reception"

I was surprised by the space inserted after the hyphen until I realised 
that you have capitalised the letter T. My own photo collection naming 
convention would have used a lower-case t, but I don't think a title of 
"Album Installation 3-the Reception" is better than the one you have! I 
guess choosing folder names is a bit of an art form!

I don't think we will ever come up with a "perfect" algorithm, so I am 
inclined to leave things alone at the moment unless you have an 
appropriate and elegant insight...

> I will need to do some more work to implement the template feature, but the page headings look fine.

What do you mean by "the template feature"? My choice of css elements to 
lay out the photos is VERY simplistic because my priority was to get 
something working that didn't look stupid. I know it could be a lot more 
elegant but lack the skills to do it quickly. If you can help I would be 
very grateful.

The html elements are built at run-time from hard-coded fragments in the 
plugin, e.g.

<div class="photobox">
<div class="photo">
<div class="photoimage">
<a href="alb/installation/3-The Reception/P2104091.jpg"/>
<img class="smallphoto" src="alb/installation/3-The 
Reception/thumbs/P2104091_t.jpg" alt="Click to enlarge this image"/>
</a>
</div>
<br/>
<div class="photocaption">
<p>
<a class="createpage" href="/ccla/Edit.jsp?page=AlbInstallation_3-The 
ReceptionP2104091.jpg&_editedtext=[{INSERT PhotoCollectionPlugin 
photodir='installation/3-The Reception/P2104091.jpg'}]" title="Create 
&quot;Album Installation 3-The Reception P2104091.jpg&quot;">Album 
Installation 3-The Reception P2104091.jpg
</a>
</div>
</div>
<div class="photo">
etc...

My extra style definitions are held in the
templates/photoCollection/jspwiki.css file, so it is easy for you to 
experiment with enhancements.

I would like to use fly-over notes similar to when you hover your mouse 
over the more tab or the search box. I would also like to improve the 
ugly box borders, but my early experiments failed. I think it is 
essential for the layout to flow properly when the browser window is 
resized and I couldn't achieve this easily.

I hope you can help!

Thanks for your testing and feedback.

Brian

RE: Photo Collection plugin - new version

Posted by Fritz Schneider <Fr...@Peacham.com>.
Brian,

After renaming my pages, I have it up and running. I will need to do some more work to implement the template feature, but the page headings look fine.

Fritz

-----Original Message-----
From: Brian Burch [mailto:Brian@PingToo.com] 
Sent: Wednesday, August 25, 2010 10:32 AM
To: jspwiki-user@incubator.apache.org
Subject: Re: Photo Collection plugin - new version

On 15/08/10 15:58, Fritz Schneider wrote:
> I have it installed, and it works fine.
> Thanks again,
> Fritz

I have just uploaded version 3 of the PhotoCollection plugin jar. The 
significant changes are in three areas:





Re: Friendly page titless

Posted by Brian Burch <Br...@PingToo.com>.
On 26/08/10 21:58, Chris Haynes wrote:
> Hey! Just a minute!
>
> Is this the new Wiki structure which permits pages to be organized into directory groups (that I was asking for last year)?

Sorry to disappoint you, Chris. The behaviour of the 
PhotoCollectionPlugin is restricted to the directory structure that 
houses the pictures. The associated wiki pages are still held in the 
"normal" single directory. It is the external photo collection that can 
be hierarchical and the plugin will map between these two organisational 
regimes.

> Is it in a standard release yet?
>
> Is it documented anywhere other than in the eMail thread?
>
> Did I miss some big announcement or is _this_ it?
>
> Regards, from a happily-expectant

However, I am puzzled that you have not looked at the standard "beautify 
pages" feature that I encountered during my research into my own plugin. 
My algorithms are derived from the base code, although the behaviour is 
customised to deal with external file and directory names when used to 
automatically derive unique wiki page names.

I tried to quickly find out something about the beautify feature, but 
was surprised at how little had been written:

http://www.jspwiki.org/wiki/SystemInfo -> Do we beautify titles? true.

http://www.jspwiki.org/wiki/JSPWikiSupport#section-JSPWikiSupport-PageNamesWithBlanks

There are two issues related to this feature, I think...
1) some people want to create wiki page names with embedded blanks, so 
the filenames and associated url's have to embed the String %20 (or is 
it +) instead to make them legal.
2) Some people want their existing wiki CamelCase page titles 
//rendered// as their page names, but with white space between each word.

My code is based on the class com.ecyrd.jspwiki.TextUtil, so you might 
like to review the original code. The only use that seems important is 
within WikiEngine.beautifyTitle(), which claims to add whitespace to 
wiki page titles.

I was under the impression that there was a global beautifyPages 
property in jspwiki.properties, but I haven't found it in the default 
file. I wonder whether the feature needs to be triggered by the template 
parameters... perhaps someone who knows more can help?

Regards,

Brian

Friendly page titless

Posted by Chris Haynes <ch...@harvington.org.uk>.
Hey! Just a minute! 

Is this the new Wiki structure which permits pages to be organized into directory groups (that I was asking for last year)?

Is it in a standard release yet? 

Is it documented anywhere other than in the eMail thread?

Did I miss some big announcement or is _this_ it?

Regards, from a happily-expectant

Chris



On Wednesday, August 25, 2010 at 6:31:52 PM, Brian Burch wrote:

> 2. I found several quirks in the way friendly page titles were generated
> and have improved the algorithm.

> 3. While working on point 2, I found several situations where the 
> algorithm that generated the associated wiki page name lost information
> about the file path that would have helped the friendly page title 
> logic. Reluctantly, I decided to make a non-backward-compatible change.
> In many cases existing wiki pages will be named exactly as before, but
> it is possible for existing pages to "apparently" disappear!

> The types of paths that will map differently are:
> File path --------original wikiname -------- new wikiname
>    abcd/2xyz          Abcd2xyz                   Abcd_2xyz
>    abc3/2xyz          Abc32xyz                   Abc3_2xyz
>    abcD/2xyz          AbcD2xyz                   AbcD_2xyz
>    abcD/Wxyz          AbcDWxyz                   AbcD_Wxyz