Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentes Révision précédente
Prochaine révision
Révision précédente
groupes:ubuntu-fr-doc:exporter_la_doc [Le 03/10/2015, 18:00]
darkjam
groupes:ubuntu-fr-doc:exporter_la_doc [Le 11/09/2022, 13:15] (Version actuelle)
moths-art Suppression des espaces en fin de ligne (détecté et corrigé via le bot wiki-corrector (https://forum.ubuntu-fr.org/viewtopic.php?id=2067892)
Ligne 6: Ligne 6:
  
 L'​export a été fait sur un pc portable : L'​export a été fait sur un pc portable :
-  * un processeur i7 4 coeurs+  * un processeur i7 4 cœurs
   * 8 Go de RAM   * 8 Go de RAM
   * HDD 500 Go   * HDD 500 Go
   * Kubuntu 15.04 64 bit   * Kubuntu 15.04 64 bit
  
-L'​exportation des 6500 page a duré 41h.+L'​exportation des 6500 pages a duré 41h.
  
 la création du fichier zim : entre 5 et 10 min. la création du fichier zim : entre 5 et 10 min.
 </​note>​ </​note>​
  
-==== Préparation de l’environnement ==== +==== Installation du serveur web ====
-=== Installation du serveur web ===+
 Dans un premier temps, nous allons installer le serveur web qui va nous permettre de mettre en place une copie du site de la documentation. J'ai personnellement utilisé Apache, il est possible d'​utiliser n'​importe quel serveur web supportant php5.(pour plus d'​information voir [[:​lamp|Serveur Web - LAMP]]) Dans un premier temps, nous allons installer le serveur web qui va nous permettre de mettre en place une copie du site de la documentation. J'ai personnellement utilisé Apache, il est possible d'​utiliser n'​importe quel serveur web supportant php5.(pour plus d'​information voir [[:​lamp|Serveur Web - LAMP]])
  
Ligne 43: Ligne 42:
 </​Directory>​ </​Directory>​
 </​file>​ </​file>​
-=== Installation de Bazaar === 
  
 +Maintenant, nous allons créer nos hotes virtuels :
 +  * Le premier est l’hôte qui hébergera le dokuwiki et que j'ai appelé www.doc-ubuntu-fr.loc
 +  * le deuxième pour les éléments statique et le template Ubuntu.
 +
 +<note help>​Actuellement,​ je ne suis pas parvenu à faire fonctionner le template Ubuntu. L'​exportation s'est fait à partir du template (mise en page) de base de dokuwiki.</​note>​
 +<​file>​
 +<​VirtualHost *:80>
 + ServerName www.doc-ubuntu-fr.loc
 +
 + ServerAdmin webmaster@localhost
 + DocumentRoot /​var/​www/​ubuntu-fr/​ubuntu-fr-doc
 +
 + <​Directory /​var/​www/​ubuntu-fr/​ubuntu-fr-doc>​
 +
 + Options Indexes FollowSymlinks
 + AllowOverride All
 + order allow,deny
 + allow from all
 + </​Directory>​
 + ErrorLog ${APACHE_LOG_DIR}/​error.log
 + CustomLog ${APACHE_LOG_DIR}/​access.log combined
 +</​VirtualHost>​
 +
 +<​VirtualHost *:80>
 + ServerName www.static-ubuntu-fr.loc
 +
 + ServerAdmin webmaster@localhost
 + DocumentRoot /​var/​www/​ubuntu-fr/​ubuntu-fr-static
 +
 + ErrorLog ${APACHE_LOG_DIR}/​error.log
 + CustomLog ${APACHE_LOG_DIR}/​access.log combined
 +</​VirtualHost>​
 +</​file>​
 +
 +Modification des valeurs par défaut de php : Il suffit de modifier les valeurs si dessous
 +<​file>​
 +max_execution_time = 300
 +max_input_time = 600
 +memory_limit = 512M
 +default_socket_timeout = 600
 +</​file>​
 +
 +Une fois terminée, il faut relancer le serveur Apache pour lui faire prendre en compte les modifications.
 +<​code>​
 +service apache restart
 +</​code>​
 +
 +==== Installation du dokuwiki ====
  
   * Installation de bazaar : (pour plus d'​information voir [[:​bzr|Bazaar]])   * Installation de bazaar : (pour plus d'​information voir [[:​bzr|Bazaar]])
