diff --git a/lang/python/doc/meta/TODO.org b/lang/python/doc/meta/TODO.org index add8f4ff..0be99b30 100644 --- a/lang/python/doc/meta/TODO.org +++ b/lang/python/doc/meta/TODO.org @@ -29,6 +29,38 @@ through converting to either Markdown or XHTML first. +** TODO Documentation build systems + :PROPERTIES: + :CUSTOM_ID: todo-docs-build-systems + :END: + +Though Org Mode is being used for the default documentation format, it +still needs to end up as usable by end users. So the Org Mode files +are used to produce the "source" files used by the two main contenders +for documenting the bindings: Texinfo and ReStructuredText/Docutils. + + +*** TODO Texinfo documentation + :PROPERTIES: + :CUSTOM_ID: todo-docs-build-texinfo + :END: + +Need to add all of Texinfo's ... special systems to make it do its +things. + + +*** TODO ReStructuredText documentation + :PROPERTIES: + :CUSTOM_ID: todo-docs-build-docutils + :END: + +Need to run Sphinx's quick start, add it to the requirements and tweak +the index page for the rst files to point to the HOWTO and other files. + +It might just be easier to do all that in Org Mode and convert the +lot, then the Sphinx bits can be automated. + + ** STARTED Documentation HOWTO :PROPERTIES: :CUSTOM_ID: todo-docs-howto diff --git a/lang/python/doc/src/index.org b/lang/python/doc/src/index.org new file mode 100644 index 00000000..8410c40b --- /dev/null +++ b/lang/python/doc/src/index.org @@ -0,0 +1,26 @@ +#+TITLE: GNU Privacy Guard (GnuPG) Made Easy Python Bindings +#+AUTHOR: Ben McGinnes +#+LATEX_COMPILER: xelatex +#+LATEX_CLASS: article +#+LATEX_CLASS_OPTIONS: [12pt] +#+LATEX_HEADER: \usepackage{xltxtra} +#+LATEX_HEADER: \usepackage[margin=1in]{geometry} +#+LATEX_HEADER: \setmainfont[Ligatures={Common}]{Times New Roman} +#+LATEX_HEADER: \author{Ben McGinnes } + + +* GPGME Python Bindings + :PROPERTIES: + :CUSTOM_ID: index + :END: + + +** Contents + :PROPERTIES: + :CUSTOM_ID: index-contents + :END: + + +- [[short-history][A short history of the project]] +- [[gpgme-python-howto][GPGME Python Bindings HOWTO]] +