Difference between revisions of "Tools/fr"

Jump to navigation Jump to search
no edit summary
 
(6 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Translations}}
{{Translations}}
''This tools are deprecated. Although they may work under certain conditions, we don't provide support for them.''


Les '''Kiwix tools''' sont un ensemble de scripts (le plus souvent en Perl) ayant pour vocation d'aider à la création de contenus exploitables par le logiciel Kiwix.
Les '''Kiwix tools''' sont un ensemble de scripts (le plus souvent en Perl) ayant pour vocation d'aider à la création de contenus exploitables par le logiciel Kiwix.
Line 102: Line 104:
Une fois que votre code Mediawiki est présent, vous pouvez l'installer : ce qui signifie en gros le configure de manière basique et créer la base de donnée MySQL associée. installMediawiki.pl est le script adéquat pour faire cela en une seule ligne de commande.
Une fois que votre code Mediawiki est présent, vous pouvez l'installer : ce qui signifie en gros le configure de manière basique et créer la base de donnée MySQL associée. installMediawiki.pl est le script adéquat pour faire cela en une seule ligne de commande.


Il est cependant impossible de savoir exactement comment un Mediawiki est configurer... Vous pouvez néanmoins vous inspirer de la configuration utiliser par le projet qui se trouve [http://kiwix.svn.sourceforge.net/viewvc/kiwix/mirroring_tools/data/conf/default.php?revision=942&view=markup ici].
Il est cependant impossible de savoir exactement comment un Mediawiki est configurer... Vous pouvez néanmoins vous inspirer de la configuration utiliser par le projet qui se trouve [http://kiwix.svn.sourceforge.net/viewvc/kiwix/tools/data/conf/default.php?revision=1618&view=markup ici].


=== Étape 3 : copier les contenus de l'original au miroir ===
=== Étape 3 : copier les contenus de l'original au miroir ===


Copier les contenus d'un Mediawiki est la partie la plus délicate. C'est délicat, car il n'est pas toujours nécessaire de copier tous les contenus et que une page de Mediawiki pour s'afficher correctement peut dépendre de nombreux autres pages : une page peut donc avoir de nombreuses dépendences. Pour faire simple, il existe deux types de dépendences: les médias (le plus souvent des images, mais cela peut aussi être des films) et d'autres pages de texte (le plus souvent des modèles ou template en anglais). Avant de commencer à copier des contenus il faut vous demander si vous souhaitez copier seulement quelques articles ou l'ensemble des articles.
Copier des contenus d'un Mediawiki à un autre est la partie la plus délicate. C'est délicat, car il n'est pas toujours nécessaire de copier tous les contenus et que une page de Mediawiki pour s'afficher correctement peut dépendre de nombreux autres pages : une page peut avoir de nombreuses dépendances.
 
Pour faire simple, il existe deux types de dépendances : les médias (le plus souvent des images, mais cela peut aussi être des vidéos ou encore tout autre type de fichier) et d'autres pages de texte (le plus souvent des modèles - ou template en anglais). Avant de commencer à copier des contenus il faut vous demander si vous souhaitez copier seulement quelques articles ou l'ensemble des articles.


Si vous souhaitez copier l'ensemble des articles et que le Mediawiki que vous souhaitez reproduire et un de la Wikimedia Foundation, alors le plus simple est de travailler avec les [http://download.wikimedia.org/backup-index.html dumps XML et SQL] fournis... Ce n'est pas simple mais c'est la méthode normale : voir l'[http://www.mediawiki.org/wiki/Importing_a_Wikipedia_database_dump_into_MediaWiki aide]. Un script perl sera écrit bientôt pour faciliter cette tâche (suivre http://www.mediawiki.org/wiki/Importing_a_Wikipedia_database_dump_into_MediaWiki). Dan tous les cas il vous restera à copier les images.
Si vous souhaitez copier l'ensemble des articles et que le Mediawiki que vous souhaitez reproduire est un de la [http://wikimediafoundation.org Wikimedia Foundation] (comme Wikipedia par exemple), alors le plus simple est de travailler avec les [http://download.wikimedia.org/backup-index.html dumps XML et SQL] fournis... Ce n'est pas simple mais c'est la méthode normale (voir [http://www.mediawiki.org/wiki/Importing_a_Wikipedia_database_dump_into_MediaWiki cette aide]). Un script perl sera écrit bientôt pour faciliter cette tâche (suivre [http://www.mediawiki.org/wiki/Importing_a_Wikipedia_database_dump_into_MediaWiki ceci]). Dans tous les cas il vous restera à copier les images par la suite (enfin si vous le souhaitez).


Si vous ne souhaitez reproduire qu'une sélection des articles, alors mirrorMediawikiCode.pl est le script qu'il vous faut. mirrorMediawikiCode.pl permet à partir de reproduire une liste d'articles avec toutes les dépendences nécessaire à son bon affichage.
Si vous ne souhaitez reproduire qu'une sélection des articles, alors mirrorMediawikiCode.pl est le script qu'il vous faut. mirrorMediawikiCode.pl permet de reproduire une liste d'articles avec toutes les dépendances nécessaire au bon affichage des articles.


=== Étape 4 : préparer les contenus à votre façon ===
=== Étape 4 : préparer les contenus à votre façon ===
Line 140: Line 144:
=== Étape 7 : créer un fichier ZIM ===
=== Étape 7 : créer un fichier ZIM ===


Créer un ZIM ce fait simplement en utilisant buildZimFileFromDirectory.pl. Il faut pour que cela fonctionne que [http://www.openzim.org/Zimwriter zimwriter] soit installé ainsi que PostreSQL.
Créer un ZIM se fait simplement en utilisant buildZimFileFromDirectory.pl. Il faut pour que cela fonctionne que [http://www.openzim.org/Zimwriter zimwriter] soit installé ainsi que PostreSQL. buildZimFileFromDirectory.pl est un script qui permet de fabriquer un fichier ZIM avec tous les contenus HTML, CSS, PNG, ... présents dans un répertoire.


=== Étape 8 : créer un index de recherche du fichier ZIM ===
=== Étape 8 : créer un index de recherche du fichier ZIM ===


Pour créer un index de recherche, utiliser le binaire kiwix-index.
Pour créer un index de recherche, utiliser le binaire kiwix-index. Kiwix peut lui aussi simplement créer un index à partir de n'importe quel fichier ZIM.

Navigation menu