-<​code>​apt-get install bzr</​code>​ +<​code>​apt-get install bzr 
-  * +mkdir /​var/​www/​ubuntu-fr/​original 
 +cd /​var/​www/​ubuntu-fr/​original 
 +</​code>​ 
 +  * Récupération du site static 
 +<​code>​bzr branch lp:​ubuntu-fr-static</​code>​ 
 +  * Récupération du site documentation. 
 +<​code>​bzr branch lp:​ubuntu-fr-doc</​code>​ 
 +<note tip>Nous récupérons les différents plug-ins déployés dans la documentation,​ mais nous allons repartir d'une installation neuve.</​note>​ 
 +  * Récupération de dokuwiki [[http://​download.dokuwiki.org/​archive|ici]]. 
 +<note help>A l'​heure de l'​écriture du tutoriel (octobre 2015), le wiki tourne sur la version 2014-05-05.</​note>​ 
 +  * Décompressez l'​archive du dokuwiki dans **/​var/​www/​ubuntu-fr/​ubuntu-fr-doc** 
 +  * Dans un navigateur ouvrir la page www.doc-ubuntu-fr.loc/​install.php et suivre le processus d’installation. 
 +<note warning>​Il est important de créer un administrateur afin de pouvoir installer et utiliser le plug-in "​SiteExport"​.</​note>​ 
 +  * Copier les plug-ins et les données obtenues auprès des administrateurs 
 +<​code>​ 
 +cp -R /​var/​www/​orignal/​ubuntu-fr-doc/​lib/​plugins /​var/​www/​ubuntu-fr-doc/​lib/​plugins 
 +cp -R [chemin ou se trouve les données]/​data/​ /​var/​www/​ubuntu-fr-doc/​data/​ 
 +</​code>​ 
 +  * Installer le [[doku>​plugin:​siteexport|plugin dokuwiki **siteexport**]],​ soit manuellement en le décompressant dans le dossier **lib/​plugins/​** soit en utilisant l'​interface d'​administration de votre instance de dokuwiki. 
 + 
 +==== Exporter le wiki ==== 
 +<note tip>​Toutes les opérations de cette section demande d'​être logué en tant qu'​administrateur sur le wiki.</​note>​
  
 +  * Dans un navigateur se rendre : http://​www.doc-ubuntu-fr.loc/​doku.php?​id=accueil
 +  * Se loguer en tant qu'​administrateur
 +  * Cliquer sur le menu **administrer**
 +  * Cliquer sur **Export du site** dans la section **Extensions**
 +  * Renseigner les champs suivants :
 +    * Espace de nom parent à exporter : accueil
 +    * Type d'​export : Tous les sous espaces de nom
 +    * Cocher : Export du corps uniquement
 +    * Décocher : Exporter les pages liées
 +    * Décocher : Export de tous les paramètres (exp: "​do"​)
 +    * Cliquer dur le bouton démarrer
 +  * Attendre la fin de l'​export. A la fin de l'​export,​ le navigateur vous proposera de télécharger le fichier.
 +<​note>​Au dessus du bouton démarrer se trouvent plusieurs liens dont le lien en téléchargement direct. Il peut être intéressant de le garder, surtout si le navigateur ne propose pas de télécharger le fichier. Il suffit alors de se rendre à l'​adresse en question pour télécharger le fichier en question.</​note>​
 +==== Créer le fichier ====
 +  * Installer [[:​zimwriterfs|zimwriterfs]]
 +  * Décompresser le fichier zip obtenu.
 +  * Lancer [[:​zimwriterfs|zimwriterfs]]
 +  * Vérifier le fichier obtenu avec [[:​kiwix|Kiwix]]
 ===== Méthode « manuelle » ===== ===== Méthode « manuelle » =====
  
Ligne 64: Ligne 149:
 FIXME la suite FIXME la suite
  
-création d'un fichier ZIM[[:​utilisateurs:​nicolah:​zimwriterfs]]+---- 
 +//​Contributeurs : [[:​utilisateurs:​Darkjam|Darkjam]]. //
  • groupes/ubuntu-fr-doc/exporter_la_doc.1443888008.txt.gz
  • Dernière modification: Le 03/10/2015, 18:00
  • par darkjam