This page (revision-1) was last changed on 16-Aug-2026 18:10 by UnknownAuthor

Only authorized users are allowed to rename pages.

Only authorized users are allowed to delete pages.

Page revision history

Version Date Modified Size Author Changes ... Change note
16-Aug-2026 18:10 10 KB UnknownAuthor

Page References

Incoming links Outgoing links
TextFormattingRules
TextFormattingRules

Version management

Difference between version and

1This page describes the wiki syntax used by JSPWiki. For details about how this differs from the syntax used by Wikipedia, please see [MigratingFromMediaWiki|JSPWiki:MigratingFromMediaWiki].
2
3[{TableOfContents }]
4\\
5When you've figured out how the editor works, then you should read [WikiEtiquette] so that you would know how to use your newly acquired skills. The [SandBox|http://sandbox.jspwiki.org] is a great place to try them out.
6!Quick Reference
7{{{
8---- = make a horizontal ruler. Extra '-' is ignored.
9\\ = force a line break
10
11[link] = create a hyperlink to an internal WikiPage called 'Link'.
12[this is also a link] = create a hyperlink to an internal WikiPage called
13 'ThisIsAlsoALink' but show the link as typed with spaces.
14[a sample|link] = create a hyperlink to an internal WikiPage called
15 'Link', but display the text 'a sample' to the
16 user instead of 'Link'.
17~NoLink = disable link creation for the word in CamelCase.
18[1] = make a reference to a footnote numbered 1.
19[#1] = mark the footnote number 1.
20[[link] = create text '[link]'.
21
22!heading = small heading with text 'heading'
23!!heading = medium heading with text 'heading'
24!!!heading = large heading with text 'heading'
25
26''text'' = print 'text' in italic.
27__text__ = print 'text' in bold.
28{{text}} = print 'text' in monospaced font.
29[text|] = print 'text' underscored (dummy hyperlink)
30* text = make a bulleted list item with 'text'
31# text = make a numbered list item with 'text'
32;term:ex = make a definition for 'term' with the explanation 'ex'
33}}}
34!Writing text
35You don't need to know anything about the Wiki text formatting rules to use Wiki. Just write normal text, and then use an empty line to mark a paragraph.
36It's just like writing an email.
37You can always Edit this page (look at the left sidebar) to see how the different
38effects on this page are used.
39!Hyperlinks
40The link can also be a direct URL starting with {{http:}}, {{ftp:}}, {{mailto:}}, {{https:}}, or {{news:}}, in which case the link points to an external entity. For example, to point at the java.sun.com home page, use {{[[http://java.sun.com]}}, which becomes [http://java.sun.com/] or {{[[Java home page|http://java.sun.com]}}, which becomes [Java home page|http://java.sun.com].
41If you do not start the link with one of the above "protocols", the wiki assumes a normal link to another page in the wiki space, you need to use a letter as the first character of the page, purely numeric page names are not allowed. If you want to use square brackets ({{[[]}}) in the page without creating a hyperlink, use two opening square brackets. So the text {{[[[Example Non-Link]}}, will appear as {{[[Example Non-Link]}}.
42To add a new page you just create a link to it from somewhere else. After all, there isn't much point in having a page if you can't access it! You'll then see the page name underlined with a red-dashed line when you return to that page. Then click on it and you have created a new page!
43It's allowed to use almost any kind of characters inside a [WikiName|JSPWiki:WikiName], as long
44as they are letters or numbers.
45Note also that this Wiki can be configured to support standard [CamelCase|JSPWiki:CamelCase] linking (if it's supported, the word CamelCase should be a link, if it doesn't start with '~~'). It's off by default, but if your friendly administrator has turned it on, then well, CamelCase all you want =).
46!Footnotes
47These are a special kind of hyperlink. By using nothing but a number inside
48a hyperlink you create a reference to a footnote, like this {{[[1]}}, which
49creates a footnote[1]. To make the actual footnote, you just put a {{[[#1]}}
50where you want that footnote to point at. Look below to find the footnote.
51You can also make a named footnote, just as if you were doing a normal hyperlink, such as {{[[Footnote name|1]}} as another way of referring to the first footnote[Footnote name|1]. Or you can put the custom name at the footnote itself[2].
52![InterWiki|JSPWiki:InterWiki] links
53You can also do links between different Wikis without knowing the URL. Just use a link in the form {{[[Wiki:WikiPage]}} and JSPWiki will create a link for you. For example, this link points to the [JSPWiki TextFormatting rules|JSPWiki:TextFormattingRules]. Check the [SystemInfo] page for more information on which Wiki links are available.
54If an [InterWiki|JSPWiki:InterWiki] link is not supported, you'll get a notification of it on the page when
55you save your page.
56!Adding pictures
57You can embed
58any image in the wiki code by putting the image available somewhere on the web in one of the allowed formats, and then just linking to it.
59If you specify a link text ({{[[this one here|http://example.com/example.png]}}) it becomes
60the ALT text for those who either can't or don't want to view images.
61The list of accepted image types depends on the Wiki. See the [SystemInfo]
62page for a list of the different image types.
63It is also possible to use the [Image plugin|JSPWiki:Image] to gain more control over the image placement and attributes.
64To force a flush after an image, use \ \ \ (that is, three consecutive backslashes instead of two).
65!Bulleted lists
66Use an asterisk (*) in the first column to make bulleted lists. Use more asterisks for deeper indentation. For example:
67{{{
68* One \\ one and a half
69* Two
70* Three
71** Three.One}}}
72creates
73* One \\ one and a half
74* Two
75* Three
76** Three.One
77!Numbered lists
78Just like with bulleted lists, but use a hash (#) instead of the asterisk. Like this:
79{{{
80# One \\ one and a half
81# Two
82# Three
83## Three.One
84}}}
85creates
86# One \\ one and a half
87# Two
88# Three
89## Three.One
90If you want to write the list item on multiple lines, just add one or more spaces on the next line and the line will be automatically added to the
91previous item. For example:
92{{{
93* This is a single-line item.
94* This is actually a multi-line item.
95 We continue the second sentence on a line on a line of its own.
96 We might as well do a third line while we're at it...
97 Notice, however, as all these sentences get put inside a single item!
98* The third line is again a single-line item for your convenience.
99}}}
100produces:
101* This is a single-line item.
102* This is actually a multi-line item.
103 We continue the second sentence on a line on a line of its own.
104 We might as well do a third line while we're at it...
105 Notice, however, as all these sentences get put inside a single item!
106* The third line is again a single-line item for your convenience.
107!Definition lists and comments
108A simple way to make definition lists is to use the ';:' -construct:
109{{{
110;__Construct__:''Something you use to do something with''
111}}}
112is rendered as:
113;__Construct__:''Something you use to do something with''
114Another nice use for the ';:' is that you can use it to comment shortly on other people's text, by having an empty 'term' in the definition, like this:
115{{{
116;:''Comment here.''
117}}}
118Which would be seen as
119;:''Comment here.''
120!Text effects
121You may use __bold__ text or ''italic'' text, by using two underscores (_) and two single quotes ('), respectively. If you're on a Windows computer, make sure that you are using the correct quote sign, as there is one that looks the same, but really isn't.
122A [underscore|] effect can be produced by using a hyperlink to nowhere, [[like this|]
123!Preformatted text
124If you want to add preformatted text (like code) just use three consecutive braces ({) to open a block, and three consecutive braces (}) to close a block. Edit this page for an example.
125!Tables
126You can do simple tables by using pipe signs ('|'). Use double pipe
127signs to start the heading of a table, and single pipe signs to then
128write the rows of the table. End with a line that is not a table.
129For example:
130{{{
131|| Heading 1 || Heading 2
132| ''Gobble'' | Bar \\ foo
133| [Main] | [SandBox]
134}}}
135gives you the following table. Note how you can use links also inside tables.
136|| Heading 1 || Heading 2
137| ''Gobble'' | Bar \\ foo
138| [Main] | [SandBox]
139!CSS styles
140While not in line with the keep it simple principle, CSS styles [can be used inline|JSPWiki:CSSInWikipages] for those special occasions when you really need to emphasize part of a page.
141!Conflicts
142If someone happens to edit the same page as you at the same time, JSPWiki will prevent you from doing changes and show a conflict page instead. Sorry to say, but the first one to make changes wins...
143__A word of warning:__ If you use the Back button of your browser to go into the Edit page, you will almost certainly get a conflict. This is because the browser thinks it's still editing an earlier copy of the page.
144!Deleting pages
145This is not possible. You can, of course, remove all the links to that page, which makes it inaccessible. Or you can email the administrator, and I'll remove the page. You may also add a [DELETEME|JSPWiki:DELETEME] link.
146!Adding new pages
147Create a link that points to a new (not existing) page using its [WikiName|JSPWiki:WikiName].
148Click that new link, which should now have a question mark (?) suffix and
149you will get an editor for the new page. -- [Asser|JSPWiki:Asser]
150!Aliasing a Page
151Sometimes you want any link to a wiki page to immediately traverse to a different page. This can be done using a [PageAlias].
152!Inserting variables
153There are many possible variables you can insert on a page. The basic form is:
154{{ [[{$variablename}], }}
155where ''variablename'' is the name of the variable you want to insert. Note that variable names are case-insensitive - that is, "pagename" is the same as "paGeNamE" and "PageName".
156You can see the list of available of variables at [WikiVariables|JSPWiki:WikiVariables].
157
158!Inserting plugins
159The basic incantation to insert a plugin looks like this:
160[[{INSERT WHERE param1=value, param2=value, ...}]
161There is more information in [JSPWikiPlugins | JSPWiki:JSPWikiPlugins].
162----
163[#1] Here's the footnote I mentioned.
164[2-The other footnote|#2] The other footnote. Note how its name is different?
165----
166Any [ideas | JSPWiki:IdeasTextFormattingRules]?
167Any [questions | JSPWiki:TextFormattingRulesDiscussion]?
This page (revision-) was last changed on 16-Aug-2026 18:10 by UnknownAuthorTop