freeipa/doc/guide
Petr Spacek 3e79d8ad4a Docs: update docs about ipaplatform to match reality
Apparently, the docs were not updated when ipapython/platform was moved
to ipaplatform module and internals have changed.

https://fedorahosted.org/freeipa/ticket/6418

Reviewed-By: Lukas Slebodnik <lslebodn@redhat.com>
Reviewed-By: Stanislav Laznicka <slaznick@redhat.com>
Reviewed-By: Christian Heimes <cheimes@redhat.com>
2016-10-24 13:30:12 +02:00
..
guide.org Docs: update docs about ipaplatform to match reality 2016-10-24 13:30:12 +02:00
Makefile Add "Extending FreeIPA" developer guide 2011-11-22 15:52:02 +02:00
netgroup.js Add "Extending FreeIPA" developer guide 2011-11-22 15:52:02 +02:00
README Add "Extending FreeIPA" developer guide 2011-11-22 15:52:02 +02:00
role.py.txt Rename included snippets to avoid problems with pylint 2011-11-22 17:04:03 +02:00
wsgi.py.txt py3: Remove py3 incompatible exception handling 2016-01-13 09:54:03 +01:00

Extending FreeIPA
-----------------

"Extending FreeIPA" is a developer guide to understand how FreeIPA core 
framework is built and how to extend it.

The Guide is written using Emacs Org Mode, see http://orgmode.org/org.html
for extensive manual of supported markup features.

You don't need to use Emacs to edit it, the markup is a plain text.

Building the guide
------------------

There is Makefile which can be used to convert the Guide from
Emacs Org Mode format to different targets.

Prerequisites:
==============
On Fedora system following packages are required to generate The Guide:

docbook-style-xsl
fop
emacs
xmlto

HTML, Docbook, and plain text
---
As Org Mode is part of Emacs since version 22, building HTML, TXT, and 
Docbook targets requires Emacs v22 and above (tested with v23.3 in Fedora).

PDF
---
Building PDF is done first generating Docbook source, converting it to FO format,
and then running 'fop' processor.