Introduction#

Greetings, gentlefolk.

First, a little background. I am a JSPWiki newbie, I have been experimenting with JSPWiki for a few days, I really like what I see and I want to use it. Let me start by thanking those of you who develop the software.

I have been using PikiePikie to run a wiki farm on our intranet, and as a personal info manager. I really like PikiePikie, it has wonderful features, but it's written in Python and is slow. In addition, (the author) Steve Pike's site is offline, and he seems to have gone walkabout - literally. Last I heard, he was on sabbatical wandering around Australia.

JSPWiki is considerably faster, has great features of its own and an active group of developers, but I do wish it had some of the PikiePikie capabilities. For one thing, it might make it much easier for me convert my existing wiki pages to JSPWiki . . .

So, please don't think I am complaining about JSPWiki when I refer to PikiePikie features. The things that attracted me to PikiePikie may also appeal to you, and be considered as suitable enhancements for JSPWiki. Or, they may not.

So, with your indulgence I will post some suggestions based on my experience with PikiePikie and several other wiki solutions I have used.

Cheers . . . Paul, 11/22/2002


Installed JSPWiki today (11/20/2002), with this configuration:
  • Win2000
  • Tomcat 4.1

I also tried to get JSPWiki working with Jetty, without success, but I am not familiar with Jetty.

So far, I like what I have seen of JSPWiki, and may use it for my team's wiki as well as my personal one, replacing PikiePikie. The latter has some great formatting capabilities (which may turn into JSPWiki enhancement requests...), but the performance sucks.

More later.

Cheers . . . Paul, 11/20/2002


Draft of Some Enhancement Requests#

(Based on some of the PikiePikie features I would love to see in JSPWiki)

Bookmarks and In-page Hyperlinks -- moved to NewIdeas, 11/22/2002

Enhanced Tables -- added to NewIdeas, 12/05/2002

PikiePikie has some advanced table syntax. The features I find particularly useful are:

  • Column spanning
  • Table width control
  • Cell alignment
  • Table border size

I include the last because I like to use tables to format the display of text and graphics and find that it is often cleaner and easier to read without borders.

On our wiki we maintain and periodically update status info in tables, some quite large. We use a simple, low tech method to maintain the wiki tables, which is painful to do in raw text. For ease of entry, we use Excel spreadsheets with embedded wiki formatting characters, which a publishing macro saves as a text files in the wiki files folder.

PikiePikie Table Syntax#

(The following is the TableSyntax page from my current wiki.)

You can define tables within a page as follows:

  • Begin a table with standard borders with '[|'. Define a border width with a single numeral between the '[' and the '|', e.g. '[0|' or '[2|'. '[1|' is equivalent to the default, '[|'. If the first cell is to span more than one column increase the number of '|' characters. Thus '[||' starts a table with a first cell that spans two colums, and '[|||' a table with a first cell that spans three columns.
    • From PikiePikie version 0.4 the '[' of the table definition can be immediately followed by a percentage value for the table's width within the page, e.g. '[90%<other parameters>|'. Any other parameters must follow the percentage sign. An assumption is made that, where a percentage width is defined, the table should also be horizontally centred within the available page width.
  • Separate each cell with a double '||'. To create a cell which spans more than one column increase the number of '|' characters. Thus '|||' spans two, and '||||' spans three columns.
    • Empty cells may be defined by including at least one space between the sets of vertical bars. Thus '|| ||' defines an empty cell, whereas '||||' defines a cell which spans three columns.
  • Each row of the table must be on a separate line, start with two or more '|', and end with '||' (make sure there are no trailing spaces or tabs on the line).
  • Each cell definition may include a single '^' (caret) after the last vertical bar, to indicate that the cell's text should be aligned to the top of the cell. See WebLogSideBars for an example.
    • If all cells in a table are to be aligned to the top of the cell, a single '^' may be placed between the '[' and first '|' of the table definition and the '^' may be omitted from the individual cell definitions.
  • Each cell definition may include one or two '>' (greater-than) characters after the last vertical bar. One indicates that the cell's text should be centre-aligned, two indicate that is should be right-aligned.
    • If all cells in a table are to be centred or right aligned, one or two > characters may be placed between the '[' and first '|' of the table definition and the '>' characters may be omitted from the individual cell definitions.
  • Each cell definition may include one or more '!' (exclamation mark) characters after the last vertical bar. These generate a class definition for the cell, of the form class="highlight<n>" where <n> is a count of the number of exclamation marks for the cell. Style sheet definitions can be used to specify how each level of highlighting is to be displayed. Here are the PikiePikie style sheet definitions:
     TD.highlight1 {
       color: #000000;
       background-color: #ADD8E6;
       font-weight: bold;
       font-size: 16px;
     }
     TD.highlight2 {
       background-color: #264B99;
       color: #FFFFFF;
       font-weight: bold;
       font-size: 16px;
     }
  • If the text of a cell is to begin with one of the formatting characters '^', '>' or '!', include a space between the start-of-cell definition and the text, e.g. || !This text begins with an exclamation mark! ||.
  • End a table with '|]'.

Examples:
[|This table||has default borders||
||and is two||rows deep|]

[0|This table||has no borders||
||and is two||rows deep|]

[|This table||has default borders||
||!is three||rows deep||
||and has||!!some highlighted cells|]

[|!This table||!has highlighted headings||
||and||is||
||three rows||deep|]

[2||This is a table has a border size=2 with a single cell on the first line||
||two cells||on this line||
||two cells on||this line too||
|||>and one centred cell on this line|]

[2>||This is a centre-aligned table has a border size=2 with a single cell on the first line||
||two cells||on this line||
||two cells on||this line too||
|||and one cell on this line|]

[100%2>||This is a full-width centre-aligned table with a single cell on the first line||
||two cells||on this line||
||two cells on||this line too||
|||and one cell on this line|]

[3||This table has thicker borders||
||and contains||[1|>a table||
||>with thinner borders||
||>and centre-aligned cells||
||>within it|]||
||and finishes||with two normal cells|] 

[3||This table has thicker borders||
||and contains||[1>>|a right-aligned table||
||with thinner borders||
||within it|]||
||and finishes||with two normal cells|] 

[3|||>This table has thicker borders||
||and contains||[1>>|a right-aligned table with||
||thinner borders|]||within it||
||and finishes||with three||normal cells|] 

[3|||>This table has thicker borders and top-aligned cells||
||^and contains||[1>>|a right-aligned table with||
||thinner borders|]||^within it||
||and finishes||with three||normal cells|] 

[3||This table has thicker borders||
||and contains||[0|>a table||
||>with no borders||
||>within it|]||
||and finishes||with two normal cells|] 

Add new attachment

Only authorized users are allowed to upload new attachments.
« This page (revision-12) was last changed on 30-Dec-2004 13:16 by Administrator