Skip to content

Editing Wiki Locally

Jump to bottom
Michael O'Cleirigh edited this page Jan 10, 2011 · 8 revisions

The Githib wiki is implemented using github/gollum. For more complex editing its possible to git clone the wiki and work locally.

Clone Wiki

  1. Click on Wiki
  2. Click on Git Access
  3. Copy writable git location.
  4. Clone the location like git clone [email protected]:wicketstuff/core.wiki.git

You can then *pull changes made online or via other peopls cloned repositories and push your work back to the central site.

Install Github/gollum

  • Install gollum: gem install gollum
  • Install Markdown support: gem install rdiscount

Running Gollum

Then in the root of your cloned copy run gollum which will run a webserver on http://127.0.0.1:4567. Note that the page content shown reflects the latest committed values for each file. If you want to see what your latest changes would look like you need to git commit locally before you rungollum.

Wiki Structure

  • /Home.md This is the home page that appears when users click on the wiki link for wicketstuff/core/wiki.
  • /dev This is the directory for topics related to wicketstuff/core development like releases and this document.
  • /projects This is a directory for holding each projects top level pages.

Page Links

[[ Link Label | Link ]]

The natural language version that you want displayed for the link is the first part. The actual link is the second part.

There is a single page namespace in Gollum so the second part if it is a page is the name of the page with dashes replacing spaces and no path info and no file extension.

For example: Here is the Progress Bar Project link.

[[Progress Bar Project | Progressbar ]]
  • Progress Bar Project is the label we want shown for the link.
  • Progressbar is the name of the page we are linking to. On the filesystem the path to the file is /projects/Progressbar.md but due to the single namespace we can refer to it directly.

Image Example

Image resources can also be placed into any location in the directory structure. I would recommend an images directory at each level in the heirarchy to keep things seperated.

They can then be referred to using an absolute name like:

[[/dev/images/example-image.png]]

Which renders like this:

Clone this wiki locally