This repository contains the source code for the autosetup documentation
In order to build the documentation you will need:
- nanoc v4.11 static website generator
- ruby v2.4 or later
I have:
$ nanoc --version
Nanoc 4.11.5 © 2007–2019 Denis Defreyne.
Running ruby 2.6.3 (2019-04-16) on x86_64-darwin17 with RubyGems 3.0.3.
See the nanoc installation documentation for installation with gem. gem should install all the required dependencies, but for reference, I have the following installed:
$ gem list --local
adsf (1.4.2)
kramdown (2.1.0)
nanoc (4.11.5)
nanoc-core (4.11.5)
nokogiri (1.10.3)
nokogumbo (2.0.1)
ref (2.0.0)
zeitwerk (2.1.6)
To build, simply run:
$ make
To update the developer reference, you will need to have an autosetup
git repository somewhere and run (note that AUTOSETUP is a path to the
actual autosetup script):
$ make AUTOSETUP=<path-to-autosetup-git>/autosetup
To update the github pages, checkout the autosetup git repository somewhere on branch gh-pages and run:
$ make PUBLISH_URL=<path-to-autosetup-gh-pages-git>
The commit the changes on the gh-pages branch.
To test your changes, run:
$ make all test
And navigate your browser to http://localhost:3000/
Generally, follow the nanoc documentation on how to add/modify content. Articles can be added under content/articles/. Remember to add a title and date to the header.