Wiki Advanced Formatting Help

This topic discusses advanced methods for Wiki content authors.

Interwiki links

You can create links between different Wikis without specifying the exact URL. For example, [Wikipedia:JSPWiki] points to a Wikipedia topic (Wikipedia:JSPWiki). The list of supported interwiki prefixes is set by the server administrator and cannot be changed by content authors. However, please do make a request by email if you need additional settings.

Current system settings:

WP_es --> http://es.wikipedia.com/wiki/%s JavaAPI --> http://www.DiversityWorkbench.net/Common/Help/JavaApi.jsp?class=%s RustFloraJapan --> http://www.phytopathology.net/RustFlora/Japan/wiki/%s MWO --> http://www.m-w.com/cgi-bin/dictionary?book=Dictionary&va=%s JSPWiki --> http://www.jspwiki.org/Wiki.jsp?page=%s WP_en --> http://en.wikipedia.com/wiki/%s JSPSandbox --> http://sandbox.jspwiki.org/Wiki.jsp?page=%s WK_de --> http://de.wiktionary.org/wiki/%s Mykolus --> http://www.phytopathology.net/Mykolus/wiki/%s Leo_de_en --> http://dict.leo.org/?lang=en&lp=ende&cmpType=relaxed§Hdr=off&search=%s Yahoo --> http://search.yahoo.com/search?p=%s rsc --> /Resource/%s Rsc --> /Resource/%s WP_de --> http://de.wikipedia.com/wiki/%s Doc --> http://doc.jspwiki.org/2.2/Wiki.jsp?page=%s MetaWiki --> http://www.DiversityCampus.net/MetaWiki/wiki/%s WorkbenchDevelopment --> http://www.DiversityWorkbench.net/Development/wiki/%s local --> /%s Leo_en_de --> http://dict.leo.org/?lang=en&lp=ende&search=%s Local --> /%s PhytopathologyHandbuch --> http://www.phytopathology.net/Handbuch/wiki/%s PhytopathologyDiagnose --> http://www.phytopathology.net/Diagnose/wiki/%s Phytopathology --> http://www.phytopathology.net/Portal/wiki/%s Wikipedia --> http://en.wikipedia.com/wiki/%s RSC --> /Resource/%s Workbench --> http://www.DiversityWorkbench.net/Portal/wiki/%s Google --> http://www.google.com/search?q=%s DataRepository --> http://www.DiversityWorkbench.net/DataRepository/wiki/%s CampusAdmin --> http://www.DiversityCampus.net/CampusAdmin/wiki/%s OudemansEnumeratio --> http://www.phytopathology.net/Oudemans/Enumeratio/wiki/%s UnionWiki --> http://www.DiversityCampus.net/UnionWiki/wiki/%s Pflanzenschutz --> http://www.phytopathology.net/Pflanzenschutz/wiki/%s Sandbox --> http://www.DiversityCampus.net/Sandbox/wiki/%s Phytophthora --> http://www.phytopathology.net/Phytophthora/wiki/%s SmutBase --> http://www.phytopathology.net/SmutBase/wiki/%s Wiktionary --> http://en.wiktionary.org/wiki/%s UBIF --> http://wiki.cs.umb.edu/twiki/bin/view/UBIF/%s WK_es --> http://es.wiktionary.org/wiki/%s WK_en --> http://en.wiktionary.org/wiki/%s ScholzBrandpilze --> http://www.phytopathology.net/Scholz/Brandpilze/wiki/%s DiversityWorkbench --> http://www.DiversityWorkbench.net/Portal/wiki/%s LiasGlossary --> http://glossary.lias.net/LiasGlossary/wiki/%s SDD --> http://wiki.cs.umb.edu/twiki/bin/view/SDD/%s WorkbenchHelp --> http://www.DiversityWorkbench.net/Help/wiki/%s

Interwiki links are case sensitive; e.g., [wikipedia:JSPWiki] will create an error like the following: "wikipedia:JSPWiki No InterWiki reference defined in properties for Wiki called 'wikipedia'!)". (Please do not correct this error, it is purposely present here!)

Footnotes

