This is a temporary repository for developer documentation about the SilverStripe framework, currently located at http://doc.silverstripe.org.
PHP JavaScript Other
Switch branches/tags
Nothing to show
Pull request Compare This branch is 122 commits behind mattclegg:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
input
master
preview
rendering
scripts
.gitignore
LICENSE
README.md

README.md

SilverStripe Documentation Restructuring Project

This is a temporary repository for developer documentation about the SilverStripe framework, currently located at [http://doc.silverstripe.org].

Note: This repository is used for collaboration during the restructuring phase, and will move elsewhere afterwards

Contact

  • Documentation questions: Ingo Schommer (ingo at silverstripe dot com)
  • Markdown Conversion: Mark Stephens (mark at silverstripe dot com)

Contributing

Requirements

You'll need to install git, which is quite straightforward on most operating systems.

To edit the files, you just need a text editor. They're written in Markdown, which many editors have syntax highlighting for (e.g. through the Textmate plugin).

To preview changes, you will need to run a local webserver capable of running SilverStripe. XAMPP is a good option.

Folders

  • master: The new markdown files - please edit in here
  • scripts: Helper scripts for conversion and file management

Forking the project

You can fork this project within github, as described on help.github.com. This fork will show up on your own github profile, and can be checked out to your local machine. You don't need a webserver on there, or run any project-specific scripts. Merging back pull requests can either be done straight on github (for simple cases), or through git pull commands (see guide).

Documentation Guidelines

Its important to read the documentation guidelines, in order to keep a consistent writing and formatting style. We use a customized version of Markdown and Markdown Extra called "ss-markdown"

Previewing your changes

The preview/ directory contains a SilverStripe site that you can visit to preview what the documentation site will look like. You will need to create a _ss_environment.php file in the root of your project or in the directory above.

Here is a minimal one. Alter the database settings to suit your set-up.

<?php
define('SS_ENVIRONMENT_TYPE', 'dev');
define('SS_DATABASE_SERVER', 'localhost');
define('SS_DATABASE_USERNAME', 'root');
define('SS_DATABASE_PASSWORD', '');

If you have check out silverstripe-doc-restructuring into your webroot, you should be able to visit a URL such as http://localhost/silverstripe-doc-restructuring/preview/ to preview your changes.

Contributing your changes

After pushing your changes to your own github fork, you can send us pull requests.

Obsolete actions

The following scripts should no longer be used, as they were designed for an earlier stage in the project.

Import DokuWiki files

Note: This is only possible by SilverStripe staff.

scp -P 2222 -R <username>@doc.silverstripe.org:/sites/ss2doc/www/assets/data/pages/ input/

Convert to Markdown files

cd scripts
php TranslateSSDocs.php