Idris-dev/docs
Alex Humphreys 289b0589ae
Update introduction.rst
Got the error `Can't find import Effects` when attempting this part of the tutorial. Managed to solve it after finding issue #1524, but would have been faster if this flag was mentioned in the tutorial.
2020-03-17 15:09:45 +01:00
..
_static add documentation for elaboration reflection 2019-05-08 16:21:40 +01:00
effects Update introduction.rst 2020-03-17 15:09:45 +01:00
elaboratorReflection add links between sections 2019-12-15 09:45:47 +00:00
faq use HTTPS URL instead of HTTP URL when possible 2019-12-19 14:26:41 +01:00
guides use HTTPS URL instead of HTTP URL when possible 2019-12-19 14:26:41 +01:00
image tidy up parser library documentation 2020-01-02 11:18:51 +00:00
listing use HTTPS URL instead of HTTP URL when possible 2019-12-19 14:26:41 +01:00
parserLibrary add documentation about end-of-input 2020-01-23 12:34:01 +00:00
proofs Merge pull request #4798 from martinbaker/fixSphinxWarning 2019-12-21 13:42:02 +01:00
reference Align steps in preorder reasoning example 2020-03-06 16:07:00 -06:00
st use HTTPS URL instead of HTTP URL when possible 2019-12-19 14:26:41 +01:00
tutorial use HTTPS URL instead of HTTP URL when possible 2019-12-19 14:26:41 +01:00
.gitignore Sphinx Based Documentation for Idris. 2015-03-17 16:19:11 +00:00
conf.py Fix Readthedocs PDF generation 2020-03-10 14:45:05 +00:00
index.rst add parser library documentation 2019-12-28 18:28:36 +00:00
LICENSE use HTTPS URL instead of HTTP URL when possible 2019-12-19 14:26:41 +01:00
make.bat use HTTPS URL instead of HTTP URL when possible 2019-12-19 14:26:41 +01:00
Makefile use HTTPS URL instead of HTTP URL when possible 2019-12-19 14:26:41 +01:00
README.md use HTTPS URL instead of HTTP URL when possible 2019-12-19 14:26:41 +01:00

Documentation for the Idris Language.

This manual has been prepared using ReStructured Text and the Sphinx Documentation Generator for future inclusion on Read The Docs.

Dependencies

To build the manual the following dependencies must be met. We assume that you have standard build automation tools already install i.e. make.

Sphinx-Doc

Python should be installed by default on most systems. Sphinx can be installed either through your hosts package manager or using pip/easy_install.

Note ReadTheDocs works with Sphinx v1.2.2. If you install a more recent version of sphinx then 'incorrectly' marked up documentation may get passed the build system of readthedocs and be ignored. In the past we had several code-blocks disappear because of that.

The ReadTheDocs theme can be installed using pip as follows:

pip install sphinx_rtd_theme

LaTeX

LaTeX can be install either using your systems package manager or direct from TeXLive.

Build Instructions

make html
make latexpdf

Contributing

The documentation for Idris has been published under the Creative Commons CC0 License. As such to the extent possible under law, /The Idris Community/ has waived all copyright and related or neighboring rights to Documentation for Idris.

More information concerning the CC0 can be found online at:

https://creativecommons.org/publicdomain/zero/1.0/

When contributing material to the manual please bear in mind that the work will be licensed as above.