Website powered by Python Sphinx about managing documentation as source code (in French)
Python TeX HTML Makefile sed CSS Shell
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
_static
_templates
_themes
code
conditional-text
graphics
scripts
.gitignore
.nojekyll
Makefile
README.md
a-propos-de-ce-blog.rst
accelerer-sa-saisie-avec-le-mode-predictive-pour-emacs.rst
afficher-un-index-dans-un-pdf-mais-pas-sous-dita-open-toolkit.rst
base-de-donnees-sql.rst
cas-concret-documentation-de-nufirewall.rst
cas-concrets-utilisation-de-dita-xml.rst
centraliser-les-conref-dans-un-fichier-unique.rst
collecte-de-l-information.rst
conf.py
configurez-le-raspberry-pi.rst
contact.rst
couv.sla
creation-du-contenu.rst
creer-des-documents-differents-a-partir-des-memes-sources-dita-xml-texte-conditionnel.rst
creer-des-documents-differents-a-partir-des-memes-sources-restructuredtext-jinja-objet-texte-conditionnel.rst
creer-des-documents-differents-a-partir-des-memes-sources-restructuredtext-jinja-texte-conditionnel.rst
creer-des-documents-differents-a-partir-des-memes-sources-restructuredtext-rest-texte-conditionnel.rst
creez-et-modifiez-le-texte.rst
creez-et-modifiez-les-schemas.rst
de-la-redaction-a-la-communication-technique.rst
definition-du-projet.rst
didacticiels-dita-xml-xsl-fo.rst
diminuer-les-couts-ameliorer-la-satisfaction-client.rst
dita-open-toolkit-afficher-les-references-croisees-dans-les-pdf.rst
docbook-ou-dita-xml.rst
documents-monolithiques-ou-modulaires.rst
du-document-a-la-base-documentaire-modulaire.rst
expressions-regulieres-python.rst
faire-sauter-les-goulets-etranglement-avec-les-branches.rst
fichiers-binaires-ou-texte.rst
format-cible.rst
format-source.rst
format-structure-dita-xml.rst
formats-cibles.rst
formats-et-outils.rst
formats-sources.rst
formats-structures-et-non-structures.rst
fournir-une-information-ciblee-avec-le-texte-conditionnel-ditaval.rst
generer-un-pdf-avec-dita-open-toolkit-sous-gnu-linux.rst
generer-un-pdf-avec-dita-open-toolkit-windows.rst
generez-votre-documentation.rst
gerer-les-projets-de-documentation-multilingues-dita-xml.rst
gerer-son-contenu-dita-xml-avec-ou-sans-cms.rst
gerez-les-versions-de-votre-documentation.rst
git-du-fichier-au-contenu.rst
imbriquer-les-conref.rst
index.rst
inserer-automatiquement-des-donnees-dans-un-fichier-dita-xml.rst
inserer-automatiquement-des-donnees-dans-un-fichier-restructuredtext.rst
inserer-automatiquement-des-donnees-sql-dans-un-fichier-restructuredtext.rst
installez-les-logiciels-necessaires-a-la-generation-de-ce-site.rst
integrer-la-documentation-aux-processus-de-developpement.rst
jourdainisation-en-ligne-python.rst
le-coin-du-geek.rst
le-single-sourcing-un-format-source-plusieurs-formats-cibles.rst
les-cms-le-workflow-en-prime-mais-une-fiabilite-a-tester.rst
les-repertoires-reseau-partages-peu-adaptes-au-travail-de-groupe.rst
les-sources-de-ce-document-sont-gerees-sous-git.rst
les-systemes-de-gestion-de-versions-rustiques-mais-fiables.rst
les-topics-modules-d-information-de-base-dita.rst
les-trois-niveaux-de-la-documentation-technique.rst
livraison.rst
maximiser-utilisation-des-conref-pour-faire-baisser-les-couts.rst
migration-de-framemaker-vers-dita-xml.rst
migrer-de-framemaker-vers-dita-xml.rst
organisation-a-la-demande-du-contenu.rst
organiser-son-historique-avec-git-rebase.rst
partager-des-blocs-information-atomiques-avec-les-conref.rst
prendre-en-compte-les-contraintes-de-traduction.rst
principe-de-simplicite-kiss.rst
proteger-les-informations-confidentielles.rst
qu-est-ce-qu-un-module-d-information.rst
quel-referentiel-pour-le-travail-de-groupe.rst
raspberry-pi-plateforme-documentation.rst
recuperez-les-sources-de-ce-site.rst
redaction-technique-un-processus-industriel.rst
referentiel.rst
restructuration-du-contenu-framemaker.rst
sed-modifiez-votre-texte-sans-ouvrir-vos-fichiers.rst
silo.rst
sphinxcontrib_awesome.py
sphinxcontrib_awesome.pyc
table-de-conversion-framemaker-vers-dita-xml.rst
tester-les-produits-pour-les-documenter.rst
traduction.rst
typologie-de-haut-niveau-de-l-information.rst
un-index-est-il-utile-dans-un-pdf.rst
un-langage-a-balises.rst
un-referentiel-unique.rst
une-architecture-documentaire-trop-complexe.rst
utiliser-ide-nxml-pour-dita-xml.rst
utiliser-le-noeud-xml-de-plus-bas-niveau.rst
utiliser-les-branches-des-systemes-de-gestion-de-sources.rst
validation-et-controle-qualite.rst
workflow-de-creation-et-validation.rst
xsl-fo-filtrer-du-contenu-selon-des-conditions-sauf-et-ou.rst
xsl-fo-inserer-automatiquement-un-titre-pour-les-exemples.rst

README.md

redaction-technique.org

Website powered by Python Sphinx about managing documentation as source code (in French)

Prerequisites

  • GNU/Linux Debian 7
  • Git
  • Sphinx 1.1.3 or higher
  • Inkscape

For PDF output


- texlive
- texlive-fonts-recommended
- texlive-latex-extra

Installing Sphinx
-----------------

$ sudo apt-get install python-sphinx

Building the HTML output
------------------------

$ git clone https://github.com/olivier-carrere/redaction-technique.org.git

$ cd redaction-technique.org

$ make html

Building the PDF output
------------------------

$ git clone https://github.com/olivier-carrere/redaction-technique.org.git

$ cd redaction-technique.org

$ make latexpdf

Building the EPUB output
------------------------

$ git clone https://github.com/olivier-carrere/redaction-technique.org.git

$ cd redaction-technique.org

$ make epub

Building all available outputs
------------------------------

$ git clone https://github.com/olivier-carrere/redaction-technique.org.git

$ cd redaction-technique.org

$ make all

Troubleshooting
---------------

If compilation fails, you can get a compiled version on
https://readthedocs.org/projects/redaction-techniqueorg.