Theming

User CSS

The markdown renderer behind Shellwiki has been designed to provide element wrapping and class information that should make it easy to apply complex css themes. You can easily attach upload an CSS file as an attachment to a page and use it by using a pragma near the top of the page:

%css /page/upload.css

CSS paragmas are applied to sub pages and can be stacked, so that sub pages use additional CSS files. This will work best if you use an absolute path when referring to a css file.

Header, Footer, Error pages

The page header, footer, error pages, login and registration page etc. are wiki pages themselves. You can access them in under the path /[wiki]/ in your installation. THis way you can add menus, custom error messages and explanation texts to the different parts of the wiki. You can also add localised version of all modified pages, when using a multilanguage installation.

Favicon

Because all attachments can be accessed simply as file pathes under their respctive pages, a favicon for your site can be provided by attaching a file named favicon.ico to your root page (/).

Theming plugins

The methods described above provide ample opportunity to modify the appearance of you wiki installation. If you need to dive even deeper into the HTML-Code, you can choose a theming plugin. Theming plugins can provide a fundamentally different layout of the pages HTML structure. They are located in the themes/ directory of the shellwiki code, and can be selected by setting the environment variable "$WIKI_THEME". For details about the structure of a theming pluging, look at ../dev-theming/.