Ceci est une ancienne révision du document !
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.
De nombreuses forges fonctionnent avec la poule.
Pré-requis
- Disposer des droits d'administration.
- Disposer d'une connexion à Internet configurée et activée.
- Avoir installé un serveur-web LAMP et ne pas avoir oublié ses login/mot de passe pour MySQL.
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 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 :
sudo chown -R www-data.www-data /var/www/dossier_poule sudo chmod -R 755 /var/www/dossier_poule
- Activer et installer browscap
sudo nano /etc/php5/apache2/php.ini
Modifier la section browscap
[browscap] ; http://php.net/browscap browscap = /etc/php5/apache2/browscap.ini
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
sudo cp /Répertoire de téléchargements/browscap.ini /etc/php5/apache2/
- Relancer Apache
sudo /etc/init.d/apache2 reload
- 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 à la documentation officielle.
Utilisation
Lancez l'application depuis Firefox en saisissant l'adresse http://localhost/dossier_poule. Mais, toujours, 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 :
sudo soffice -headless -accept="socket,host=127.0.0.1,port=8100;urp;" -nofirststartwizard
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 :
#!/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