This repository is for both the site, and content, of Bolt, and should be considered a counterpart of the Bolt repository.
The documentation uses the Markdown format. There is no need to build anything to generate HTML. We parse the markdown with PHP.
Since this repository is set up to use git's worktree feature, it is advised with to use git version 2.5 or later.
The repository uses branches to group documentation relevant to each version in
the format of release/<version>.
Changes should be PR-ed against the lowest relevant version and will then be merged down into higher version branches as required.
e.g. if you're fixing a typo that exists in the same Markdown file in both
version 3.0 as well as in 3.1, you would checkout release/3.0 and submit your
PR against that branch.
To run the site locally you need to complete the following steps:
- Create the repository with
git clone - Create worktrees for required versions
- Run
composer updateto install required vendor libraries
An example that sets up work trees for 2.2, 3.0 and 3.1 is:
git clone git@github.com:bolt/docs.git bolt-docs
cd bolt-docs
git checkout site
git worktree add var/versions/2.2 origin/release/2.2
git worktree add var/versions/3.0 origin/release/3.0
git worktree add var/versions/3.1 origin/release/3.1
composer update
For your local environment you can add a configuration file, located at
app/config.yml to facilitate local development. It should contain the
following:
debug: true
default-version: '3.1'
Note: If you want to set it to 3.0 for example, be sure to include the
quotes. Otherwise the YML parser will interpret it as 3.
Finally if you wish to use the built-in PHP web server, it can be run from the
bolt-docs/ folder, pointing to web/ as the document root.
php -S 0.0.0.0:8000 -t web web/index.php
Alternatively, configure your preferred webserver to point at the web/
folder. To see the documentation site go to example.localhost/3.1/, from
where you'll get redirected to the front page of the documentation.