Add Github Pages Documentation

.gitignore

@@ -0,0 +1,53 @@
+# sphinx build folder
+_build
+
+# internal copy of master branch
+git_src/
+
+# Compiled source #
+###################
+*.com
+*.class
+*.dll
+*.exe
+*.o
+*.so
+
+# Packages #
+############
+# it's better to unpack these files and commit the raw source
+# git has its own built in compression methods
+*.7z
+*.dmg
+*.gz
+*.iso
+*.jar
+*.rar
+*.tar
+*.zip
+
+# Logs and databases #
+######################
+*.log
+*.sql
+*.sqlite
+
+# OS generated files #
+######################
+.DS_Store?
+ehthumbs.db
+Icon?
+Thumbs.db
+
+# Editor backup files #
+#######################
+*~
+
+# NEMOH #
+#########
+~nemoh_runs/
+
+# Tests #
+#########
+test_results/
+test_results.pdf

README.md

@@ -1,2 +1,41 @@
 # WecOptTool Documentation
 
+## Compile Instructions
+
+### Setup Sphinx (One Time Only)
+
+Install [Anaconda Python](https://www.anaconda.com/distribution/)
+
+Create the Sphinx environment
+
+```
+> conda create -n _sphinx pip sphinx sphinx_rtd_theme colorama future
+> activate _sphinx
+(_sphinx) > pip install sphinxcontrib-matlabdomain
+(_sphinx) > conda deactivate
+>
+```
+
+### Build Locally
+The make process clones a copy of the master branch and then uses this to quote snippets of code.
+Docs are built in the `_build` directory.
+
+#### Windows
+This uses the instructions in `make_www_local.bat`.
+
+```
+> cd path/to/WecOptTool
+> make_www_local
+```
+
+#### OSX
+This uses the instructions in `makefile`.
+
+```bash
+> cd path/to/WecOptTool
+> make html
+```
+
+## License
+
+[CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/)

_static/theme_overrides.css

@@ -0,0 +1,13 @@
+/* override table width restrictions */
+@media screen and (min-width: 767px) {
+
+   .wy-table-responsive table td {
+      /* !important prevents the common CSS stylesheets from overriding
+         this as on RTD they are loaded after this stylesheet */
+      white-space: normal !important;
+   }
+
+   .wy-table-responsive {
+      overflow: visible !important;
+   }
+}