Documentation de PostgreSQL 8.0.0 assemblée pour l'aide de MacOS X

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

J'ai assemblé la documentation anglaise de PostgreSQL 8.0.0 pour le système
d'aide de MacOS X [1].

Vous pouvez la téléchargez à l'adresse suivante:

<http://homepage.mac.com/jimini/>

== Installation ==

1. décompressez le fichier zip;
2. glissez le fichier "PostgreSQL 8.0.0 Documentation.help" dans le dossier
"/Bibliothèque/Documentation/Aide/".

Vous pouvez l'ouvrir en double-cliquant le fichier.

Vous pouvez également y accéder à partir du Finder:

1. sélectionnez "Aide Mac" dans le menu "Aide";
2. sélectionnez "PostgreSQL 8.0.0 Documentation" dans le menu "Bibliothèque".

== À faire ==

Il s'agit d'un assemblage manuel (en version 0.1 !) et certains éléments
manquent à l'appel:

- - l'index pour le système d'aide;
- - les pages pour les listes de figures, de table et d'exemples;
- - l'icône pour le Finder.

(un détail: l'extension de paquets .help est normalement réservée pour Apple...
[2])

Comme la documentation pour PostgreSQL est écrite avec DocBook [3], le meilleur
moyen de la voir assemblée pour l'Aide de MacOS X serait de:

1. créer un feuille de transformation XSLT "DocBook to Apple Help" pour le
système "Modular DocBook HTML Stylesheet" [4][5];

2. étendre le fichier Makefile de pgsql-doc/SGML pour lui faire sortir l'Aide
MacOS X [6];

3. et soumettre tout cela à la liste de diffusion pgsql-doc [7] pour être inclus
dans le code source de PostgreSQL...

Cerise sur le gâteau... pas mal de documentations de logiciels libres sont
écrites avec DocBook, alors, ça aiderait à leur portage vers MacOS X.

Alors si vous avez de l'expérience avec DocBook, XSLT et/ou le système d'aide de
MacOS X, soyez les bienvenus [8]... :-)

Georges Martin,
Février 2005

- --
[1]
<http://developer.apple.com/documentation/Carbon/Conceptual/
ProvidingUserAssitAppleHelp/index.html>
[2]
<http://developer.apple.com/documentation/Carbon/Conceptual/
ProvidingUserAssitAppleHelp/registering_help/chapter_4_section_2.html#//
apple_ref/doc/uid/TP30000903-CH207-TPXREF101>
[3] <http://docbook.sourceforge.net/>
[4] <http://docbook.sourceforge.net/projects/xsl/index.html>
[5] il existe déjà une feuille de transformation "htmlhelp" pour l'aide de
Windows:
<http://docbook.sourceforge.net/release/xsl/current/doc/htmlhelp.html>
[6] <http://developer.postgresql.org/cvsweb.cgi/pgsql/doc/src/sgml/>
[7] <http://archives.postgresql.org/pgsql-docs/>
[8] sur les listes de diffusion pgsql-doc, docbook-apps
(<http://www.oasis-open.org/docbook/mailinglist/>) et/ou apple-help-authoring
(<http://lists.apple.com/mailman/listinfo/apple-help-authoring/>) ?

-----BEGIN PGP SIGNATURE-----
Version: PGP SDK 3.2.2

iQA/AwUBQgJKzlzTc+nAMVDKEQJyUQCdEOjJc2qYqJRJb27yxu2eFM4b5/sAoNS4
ANuNZ7e3j23zS/0zs1+azWw8
=rr1c
-----END PGP SIGNATURE-----