Skip site navigation (1) Skip section navigation (2)

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

From: Georges Martin <georges(dot)martin(at)scarlet(dot)be>
To: pgsql-fr-generale(at)postgresql(dot)org
Subject: Documentation de PostgreSQL 8.0.0 assemblée pour l'aide de MacOS X
Date: 2005-02-03 16:01:18
Message-ID: r02010400-1037-D85FAF4575FC11D9A7D6000A95CE07C2@[10.0.1.2] (view raw, whole thread or download thread mbox)
Thread:
Lists: pgsql-fr-generale
-----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-----

Responses

pgsql-fr-generale by date

Next:From: Didier BRETINDate: 2005-02-04 12:45:30
Subject: Quid de l'association PostgreSQLFr ?
Previous:From: Erwan DUROSELLEDate: 2005-01-31 08:51:17
Subject: Rép. : Re: Presentation rapide de PostgreSQL

Privacy Policy | About PostgreSQL
Copyright © 1996-2017 The PostgreSQL Global Development Group