Product SiteDocumentation Site

4. Publication

4.1. Effectuer un rendu du document

Notre document est maintenant écrit au format DocBook XML mais ce format n'est pas facile à lire. Nous avons donc besoin de le publier dans un autre format. publican propose plusieurs rendu de sortie:
  • html: Document html divisé en de multiples pages avec des boutons de navigation en haut et en bas de chaque page
  • html-single: document html en une seule page
  • html-desktop: Format identique à html mais avec une table des matières sur la gauche
  • pdf: Le document est rendu en un fichier pdf
  • epub: le document est rendu en ebook
La commande suivante va générer un document pdf 
cd ~/Document/Publican_and_Serna publican build --lang en-US --format pdf
Le paramètre --lang est obligatoire et peut être un code de langue ou le mot clé all.
Le paramètre --format définit le format de sortie et doit être l'un des formats décrit précédement. Il est possible de générer de multiples formats de sortie en séparant les formats par des virgules.
Quand le document et prêt pour une publication, le paramètre --publish doit être ajouté à la commande. Le document sera alors stocké dans le répertoire ./publish/Langues/NomDuProduit/VersionDuProduit/Fromat/NomDuDocument/ comme par exemple : ./publish/en-US/Publication_Chain/1.0/pdf/Publican_and_Serna/. Ce sont ces fichiers qui seront automatiquement poussés vers le site web si vous créez un site de publication tel que décrit dans le chapitre suivant.