Armstrong Sphinx Theme

Sphinx theme for Armstrong documentation

Usage

Symlink this repository into your documentation at docs/_themes/armstrong then add the following two settings to your Sphinx conf.py file:

html_theme = "armstrong"
html_theme_path = ["_themes", ]

You can also change colors and such by adjusting the html_theme_options dictionary. For a list of all settings, see theme.conf.

Defaults

This repository has been customized for Armstrong documentation, but you can use the original default color scheme on your project by copying the rtd-theme.conf over the existing theme.conf.

Contributing

  • Create something awesome -- make the code better, add some functionality, whatever (this is the hardest part).
  • Fork it
  • Create a topic branch to house your changes
  • Get all of your commits in the new topic branch
  • Submit a pull request

State of Project

Armstrong is an open-source news platform that is freely available to any organization. It is the result of a collaboration between the Texas Tribune and Bay Citizen, and a grant from the John S. and James L. Knight Foundation. The first stable release is scheduled for September, 2011.

To follow development, be sure to join the Google Group.

armstrong_sphinx is part of the Armstrong project. Unless you're looking for a Sphinx theme, you're probably looking for the main project.

Credit

This theme is based on the the excellent Read the Docs theme. The original can be found in the readthedocs.org repository on GitHub.

License

Like the original RTD code, this code is licensed under a BSD. See the associated LICENSE file for more information.