========
Website
========

Sphinx
=======
This website, and its counterpart http://career.bjawise.com , are one of my projects. They were created with Sphinx and are run via AWS.

Installation
------------
``pip install Sphinx``

Useful Sphinx Resources
------------------------

* `Sphinx Home Page <http://www.sphinx-doc.org/en/stable/index.html>`_
* `Restructured Text reST and Sphinx Cheatsheet <https://thomas-cokelaer.info/tutorials/sphinx/rest_syntax.html>`_
* `reStructuredText Markup Specification <http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#reference-names>`_
* `reStructuredText Directives <http://docutils.sourceforge.net/docs/ref/rst/directives.html#table-of-contents>`_

Sphinx Make Hack
-----------------

Modify make or .bat files so that they default to html output, by adding::

	:html
	%SPHINXBUILD% -M html %SOURCEDIR% %BUILDDIR% %SPHINXOPTS%
	goto end

and modifying

``if "%1" == "" goto help`` 

to read

``if "%1" == "" goto html``

Or similar changes for make files.