Skip to content

hayesall/starling-theme

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

StARLinG Sphinx Theme

A Sphinx Theme for StARLinG Lab Documentation.

There are already a lot of tools that support writing and building documentation with Sphinx. This component makes it easy to generate .html pages that meld seamlessly with StARLinG's Webpage.

Installation & Getting Started

  1. Clone the repository
$ git clone git@github.com:starling-lab/starling-theme.git
$ python setup.py develop
  1. This repository uses itself as a theme. Build the documentation with Sphinx and open it with a browser.
$ cd documentation
$ make html
$ firefox build/html/index.html

Project State & Current Goals

This repository is in an Alpha Phase. The goal is to create a documentation theme which blends seamlessly with the StARLinG Website, but exactly how this may be achieved is up for debate.

Open Problems are tracked through the Issues Page.

License

Copyright © 2018, Alexander L. Hayes

Distributed under the terms of the MIT License. See the LICENSE at the base of the repository for details.