mirror of
https://salsa.debian.org/freeipa-team/freeipa.git
synced 2024-12-27 09:21:59 -06:00
d09389ab6f
"Extending FreeIPA" is a developer guide of FreeIPA core framework. Please make sure to improve the guide every time parts of the core framework are affected by your changes. This document ideally should correspond to the current state of the framework. The Guide is written using Emacs Org Mode but can be edited with any plain text editing tool. Emacs is only required to convert it to distribution formats like HTML and TXT. See guide/Makefile for building the guide and README for details of the build environment.
37 lines
940 B
Plaintext
37 lines
940 B
Plaintext
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.
|
|
|