Mot-clé - documentation

Fil des billets - Fil des commentaires

mardi, avril 22 2008

Enfin une recherche sur docs.postgresqlfr.org

Depuis le temps que je voulais le faire ! Bref, peu importe.

Le site de la documentation française de PostgreSQL dispose enfin de son propre moteur de recherche, utilisant évidemment PostgreSQL 8.3 et la recherche plein texte. Cela n'a demandé que l'ajout d'un formulaire sur la page d'index (toujours en HTML) et l'ajout d'une page PHP pour la connexion à la base, l'exécution de la requête et la récupération des résultats. Bon, le code n'est pas très propre mais le principal est là : ça fonctionne ! (ça a demandé aussi l'écriture d'un script d'intégration de la doc dans la base, mais c'est le côté invisible pour les utilisateurs)

J'ai tout mis dans le SVN de la traduction. Pour les curieux, c'est ici.

La suite est prévisible : rédaction d'un document développeur, d'un document utilisateur, nettoyage du code, ajout de quelques fonctionnalités (l'addon Firefox est le premier qui me vient en tête).

vendredi, avril 4 2008

Encodage de la documentation PostgreSQL

En début de semaine, j'ai modifié l'encodage des documents XML de la documentation PostgreSQL. Nous sommes passés de ISO-8859-1 à ISO-8859-15 parce que nous utilisons le caractère œ (e dans l'o). Comme tidy ne gère pas l'ISO-8859-15 mais accepte l'UTF-8, il a fallu rajouter une étape pour recoder l'ISO-8859-15 en UTF-8 avant de passer les fichiers à tidy.

Pourquoi ne pas avoir passé les documents en UTF-8 directement ? tout simplement parce que ça aurait fait beaucoup de modifs dans les fichiers pour un résultat identique. Voilà. Uniquement pour éviter de modifier tous les fichiers en profondeur.

Bref, tout ça pour dire que les caractères spécifiques au codage ISO-8859-15 devraient apparaître correctement maintenant.