Idris-dev/samples
Jan de Muijnck-Hughes af72159e60 Sphinx Based Documentation for Idris.
Sphinx provides a retargatable documentation system for documentation, and code. Allowing for HTML, LaTeX, and ePub documents to be generated from a single source.
ReadTheDocs is a free service for Open Source Projects that provides continuous delivery of documents that use either Sphinx or MakeDoc.

This commit provides Sphinx based versions of:

+ The Idris Tutorial
+ The Effects Tutorial
+ Select articles from the Wiki to begin a language reference
+ Select articles from the Wiki to begin short guides.

The examples from the effect tutorial have been integrated as well.

In the `docs` folder see `README.md` for dependencies, Sphinx is easily obtainable from all major Linux ditributions and through brew on Mac OS X.

+ Running `make html` will produce a monolithic html website for use with readthedocs.
+ Running `make latexpdf` will produce individual PDFs for each of the above tutorials.
+ Running `make epub` will produce a monolithic epub. This will need to be adapted to either produce one of the above document sets, or individual epubs.

Future work will be to:

+ Integrate idris with readthedocs for documentation generation for tagged released..
+ Add latex and html generation to the travis builds.
+ Add
2015-03-17 16:19:11 +00:00
..
binary.idr Sphinx Based Documentation for Idris. 2015-03-17 16:19:11 +00:00
ConsoleIO.idr Sphinx Based Documentation for Idris. 2015-03-17 16:19:11 +00:00
Exception.idr Sphinx Based Documentation for Idris. 2015-03-17 16:19:11 +00:00
hworld.idr Sphinx Based Documentation for Idris. 2015-03-17 16:19:11 +00:00
interp-alt.idr Address semantic differences in putting things to STDOUT. 2015-03-06 17:26:33 +00:00
interp.idr Address semantic differences in putting things to STDOUT. 2015-03-06 17:26:33 +00:00
javaffi.idr Address semantic differences in putting things to STDOUT. 2015-03-06 17:26:33 +00:00
Makefile Sphinx Based Documentation for Idris. 2015-03-17 16:19:11 +00:00
named_instance.lidr Whitespace cleanup. 2013-11-01 14:33:45 +01:00
Random.idr Sphinx Based Documentation for Idris. 2015-03-17 16:19:11 +00:00
ReadInt.idr Sphinx Based Documentation for Idris. 2015-03-17 16:19:11 +00:00
reflection.idr Renaming of built-in datatypes works finally 2014-09-26 07:34:29 +02:00
Select.idr Sphinx Based Documentation for Idris. 2015-03-17 16:19:11 +00:00
TreeTag-noeff.idr Sphinx Based Documentation for Idris. 2015-03-17 16:19:11 +00:00
TreeTag.idr Sphinx Based Documentation for Idris. 2015-03-17 16:19:11 +00:00
TreeTagCount.idr Sphinx Based Documentation for Idris. 2015-03-17 16:19:11 +00:00
vadd.idr Sphinx Based Documentation for Idris. 2015-03-17 16:19:11 +00:00