Go back to First Steps

Wiki

What is a Wiki?

  • A wiki is a dynamic content manager similiar to Wikipedia. All changes to wiki pages are saved in a wiki history. You can roll back to previous versions, export the pages as txt file or compare the changes with past versions. This makes it the perfect tool collaboration tool to keep track of text changes in long text files. Each project can have its own wiki. To activate it go to the wiki module in project settings ad give a name for the main page and click 'Save'.

Features:

  • Roll back history to restore previous wiki pages
  • Changes are saved per user, you can see who changed what
  • Color scheme based history (red=deleted, green=new)
  • Create unlimited wiki pages
  • Intelligent style tags makes it possible to work without repeatitive <open> and </close> tags.
  • Wiki page export as txt file

You can use it to:

  • Post your translations
  • Add series information, reviews and images
  • Gain full control of text changes made by multiple authors.

Create New Pages

  • To create additional wiki pages simply point the browser to the url, where you want to create the wiki page:

Example: http://rome.jcafe24.com/wiki/*yourproject*/name_of_new_wiki_page

Will create a wiki page called "name_of_new_wiki_page" for project "*yourproject*"

Wiki Navigation

Table of content

{{toc}} => left aligned toc
{{>toc}} => right aligned toc

Wiki commands

Wiki formatting

Links

ROME links

ROME allows hyperlinking between issues, changesets and wiki pages from anywhere wiki formatting is used.

  • Link to an issue: #124 (displays #124, link is striked-through if the issue is closed)
  • Link to a changeset: r758 (displays r758)
  • Link to a changeset with a non-numeric hash: commit:"c6f4d0fd" (displays c6f4d0fd). Added in r1236.

Wiki links:

  • [[Guide]] displays a link to the page named 'Guide': Guide
  • [[Guide|User manual]] displays a link to the same page but with a different text: User manual

You can also link to pages of an other project wiki:

  • [[sandbox:some page]] displays a link to the page named 'Some page' of the Sandbox wiki
  • [[sandbox:]] displays a link to the Sandbox wiki main page

Wiki links are displayed in red if the page doesn't exist yet, eg: Nonexistent page.

Links to others resources (0.7):

  • Documents:
  • document#17 (link to document with id 17)
  • document:Greetings (link to the document with title "Greetings")
  • document:"Some document" (double quotes can be used when document title contains spaces)
  • Versions:
  • version#3 (link to version with id 3)
  • version:1.0.0 (link to version named "1.0.0")
  • version:"1.0 beta 2"
  • Attachments:
  • attachment:file.zip (link to the attachment of the current object named file.zip)
  • For now, attachments of the current object can be referenced only (if you're on an issue, it's possible to reference attachments of this issue only)

Escaping (0.7):

  • You can prevent ROME links from being parsed by preceding them with an exclamation mark: !

External links

HTTP URLs and email addresses are automatically turned into clickable links:

http://www.ROME.org, someone@foo.bar

displays: http://www.ROME.org,

If you want to display a specific text instead of the URL, you can use the standard textile syntax:

"ROME web site":http://www.ROME.org

displays: ROME web site

Text formatting

For things such as headlines, bold, tables, lists, ROME supports Textile syntax. See http://hobix.com/textile/ for information on using any of these features. A few samples are included below, but the engine is capable of much more of that.

Font style

* *bold*
* _italic_
* _*bold italic*_
* +underline+
* -strike-through-

Display:

  • bold
  • italic
  • *bold italic*
  • underline
  • strike-through

Inline images

  • !image_url! displays an image located at image_url (textile syntax)
  • !>image_url! right floating image
  • !{width:300px}image_url! sets the width of the image

If you have an image attached to your wiki page, it can be displayed inline using its filename: !attached_image.png!

Headings

h1. Heading
h2. Subheading
h3. Subheading

Paragraphs

p>. right aligned
p=. centered

This is centered paragraph.

Blockquotes

Start the paragraph with bq.

bq. Rails is a full-stack framework for developing database-backed web applications according to the Model-View-Control pattern.
To go live, all you need to add is a database and a web server.

Display:

Rails is a full-stack framework for developing database-backed web applications according to the Model-View-Control pattern.
To go live, all you need to add is a database and a web server.

Also available in: HTML TXT