✎ la_poule_ou_l_oeuf [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

----

====== La poule ou l'œuf ======

"//La poule ou l'œuf//" est un outil permettant de rédiger (seul ou à plusieurs mains) des livres et de les exporter sous de nombreux formats imprimables. Cet outil rentre dans la catégorie des "chaînes éditoriales" ([[LaTeX]] ou [[Scenari]] par exemple). La poule (pour les intimes) est très utile pour tous les rédacteurs qui ne veulent pas s'ennuyer avec la mise en page : il suffit de fournir le contenu (le texte, les illustrations...) et l'interface s'occupe du reste (formatage, mise en page, génération de formats PDF, [[epub]]...). La poule s'installe sur un serveur (dédié) Apache et MySQL.

<note tip>La [[http://www.framabook.org/stallman.html|biographie officielle en français de Richard Stallman]] a été réalisée avec "//la poule ou l'œuf//".</note>

De nombreuses forges fonctionnent avec la poule dont :
  * [[http://www.ilv-forge.net/|Forge de In Libro Veritas, un éditeur libre]]
  * Forge de [[http://www.framabook.org|Framabook, un éditeur de livres liés à l'informatique]]

===== Pré-requis =====
  * Disposer des [[:sudo|droits d'administration]].
  * Disposer d'une connexion à Internet configurée et activée.
  * Avoir installé un serveur [[apache2|APACHE]] et la prise en charge de PHP.
  * Avoir installé un serveur [[mysql|MySQL]] (et les scripts APACHE/PHP pour la gestion de cette base) et ne pas avoir oublié ses login/mot de passe pour MySQL.
  * Avoir installé [[openoffice.org|la suite bureautique OpenOffice.org 3]]
  * Avoir installé [[latex]] : **[[apt://texlive|distribution TexLive]]**
  * Avoir installé [[Java]]
  * Avoir installé **[[apt://unoconv|unoconv]]**

===== Installation =====

Il faudra veiller à ce que les modules PHP suivants soient bien installés (faites une vérification en lançant une recherche dans le Gestionnaire de paquets [[Synaptic]] avec "le nom du module" plus le mot "PHP") :

* CURL
        * GD
        * ICONV
        * ImageMagick
        * JSON
        * LIBXML
        * MBSTRING
        * pdo
        * PDO_MYSQL
        * WDDX
        * TIDY
        * XMLWRITER
        * XLT (libxslt Version)
        * ZIP
        * ZLIB

Il faut que le serveur web soit configuré pour l'url rewriting (modules apache : mod_rewrite). Il faudra ajouter cette prise en charge en suivant les indication [[apache2#activer_l_url_rewriting|Activer l'Url Rewriting]]

Créer une base (poule par exemple) sur MySQL. L'installation conjointe et l'utilisation de [[PhpMyAdmin]] peut s'avérer très pratique si vous ne connaissez pas bien le fonctionnement de MySQL.

L'installation se déroule comme toute installation d'application Web sur un serveur Apache :
  * récupérer [[http://www.pouleouoeuf.org/p-50.tic|l'archive de "la poule ou l'œuf"]]
  * décompresser cette archive dans le répertoire /var/www (ce qui donnera quelque chose comme /var/www/poule)
  * enfin vous allez sur votre site : http://localhost/poule/install pour lancer l'installation (si "poule" est bien le nom donné à votre répertoire)
  * suivre la procédure d'installation automatique.

===== Configuration =====

Tout d'abord, [[:tutoriel:comment_modifier_un_fichier|ouvrez le fichier]] **/truc/machin/bidule** en modification puis …

<note tip>Configuration particulière ? Expliquez les détails utiles de configuration (il n'est pas nécessaire de faire un copier-coller de la page de manuel ; les grandes lignes suffisent avec éventuellement un lien dans les références).
</note>

===== Utilisation=====

Lancez l'application depuis le menu //Applications -> Accessoires -> Machin Chose// ou //via// la commande suivante :

machin-chose

<note tip>Raccourcis intéressants ? Fonctions cachées ? Expliquez le fonctionnement général de ce que vous présentez (là non plus, il n'est pas nécessaire de copier-coller la page de manuel).
</note>

===== Désinstallation =====

Pour supprimer cette application, il suffit de [[:tutoriel:comment_supprimer_un_paquet|supprimer son paquet]]. La configuration de l'application sera conservée ou supprimée selon la méthode de désinstallation que vous choisirez.

===== Liens =====

<note tip>Des références particulièrement intéressantes pour approfondir le sujet peuvent être utiles.</note>

* **(en)** [[http://spuriousinterrupt.org/projects/xfmedia/|Site officiel de Xfmedia]]
  * **(fr, en)** [[http://www.xfce.org|Site officiel du projet Xfce]]

----

<note help>Si vous considérez que votre contribution à la page de documentation est significative, vous avez la possibilité de la signer en ajoutant votre identifiant dans la ligne ci-dessous.
</note>

//Contributeurs principaux : [[utilisateurs:votre_identifiant|votre nom ou pseudonyme]], [[utilisateurs:autre_identifiant|nom ou pseudo autre]].//

<note help>Si vous vous êtes basé sur un document existant pour écrire votre article, citez la source originale ! Ceci est indispensable afin de respecter les droits d'auteur.</note>

//Basé sur [[http://www.document_source.com|« Titre original de l’article »]] par Auteur Original.//

Merci de recopier le code ci-contre pour prouver que vous êtes humain : I E T C E Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported