The purpose of this page is to exemplify how to write scientific reports in various formats: LaTeX PDF, HTML, Sphinx, IPython notebook, HTML blog post, etc.
The DocOnce source code for all the examples resides in a file
report.do.txt. In the
commands below, for translating the text to LaTeX, HTML, etc.,
one can use the full filename
report.do.txt or just
If you want to play around with
report.do.txt and modify it, you
need the DocOnce source, figure files, computer code, etc. All
the files are contained in a directory at GitHub.
The classical LaTeX-style report format is widely used throughout mathematical sciences. This PDF version was made from the hand-written DocOnce source report.do.txt, first translated to LaTeX source code and then compiled to PDF.
Here is another version of the same report, this time in a fresher, more modern PDF format for electronic view where URLs and references are hyperlinks. This PDF file is made from LaTeX source generated from DocOnce source.
DocOnce can generate LaTeX for A4 or A6 paper size, if desired. The A6
size is good for smart phones, see the PDF file (made from DocOnce source). In this versiond we also change the
LaTeX font to Palatino (
--latex_font=helvetica is another
The Sphinx documentation system is very popular for creating online documents with fancy and attractive layouts. Check out the author's favorite themes: alabaster, bizstyle, bootstrap, bloodish (or cbc), fenics_minimal1, pyramid, redcloud, and scipy_lectures.
Sphinx default layout made from Sphinx-extended reStructuredText source generated from DocOnce. Other Sphinx layouts are ADCtheme, agni, agogo, alabaster, basic, basicstrap, bizstyle, bloodish, boilerplate, bootstrap, cbc, classic, cloud, dark, default, epub, fenics, fenics_classic, fenics_minimal1, fenics_minimal2, flat, haiku, jal, minimal5, modern5, nature, pylons, pyramid, redcloud, responsive, scipy_lectures, scrolls, slim-agogo, sphinxdoc, sphinx_rtd_theme, traditional, uio, uio2, vlinux-theme
The solarized color style for online documents has received much attention. Below are some examples on DocOnce support for this color style.
DocOnce supports a range of HTML styles based on the Bootstrap framework. Such styles are seen all over the Internet and have a lot of functionality, e.g., responsive pages for smart phones and large screens. Here are some Bootstrap-based HTML styles: plain bootstrap made from DocOnce source, bloodish, FlatUI, bluegray. And here are some Bootswatch styles: cosmo, journal, readable, cyborg.
For reports without mathematics, DocOnce can also generate Googlecode
wiki format (used at
and the Creole wiki format (used at
Wordpress blog post at doconcereportdemo.wordpress.com based on HTML code generated from DocOnce source