Revision e5c6964a497a71fb940117530c1867ddd71f4c67 authored by Jeff Bezanson on 09 September 2015, 16:07:51 UTC, committed by Jeff Bezanson on 09 September 2015, 16:07:51 UTC
[ci skip]
1 parent e9f4e20
README.md
Julia Documentation README
==========================
Julia's documentation is written in reStructuredText, a good reference for which
is the [Documenting Python](http://docs.python.org/devguide/documenting.html)
chapter of the Python Developer's Guide.
Prerequisites for building the documentation
--------------------------------------------
The documentation is built using [Sphinx](http://sphinx.pocoo.org/) and LaTeX.
On ubuntu, you'll need the following packages installed:
latex-cjk-all
texlive
texlive-lang-cjk
texlive-latex-extra
On OS X, you can install install MacTex using the GUI installer
Building the documentation
--------------------------
Build the documentation by running
$ make html
$ make latexpdf
File layout
-----------
conf.py Sphinx configuration
stdlib/ Julia standard library documentation
UNDOCUMENTED.rst Undocumented functions (to be filled in and copied to
the correct location in stdlib/)
Sphinx extensions and theme
---------------------------
The extensions to Sphinx and the theme are in the
https://github.com/JuliaLang/JuliaDoc repository, and can also be used to style
package documentation.
![swh spinner](/static/img/swh-spinner.gif)
Computing file changes ...