By using only a number inside two brackets (like [1]), you create a footnote link. The actual footnote is created by placing a '#' in front of the corresponding number ([#1]). You can also create named footnotes by using the display text feature. For example, [RefX|2] may point to: [RefX|#2].

When using simple numbered footnotes, currently (JSPWiki 2.2.28, Sept. 2005) only the footnote marker in the main text is formatted as superscript. The marker in front of the footnote is displayed literally, including the '#' sign. Using named footnotes is therefore recommended.

Tables

Simple tables may be created using pipe symbols ('|'). Double pipe symbols in the first rows create table heading rows, single pipe symbols create data rows. Each row must be on a single line. You can use inline formatting rules, and line breaks (\\), but no block level (heading, paragraph, list, definition) markup. For example:

|| Column 1 || Column 2
| Data | ''data'' \\ second line created with line break
| [Main]     | [PageIndex]

Creates:

Column 1	Column 2
Data	data second line created with line break
Main	PageIndex

With standard table markup it is not possible to create row or column spans. A table plugin is under development and available as contributed code, but not yet included in the standard installation of JSPWiki.

Variables

You can define and reuse variables on pages, for example, to increase the consistency of a page and simplify updating. Writing on a Wiki page: [{SET RecentVersion='2.5'}] Current version is "[{$RecentVersion}])" results in: Current version is "2.5)".

Some additional predefined variables are always available. Most useful are [{$pagename}] (here = WikiAdvancedFormattingHelp) and [{$applicationname}] (here = Diversity Workbench Portal.

However, you cannot refer to variables defined on other pages (compare HowToUseAVariable for possible updates).

Tip: As of JSPWiki 2.2.28, no internal annotating/commenting method is available (visible during editing, but not during page view). Such a method is often useful to document decisions or create progress/to-do comments). You may, however, create a variable like: [{SET Note='GH: continue revision here'}].

Plugins

A plugin is a function that generates dynamic page content. All JSPWiki Core Plugins are available to you. Many of these have specific functionality used on a single page like Index, RecentChanges, UnusedPages, etc. The following plugins are perhaps most likely to be used by general content authors:

• Image plugin: Normally, an image may simply be embedded by creating a link to it. If the image ends in one of the image extensions recognized by this JSPWiki installation, an image will be displayed instead of a hyperlink. However, if more complex formatting is desired, the image plugin is very powerful. It enables you to add a hyperlink behind an image, a caption below the image, define alt-text, width and height, align position, etc. Example: [{Image src='http://xyz.net/img/234.png' link='http://me.my.com/index.html' height='80' width='30' align='right' }].
• Table of contents plugin: All headings (marked with !, !!, or !!! in first line) are displayed as a short, hyperlinked table of contents. Optionally a title may be set: Example: [{TableOfContents title='Contents'}].
• Insert page plugin: This plugin allows you to include the content of one page into another page. Example: [{InsertPage page='CommonDisclaimer'}]. The plugin offers a number of formatting parameters and also an option to only include sections [as of 2005-09-05 the use of the section parameter was undocumented, however, please update once documentation arrives!].
• Referring pages plugin: This plugin (depending on your template this may also be visible in the bottom of the left menu or when you display the page information page) shows all pages that link to your current page (using [{ReferringPagesPlugin}]) or to a specified page (using [{ReferringPagesPlugin page='ProjectX'}]).
  • The catch with this plugin is that you can set up specific pages to organize your Wiki content. For example, creating a page [NewIdea] that contains this plugin, and then adding "This is a [NewIdea]" to pages containing new ideas, you automatically generate a cross-indexing system.
  • The plugin has some additional parameters that allow you to customize the display. Very useful is: [{INSERT ReferringPagesPlugin max=100 maxwidth=100 before='#' after='\n'}] to display the results in a numbered list (or use before='*' to create a bulleted list).

If you require additional contributed plugins, please contact your local Wiki server maintainer whether it is possible to install them.

Styles

The standard Wiki markup rules are purposely limited to help you concentrate on the content and enable different presentations for different target systems. Occasionally, however, a richer formatting is desirable. A special syntax with a double %-sign supports this as shown in the red super- and sub-examples in Wiki FormattingQuickReference. The color example uses a local inlining of CSS definitions (use parantheses after the opening double %), whereas the super-, and subscript examples refer to class definitions defined in a CSS stylesheet. You can either use all classes defined in the CSS stylesheet defined for the template your Wiki is using, or (when using the ConfigurableTemplate) you may define your own styles in the wiki page "WikiCSSExtensions"; see WikiCSSExtensionHelp for additional help.

---

(Continue with WikiHelp or WikiFormattingQuickReference)

Your trail: