2010-03-04 05:39:02 +01:00
|
|
|
# Documentation Viewer Module
|
|
|
|
|
2013-03-29 09:38:02 +01:00
|
|
|
[![Build Status](https://secure.travis-ci.org/silverstripe/silverstripe-docsviewer.png?branch=master)](http://travis-ci.org/silverstripe/silverstripe-docsviewer)
|
|
|
|
|
2011-01-11 02:35:59 +01:00
|
|
|
## Maintainer Contact
|
|
|
|
|
|
|
|
* Will Rossiter (Nickname: willr, wrossiter)
|
2012-04-08 11:23:49 +02:00
|
|
|
<will@fullscreen.io>
|
2010-03-04 05:39:02 +01:00
|
|
|
|
|
|
|
## Requirements
|
2011-01-11 02:35:59 +01:00
|
|
|
|
2014-01-14 08:41:59 +01:00
|
|
|
* SilverStripe 3.1
|
2010-03-04 05:39:02 +01:00
|
|
|
|
|
|
|
## Summary
|
|
|
|
|
2012-04-08 11:23:49 +02:00
|
|
|
Reads text files from a given list of folders from your installation and
|
|
|
|
provides a web interface for viewing.
|
|
|
|
|
|
|
|
To read documentation go to yoursite.com/dev/docs/
|
2010-03-04 05:39:02 +01:00
|
|
|
|
2011-01-11 02:35:59 +01:00
|
|
|
For more documentation on how to use the module please read /docs/Writing-Documentation.md
|
2014-01-14 08:41:59 +01:00
|
|
|
(or via this in /dev/docs/docsviewer/Writing-Documentation in your webbrowser)
|
2011-01-10 11:59:31 +01:00
|
|
|
|
2011-01-14 02:03:46 +01:00
|
|
|
**Note** This module assumes you are using numeric values for your versions.
|
2014-01-14 08:41:59 +01:00
|
|
|
|
2014-01-14 09:16:39 +01:00
|
|
|
### HTML Publishing
|
2014-01-14 08:41:59 +01:00
|
|
|
|
|
|
|
If you wish to generate a truly static version of your documentation after it
|
|
|
|
has been rendered through the website, add the [Static Publisher](https://github.com/silverstripe-labs/silverstripe-staticpublisher)
|
|
|
|
module to your documentation project and set the following configuration in your
|
|
|
|
applications config.yml:
|
|
|
|
|
|
|
|
```
|
|
|
|
StaticExporter:
|
|
|
|
extensions:
|
|
|
|
- DocumentationStaticPublisherExtension
|
|
|
|
```
|
|
|
|
|
|
|
|
If you don't plan on using static publisher for anything else and you have the
|
|
|
|
cms module installed, make sure you disable the CMS from being published.
|
|
|
|
|
|
|
|
Again, in your applications config.yml file
|
|
|
|
|
|
|
|
```
|
|
|
|
StaticExporter:
|
|
|
|
disable_sitetree_export: true
|
|
|
|
```
|