✎ 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]] {{ :application:pouloeuf.png}}

===== Pré-requis =====
  * Disposer des [[:sudo|droits d'administration]].
  * Disposer d'une connexion à Internet configurée et activée.
  * Avoir installé [[lamp|un serveur-web LAMP]] 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
<note>Tous les modules de cette liste se trouvent pas dans les dépots mais nombreux sont ceux qui se trouvent regroupés sous un seul paquet.</note>

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/dossier_poule)
  * donner les droits suffisants pour l'exécution des scripts d'installation :

<code>sudo chown -R www-data.www-data /var/www/dossier_poule
sudo chmod -R 755 /var/www/dossier_poule</code>

* Activer la prise en compte des .htaccess par apache en remplaçant "AllowOverride none" par "AllowOverride All" entre les balises <Directory />…</Directory> et <Directory /var/www/>…</Directory> des fichiers /etc/apache2/sites-available/default-ssl et default

* Relancer Apache 
<code>sudo /etc/init.d/apache2 reload </code>

* enfin vous allez sur votre site : http://localhost/dossier_poule/install pour lancer l'installation (si "dossier_poule" est bien le nom donné à votre répertoire)
  * suivre la procédure d'installation automatique.

===== Configuration =====

Lancez l'application depuis Firefox en saisissant l'adresse http://localhost/dossier_poule.

Une fois loggé, la configuration se fait avec les menus Services et Configuration de "la poule ou l'œuf".

Mais pour cela, il n'y a rien de tel que de se référer à [[http://edit.lescomplexes.com/complexes/tuto/|la documentation officielle]].

===== Utilisation=====

Lancez l'application depuis Firefox en saisissant l'adresse http://localhost/dossier_poule. Mais, toujours, [[http://edit.lescomplexes.com/complexes/tuto/|la documentation officielle]] est là pour vous accompagner à ce niveau.

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

Pour supprimer cette application, il suffit de supprimer le répertoire /var/www/dossier_poule ainsi que la base "poule" créée à cet effet.

===== Exportation ODT, PDF... =====

Si un problème d'exportation apparaît (lors de la génération des fichiers ODT, PDF...) cela signifie en général que le serveur OpenOffice.org n'est pas lancé.

Saisir dans un terminal la commande suivante :
<code>sudo soffice -headless -accept="socket,host=127.0.0.1,port=8100;urp;" -nofirststartwizard</code>

Un script est proposé afin de lancer cette commande dès le démarrage (proposé sur le forum officiel du logiciel), le script est à placer dans la liste des commandes à exécuter au démarrage du serveur LAMP ou de l'ordinateur :
<code>
#!/bin/bash
#
# chkconfig: 345 20 100
# description: OpenOffice server listener
#

PORT="8100"
PIDFILE="/var/run/ooffice.pid"

start() {

if [[ -f $PIDFILE ]]; then
                echo "A server is already active"
                exit 1
        fi

echo -n "Starting OpenOffice Server:"
        soffice -headless -accept="socket,host=localhost,port=$PORT;urp;" -nofirststartwizard  > /dev/null 2>&1 &
        [[ $? -eq 0 ]] && touch $PIDFILE
    echo
        return 0
}

stop() {
        echo -n "Stopping OpenOffice"   
        killall soffice.bin
    rm -f /var/run/ooffice.pid
        echo
        return 0
}
case "$1" in
        start)
                start
                ;;
        stop)
                stop
                ;;
        restart)
                stop
                start
                ;;
        *)
                echo "Usage: $PROG {start|stop|restart}"
                exit 1
esac
</code>

===== Liens =====

* **(fr)** [[http://www.pouleouoeuf.org/|Le site Officiel]]
  * **(fr)** [[http://edit.lescomplexes.com/complexes/tuto/|la documentation officielle]]. 
  * **(fr)** [[http://www.lescomplexes.com/forum/|Le forum officiel]]
  * **(fr)** [[http://www.webs-incidences.com/|La forge de web incidences qui propose un hébergement à tout petit prix]]
  * **(fr)** [[http://www.ilv-forge.net/|La forge d'In Libro Veritas]]

----

Contributeurs principaux : [[utilisateurs:Bionet]]

Merci de recopier le code ci-contre pour prouver que vous êtes humain : D D W M W 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