doc.silverstripe.org/sapphiredocs/docs/en/index.md
2011-02-11 03:21:20 +00:00

1.4 KiB

Sapphire Documentation Module

This module has been developed to read and display content from markdown files in webbrowser. It is an easy way to bundle end user documentation within a SilverStripe installation.

See Writing Documentation for more information on how to write markdown files which are available here.

To include your docs file here create a docs/en/index.md file. You can also include custom paths and versions. To configure the documentation system the configuration information is available on the Configurations page.

Setup

The module provides automatic search functionality via Lucene Search. To enable search you need to add the following to your applications _config.php file:

DocumentationSearch::enable();

After adding that line you will also need to build the indexes of the search. You can run the following from your webbrowser or via sake

Using a URL other than /dev/docs/

By default, the documentation is available in dev/docs. If you want it to live on the webroot instead of a subfolder, add the following configuration to your mysite/_config.php:

DocumentationViewer::set_link_base('');
Director::addRules(1, array(
	'$Action' => 'DocumentationViewer',
	'' => 'DocumentationViewer'
));