Documentation

This commit is contained in:
Will Rossiter 2012-09-21 19:18:57 +12:00
parent 3ff1deff7d
commit 97b79f14b5
3 changed files with 47 additions and 4 deletions

View File

@ -3,7 +3,7 @@
## Introduction ## Introduction
Static provides several extensions for exporting a SilverStripe application to Static provides several extensions for exporting a SilverStripe application to
both local or remote file systems both local or remote file systems.
## Maintainer Contact ## Maintainer Contact
@ -15,4 +15,8 @@ both local or remote file systems
* SilverStripe 3.1 * SilverStripe 3.1
* Tar archive * Tar archive
## Documentation
See docs/
Note this is untested on Windows. Note this is untested on Windows.

View File

@ -33,12 +33,27 @@ configuration options then will generate a tar.gz archive of the website.
Accessing http://yoursite.com/dev/tasks/StaticExporterTask will generate the Accessing http://yoursite.com/dev/tasks/StaticExporterTask will generate the
export of the website and save it to a folder on your filesystem. Unlike the export of the website and save it to a folder on your filesystem. Unlike the
GUI option this does not allow you to configure options in the browser, instead GUI option this does not allow you to configure options in the browser, instead
it relies on the developer setting the options via statics (as deploy) it relies on the developer setting the options via statics or through GET
parameters.
### Sake ### Sake
To generate the export via command line ([sake](framework/en/topics/commandline.md)) To generate the export via command line ([sake](/framework/en/topics/commandline.md))
sake dev/tasks/StaticExporterTask sake dev/tasks/StaticExporterTask
## Options ## Options
Both the StaticExporterTask and Sake task take the following GET params. The
GUI method only allows you to customize the baseurl path.
* baseurl - (string) Base URL for the published site
* symlink - (false|true) Copy the assets directory into the export or, simply
symlink to the original assets folder. If you're deploying to a separate
server ensure this is set to false.
* quiet - (false|true) Output progress of the export.
* path - (string) server path to generate export to.
Note that the path directory will be populated with the new exported files.
This script does not empty the directory first so you may which to remove the
folder (`rm -rf cache && sake dev/tasks/StaticExporterTask path=cache`)

24
docs/en/index.md Normal file
View File

@ -0,0 +1,24 @@
# Static
Static is a module providing extensions to SilverStripe to allow developers to
generate static exports of their SilverStripe sites either for performance or
as a backup system.
There are two main parts to the module
## Static Publisher
Publish selected SilverStripe pages as HTML / PHP files to get a performance
increase on those pages. You can run the static content alongside a full
installation to allow for seamless integration. Also supports syncing published
content to multiple servers for load balancing.
* [Static Publisher](StaticPublisher)
## Static Exporter
Export your entire website to HTML pages. Suitable if your entire site is
static and you wish to deploy the content to a machine other than the CMS or
as a backup measure to your website
* [Static Exporter](StaticExporter)