/sphinxtechnicalwriting

A blog about my experience using Sphinx for modern technical writing

Primary LanguageHTMLApache License 2.0Apache-2.0

Sphinx Technical Writing

Build Status Documentation Status

A Sphinx-built website about modern technical writing using Sphinx.

This website/repository is aimed at technical writers. You'll find some examples that illustrate how to set up self-publishing documentation and some tips to increase your productivity with Sphinx.

Warning: This is a work in progress. You might find typos and other delicacies but you should still take a look.

Building the output

  1. If you haven't done it already, set up your environment:

    pipenv install
  2. Build:

    pipenv run make html
  3. Celebrate.

Or use Docker:

make image
make html-docker