✎ 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 [[#liens|forges]] fonctionnent avec la poule.

<note important>La lecture de cette notice ne vous dispense pas de la lecture du fichier README.txt placé à la racine de l'archive de "la poule ou l'œuf".</note>

===== 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é [[latex]] : simplifiez-vous les démarches en installant directement [[apt>texlive]]
  * Avoir [[:tutoriel:comment_installer_un_paquet|installé les paquets]] **[[apt>openoffice.org,sun-java6-jre,unoconv,python|openoffice.org sun-java6-jre unoconv python]]**
  * Veiller à ce que les modules PHP suivants soient bien installés : **[[apt>php5-curl,php5-gd,libapache2-mod-php5,php5-cgi,php5-cli,php5-imagick,php-db,php5-mysql,php5-tidy,php5-xsl,libapache2-modxslt,libphp-pclzip|php5-curl php5-gd libapache2-mod-php5 php5-cgi php5-cli php5-imagick php-db php5-mysql php5-tidy php5-xsl libapache2-modxslt libphp-pclzip]]**

===== Installation =====

Créer tout d'abord 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>
  * Il faut que [[apache2#activer_l_url_rewriting|le serveur web soit configuré pour l'url rewriting]]

* Activer [[apache2#activer_les_fichiers_.htaccess|la prise en compte des .htaccess par apache]]

* Activer et installer browscap
<code>sudo nano /etc/php5/apache2/php.ini</code>

Modifier la section browscap  
<code>[browscap]
; http://php.net/browscap
browscap = /etc/php5/apache2/browscap.ini</code>

Télécharger le fichier browscap.ini avec le lien suivant
[[http://tempdownloads.browserscap.com/stream.php?BrowsCapINI]]

copier le dans le répertoire /etc/php5/apache2
<code>sudo cp /Répertoire de téléchargements/browscap.ini /etc/php5/apache2/</code>

* 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.
  * ...
  * Après installation supprimer le dossier "install" de votre serveur

===== 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://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]]
  * **(fr)** [[http://forge.framabook.org/|La forge Framabook]]

----

Contributeurs principaux : [[utilisateurs:Bionet]]

Merci de recopier le code ci-contre pour prouver que vous êtes humain : U N P N U 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