EditWikiLocally

The Github wiki is implemented using github/gollum. For more complex editing it's 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 git@github.com:Albacore/albacore.wiki.git

You can then *pull changes made online or via other peoples 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 bundle && bundle exec 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.

More info can be found at Gollum's repository.

Wiki Structure

• /Home.md This is the home page that appears when users click on the wiki link for Albacore/albacore/wiki.
• dev/ Pages relating to the development of Albacore.
• tasks/ If you have created a new task, please place its documentation in here.

Task Pages

Each task should have its own page located in tasks/MyTaskName-Task.ext.

Images for each project should be placed into the tasks/images/task-name/ directory.

The sidebar _Sidebar.md should be updated with a link to the task.

Task Page Markdown Template

# Task Name With White Space  (this shows up in the Pages listing as the name of the page)

Description of the task and a diagram to help make it understandable.

[[/tasks/images/task-name/diagram.png]]

# Maven Artifacts

* project-parent
* project
* project-examples

 
# Documentation

## Maven Stable
 ```xml
<dependency>
    <groupId>org.wicketstuff</groupId>
    <artifactId>project</artifactId>
    <version>1.4.14</version>
</dependency>

Maven Development

<dependency>
   <groupId>org.wicketstuff</groupId>
   <artifactId>project</artifactId>
   <version>1.4-SNAPSHOT</version>
</dependency>

<repository>
 <id>wicketstuff-core-snapshots</id>
 <url>ttps://oss.sonatype.org/content/repositories/snapshots</url>
 <snapshots>
   <enabled>true</enabled>
 </snapshots>    
</repository>

Java

// Example in Java of how the component can be used.

HTML

<!-- HTML example of how the component can be attached to markup -->
<div wicket:id="grid"></div>

Project Maintainers

The list of task maintainers or it could list historical contributors.

## Page Links

```text
[[ 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 AssemblyInfo Task link.

[[AssemblyInfo Task | AssemblyInfo-Task ]]

• AssemblyInfo Task is the label we want shown for the link.
• AssemblyInfo is the name of the page we are linking to. On the filesystem the path to the file is /tasks/AssemblyInfo-Task.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:

[[http://albacorebuild.net/images/AlbacoreLogo3.png]]

Which renders like this: