Dissertation Development Notes
I'd like to write my dissertation in a presentation neutral format so that I can create a web version and a pdf version which meets the requirements of UC Davis's dissertation submission rules.
- It has to output both html and latex.
- Citations will need to work seemlessly with a bibtex database.
- I need to be able to excluded parts from both the html and latex outputs (i.e. videos, datasets and verbose text should only be in the html version)
- It must be able to handle complex mathematical equations.
- The html should be pushed to the web reguarlay in a platform that allows commenting.
- Needs to support images and video content.
- I'd like to (and probably have to) write in a simple text format.
- I'm using Plone for our lab website and a crude citation system with bibtex2html, it would be nice to push my dissertation to Plone.
Things I've found
- Markup languages
- ReST: python based, used in Sphinx, lots of functionality
- Markdown: a really basic markup languge
- Docbook: xml based, used for gnome, kde and linux docs
- Latex2Html: really outdated program that attempts to parse latex files and create html, including turning the mathematics into png image files
- Bibtex2html: converts a bibtex file to basic html, currently using it to manage our citations in plone
- Youtube in restructuredtext: http://countergram.com/youtube-in-rst
- Looks like the plone developer manual is written for Sphinx and then automatically pushed to plone.org in the plone website
- The developer manual in plone: http://plone.org/documentation/manual/plone-community-developer-documentation/introduction/developermanual
- The developer manual as a standalone sphinx site: http://collective-docs.readthedocs.org/en/latest
- collective.developermanual source code: https://github.com/collective/collective.developermanual
- Pandoc converts among different markups but seems to be based on markdown: http://johnmacfarlane.net/pandoc/
- Disqus is embeddable comment software http://disqus.com/welcome/ that has been used with Sphinx on the ZODB book http://www.zodb.org/zodbbook/.
- Readthedocs http://readthedocs.org/ is place to host documentation that will update daily or with every commit.