Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
_test
content Support and Status edits (#366) Oct 18, 2018
layouts
lib
priorities
.gitignore From Cancel subscription to Unsubscribe (#322) Jan 30, 2018
.ruby-gemset First commit Jan 23, 2014
.ruby-version Specify Ruby implementation Jan 30, 2018
.travis.yml Fix category generation Jul 31, 2016
Gemfile
Gemfile.lock Update dependencies Oct 8, 2018
Guardfile Add guard-nanoc Jul 31, 2016
README.markdown Update README.markdown Mar 27, 2018
Rakefile
Rules Generate search index as part of the compilation Aug 1, 2016
nanoc.yaml Fix bug with category order introduced in the v4 upgrade Jul 31, 2016
s3_website.yml Move DNSSEC Support article to DNSSEC. Update with latest DNSSEC deta… Mar 7, 2017

README.markdown

DNSimple Help Site

This is the DNSimple Help site built with nanoc.

Setup

Ruby 2, or higher, is required to build the site. Dependencies are managed using Bundler.

git clone git@github.com:dnsimple/dnsimple-support.git
cd dnsimple-support
bundle

For a list of nanoc commands type

nanoc --help

Development

nanoc ships with an autocompiler that automatically compiles changed files on every HTTP request.

bundle exec nanoc live

Loading site… done
Thin web server (v1.7.0 codename Dunder Mifflin)
Maximum connections set to 1024
Listening on 0.0.0.0:3000, CTRL+C to stop

14:26:35 - INFO - Compilation succeeded.
14:26:35 - INFO - Guard is now watching at '~/projects/dnsimple-support'

Managing categories

You can add/remove/edit categories by editing the file priorities/categories.yaml.

Once you are done, run rake clean, rake compile and nanoc view (or nanoc live) to see your changes

Sorting articles

You can edit the order in which the articles appear in a category page by editing the file priorities/articles.yaml

Once you are done, run rake clean, rake compile and nanoc view (or nanoc live) to see your changes.

Deployment

Each commit to master is deployed automatically via Travis.

Manual deployment

To publish the site manually you will need Java (as the static deployer is written in Scala).

Add a .env file with following variables, replacing ACCESS_ID and ACCESS_KEY with the real values.

S3_ID=ACCESS_ID
S3_SECRET=ACCESS_KEY

Finally, run:

rake publish