Adding the FDP-primer
This commit is contained in:
Sebastien Gioria
parent
17147340bb
commit
4b4212705e
Notes:
svn2git
2020-12-08 03:00:23 +00:00
svn path=/head/; revision=7338
30 changed files with 12476 additions and 0 deletions
fr_FR.ISO8859-1/books/fdp-primer
Makefilebook.sgmlchapters.ent
overview
psgml-mode
see-also
sgml-markup
sgml-primer
stylesheets
the-faq
the-handbook
the-website
tools
translations
writing-style
fr_FR.ISO_8859-1/books/fdp-primer
Makefilebook.sgmlchapters.ent
overview
psgml-mode
see-also
sgml-markup
sgml-primer
stylesheets
the-faq
the-handbook
the-website
tools
translations
writing-style
47
fr_FR.ISO8859-1/books/fdp-primer/Makefile
Normal file
47
fr_FR.ISO8859-1/books/fdp-primer/Makefile
Normal file
|
|
@ -0,0 +1,47 @@
|
|||
#
|
||||
# The FreeBSD Documentation Project
|
||||
# The FreeBSD French Documentation Project
|
||||
#
|
||||
# Compilation de l'Introduction au Projet de Documentation de FreeBSD
|
||||
#
|
||||
# $Id: Makefile,v 1.1 2000-06-12 15:46:26 gioria Exp $
|
||||
# Original revision: 1.6
|
||||
#
|
||||
|
||||
MAINTAINER=nik@FreeBSD.ORG
|
||||
|
||||
DOC?= book
|
||||
|
||||
FORMATS?= html-split html
|
||||
|
||||
INSTALL_COMPRESSED?= gz
|
||||
INSTALL_ONLY_COMPRESSED?=
|
||||
|
||||
#
|
||||
# SRCS lists the individual SGML files that make up the document. Changes
|
||||
# to any of these files will force a rebuild
|
||||
#
|
||||
|
||||
# SGML content
|
||||
SRCS= book.sgml
|
||||
SRCS+= overview/chapter.sgml
|
||||
SRCS+= psgml-mode/chapter.sgml
|
||||
SRCS+= see-also/chapter.sgml
|
||||
SRCS+= sgml-markup/chapter.sgml
|
||||
SRCS+= sgml-primer/chapter.sgml
|
||||
SRCS+= stylesheets/chapter.sgml
|
||||
SRCS+= the-faq/chapter.sgml
|
||||
SRCS+= the-handbook/chapter.sgml
|
||||
SRCS+= the-website/chapter.sgml
|
||||
SRCS+= tools/chapter.sgml
|
||||
SRCS+= translations/chapter.sgml
|
||||
SRCS+= writing-style/chapter.sgml
|
||||
|
||||
# Entities
|
||||
SRCS+= chapters.ent
|
||||
SRCS+= ../handbook/mailing-lists.ent
|
||||
SRCS+= ../../../en_US.ISO_8859-1/books/handbook/authors.ent
|
||||
|
||||
DOC_PREFIX?= ${.CURDIR}/../../..
|
||||
|
||||
.include "${DOC_PREFIX}/share/mk/doc.project.mk"
|
||||
303
fr_FR.ISO8859-1/books/fdp-primer/book.sgml
Normal file
303
fr_FR.ISO8859-1/books/fdp-primer/book.sgml
Normal file
|
|
@ -0,0 +1,303 @@
|
|||
<!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.
|
||||
|
||||
Redistribution and use in source (SGML DocBook) and 'compiled' forms
|
||||
(SGML, HTML, PDF, PostScript, RTF and so forth) with or without
|
||||
modification, are permitted provided that the following conditions
|
||||
are met:
|
||||
|
||||
1. Redistributions of source code (SGML DocBook) must retain the above
|
||||
copyright notice, this list of conditions and the following
|
||||
disclaimer as the first lines of this file unmodified.
|
||||
|
||||
2. Redistributions in compiled form (transformed to other DTDs,
|
||||
converted to PDF, PostScript, RTF and other formats) must reproduce
|
||||
the above copyright notice, this list of conditions and the
|
||||
following disclaimer in the documentation and/or other materials
|
||||
provided with the distribution.
|
||||
|
||||
THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
|
||||
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
||||
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||||
DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
|
||||
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
||||
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
||||
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
||||
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
||||
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
|
||||
POSSIBILITY OF SUCH DAMAGE.
|
||||
|
||||
The FreeBSD Documentation Project
|
||||
The FreeBSD French Documentation Project
|
||||
|
||||
$Id: book.sgml,v 1.1 2000-06-12 15:46:26 gioria Exp $
|
||||
Original revision: 1.7
|
||||
-->
|
||||
|
||||
<!DOCTYPE BOOK PUBLIC "-//FreeBSD//DTD DocBook V3.1-Based Extension//EN" [
|
||||
<!ENTITY % man PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN"> %man;
|
||||
<!ENTITY % urls PUBLIC "-//FreeBSD//ENTITIES Common Document URL Entities//FR"> %urls;
|
||||
<!ENTITY % bookinfo PUBLIC "-//FreeBSD//ENTITIES DocBook BookInfo Entities//FR"> %bookinfo;
|
||||
<!ENTITY % translators PUBLIC "-//FreeBSD//ENTITIES DocBook Translator Entities//FR"> %translators;
|
||||
<!ENTITY % chapters SYSTEM "chapters.ent"> %chapters;
|
||||
<!ENTITY % authors SYSTEM "../../../en_US.ISO_8859-1/books/handbook/authors.ent"> %authors;
|
||||
<!ENTITY % mailing-lists SYSTEM "../handbook/mailing-lists.ent"> %mailing-lists;
|
||||
<!ENTITY rel.current CDATA "3.2">
|
||||
<!-- We need the followings until the translation is completed -->
|
||||
<!ENTITY sgml.in-progress SYSTEM "../handbook/in-progress.sgml">
|
||||
<!ENTITY sgml.todo SYSTEM "../handbook/todo.sgml">
|
||||
]>
|
||||
|
||||
<book lang="fr">
|
||||
<bookinfo>
|
||||
<title>Introduction au Projet de Documentation de FreeBSD pour les
|
||||
nouveaux participants</title>
|
||||
|
||||
<author>
|
||||
<firstname>Nik</firstname>
|
||||
<surname>Clayton</surname>
|
||||
<affiliation>
|
||||
<address><email>nik@FreeBSD.ORG</email></address>
|
||||
</affiliation>
|
||||
</author>
|
||||
|
||||
<copyright>
|
||||
<year>1998</year>
|
||||
<year>1999</year>
|
||||
<holder role="mailto:nik@FreeBSD.ORG">Nik Clayton</holder>
|
||||
</copyright>
|
||||
|
||||
<pubdate role="rcs">$Date: 2000-06-12 15:46:26 $</pubdate>
|
||||
|
||||
<releaseinfo>$Id: book.sgml,v 1.1 2000-06-12 15:46:26 gioria Exp $</releaseinfo>
|
||||
|
||||
<legalnotice>
|
||||
<para>La redistribution et l'utilisation du code source (SGML), et
|
||||
compilé (HTML, PostScript, etc.), modifiés ou non, sont soumises aux
|
||||
conditions suivantes :</para>
|
||||
|
||||
<orderedlist>
|
||||
<listitem>
|
||||
<para>Le code source (SGML DocBook) distribué doit conserver le
|
||||
copyright ci-dessus, la présente liste de conditions et
|
||||
l'avertissement qui la suit, sans modifications, en tête de ce
|
||||
fichier.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para>Le code source distribué sous forme compilé (transformation
|
||||
vers d'autres DTDs, conversion en PDF, PostScript, RTF et autres
|
||||
formats) doit faire apparaître dans la documentation et/ou les
|
||||
autres composants distribués, le copyright ci-dessus, la présente
|
||||
liste de conditions et l'avertissement qui la suit.</para>
|
||||
</listitem>
|
||||
</orderedlist>
|
||||
|
||||
<important>
|
||||
<para>CE DOCUMENT EST FOURNI PAR NIK CLAYTON “TEL QUEL” ET
|
||||
AUCUNE GARANTIE EXPRESSE OU IMPLICITE, Y COMPRIS, MAIS NON
|
||||
LIMITÉE, GARANTIES IMPLICITES DE COMMERCIABILITÉ ET
|
||||
D'ADÉQUATION À UN BUT PARTICULIER N'EST DONNÉE.
|
||||
EN AUCUN CAS NIK CLAYTON NE SAURAIT ÊTRE TENU RESPONSABLE DES
|
||||
DOMMAGES DIRECTS, INDIRECTS, ACCIDENTELS, SPÉCIAUX,
|
||||
EXEMPLAIRES OU CONSÉQUENTS (Y COMPRIS, MAIS SANS LIMITATION,
|
||||
LA FOURNITURE DE BIENS ET SERVICES ANNEXES DÉFAUT
|
||||
D'UTILISABILITÉ, PERTE DE DONNÉES OU DE PROFITS ;
|
||||
OU INTERRUPTION DE TRAVAIL) QUELLE QU'EN SOIT LA CAUSE ET SELON
|
||||
TOUTE DÉFINITION DE RESPONSABILITÉ, SOIT PAR CONTRAT,
|
||||
RESPONSABILITÉ STRICTE, OU PRÉJUDICE (Y COMPRIS
|
||||
NÉGLIGENCE OU AUTRES) IMPUTABLES D'UNE FAÇON OU D'UNE
|
||||
AUTRE À L'UTILISATION DE CE DOCUMENT, MÊME APRES AVOIR
|
||||
ÉTÉ AVISÉ DE LA POSSIBILITÉ DE TELS
|
||||
DOMMAGES.</para>
|
||||
</important>
|
||||
</legalnotice>
|
||||
|
||||
<abstract>
|
||||
<para>Merci de votre participation au Projet de Documentation de
|
||||
FreeBSD. Votre contribution est très utile.</para>
|
||||
|
||||
<para>Cette introduction décrit tout ce que vous devez savoir pour
|
||||
commencer à participer au projet de documentation de FreeBSD, des
|
||||
outils et logiciels que vous utiliserez (indispensables et
|
||||
facultatifs) à la philosophie sous-jacente au Projet de
|
||||
Documentation.</para>
|
||||
|
||||
<para>Ce document est en cours de rédaction et n'est pas terminé. Les
|
||||
sections inachevées sont indiquées par un
|
||||
astérisque - <literal>*</literal> - qui précède
|
||||
leur nom.</para>
|
||||
|
||||
&trans.a.haby;
|
||||
</abstract>
|
||||
</bookinfo>
|
||||
|
||||
<preface>
|
||||
<title>Préface</title>
|
||||
|
||||
<sect1>
|
||||
<title>Invites de l'interpréteur de commandes</title>
|
||||
|
||||
<para>La table ci-dessous donne les invites par défaut du système pour
|
||||
un utilisateur normal et pour le super-utilisateur. Elles sont
|
||||
utilisées dans les exemples pour indiquer quel utilisateur doit
|
||||
appliquer l'exemple.</para>
|
||||
|
||||
<informaltable frame="none">
|
||||
<tgroup cols="2">
|
||||
<thead>
|
||||
<row>
|
||||
<entry>Utilisateur</entry>
|
||||
<entry>Invite</entry>
|
||||
</row>
|
||||
</thead>
|
||||
|
||||
<tbody>
|
||||
<row>
|
||||
<entry>Utilisateur normal</entry>
|
||||
<entry>&prompt.user;</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><username>root</username></entry>
|
||||
<entry>&prompt.root;</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</informaltable>
|
||||
</sect1>
|
||||
|
||||
<sect1>
|
||||
<title>Conventions Typographiques</title>
|
||||
|
||||
<para>La table ci-dessous décrit les conventions typographiques
|
||||
utilisées dans le présent ouvrage.</para>
|
||||
|
||||
<informaltable frame="none">
|
||||
<tgroup cols="2">
|
||||
<thead>
|
||||
<row>
|
||||
<entry>Signification</entry>
|
||||
<entry>Exemples</entry>
|
||||
</row>
|
||||
</thead>
|
||||
|
||||
<tbody>
|
||||
<row>
|
||||
<entry>Noms de commandes, fichiers et répertoires. Affichage à
|
||||
l'écran de l'ordinateur.</entry>
|
||||
|
||||
<entry><para>Modifiez votre fichier
|
||||
<filename>.login</filename>.</para><para>Utilisez
|
||||
<command>ls -a</command> pour avoir la liste de tous les
|
||||
fichiers.</para><para><screen>Vous avez reçu du courrier.</screen></para></entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry>Ce que vous tapez, par opposition à ce que l'ordinateur
|
||||
affiche.</entry>
|
||||
|
||||
<entry><screen>&prompt.user; <userinput>su</userinput>
|
||||
Password:</screen></entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry>Références aux pages de manuel</entry>
|
||||
|
||||
<entry>Utilisez <citerefentry><refentrytitle>su</refentrytitle>
|
||||
<manvolnum>1</manvolnum></citerefentry> pour changer de nom
|
||||
d'utilisateur.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry>Noms d'utilisateurs et de groupes</entry>
|
||||
|
||||
<entry>Seul <username>root</username> peut le faire.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry>Mise en valeur</entry>
|
||||
|
||||
<entry>Vous <emphasis>devez</emphasis> le faire.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry>Variables sur la ligne de commande ; à remplacer par
|
||||
le nom ou la valeur effectif.</entry>
|
||||
|
||||
<entry>Pour supprimer un fichier, tapez <command>rm
|
||||
<filename><replaceable>nom_du_fichier</replaceable></filename></command>.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry>Variables d'environnement</entry>
|
||||
|
||||
<entry><envar>$HOME</envar> est votre répertoire
|
||||
utilisateur.</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</informaltable>
|
||||
</sect1>
|
||||
|
||||
<sect1>
|
||||
<title>Notes, avertissements et exemples</title>
|
||||
|
||||
<para>Dans le cours du texte, il peut y avoir des notes, des
|
||||
avertissements et des exemples.</para>
|
||||
|
||||
<note>
|
||||
<para>Les notes apparaissent comme ceci, et contiennent des
|
||||
informations que vous devriez prendre en considération, parce
|
||||
qu'elles peuvent avoir une incidence sur ce que vous faites.</para>
|
||||
</note>
|
||||
|
||||
<warning>
|
||||
<para>Les avertissements apparaissent comme ceci, et vous préviennent
|
||||
de problèmes potentiels si vous n'appliquez pas ces instructions.
|
||||
Des dégats peuvent être causés à votre matériel, ou ne pas être
|
||||
physiques, suppression inopinée de fichiers importants par
|
||||
exemple.</para>
|
||||
</warning>
|
||||
|
||||
<example>
|
||||
<title>Un exemple d'exemple</title>
|
||||
|
||||
<para>Les exemples apparaissent comme ceci, et sont généralement des
|
||||
exemples que vous devriez tester ou qui vous montrent quels doivent
|
||||
être les résultats d'une opération donnée.</para>
|
||||
</example>
|
||||
</sect1>
|
||||
|
||||
<sect1>
|
||||
<title>Remerciements</title>
|
||||
|
||||
<para>Mes remerciements à Sue Blake, Patrick Durusau, Jon Hamilton,
|
||||
Peter Flynn et Christopher Maden, qui ont pris le temps de lire les
|
||||
premières versions de ce document et ont apporté de nombreux
|
||||
commentaires et critiques utiles.</para>
|
||||
</sect1>
|
||||
</preface>
|
||||
|
||||
&chap.overview;
|
||||
&chap.tools;
|
||||
&chap.sgml-primer;
|
||||
&chap.sgml-markup;
|
||||
&chap.stylesheets;
|
||||
&chap.the-faq;
|
||||
&chap.the-handbook;
|
||||
&chap.the-website;
|
||||
&chap.translations;
|
||||
&chap.writing-style;
|
||||
&chap.psgml-mode;
|
||||
&chap.see-also;
|
||||
</book>
|
||||
|
||||
<!--
|
||||
Local Variables:
|
||||
mode: sgml
|
||||
sgml-indent-data: t
|
||||
sgml-omittag: nil
|
||||
sgml-always-quote-attributes: t
|
||||
End:
|
||||
-->
|
||||
23
fr_FR.ISO8859-1/books/fdp-primer/chapters.ent
Normal file
23
fr_FR.ISO8859-1/books/fdp-primer/chapters.ent
Normal file
|
|
@ -0,0 +1,23 @@
|
|||
<!--
|
||||
Creates entities for each chapter in the Documentation Project Primer.
|
||||
Each entity is named chap.foo, where foo is the value of the id
|
||||
attribute on that chapter, and corresponds to the name of the
|
||||
directory in which that chapter's .sgml file is stored.
|
||||
|
||||
Chapters should be listed in the order in which they are referenced.
|
||||
|
||||
$Id: chapters.ent,v 1.1 2000-06-12 15:46:26 gioria Exp $
|
||||
-->
|
||||
|
||||
<!ENTITY chap.overview SYSTEM "overview/chapter.sgml">
|
||||
<!ENTITY chap.sgml-primer SYSTEM "sgml-primer/chapter.sgml">
|
||||
<!ENTITY chap.tools SYSTEM "tools/chapter.sgml">
|
||||
<!ENTITY chap.sgml-markup SYSTEM "sgml-markup/chapter.sgml">
|
||||
<!ENTITY chap.stylesheets SYSTEM "stylesheets/chapter.sgml">
|
||||
<!ENTITY chap.the-faq SYSTEM "the-faq/chapter.sgml">
|
||||
<!ENTITY chap.the-handbook SYSTEM "the-handbook/chapter.sgml">
|
||||
<!ENTITY chap.the-website SYSTEM "the-website/chapter.sgml">
|
||||
<!ENTITY chap.translations SYSTEM "translations/chapter.sgml">
|
||||
<!ENTITY chap.writing-style SYSTEM "writing-style/chapter.sgml">
|
||||
<!ENTITY chap.psgml-mode SYSTEM "psgml-mode/chapter.sgml">
|
||||
<!ENTITY chap.see-also SYSTEM "see-also/chapter.sgml">
|
||||
187
fr_FR.ISO8859-1/books/fdp-primer/overview/chapter.sgml
Normal file
187
fr_FR.ISO8859-1/books/fdp-primer/overview/chapter.sgml
Normal file
|
|
@ -0,0 +1,187 @@
|
|||
<!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.
|
||||
|
||||
Redistribution and use in source (SGML DocBook) and 'compiled' forms
|
||||
(SGML HTML, PDF, PostScript, RTF and so forth) with or without
|
||||
modification, are permitted provided that the following conditions
|
||||
are met:
|
||||
|
||||
1. Redistributions of source code (SGML DocBook) must retain the above
|
||||
copyright notice, this list of conditions and the following
|
||||
disclaimer as the first lines of this file unmodified.
|
||||
|
||||
2. Redistributions in compiled form (transformed to other DTDs,
|
||||
converted to PDF, PostScript, RTF and other formats) must reproduce
|
||||
the above copyright notice, this list of conditions and the
|
||||
following disclaimer in the documentation and/or other materials
|
||||
provided with the distribution.
|
||||
|
||||
THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
|
||||
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
||||
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||||
DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
|
||||
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
||||
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
||||
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
||||
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
||||
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
|
||||
POSSIBILITY OF SUCH DAMAGE.
|
||||
|
||||
The FreeBSD Documentation Project
|
||||
The FreeBSD French Documentation Project
|
||||
|
||||
$Id: chapter.sgml,v 1.1 2000-06-12 15:46:30 gioria Exp $
|
||||
Original revision: 1.3
|
||||
-->
|
||||
|
||||
<chapter id="overview">
|
||||
<title>Introduction</title>
|
||||
|
||||
<para>Bienvenue au Projet de Documentation de FreeBSD. Une documentation de
|
||||
bonne qualité est un facteur important de succès pour FreeBSD, et le
|
||||
Projet de Documentation de
|
||||
FreeBSD - “<foreignphrase>The FreeBSD Documentation
|
||||
Project</foreignphrase>” - est la source d'une grande
|
||||
part de cette documentation. Votre participation est importante.</para>
|
||||
|
||||
<para>L'objectif principal de ce document est d'expliquer clairement
|
||||
<emphasis>comment est organisé le FDP</emphasis>, <emphasis>comment
|
||||
écrire et soumettre de la documentation au FDP</emphasis> et
|
||||
<emphasis>comment utiliser les outils disponibles pour produire de la
|
||||
documentation</emphasis>.</para>
|
||||
|
||||
<para>La participation de chacun au FDP est bienvenue. Il n'y a pas de
|
||||
cotisation minimum, pas de quota de documentation à produire par mois. Il
|
||||
vous suffit de vous inscrire sur la &a.doc;.</para>
|
||||
|
||||
<para>Après avoir lu ce document, vous :</para>
|
||||
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>Saurez quelles sont les documentations maintenues par le
|
||||
FDP.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para>Serez capable de lire et comprendre le code SGML source des
|
||||
documentations maintenues par le FDP.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para>Serez capable de modifier la documentation.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para>Saurez comment soumettre vos modifications pour qu'elles soient
|
||||
revues et incorporées à la documentation de FreeBSD.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
|
||||
<sect1>
|
||||
<title>Le jeu de documentations de FreeBSD</title>
|
||||
|
||||
<para>Le FDP a la responsabilité de quatre catégories de documents.</para>
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term>Les pages de manuel</term>
|
||||
|
||||
<listitem>
|
||||
<para>Les pages de manuel système en anglais ne sont pas rédigées
|
||||
par le FDP, puisqu'elles font partie du système de base. Le FDP,
|
||||
néanmoins, peut (et a) récrit des pages de manuel existantes pour
|
||||
les clarifier ou corriger des inexactitudes.</para>
|
||||
|
||||
<para>Les équipes de traductions sont responsables de la traduction
|
||||
des pages de manuel dans les différentes langues. Ces traductions
|
||||
sont archivées par le FDP.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term>FAQ</term>
|
||||
|
||||
<listitem>
|
||||
<para>L'objectif de la FAQ est de répondre (sous forme de courtes
|
||||
questions/réponses) aux questions qui sont posées, ou devraient
|
||||
être posées, sur les différentes listes de diffusion et forums de
|
||||
discussion consacrées à FreeBSD. Son format n'autorise pas de
|
||||
réponses longues et exhaustives.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term>Manuel de
|
||||
référence - “<foreignphrase>Handbook</foreignphrase>”</term>
|
||||
|
||||
<listitem>
|
||||
<para>Le Manuel cherche à être la ressource en ligne exhaustive et
|
||||
de référence pour les utilisateurs de FreeBSD.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term>Le site Web</term>
|
||||
|
||||
<listitem>
|
||||
<para>C'est le point de présence central de FreeBSD sur le
|
||||
<foreignphrase>World Wide Web</foreignphrase>, dont le site
|
||||
principal est <ulink
|
||||
url="http://www.freebsd.org/">http://www.freebsd.org/</ulink>
|
||||
et qui a de nombreux sites miroirs dans le monde. Pour beaucoup
|
||||
de gens, ce site est leur première rencontre avec FreeBSD.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
|
||||
<para>Ces quatres catégories de documentation sont disponibles dans les
|
||||
archives CVS de FreeBSD. Ce qui signifie que les modifications et les
|
||||
notifications sont accessibles à tous, et que chacun peut utiliser un
|
||||
programme comme <application>CVSup</application> ou
|
||||
<application>CTM</application> pour maintenir à jour son propre
|
||||
exemplaire local.</para>
|
||||
|
||||
|
||||
<para>En plus de ces documents, de nombreuses personnes ont écrit des
|
||||
guides ou réalisé des sites Web se rapportant à FreeBSD. Certains sont
|
||||
aussi archivés dans l'arborescence CVS (quand l'auteur a donné son
|
||||
accord). Dans d'autre cas, l'auteur a choisi de conserver ses
|
||||
documentations en dehors des archives FreeBSD. Le FDP essaie de donner
|
||||
le maximum de liens possible sur ces documents.</para>
|
||||
</sect1>
|
||||
|
||||
<sect1>
|
||||
<title>Avant de commencer</title>
|
||||
|
||||
<para>Ce document fait l'hypothèse que vous savez déjà :</para>
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>Vous procurer et tenir à jour une copie locale de la
|
||||
documentation. Soit en maintenant une copie locale des archives CVS
|
||||
de FreeBSD (avec <application>CVS</application>,
|
||||
<application>CVSup</application> ou <application>CTM</application>),
|
||||
ou en vous servant de <application>CVSup</application> pour ne
|
||||
télécharger que la version
|
||||
extraite - <emphasis>courante</emphasis>.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para>Comment télécharger et installer de nouveaux logiciels en vous
|
||||
servant soit du catalogue des logiciels de FreeBSD soit de
|
||||
&man.pkg.add.1;.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</sect1>
|
||||
</chapter>
|
||||
|
||||
<!--
|
||||
Local Variables:
|
||||
mode: sgml
|
||||
sgml-declaration: "../chapter.decl"
|
||||
sgml-indent-data: t
|
||||
sgml-omittag: nil
|
||||
sgml-always-quote-attributes: t
|
||||
sgml-parent-document: ("../book.sgml" "part" "chapter")
|
||||
End:
|
||||
-->
|
||||
|
||||
154
fr_FR.ISO8859-1/books/fdp-primer/psgml-mode/chapter.sgml
Normal file
154
fr_FR.ISO8859-1/books/fdp-primer/psgml-mode/chapter.sgml
Normal file
|
|
@ -0,0 +1,154 @@
|
|||
<!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.
|
||||
|
||||
Redistribution and use in source (SGML DocBook) and 'compiled' forms
|
||||
(SGML HTML, PDF, PostScript, RTF and so forth) with or without
|
||||
modification, are permitted provided that the following conditions
|
||||
are met:
|
||||
|
||||
1. Redistributions of source code (SGML DocBook) must retain the above
|
||||
copyright notice, this list of conditions and the following
|
||||
disclaimer as the first lines of this file unmodified.
|
||||
|
||||
2. Redistributions in compiled form (transformed to other DTDs,
|
||||
converted to PDF, PostScript, RTF and other formats) must reproduce
|
||||
the above copyright notice, this list of conditions and the
|
||||
following disclaimer in the documentation and/or other materials
|
||||
provided with the distribution.
|
||||
|
||||
THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
|
||||
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
||||
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||||
DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
|
||||
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
||||
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
||||
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
||||
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
||||
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
|
||||
POSSIBILITY OF SUCH DAMAGE.
|
||||
|
||||
$Id: chapter.sgml,v 1.1 2000-06-12 15:46:33 gioria Exp $
|
||||
-->
|
||||
|
||||
<chapter id="psgml-mode">
|
||||
<title> Utiliser <literal>sgml-mode</literal> avec
|
||||
<application>Emacs</application></title>
|
||||
|
||||
<para>Les versions récentes d'Emacs ou Xemacs (disponibles au catalogue des
|
||||
logiciels portés) incluent un paquetage très utile appelé PSGML. Il est
|
||||
automatiquement appelé au chargement d'un fichier avec l'extension
|
||||
<filename>.sgml</filename>, ou lorsque l'on tape <command>M-x
|
||||
sgml-mode</command>. C'est un mode majeur pour traiter les fichiers
|
||||
SGML, les éléments et les attributs.</para>
|
||||
|
||||
<para>Connaître certaines des commandes de ce mode peut rendre le travail
|
||||
sur des documents comme le Manuel de Référence beaucoup plus
|
||||
facile.</para>
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><command>C-c C-e</command></term>
|
||||
|
||||
<listitem>
|
||||
<para>Exécute <literal>sgml-insert-element</literal>. On vous
|
||||
demandera le nom de l'élement à insérer là ou se trouve le
|
||||
curseur. Vous pouvez utiliser la touche <keycap>Tab</keycap> pour
|
||||
compléter le nom de l'élément. Seuls les éléments syntaxiquement
|
||||
valides à cet endroit seront acceptés.</para>
|
||||
|
||||
<para>L'éditeur insérera les marques de début et de fin de l'élément.
|
||||
S'il y a d'autres éléments obligatoires qui doivent être inclus
|
||||
dans cet élément, ils seront aussi inclus.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><command>C-c =</command></term>
|
||||
|
||||
<listitem>
|
||||
<para>Exécute <literal>sgml-change-element-name</literal>. Mettez-vous
|
||||
dans un élément et utilisez cette commande. On vous demandera le nom
|
||||
de l'élément par lequel il faut le remplacer. Les marques de début
|
||||
et de fin de l'élément seront remplacées.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><command>C-c C-r</command></term>
|
||||
|
||||
<listitem>
|
||||
<para>Exécute <literal>sgml-tag-region</literal>. Sélectionnez du
|
||||
texte (placez-vous au début, <command>C-espace</command>, allez à
|
||||
la fin du texte, <command>C-espace</command>) et lancez ensuite
|
||||
cette commande. On vous demandera quel élement utiliser. Celui-ci
|
||||
sera inséré immédiatement avant et après la région choisie.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><command>C-c -</command></term>
|
||||
|
||||
<listitem>
|
||||
<para>Exécute <literal>sgml-untag-element</literal>. Mettez-vous sur
|
||||
la marque de début ou de fin de l'élément que vous voulez supprimer
|
||||
et lancez cette commande. Les marques de début et de fin de
|
||||
l'élément seront supprimées.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><command>C-c C-q</command></term>
|
||||
|
||||
<listitem>
|
||||
<para>Exécute <literal>sgml-fill-element</literal>.
|
||||
“Remplira” (i.e., reformatera) le contenu de l'élément
|
||||
courant. Cela affectera aussi le contenu dont les blancs sont
|
||||
significatifs, comme celui des éléments
|
||||
<sgmltag>programlisting</sgmltag>, utilisez donc cette commande avec
|
||||
précaution.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><command>C-c C-a</command></term>
|
||||
|
||||
<listitem>
|
||||
<para>Exécute <literal>sgml-edit-attributes</literal>. Ouvre un
|
||||
deuxième tampon donnant la liste des attributs de l'élément
|
||||
qui inclut le contenu courant, avec leurs valeurs. La touche
|
||||
<keycap>Tab</keycap> vous permet de passer d'un attribut à l'autre,
|
||||
<command>C-k</command> de modifier une valeur existante, et
|
||||
<command>C-c</command> de fermer le tampon et de revenir au
|
||||
document principal.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><command>C-c C-v</command></term>
|
||||
|
||||
<listitem>
|
||||
<para>Exécute <literal>sgml-validate</literal>. Vous propose de
|
||||
sauvegarder le document en cours (si besoin est) et passe ensuite un
|
||||
programme de validation du SGML. Les résultats de cette validation
|
||||
sont affichés dans un nouveau tampon et vous pouvez ensuite naviguer
|
||||
d'une erreur à l'autre, pour les corriger au fur et à mesure.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
|
||||
<para>Il y a sans aucun doute d'autres fonctions utiles, mais j'ai décrit
|
||||
celles que j'utilise le plus souvent.</para>
|
||||
</chapter>
|
||||
|
||||
|
||||
<!--
|
||||
Local Variables:
|
||||
mode: sgml
|
||||
sgml-declaration: "../chapter.decl"
|
||||
sgml-indent-data: t
|
||||
sgml-omittag: nil
|
||||
sgml-always-quote-attributes: t
|
||||
sgml-parent-document: ("../book.sgml" "part" "chapter")
|
||||
End:
|
||||
-->
|
||||
|
||||
124
fr_FR.ISO8859-1/books/fdp-primer/see-also/chapter.sgml
Normal file
124
fr_FR.ISO8859-1/books/fdp-primer/see-also/chapter.sgml
Normal file
|
|
@ -0,0 +1,124 @@
|
|||
<!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.
|
||||
|
||||
Redistribution and use in source (SGML DocBook) and 'compiled' forms
|
||||
(SGML HTML, PDF, PostScript, RTF and so forth) with or without
|
||||
modification, are permitted provided that the following conditions
|
||||
are met:
|
||||
|
||||
1. Redistributions of source code (SGML DocBook) must retain the above
|
||||
copyright notice, this list of conditions and the following
|
||||
disclaimer as the first lines of this file unmodified.
|
||||
|
||||
2. Redistributions in compiled form (transformed to other DTDs,
|
||||
converted to PDF, PostScript, RTF and other formats) must reproduce
|
||||
the above copyright notice, this list of conditions and the
|
||||
following disclaimer in the documentation and/or other materials
|
||||
provided with the distribution.
|
||||
|
||||
THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
|
||||
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
||||
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||||
DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
|
||||
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
||||
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
||||
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
||||
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
||||
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
|
||||
POSSIBILITY OF SUCH DAMAGE.
|
||||
|
||||
$Id: chapter.sgml,v 1.1 2000-06-12 15:46:35 gioria Exp $
|
||||
-->
|
||||
|
||||
<chapter id="see-also">
|
||||
<title> A consulter</title>
|
||||
|
||||
<para>Ce document ne décrit délibérement pas exhaustivement, ni le SGML, ni
|
||||
les DTDs citées, ni le Projet de Documentation de FreeBSD. Pour plus
|
||||
d'information sur ces sujets, il est recommandé de consulter les sites Web
|
||||
ci-dessous.</para>
|
||||
|
||||
<sect1>
|
||||
<title>Projet de Documentation de FreeBSD</title>
|
||||
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para><ulink url="http://www.freebsd.org/docproj/">Les pages Web du
|
||||
Projet de Documentation de FreeBSD</ulink>,</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><ulink url="http://www.freebsd.org/handbook/">Le Manuel de
|
||||
Référence de FreeBSD</ulink>.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</sect1>
|
||||
|
||||
<sect1>
|
||||
<title>SGML</title>
|
||||
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para><ulink url="http://www.oasis-open.org/cover/">La page Web
|
||||
SGML/XML</ulink>, un ressource SGML exhaustive,</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><ulink
|
||||
url='http://etext.virginia.edu/bin/tei-tocs?div=DIV1&id=SG">http://etext.virginia.edu/bin/tei-tocs?div=DIV1&id=SG'>L'Introduction en
|
||||
douceur au SGML</ulink>.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</sect1>
|
||||
|
||||
<sect1>
|
||||
<title>HTML</title>
|
||||
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para><ulink url="http://www.w3.org/">Le consortium World Wide
|
||||
Web</ulink>,</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><ulink url="http://www.w3.org/TR/REC-html40/">Les spécifications
|
||||
du HTML 4.0</ulink>.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</sect1>
|
||||
|
||||
<sect1>
|
||||
<title>DocBook</title>
|
||||
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para><ulink url="http://www.oreilly.com/davenport/">Le
|
||||
<foreignphrase>Davenport Group</foreignphrase></ulink>, qui
|
||||
maintient la DTD DocBook.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</sect1>
|
||||
|
||||
<sect1>
|
||||
<title>Le Projet de Documentation de Linux</title>
|
||||
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para><ulink url="http://metalab.unc.edu/LDP/">Les pages Web du Projet
|
||||
de Documentation de Linux</ulink>.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</sect1>
|
||||
</chapter>
|
||||
|
||||
<!--
|
||||
Local Variables:
|
||||
mode: sgml
|
||||
sgml-declaration: "../chapter.decl"
|
||||
sgml-indent-data: t
|
||||
sgml-omittag: nil
|
||||
sgml-always-quote-attributes: t
|
||||
sgml-parent-document: ("../book.sgml" "part" "chapter")
|
||||
End:
|
||||
-->
|
||||
|
||||
2356
fr_FR.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml
Normal file
2356
fr_FR.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml
Normal file
File diff suppressed because it is too large
Load diff
1645
fr_FR.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml
Normal file
1645
fr_FR.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml
Normal file
File diff suppressed because it is too large
Load diff
72
fr_FR.ISO8859-1/books/fdp-primer/stylesheets/chapter.sgml
Normal file
72
fr_FR.ISO8859-1/books/fdp-primer/stylesheets/chapter.sgml
Normal file
|
|
@ -0,0 +1,72 @@
|
|||
<!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.
|
||||
|
||||
Redistribution and use in source (SGML DocBook) and 'compiled' forms
|
||||
(SGML HTML, PDF, PostScript, RTF and so forth) with or without
|
||||
modification, are permitted provided that the following conditions
|
||||
are met:
|
||||
|
||||
1. Redistributions of source code (SGML DocBook) must retain the above
|
||||
copyright notice, this list of conditions and the following
|
||||
disclaimer as the first lines of this file unmodified.
|
||||
|
||||
2. Redistributions in compiled form (transformed to other DTDs,
|
||||
converted to PDF, PostScript, RTF and other formats) must reproduce
|
||||
the above copyright notice, this list of conditions and the
|
||||
following disclaimer in the documentation and/or other materials
|
||||
provided with the distribution.
|
||||
|
||||
THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
|
||||
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
||||
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||||
DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
|
||||
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
||||
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
||||
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
||||
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
||||
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
|
||||
POSSIBILITY OF SUCH DAMAGE.
|
||||
|
||||
$Id: chapter.sgml,v 1.1 2000-06-12 15:46:47 gioria Exp $
|
||||
-->
|
||||
|
||||
<chapter id="stylesheets">
|
||||
|
||||
<title>* Feuilles de style</title>
|
||||
|
||||
<para>SGML ne décrit pas comment un document doit être affiché ou imprimé.
|
||||
A cet effet, différents langages ont été conçus pour définir des feuilles
|
||||
de style, dont DynaText, Panorama, SPICE,
|
||||
JSSS, FOSI, CSS, et DSSSL.</para>
|
||||
|
||||
<para>Pour DocBook, nous utilisons des feuilles de style écrites en DSSSL.
|
||||
Pour le HTML, nous utilisons CSS.</para>
|
||||
|
||||
<sect1>
|
||||
<title>* DSSSL</title>
|
||||
|
||||
<para>Le Projet de Documentation utilise une version un minimum
|
||||
personnalisée des feuilles de style DocBook modulaires de Norm
|
||||
Walsh.</para>
|
||||
|
||||
<para>Vous les trouverez dans
|
||||
<filename>textproc/dsssl-docbook-modular</filename>.</para>
|
||||
</sect1>
|
||||
|
||||
<sect1>
|
||||
<title>* CSS</title>
|
||||
|
||||
<para></para>
|
||||
</sect1>
|
||||
</chapter>
|
||||
|
||||
<!--
|
||||
Local Variables:
|
||||
mode: sgml
|
||||
sgml-declaration: "../chapter.decl"
|
||||
sgml-indent-data: t
|
||||
sgml-omittag: nil
|
||||
sgml-always-quote-attributes: t
|
||||
sgml-parent-document: ("../book.sgml" "part" "chapter")
|
||||
End:
|
||||
-->
|
||||
49
fr_FR.ISO8859-1/books/fdp-primer/the-faq/chapter.sgml
Normal file
49
fr_FR.ISO8859-1/books/fdp-primer/the-faq/chapter.sgml
Normal file
|
|
@ -0,0 +1,49 @@
|
|||
<!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.
|
||||
|
||||
Redistribution and use in source (SGML DocBook) and 'compiled' forms
|
||||
(SGML HTML, PDF, PostScript, RTF and so forth) with or without
|
||||
modification, are permitted provided that the following conditions
|
||||
are met:
|
||||
|
||||
1. Redistributions of source code (SGML DocBook) must retain the above
|
||||
copyright notice, this list of conditions and the following
|
||||
disclaimer as the first lines of this file unmodified.
|
||||
|
||||
2. Redistributions in compiled form (transformed to other DTDs,
|
||||
converted to PDF, PostScript, RTF and other formats) must reproduce
|
||||
the above copyright notice, this list of conditions and the
|
||||
following disclaimer in the documentation and/or other materials
|
||||
provided with the distribution.
|
||||
|
||||
THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
|
||||
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
||||
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||||
DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
|
||||
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
||||
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
||||
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
||||
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
||||
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
|
||||
POSSIBILITY OF SUCH DAMAGE.
|
||||
|
||||
$Id: chapter.sgml,v 1.1 2000-06-12 15:46:49 gioria Exp $
|
||||
-->
|
||||
|
||||
<chapter id="the-faq">
|
||||
<title>* La Foire Aux Questions</title>
|
||||
|
||||
<para></para>
|
||||
</chapter>
|
||||
|
||||
<!--
|
||||
Local Variables:
|
||||
mode: sgml
|
||||
sgml-declaration: "../chapter.decl"
|
||||
sgml-indent-data: t
|
||||
sgml-omittag: nil
|
||||
sgml-always-quote-attributes: t
|
||||
sgml-parent-document: ("../book.sgml" "part" "chapter")
|
||||
End:
|
||||
-->
|
||||
|
||||
282
fr_FR.ISO8859-1/books/fdp-primer/the-handbook/chapter.sgml
Normal file
282
fr_FR.ISO8859-1/books/fdp-primer/the-handbook/chapter.sgml
Normal file
|
|
@ -0,0 +1,282 @@
|
|||
<!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.
|
||||
|
||||
Redistribution and use in source (SGML DocBook) and 'compiled' forms
|
||||
(SGML HTML, PDF, PostScript, RTF and so forth) with or without
|
||||
modification, are permitted provided that the following conditions
|
||||
are met:
|
||||
|
||||
1. Redistributions of source code (SGML DocBook) must retain the above
|
||||
copyright notice, this list of conditions and the following
|
||||
disclaimer as the first lines of this file unmodified.
|
||||
|
||||
2. Redistributions in compiled form (transformed to other DTDs,
|
||||
converted to PDF, PostScript, RTF and other formats) must reproduce
|
||||
the above copyright notice, this list of conditions and the
|
||||
following disclaimer in the documentation and/or other materials
|
||||
provided with the distribution.
|
||||
|
||||
THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
|
||||
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
||||
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||||
DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
|
||||
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
||||
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
||||
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
||||
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
||||
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
|
||||
POSSIBILITY OF SUCH DAMAGE.
|
||||
|
||||
$Id: chapter.sgml,v 1.1 2000-06-12 15:46:54 gioria Exp $
|
||||
-->
|
||||
|
||||
<chapter id="the-handbook">
|
||||
<title>* Le Manuel de Référence</title>
|
||||
|
||||
<sect1>
|
||||
<title>Organisation logique</title>
|
||||
|
||||
<para>Le Manuel de Référence est rédigé en conformité avec la DTD DocBook
|
||||
étendue de FreeBSD.</para>
|
||||
|
||||
<para>Le Manuel de Référence est un <sgmltag>book</sgmltag> DocBook. Il
|
||||
est ensuite divisé en <sgmltag>part</sgmltag>s, qui contiennent
|
||||
elles-mêmes plusieurs <sgmltag>chapter</sgmltag>s. Les
|
||||
<sgmltag>chapter</sgmltag>s sont eux-mêmes composés de sections
|
||||
(<sgmltag>sect1</sgmltag>) et sous-sections
|
||||
(<sgmltag>sect2</sgmltag>, <sgmltag>sect3</sgmltag>) et ainsi de
|
||||
suite.</para>
|
||||
</sect1>
|
||||
|
||||
<sect1>
|
||||
<title>Organisation physique</title>
|
||||
|
||||
<para>Le Manuel de Référence (et ses traductions) sont dans le
|
||||
sous-répertoire
|
||||
<filename>doc/<replaceable>langue</replaceable>/handbook</filename>
|
||||
des archives CVS principales. <replaceable>langue</replaceable> est le
|
||||
code ISO pour la langue, <literal>en</literal>, pour l'Anglais,
|
||||
<literal>ja</literal> pour le Japonais, et ainsi de suite.</para>
|
||||
|
||||
<para>Il y a un certain nombre de fichiers et répertoires dans le
|
||||
répertoire <filename>handbook</filename>.</para>
|
||||
|
||||
<note>
|
||||
<para>L'organisation du Manuel de Référence sera peut-être modifiée avec
|
||||
le temps, et le présent document peut ne pas être en phase avec ces
|
||||
changements. Si vous avez des questions sur la façon dont le Manuel de
|
||||
Référence est organisé, contactez s'il vous plaît le Projet de
|
||||
Documentation de FreeBSD, <email>doc@FreeBSD.ORG</email>.</para>
|
||||
</note>
|
||||
|
||||
<sect2>
|
||||
<title><filename>Makefile</filename></title>
|
||||
|
||||
<para>Le <filename>Makefile</filename> décrit les règles utilisées pour
|
||||
convertir le Manuel de Référence à partir du source (DocBook) dans
|
||||
plusieurs formats cibles (dont HTML, PostScript, et texte).</para>
|
||||
|
||||
<para>Le <filename>Makefile</filename> est décrit plus en détail à la
|
||||
<xref linkend="the-handbook-converting">.</para>
|
||||
</sect2>
|
||||
|
||||
<sect2>
|
||||
<title><filename>handbook.sgml</filename></title>
|
||||
|
||||
<para>C'est la racine du Manuel de Référence. Il contient la
|
||||
<link linkend="sgml-primer-doctype-declaration">déclaration
|
||||
DOCTYPE</link> du Manuel, ainsi que les éléments qui décrivent sa
|
||||
structure.</para>
|
||||
|
||||
<para><filename>handbook.sgml</filename> utilise des <link
|
||||
linkend="sgml-primer-parameter-entities">entités paramètres</link>
|
||||
pour charger les fichiers d'extensions <filename>.ent</filename>. Ces
|
||||
fichiers (décrits plus loin) définissent à leur tour des
|
||||
<link linkend="sgml-primer-general-entities">entités générales</link>
|
||||
qui sont elles-mêmes employées dans le reste du Manuel.</para>
|
||||
</sect2>
|
||||
|
||||
<sect2>
|
||||
<title><filename><replaceable>répertoire</replaceable>/chapter.sgml</filename></title>
|
||||
|
||||
<para>Chaque chapitre du manuel est composé d'un fichier
|
||||
<filename>chapter.sgml</filename> dans un sous-répertoire séparé pour
|
||||
chaque chapitre. Chaque répertoire prend le nom de l'attribut
|
||||
<literal>id</literal> de l'élément <sgmltag>chapter</sgmltag>.</para>
|
||||
|
||||
<para>Si par exemple, un des chapitres contient :</para>
|
||||
|
||||
<programlisting><![ CDATA [
|
||||
<chapter id="kernelconfiguration">
|
||||
...
|
||||
</chapter>]]></programlisting>
|
||||
|
||||
<para>il s'appelera alors <filename>chapter.sgml</filename> dans le
|
||||
répertoire <filename>kernelconfiguration</filename>. Habituellement,
|
||||
il y aura un seul fichier pour tout le chapitre.</para>
|
||||
|
||||
<para>A la génération de la version HTML du Manuel, on obtiendra un
|
||||
<filename>kernelconfiguration.html</filename>. C'est dû à la valeur
|
||||
du <literal>id</literal>, et non au nom du répertoire.</para>
|
||||
|
||||
<para>Dans les versions précédentes du Manuel, ces fichiers étaient dans
|
||||
le même répertoire que <filename>handbook.sgml</filename>, avec le
|
||||
même nom que l'attribut <literal>id</literal> de l'élément
|
||||
<sgmltag>chapter</sgmltag> du fichier. Ils ont été déplacés dans des
|
||||
répertoires séparés en prévision des évolutions à venir du Manuel. Il
|
||||
sera en particulier bientôt possible d'inclure des images dans chaque
|
||||
chapitre. Il est donc plus logique que celles-ci soient rangées dans
|
||||
un répertoire où se trouve aussi le texte du chapitre plutôt que de
|
||||
mettre le texte de chaque chapitre, et donc toutes les images dans un
|
||||
même répertoire. Il y aurait fatalement des conflits de nom, alors
|
||||
qu'il est plus facile de travailler avec plusieurs répertoires
|
||||
contenant quelques fichiers qu'avec un seul répertoire dans lequel il
|
||||
y a beaucoup de fichiers.</para>
|
||||
|
||||
<para>Un bref coup d'oeil montre qu'il y a de nombreux répertoires avec
|
||||
chacun un fichier <filename>chapter.sgml</filename> dont
|
||||
<filename>basics/chapter.sgml</filename>,
|
||||
<filename>introduction/chapter.sgml</filename> et
|
||||
<filename>printing/chapter.sgml</filename>.</para>
|
||||
|
||||
<important>
|
||||
<para>Les noms des chapitres et/ou répertoires ne doivent pas faire
|
||||
réference à leur place dans le Manuel. Cet ordre peut changer quand
|
||||
le contenu du Manuel est réorganisé ; ce type de réorganisation
|
||||
ne devrait (normalement) pas entraîner de modification des noms des
|
||||
fichiers (à moins que des chapitres entiers ne changent de niveau
|
||||
dans la hiérarchie).</para>
|
||||
</important>
|
||||
|
||||
<para>Chaque fichier <filename>chapter.sgml</filename> n'est pas un
|
||||
document SGML intégral. Ils n'ont en particulier pas de déclaration
|
||||
DOCTYPE en tête du fichier.</para>
|
||||
|
||||
<para>C'est dommage pour deux raisons :</para>
|
||||
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>Il n'est pas possible de les traiter comme des fichiers SGML
|
||||
et de les convertir en HTML, RTF, PS et autres formats de la même
|
||||
manière que le Manuel. Cela vous <emphasis>oblige</emphasis> à
|
||||
recompiler tout le Manuel chaque fois que vous voulez vérifier les
|
||||
effets d'une modification d'un seul chapitre.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para>Le <literal>sgml-mode</literal> d'Emacs ne peut pas s'en
|
||||
servir pour déterminer quelle DTD utiliser, ce qui fait perdre les
|
||||
bénéfices de fonctionnalités utiles du
|
||||
<literal>sgml-mode</literal> (complétion des éléments, validation
|
||||
automatique, et ainsi de suite).</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
||||
<sect1>
|
||||
<title>Guide de style</title>
|
||||
|
||||
<para>Respectez s'il vous plaît les conventions de style ci-dessous pour
|
||||
garder aux sources du Manuel une consistance malgré les nombreuses
|
||||
personnes qui interviennent dessus.</para>
|
||||
|
||||
<sect2>
|
||||
<title>Majuscules et minuscules</title>
|
||||
|
||||
<para>Les marques doivent être en minuscules
|
||||
<literal><para></literal> et <emphasis>non</emphasis>
|
||||
<literal><PARA></literal>.</para>
|
||||
|
||||
<para>Le texte dans les contextes SGML est normalement en majuscules,
|
||||
<literal><!ENTITY…></literal> ou
|
||||
<literal><!DOCTYPE…></literal> et
|
||||
<emphasis>non</emphasis> <literal><!entity…></literal>
|
||||
ou <literal><!doctype…></literal>.</para>
|
||||
</sect2>
|
||||
|
||||
<sect2>
|
||||
<title>Indentation</title>
|
||||
|
||||
<para>Chaque fichier est indenté à partir de la colonne 0,
|
||||
<emphasis>quel que soit</emphasis> le niveau d'indentation dans le
|
||||
fichier où il est inclus.</para>
|
||||
|
||||
<para>Chaque marque de début augmente l'indentation de 2 blancs et
|
||||
chaque marque de fin la décrémente d'autant. Le contenu des éléments
|
||||
doit être indenté de 2 blancs s'il court sur plusieurs lignes.</para>
|
||||
|
||||
<para>A titre d'exemple, voici à quoi ressemble le source de cette
|
||||
section :</para>
|
||||
|
||||
<programlisting>
|
||||
<![ CDATA [+--- C'est la colonne 0
|
||||
|
||||
<chapter>
|
||||
<title>...</title>
|
||||
|
||||
<sect1>
|
||||
<title>...</title>
|
||||
|
||||
<sect2>
|
||||
<title>Indentation</title>
|
||||
|
||||
<para>Chaque fichier est indenté à partir de la colonne 0,
|
||||
<emphasis>quel que soit</emphasis> le niveau d'indentation dans le
|
||||
fichier où il est inclus.</para>
|
||||
|
||||
<para>Chaque marque de début augmente l'indentation de 2 blancs et
|
||||
chaque marque de fin la décrémente d'autant. Le contenu des éléments
|
||||
doit être indenté de 2 blancs s'il court sur plusieurs lignes.</para>
|
||||
|
||||
...
|
||||
</sect2>
|
||||
</sect1>
|
||||
</chapter>]]></programlisting>
|
||||
|
||||
<para>Si vous vous servez d'<application>Emacs</application> ou
|
||||
<application>Xemacs</application> pour éditer les fichiers, le
|
||||
<literal>sgml-mode</literal> doit être chargé automatiquement, et les
|
||||
variables Emacs locales en fin de chaque fichier doivent mettre ces
|
||||
indentations en pratique.</para>
|
||||
</sect2>
|
||||
|
||||
<sect2>
|
||||
<title>Modifications de présentation des sources</title>
|
||||
|
||||
<para>Quand vous intégrez des modifications, <emphasis>ne faites pas en
|
||||
même temps de modification de contenu et de présentation des
|
||||
sources</emphasis>.</para>
|
||||
|
||||
<para>Cela pour que les équipes de traductions du Manuel puissent
|
||||
rapidement voir les modifications de contenu que vous avez intégrées,
|
||||
sans avoir à se demander si une ligne a changé de contenu ou
|
||||
simplement de présentation.</para>
|
||||
|
||||
<para>Si vous avez par exemple ajouté deux phrases à un paragraphe, de
|
||||
sorte que les lignes du paragraphe débordent maintenant des 80
|
||||
colonnes, intégrez d'abord la modification avec les lignes trop
|
||||
longues. Puis corrigez ensuite ce problème, en précisant qu'il ne
|
||||
s'agit que d'une modification de présentation, dont les équipes de
|
||||
traduction n'ont pas à se soucier.</para>
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
||||
<sect1 id="the-handbook-converting">
|
||||
<title>* Conversion du Manuel dans d'autres formats</title>
|
||||
|
||||
<para></para>
|
||||
</sect1>
|
||||
</chapter>
|
||||
|
||||
<!--
|
||||
Local Variables:
|
||||
mode: sgml
|
||||
sgml-declaration: "../chapter.decl"
|
||||
sgml-indent-data: t
|
||||
sgml-omittag: nil
|
||||
sgml-always-quote-attributes: t
|
||||
sgml-parent-document: ("../book.sgml" "part" "chapter")
|
||||
End:
|
||||
-->
|
||||
|
||||
49
fr_FR.ISO8859-1/books/fdp-primer/the-website/chapter.sgml
Normal file
49
fr_FR.ISO8859-1/books/fdp-primer/the-website/chapter.sgml
Normal file
|
|
@ -0,0 +1,49 @@
|
|||
<!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.
|
||||
|
||||
Redistribution and use in source (SGML DocBook) and 'compiled' forms
|
||||
(SGML HTML, PDF, PostScript, RTF and so forth) with or without
|
||||
modification, are permitted provided that the following conditions
|
||||
are met:
|
||||
|
||||
1. Redistributions of source code (SGML DocBook) must retain the above
|
||||
copyright notice, this list of conditions and the following
|
||||
disclaimer as the first lines of this file unmodified.
|
||||
|
||||
2. Redistributions in compiled form (transformed to other DTDs,
|
||||
converted to PDF, PostScript, RTF and other formats) must reproduce
|
||||
the above copyright notice, this list of conditions and the
|
||||
following disclaimer in the documentation and/or other materials
|
||||
provided with the distribution.
|
||||
|
||||
THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
|
||||
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
||||
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||||
DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
|
||||
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
||||
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
||||
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
||||
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
||||
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
|
||||
POSSIBILITY OF SUCH DAMAGE.
|
||||
|
||||
$Id: chapter.sgml,v 1.1 2000-06-12 15:46:59 gioria Exp $
|
||||
-->
|
||||
|
||||
<chapter id="the-website">
|
||||
<title>* Le site Web</title>
|
||||
|
||||
<para></para>
|
||||
</chapter>
|
||||
|
||||
<!--
|
||||
Local Variables:
|
||||
mode: sgml
|
||||
sgml-declaration: "../chapter.decl"
|
||||
sgml-indent-data: t
|
||||
sgml-omittag: nil
|
||||
sgml-always-quote-attributes: t
|
||||
sgml-parent-document: ("../book.sgml" "part" "chapter")
|
||||
End:
|
||||
-->
|
||||
|
||||
301
fr_FR.ISO8859-1/books/fdp-primer/tools/chapter.sgml
Normal file
301
fr_FR.ISO8859-1/books/fdp-primer/tools/chapter.sgml
Normal file
|
|
@ -0,0 +1,301 @@
|
|||
<!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.
|
||||
|
||||
Redistribution and use in source (SGML DocBook) and 'compiled' forms
|
||||
(SGML, HTML, PDF, PostScript, RTF and so forth) with or without
|
||||
modification, are permitted provided that the following conditions
|
||||
are met:
|
||||
|
||||
1. Redistributions of source code (SGML DocBook) must retain the above
|
||||
copyright notice, this list of conditions and the following
|
||||
disclaimer as the first lines of this file unmodified.
|
||||
|
||||
2. Redistributions in compiled form (transformed to other DTDs,
|
||||
converted to PDF, PostScript, RTF and other formats) must reproduce
|
||||
the above copyright notice, this list of conditions and the
|
||||
following disclaimer in the documentation and/or other materials
|
||||
provided with the distribution.
|
||||
|
||||
THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
|
||||
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
||||
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||||
DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
|
||||
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
||||
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
||||
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
||||
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
||||
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
|
||||
POSSIBILITY OF SUCH DAMAGE.
|
||||
|
||||
The FreeBSD Documentation Project
|
||||
The FreeBSD French Documentation Project
|
||||
|
||||
$Id: chapter.sgml,v 1.1 2000-06-12 15:47:01 gioria Exp $
|
||||
Original revision: 1.6
|
||||
-->
|
||||
|
||||
<chapter id="tools">
|
||||
<title>Outils</title>
|
||||
|
||||
<para>Le FDP utilise un certain nombre de logiciels pour faciliter la
|
||||
gestion de la documentation de FreeBSD, la convertir en différents
|
||||
formats, et ainsi de suite. Vous devrez vous-même vous servir de ces
|
||||
outils, si vous travaillez à la documentation de FreeBSD.</para>
|
||||
|
||||
<para>Tous ces outils existent sous forme de logiciels portés ou
|
||||
pré-compilés pour FreeBSD, ce qui vous simplifie beaucoup la tâche de leur
|
||||
installation.</para>
|
||||
|
||||
<para>Vous devrez les installer avant de mettre en pratique les exemples
|
||||
donnés dans les chapitres suivants. Ces chapitres vous expliquent comment
|
||||
vous servir de ces outils.</para>
|
||||
|
||||
<important>
|
||||
<title>Utilisez <filename>textproc/docproj</filename> si possible</title>
|
||||
|
||||
<para>Vous pouvez gagner beaucoup de temps si vous les installez avec
|
||||
<filename>textproc/docproj</filename>. C'est un
|
||||
<emphasis>méta-port</emphasis> qui ne contient pas lui-même de
|
||||
logiciels. Au lieu de cela, il dépend de l'installation correcte de
|
||||
divers autres logiciels portés. Son installation
|
||||
<emphasis>devrait</emphasis> télécharger et installer automatiquement
|
||||
tous les paquetages listés dans ce chapitre dont vous aurez besoin,
|
||||
s'ils n'existent pas déjà sur votre système.</para>
|
||||
|
||||
<para>L'un des paquetages dont vous aurez peut-être besoin est le jeu de
|
||||
macro-instructions JadeTeX. Celui-ci, à son tour, a besoin que TeX soit
|
||||
installé. TeX est un paquetage volumineux, dont vous n'aurez besoin que
|
||||
si vous voulez générer les versions PostScript et PDF.</para>
|
||||
|
||||
<para>Pour économiser du temps et de l'espace disque, vous pouvez préciser
|
||||
si vous voulez ou non installer JadeTeX (et donc TeX). Faites
|
||||
soit :</para>
|
||||
|
||||
<informalexample>
|
||||
<screen>&prompt.root; <userinput>make JADETEX=yes install</userinput></screen>
|
||||
</informalexample>
|
||||
|
||||
<para>ou :</para>
|
||||
|
||||
<informalexample>
|
||||
<screen>&prompt.root; <userinput>make JADETEX=no install</userinput></screen>
|
||||
</informalexample>
|
||||
|
||||
<para>selon le cas.</para>
|
||||
</important>
|
||||
|
||||
<sect1>
|
||||
<title>Outils indispensables</title>
|
||||
|
||||
<sect2>
|
||||
<title>Logiciels</title>
|
||||
|
||||
<para>Vous aurez besoin de ces programmes avant de pouvoir utilement
|
||||
travailler sur la documentation de FreeBSD. Ils font tous partie de
|
||||
<filename>textproc/docproj</filename>.</para>
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><application>SP</application>
|
||||
(<filename>textproc/sp</filename>)</term>
|
||||
|
||||
<listitem>
|
||||
<para>Une série d'applications, dont un analyseur syntaxique SGML
|
||||
et un outil de normalisation du source SGML.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><application>Jade</application>
|
||||
(<filename>textproc/jade</filename>)</term>
|
||||
|
||||
<listitem>
|
||||
<para>Une implémentation des DSSSL. Cela sert à convertir des
|
||||
documents marqués vers d'autres formats, dont HTML et
|
||||
TeX.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><application>Tidy</application>
|
||||
(<filename>www/tidy</filename>)</term>
|
||||
|
||||
<listitem>
|
||||
<para>Un formateur HTML, qui sert à remettre en forme le code HTML
|
||||
généré automatiquement pour qu'il soit plus lisible.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><application>Lynx</application>
|
||||
(<filename>www/lynx-current</filename>)</term>
|
||||
|
||||
<listitem>
|
||||
<para>Navigateur WWW en mode texte, &man.lynx.1; peut aussi
|
||||
convertir des fichiers HTML en fichiers texte.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
</sect2>
|
||||
|
||||
<sect2>
|
||||
<title>DTDs et Entités</title>
|
||||
|
||||
<para>Ce sont les DTDs et jeux d'entités utilisés par le FDP. Il faut
|
||||
les installer avant de pouvoir travailler à la documentation.</para>
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term>DTD HTML (<filename>textproc/html</filename>)</term>
|
||||
|
||||
<listitem>
|
||||
<para>HTML est le langage principal du <foreignphrase>World Wide
|
||||
Web</foreignphrase>, il est utilisé constamment par le site
|
||||
Web de FreeBSD.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term>DTD LinuxDoc
|
||||
(<filename>textproc/linuxdoc</filename>)</term>
|
||||
|
||||
<listitem>
|
||||
<para>Une partie de la documentation de FreeBSD est marquée avec
|
||||
LinuxDoc. Le FDP migre activement de LinuxDoc à DocBook.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term>DTD DocBook
|
||||
(<filename>textproc/docbook</filename>)</term>
|
||||
|
||||
<listitem>
|
||||
<para>DocBook est conçu pour le marquage de documentation
|
||||
technique et le FDP est en cours de migration de LinuxDoc à
|
||||
DocBook. A la date de rédaction de cette documentation, celle-ci
|
||||
et le Manuel de Référence de FreeBSD sont au format
|
||||
DocBook.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term>Entités ISO 8879
|
||||
(<filename>textproc/iso8879</filename>)</term>
|
||||
|
||||
<listitem>
|
||||
<para>19 de jeux de caractères ISO 8879:1986 utilisés par de
|
||||
nombreuses DTDs. Cela comprend des symboles mathématiques
|
||||
nommés, les caractères “latins” supplémentaires
|
||||
(accents, signes diacritiques et ainsi de suite) et les lettres
|
||||
grecques.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
</sect2>
|
||||
|
||||
<sect2>
|
||||
<title>Feuilles de style</title>
|
||||
|
||||
<para>Les feuilles de style sont utilisées pour convertir et formater
|
||||
la documentation pour l'affichage à l'écran, l'impression, et ainsi de
|
||||
suite.</para>
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term>Les <foreignphrase>Modular DocBook Stylesheets</foreignphrase>
|
||||
(<filename>textproc/dsssl-docbook-modular</filename>)</term>
|
||||
|
||||
<listitem>
|
||||
<para>Les <foreignphrase>Modular DocBook
|
||||
Stylesheets</foreignphrase> sont utilisées pour convertir la
|
||||
documentation marqué en DocBook aux autres formats, comme HTML
|
||||
ou RTF.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
||||
<sect1>
|
||||
<title>Outils facultatifs</title>
|
||||
|
||||
<para>Il n'est pas obligatoire d'installer les outils qui suivent. Si vous
|
||||
le faites cependant, vous trouverez peut-être plus facile de travailler
|
||||
à la documentation et ils vous donneront plus de possibilité de choix du
|
||||
format de sortie.</para>
|
||||
|
||||
<sect2>
|
||||
<title>Logiciels</title>
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><application>JadeTeX</application> et
|
||||
<application>teTeX</application>
|
||||
(<filename>print/jadetex</filename> et
|
||||
<filename>print/teTeX</filename>)</term>
|
||||
|
||||
<listitem>
|
||||
<para><application>Jade</application> et
|
||||
<application>teTeX</application> servent à convertir les
|
||||
documents DocBook en DVI, Postscript et PDF. Il faut pour cela
|
||||
les macro-instructions
|
||||
<application>JadeTeX</application>.</para>
|
||||
|
||||
<para>Si vous n'avez pas l'intention de convertir votre
|
||||
documentation à l'un de ces formats (i.e., HTML, texte et RTF
|
||||
vous suffisent), il n'est pas nécessaire d'installer
|
||||
<application>JadeTeX</application> et
|
||||
<application>teTeX</application>. Cela vous fera gagner du temps
|
||||
et de l'espace disque, <application>teTeX</application>, en
|
||||
effet occupe plus de 30 Mo.</para>
|
||||
|
||||
<important>
|
||||
<para>Si vous choisissez d'installer
|
||||
<application>JadeTeX</application> et
|
||||
<application>teTeX</application>, vous devrez configurer
|
||||
<application>teTeX</application> après avoir installé
|
||||
<application>JadeTeX</application>.
|
||||
<filename>print/jadetex/pkg/MESSAGE</filename> vous donnera
|
||||
des instructions détaillées sur la façon de procéder.</para>
|
||||
</important>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><application>Emacs</application> ou
|
||||
<application>xemacs</application>
|
||||
(<filename>editors/emacs</filename> ou
|
||||
<filename>editors/xemacs</filename>)</term>
|
||||
|
||||
<listitem>
|
||||
<para>Ces deux éditeurs ont un mode spécialisé pour travailler sur
|
||||
des documents marqués conformément à une DTD SGML. Cela vous
|
||||
permet d'avoir moins de choses à saisir et limite la possibilité
|
||||
d'erreurs.</para>
|
||||
|
||||
<para>Vous n'êtes pas obligé de les utiliser, n'importe quel
|
||||
éditeur peut servir avec des documents marqués. Mais vous
|
||||
trouverez peut-être qu'ils vous permettent d'être plus
|
||||
efficace.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
|
||||
<para>Si quelqu'un a d'autres outils utiles pour manipuler des documents
|
||||
SGML, merci de transmettre l'information à Nik Clayton
|
||||
(nik@freebsd.org), de façon à ce qu'il les ajoute à cette
|
||||
liste.</para>
|
||||
</sect2>
|
||||
</sect1>
|
||||
</chapter>
|
||||
|
||||
<!--
|
||||
Local Variables:
|
||||
mode: sgml
|
||||
sgml-declaration: "../chapter.decl"
|
||||
sgml-indent-data: t
|
||||
sgml-omittag: nil
|
||||
sgml-always-quote-attributes: t
|
||||
sgml-parent-document: ("../book.sgml" "part" "chapter")
|
||||
End:
|
||||
-->
|
||||
497
fr_FR.ISO8859-1/books/fdp-primer/translations/chapter.sgml
Normal file
497
fr_FR.ISO8859-1/books/fdp-primer/translations/chapter.sgml
Normal file
|
|
@ -0,0 +1,497 @@
|
|||
<!-- Copyright (c) 1999 Nik Clayton, All rights reserved.
|
||||
|
||||
Redistribution and use in source (SGML DocBook) and 'compiled' forms
|
||||
(SGML HTML, PDF, PostScript, RTF and so forth) with or without
|
||||
modification, are permitted provided that the following conditions
|
||||
are met:
|
||||
|
||||
1. Redistributions of source code (SGML DocBook) must retain the above
|
||||
copyright notice, this list of conditions and the following
|
||||
disclaimer as the first lines of this file unmodified.
|
||||
|
||||
2. Redistributions in compiled form (transformed to other DTDs,
|
||||
converted to PDF, PostScript, RTF and other formats) must reproduce
|
||||
the above copyright notice, this list of conditions and the
|
||||
following disclaimer in the documentation and/or other materials
|
||||
provided with the distribution.
|
||||
|
||||
THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
|
||||
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
||||
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||||
DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
|
||||
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
||||
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
||||
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
||||
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
||||
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
|
||||
POSSIBILITY OF SUCH DAMAGE.
|
||||
|
||||
$Id: chapter.sgml,v 1.1 2000-06-12 15:47:06 gioria Exp $
|
||||
-->
|
||||
|
||||
<chapter id="translations">
|
||||
<title>Traductions</title>
|
||||
|
||||
<para>Ceci est la Foire aux Questions pour les gens qui traduisent la
|
||||
documentation de FreeBSD (FAQ, Manuel de Référence, guides, pages de
|
||||
manuel et autres) en différentes langues.</para>
|
||||
|
||||
<para>Elle est <emphasis>très</emphasis> largement basée sur la FAQ du
|
||||
Projet Allemand de Documentation de FreeBSD, rédigée à l'origine par
|
||||
Frank Grnder <email>elwood@mc5sys.in-berlin.de</email> et traduite en
|
||||
Anglais par Bernd Warken <email>bwarken@mayn.de</email>.</para>
|
||||
|
||||
<para>Nik Clayton <email>nik@FreeBSD.org</email> maintient cette FAQ.</para>
|
||||
|
||||
<qandaset>
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>Pourquoi une FAQ ?</para>
|
||||
</question>
|
||||
|
||||
<answer>
|
||||
<para>De plus en plus de gens s'adressent à la &a.doc; et se proposent
|
||||
de traduire en d'autres langues la documentation de FreeBSD. Le but
|
||||
de cette FAQ est de répondre à leurs questions de façon à ce qu'ils
|
||||
puissent commencer le plus rapidement possible à traduire la
|
||||
documentation.</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>Que signfient <phrase>i18n</phrase> et
|
||||
<phrase>l10n</phrase> ?</para>
|
||||
</question>
|
||||
|
||||
<answer>
|
||||
<para><phrase>i18n</phrase> veut dire
|
||||
<phrase>internationalisation</phrase> et <phrase>l10n</phrase>
|
||||
<phrase>localisation</phrase>. Ce ne sont que des abréviations
|
||||
commodes.</para>
|
||||
|
||||
<para><phrase>i18n</phrase> se lit “i” suivi de 18
|
||||
lettres, suivies d'un “n”. De la même façon,
|
||||
<phrase>l10n</phrase> se lit “l” suivi de 10 lettres,
|
||||
suivies d'un “n”.</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>Y-a-t-il une liste de diffusion pour les
|
||||
traducteurs ?</para>
|
||||
</question>
|
||||
|
||||
<answer>
|
||||
<para>Oui, <email>freebsd-translate@ngo.org.uk</email>. Inscrivez-vous
|
||||
en envoyant un message à
|
||||
<email>freebsd-translate-request@ngo.org.uk</email> avec le mot
|
||||
<literal>subscribe</literal> dans le texte du message.</para>
|
||||
|
||||
<para>Vous recevrez une réponse vous demandant de confirmer votre
|
||||
inscription (de la même façon que pour les listes de FreeBSD sur
|
||||
<hostid role="domainname">FreeBSD.org</hostid>).</para>
|
||||
|
||||
<para>La langue de base sur la liste est l'Anglais, mais les messages
|
||||
en d'autres langues sont acceptés. La liste n'est pas modérée, mais
|
||||
vous devez vous y être inscrit avant d'y adresser des
|
||||
messages.</para>
|
||||
|
||||
<para>La liste est archivée, mais il n'est pas actuellement possible
|
||||
d'y faire des recherches. Vous aurez en retour des explications sur
|
||||
la façon d'accéder aux archives en envoyant le message
|
||||
<literal>help</literal> à
|
||||
<email>majordomo@ngo.org.uk</email>.</para>
|
||||
|
||||
<para>Il est prévue que la liste de diffusion soit transférée sur
|
||||
<hostid role="domainname">FreeBSD.org</hostid> et devienne donc
|
||||
<emphasis>officielle</emphasis> dans un avenir proche.</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>A-t-on besoin de nouveaux traducteurs ?</para>
|
||||
</question>
|
||||
|
||||
<answer>
|
||||
<para>Oui. Plus il y a de gens qui travaillent aux traductions, plus
|
||||
vite elles sont réalisées, et synchronisées avec les modifications
|
||||
de la version anglaise.</para>
|
||||
|
||||
<para>Il n'est pas nécessaire que vous soyez traducteur professionnel
|
||||
pour pouvoir contribuer.</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>Quelle langue faut-il que je connaisse ?</para>
|
||||
</question>
|
||||
|
||||
<answer>
|
||||
<para>Dans l'idéal, il faudrait que vous ayez une bonne connaissance
|
||||
de l'anglais écrit et bien sûr, il faut que vous pratiquiez
|
||||
couramment la langue dans laquelle vous traduisez.</para>
|
||||
|
||||
<para>L'anglais n'est pas strictement indispensable. Vous pourriez par
|
||||
exemple effectuez une traduction en Hongrois, à partir de la
|
||||
traduction espagnole de la FAQ.</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>Quels logiciels faut-il que je connaisse ?</para>
|
||||
</question>
|
||||
|
||||
<answer>
|
||||
<para>Il est fortement recommandé que vous teniez à jour une copie
|
||||
locale des archives CVS de FreeBSD (au moins de la documentation),
|
||||
soit à l'aide de <application>CTM</application>, soit en utilisant
|
||||
<application>CVSup</application>. Le chapitre “Se synchroniser
|
||||
avec la version <literal>-current</literal> de FreeBSD” du
|
||||
Manuel de Référence vous explique comment utiliser ces
|
||||
logiciels.</para>
|
||||
|
||||
<para>Il faudra que vous soyiez à l'aise avec
|
||||
<application>CVS</application>. Cela vous permettra de suivre les
|
||||
modifications apportées entre les différentes versions des
|
||||
fichiers qui constituent la documentation.</para>
|
||||
|
||||
<para>[A Faire -- écrire un mode d'emploi qui explique comment
|
||||
utiliser <application>CVSup</application> pour ne récupérer que la
|
||||
documentation, et voir ce qui a évolué entre deux versions
|
||||
données]</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>Comment savoir qui d'autre traduit la documentation dans la
|
||||
même langue ?</para>
|
||||
</question>
|
||||
|
||||
<answer>
|
||||
<para>La <ulink
|
||||
url="http://www.freebsd.org/docproj/translations.html">page des
|
||||
traductions du Projet de Documentation</ulink> liste les traductions
|
||||
en cours déjà connues. S'il y a déjà d'autres personnes qui
|
||||
travaillent à la traduction de documentation dans votre langue, s'il
|
||||
vous plaît, ne faites pas le même travail qu'eux en double. Au lieu
|
||||
de cela, prenez contact avec eux, pour savoir comment vous pouvez
|
||||
les aider.</para>
|
||||
|
||||
<para>S'il la page n'indique personne qui travaille dans votre langue,
|
||||
envoyez un message à la &a.doc; au cas où quelqu'un aurait déjà
|
||||
envisagé de commencer une traduction, mais que ne ce soit pas encore
|
||||
signalé.</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>Il n'y a personne d'autre qui traduise dans ma langue. Que
|
||||
faire ?</para>
|
||||
</question>
|
||||
|
||||
<answer>
|
||||
<para>Félicitations, vous venez juste de lancer le “Projet de
|
||||
Documentation <replaceable>dans-votre-langue</replaceable> de
|
||||
FreeBSD. Bien venu à bord.</para>
|
||||
|
||||
<para>Commencez par vous assurer que vous avez bien du temps
|
||||
disponible. Comme vous êtes pour le moment le seul volontaire pour
|
||||
la traduction dans votre langue, il sera de votre responsabilité
|
||||
de publier votre travail et de coordonner celui d'autres personnes
|
||||
qui voudraient y collaborer.</para>
|
||||
|
||||
<para>Envoyez un courrier électronique à la &a.doc; pour annoncer que
|
||||
vous allez traduire la documentation de façon à ce que la pages des
|
||||
traductions du Projet de Documentation puisse être tenue à
|
||||
jour.</para>
|
||||
|
||||
<para>Il faudra vous inscrire à la liste de diffusion
|
||||
<email>freebsd-translate@ngo.org.uk</email> (comme expliqué plus
|
||||
haut).</para>
|
||||
|
||||
<para>S'il y a déjà dans votre pays quelqu'un qui maintienne un site
|
||||
miroir de FreeBSD, vous devriez le contacter et voir s'il peut vous
|
||||
fournir un hébergement pour votre projet et, si possible, une
|
||||
adresse de courrier électronique et la possibilité de mettre en
|
||||
place une liste de diffusion.</para>
|
||||
|
||||
<para>Choisissez ensuite une documentation et commencez la traduction.
|
||||
Il vaut mieux commencer par quelque chose de pas trop
|
||||
volumineux—soit la FAQ, soit l'un des guides.</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>J'ai traduit une documentation, à qui dois-je
|
||||
l'envoyer ?</para>
|
||||
</question>
|
||||
|
||||
<answer>
|
||||
<para>Cela dépend. Si vous travaillez déjà au sein d'une équipe de
|
||||
traduction (comme l'équipe Japonaise ou l'équipe Allemande), elle
|
||||
aura ses propres procédures pour gérer la documentation soumise, qui
|
||||
seront décrites dans ses pages Web.</para>
|
||||
|
||||
<para>Si vous êtes la seule personne à travailler dans une langue
|
||||
donnée (ou si vous êtes responsable d'un projet de traduction et
|
||||
voulez soumettre votre travail au Projet FreeBSD), vous devez alors
|
||||
l'envoyer au Projet FreeBSD (voir la question suivante).</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>Je suis la seule personne à traduire dans cette langue, comment
|
||||
soumettre mes traductions ?</para>
|
||||
|
||||
<para>ou</para>
|
||||
|
||||
<para>Nous sommes une équipe de traduction et voulons soumettre les
|
||||
traductions de nos membres ?</para>
|
||||
</question>
|
||||
|
||||
<answer>
|
||||
<para>Commencez par vérifier que vos traductions sont correctement
|
||||
structurées. C'est-à-dire qu'elles doivent s'intégrer à
|
||||
l'arborescence des documentations existantes et compiler sans
|
||||
problèmes.</para>
|
||||
|
||||
<para>La documentation de FreeBSD est actuellement archivée dans les
|
||||
répertoires en dessous de <filename>doc/</filename>. Les
|
||||
sous-répertoires de celui-ci prennent le nom codifiant la langue
|
||||
dans laquelle les documentations sont écrites, selon la norme
|
||||
ISO639 (<filename>/usr/share/misc/iso639</filename>, pour les
|
||||
versions de FreeBSD postérieures au 20 Janvier 1999).</para>
|
||||
|
||||
<para>S'il ya a différentes codifications pour votre langue
|
||||
(le Chinois,par exemple), il y aura au niveau en-dessous plusieurs
|
||||
sous-répertoires, un pour chacun des formats de codage que vous
|
||||
aurez fournis.</para>
|
||||
|
||||
<para>Vous aurez enfin des sous-répertoires pour chaque
|
||||
document.</para>
|
||||
|
||||
<para>Une éventuelle traduction en Suédois ressemblerait par exemple
|
||||
à ce qui suit :</para>
|
||||
|
||||
<programlisting> doc/
|
||||
sv/
|
||||
Makefile
|
||||
FAQ/
|
||||
Makefile
|
||||
*.sgml</programlisting>
|
||||
|
||||
<para><literal>sv</literal> est le code ISO639 pour le Suédois.
|
||||
Remarquez les deux <filename>Makefile</filename>s, qui servent à
|
||||
compiler la documentation. Il n'y a qu'une seule façon de coder le
|
||||
Suédois, il n'y a donc pas de niveau intermédiaire entre
|
||||
les répertoires <filename>sv</filename> et
|
||||
<filename>FAQ</filename><footnote><para>Cette organisation va
|
||||
radicalement changer très bientôt. Suivez ce qui ce dit sur la
|
||||
&a.doc; pour plus d'information.</para></footnote>.</para>
|
||||
|
||||
<para>Utilisez &man.tar.1; et &man.gzip.1; pour compresser votre
|
||||
documentation, et envoyez-la au projet.</para>
|
||||
|
||||
<screen>&prompt.user; <userinput>cd doc</userinput>
|
||||
&prompt.user; <userinput>tar cf swedish-docs.tar sv</userinput>
|
||||
&prompt.user; <userinput>gzip -9 swedish-docs.tar</userinput></screen>
|
||||
|
||||
<para>Mettez <filename>swedish-docs.tar.gz</filename> quelque part. Si
|
||||
vous ne disposez pas d'espace sur le Web (votre fournisseur d'accès
|
||||
n'en met peut-être pas à votre disposition), vous pouvez envoyer un
|
||||
courrier électronique à &a.nik;, pour vous mettre d'accord sur une
|
||||
date pour les lui envoyer par courrier.</para>
|
||||
|
||||
<para>De quelque façon que vous procédiez, il faudra que vous utilisez
|
||||
&man.send-pr.1; pour envoyer un rapport signalant que vous avez
|
||||
soumis de la documentation. Il serait très utile que d'autres
|
||||
puissent relire votre traduction d'abord, parce qu'il y a peu de
|
||||
chances que la personne qui l'intégrera connaisse bien votre
|
||||
langue.</para>
|
||||
|
||||
<para>Quelqu'un (probablement le Responsbale du Projet de
|
||||
Documentation, &a.nik; actuellement), récupérera votre traduction et
|
||||
s'assurera qu'elle compile. En particulier, les points suivants
|
||||
seront examinés :</para>
|
||||
|
||||
<orderedlist>
|
||||
<listitem>
|
||||
<para>Tous vos fichiers utilisent-ils de chaînes RCS (comme
|
||||
“ID”).</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><command>make all</command> fonctionne-t-il correctement
|
||||
dans le répertoire <filename>sv</filename>.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><command>make install</command> fonctionne-t-il
|
||||
correctement.</para>
|
||||
</listitem>
|
||||
</orderedlist>
|
||||
|
||||
<para>S'il y a des problèmes, la personne qui examine votre soumission
|
||||
vous en fera part pour que vous essayiez de les régler.</para>
|
||||
|
||||
<para>S'il n'y a pas de problèmes, votre traduction sera intégrée
|
||||
aussi vite que possible.</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>Puis-je inclure dans mon texte des considérations propres à la
|
||||
langue ou au pays ?</para>
|
||||
</question>
|
||||
|
||||
<answer>
|
||||
<para>Nous préférerions que vous ne le fassiez pas.</para>
|
||||
|
||||
<para>Supposons par exemple que vous traduisiez le Manuel de Référence
|
||||
en Coréen et que vous vouliez inclure une section sur les revendeurs
|
||||
en Corée dans votre Manuel.</para>
|
||||
|
||||
<para>Il n'y a pas vraiment de raison pour que cette information
|
||||
ne soit pas aussi présente dans la version anglaise (ou allemande,
|
||||
espagnole, …). Il se peut qu'un anglophone ait besoin d'un
|
||||
exemplaire de FreeBSD alors qu'il se trouve en Corée. Cela permet
|
||||
aussi de mettre en avant la pénétration de FreeBSD dans le monde
|
||||
entier, ce qui n'est pas une mauvaise chose.</para>
|
||||
|
||||
<para>Si vous avez des informations propres à un pays donné,
|
||||
soumettez-les d'abord sous forme de modifications à la version
|
||||
anglaise du Manuel de Référence (avec &man.send-pr.1;) et
|
||||
traduisez-les ensuite dans votre langue dans le Manuel de
|
||||
Référence dans cette langue.</para>
|
||||
|
||||
<para>Merci.</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>Comment faut-il coder les caractères propres à une
|
||||
langue ?</para>
|
||||
|
||||
<para>Dans les documentations, les caractères Non-ASCII doivent
|
||||
apparaître sous forme d'entités SGML.</para>
|
||||
|
||||
<para>Brièvement, celles-ci sont constituées d'une perluette (&),
|
||||
du nom de l'entité, et d'un point-virgule (;).</para>
|
||||
|
||||
<para>Les noms des entités sont définis par la norme ISO8879, que vous
|
||||
trouverez dans le catalogue des logiciels portés, sous
|
||||
<filename>textproc/iso8879</filename>.</para>
|
||||
|
||||
<para>Voici quelques examples :</para>
|
||||
|
||||
<segmentedlist>
|
||||
<seglistitem>
|
||||
<seg>&eacute;</seg>
|
||||
<seg>é</seg>
|
||||
<seg>“e” accent aigu minuscule</seg>
|
||||
</seglistitem>
|
||||
|
||||
<seglistitem>
|
||||
<seg>&Eacute;</seg>
|
||||
<seg>É</seg>
|
||||
<seg>“e” accent aigu majuscule</seg>
|
||||
</seglistitem>
|
||||
|
||||
<seglistitem>
|
||||
<seg>&uuml;</seg>
|
||||
<seg>ü</seg>
|
||||
<seg>“u” tréma minuscule</seg>
|
||||
</seglistitem>
|
||||
</segmentedlist>
|
||||
|
||||
<para>Après installation du logiciel porté “iso8879”, le
|
||||
fichier <filename>/usr/local/share/sgml/iso8879</filename> en donne
|
||||
la liste complète.</para>
|
||||
</question>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>Comment doit-on s'adresser au lecteur ?</para>
|
||||
</question>
|
||||
|
||||
<answer>
|
||||
<para>Dans les documents anglais, le
|
||||
“<foreignphrase>you</foreignphrase>” est employé, il n'y
|
||||
a qu'une seule forme, à l'inverse d'autres langues.</para>
|
||||
|
||||
<para>Si vous traduisez dans une langue qui dispose de plusieurs
|
||||
formes, utilisez celle que l'on emploie habituellement dans les
|
||||
documentations techniques. En cas de doute, servez-vous d'une forme
|
||||
de politesse courante.</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>Y'a-t-il des informations supplémentaires à inclure dans les
|
||||
traductions ?</para>
|
||||
</question>
|
||||
|
||||
<answer>
|
||||
<para>Oui.</para>
|
||||
|
||||
<para>Les en-têtes de la version anglaise du document ressembleront à
|
||||
ceci :</para>
|
||||
|
||||
<programlisting><![ CDATA [<!--
|
||||
The FreeBSD Documentation Project
|
||||
|
||||
$Id: chapter.sgml,v 1.11 1999/06/20 21:18:57 billf Exp $
|
||||
-->]]></programlisting>
|
||||
|
||||
<para>La forme exacte peut changer, mais elles comporteront toujours
|
||||
la ligne “Id” et la phrase <literal>The FreeBSD
|
||||
Documentation Project</literal>.</para>
|
||||
|
||||
<para>Vos traductions doivent comporter leur propre ligne
|
||||
“Id” et <literal>FreeBSD Documentation Project</literal>
|
||||
doit être remplacé par <literal>The FreeBSD
|
||||
<replaceable>Langue</replaceable> Documentation
|
||||
Project</literal>.</para>
|
||||
|
||||
<para>Vous devrez aussi ajouter une troisième ligne qui donne la
|
||||
version anglaise d'origine sur laquelle est basée la
|
||||
traduction.</para>
|
||||
|
||||
<para>Donc, la version espagnole du présent fichier commencerait
|
||||
par :</para>
|
||||
|
||||
<programlisting><![ CDATA [<!--
|
||||
The FreeBSD Spanish Documentation Project
|
||||
|
||||
$Id: chapter.sgml,v 1.3 1999/06/24 19:12:32 jesusr Exp $
|
||||
Original revision: 1.11
|
||||
-->]]></programlisting>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
</qandaset>
|
||||
</chapter>
|
||||
|
||||
<!--
|
||||
Local Variables:
|
||||
mode: sgml
|
||||
sgml-declaration: "../chapter.decl"
|
||||
sgml-indent-data: t
|
||||
sgml-omittag: nil
|
||||
sgml-always-quote-attributes: t
|
||||
sgml-parent-document: ("../book.sgml" "part" "chapter")
|
||||
End:
|
||||
-->
|
||||
149
fr_FR.ISO8859-1/books/fdp-primer/writing-style/chapter.sgml
Normal file
149
fr_FR.ISO8859-1/books/fdp-primer/writing-style/chapter.sgml
Normal file
|
|
@ -0,0 +1,149 @@
|
|||
<!-- Copyright (c) 1998 Nik Clayton, All rights reserved.
|
||||
|
||||
Redistribution and use in source (SGML DocBook) and 'compiled' forms
|
||||
(SGML HTML, PDF, PostScript, RTF and so forth) with or without
|
||||
modification, are permitted provided that the following conditions
|
||||
are met:
|
||||
|
||||
1. Redistributions of source code (SGML DocBook) must retain the above
|
||||
copyright notice, this list of conditions and the following
|
||||
disclaimer as the first lines of this file unmodified.
|
||||
|
||||
2. Redistributions in compiled form (transformed to other DTDs,
|
||||
converted to PDF, PostScript, RTF and other formats) must reproduce
|
||||
the above copyright notice, this list of conditions and the
|
||||
following disclaimer in the documentation and/or other materials
|
||||
provided with the distribution.
|
||||
|
||||
THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
|
||||
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
||||
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||||
DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
|
||||
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
||||
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
||||
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
||||
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
||||
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
|
||||
POSSIBILITY OF SUCH DAMAGE.
|
||||
|
||||
$Id: chapter.sgml,v 1.1 2000-06-12 15:47:08 gioria Exp $
|
||||
-->
|
||||
|
||||
<chapter id="writing-style">
|
||||
<title> Style</title>
|
||||
|
||||
<para>Pour conserver une certaine cohérence entre le travail des nombreux
|
||||
rédacteurs de la documentation de FreeBSD, on a défini quelques règles à
|
||||
suivre.</para>
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term>N'utilisez pas de formes contractées</term>
|
||||
|
||||
<listitem>
|
||||
<para>N'utilisez pas de formes contractées. Utilisez toujours les mots
|
||||
entiers. “<foreignphrase>Don't use
|
||||
contractions</foreignphrase>” n'est pas
|
||||
correct<footnote><para>N.d.T.: Ceci s'applique bien sûr aux textes
|
||||
rédigés en anglais.</para></footnote>.</para>
|
||||
|
||||
<para>Ne pas contracter donne au texte un ton plus formel, est plus
|
||||
précis, et facilite la tâche des traducteurs.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term>Utilisez la virgule dans les énumérations</term>
|
||||
|
||||
<listitem>
|
||||
<para>Dans une énumération au sein d'un paragraphe, séparez avec des
|
||||
virgules les éléments les uns des autres. Mettez aussi un virgule et
|
||||
la conjonction “et” avant le dernier élément.</para>
|
||||
|
||||
<para>Examinez par exemple la phrase suivante :</para>
|
||||
|
||||
<blockquote>
|
||||
<para>C'est une liste d'un, deux et trois éléments.</para>
|
||||
</blockquote>
|
||||
|
||||
<para>Est-ce une liste de trois éléments, “un”,
|
||||
“deux”, et “trois”, ou une liste de deux
|
||||
éléments, “un” et “deux et
|
||||
trois” ?</para>
|
||||
|
||||
<para>Il vaut mieux être explicite et ajouter la dernière
|
||||
virgule :</para>
|
||||
|
||||
<blockquote>
|
||||
<para>C'est une liste d'un, deux, et trois éléments.</para>
|
||||
</blockquote>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term>Evitez les redondances</term>
|
||||
|
||||
<listitem>
|
||||
<para>Evitez les redondances. En particulier, “la
|
||||
commande”, “le fichier”, et “man
|
||||
commande” sont probablement redondants.</para>
|
||||
|
||||
<para>Voici deux exemples pour ce qui concerne les commandes. Il est
|
||||
préférable d'utiliser le second.</para>
|
||||
|
||||
<informalexample>
|
||||
<para>Utilisez la commande <command>cvsup</command> pour mettre à
|
||||
jour vos sources.</para>
|
||||
</informalexample>
|
||||
|
||||
<informalexample>
|
||||
<para>Utilisez <command>cvsup</command> pour mettre à jour vos
|
||||
sources.</para>
|
||||
</informalexample>
|
||||
|
||||
<para>Voici deux exemples pour ce qui concerne les noms de fichiers.
|
||||
Il est préférable d'utiliser le second.</para>
|
||||
|
||||
<informalexample>
|
||||
<para>… dans le fichier
|
||||
<filename>/etc/rc.local</filename>…</para>
|
||||
</informalexample>
|
||||
|
||||
<informalexample>
|
||||
<para>… dans
|
||||
<filename>/etc/rc.local</filename>…</para>
|
||||
</informalexample>
|
||||
|
||||
<para>Voici enfin deux exemples pour les références aux pages de
|
||||
manuel. Il est préférable d'utiliser le second (il emploie
|
||||
<sgmltag>citerefentry</sgmltag>).</para>
|
||||
|
||||
<informalexample>
|
||||
<para>Voyez <command>man csh</command> pour plus
|
||||
d'information.</para>
|
||||
</informalexample>
|
||||
|
||||
<informalexample>
|
||||
<para>Voyez &man.csh.1;</para>
|
||||
</informalexample>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
|
||||
<para>Pour des détails sur le style, consultez les <ulink
|
||||
url="http://www.columbia.edu/acis/bartleby/strunk/"><foreignphrase>Eléments
|
||||
de Style</foreignphrase></ulink>, de William Strunk.</para>
|
||||
</chapter>
|
||||
|
||||
<!--
|
||||
Local Variables:
|
||||
mode: sgml
|
||||
sgml-declaration: "../chapter.decl"
|
||||
sgml-indent-data: t
|
||||
sgml-omittag: nil
|
||||
sgml-always-quote-attributes: t
|
||||
sgml-parent-document: ("../book.sgml" "part" "chapter")
|
||||
End:
|
||||
-->
|
||||
|
||||
47
fr_FR.ISO_8859-1/books/fdp-primer/Makefile
Normal file
47
fr_FR.ISO_8859-1/books/fdp-primer/Makefile
Normal file
|
|
@ -0,0 +1,47 @@
|
|||
#
|
||||
# The FreeBSD Documentation Project
|
||||
# The FreeBSD French Documentation Project
|
||||
#
|
||||
# Compilation de l'Introduction au Projet de Documentation de FreeBSD
|
||||
#
|
||||
# $Id: Makefile,v 1.1 2000-06-12 15:46:26 gioria Exp $
|
||||
# Original revision: 1.6
|
||||
#
|
||||
|
||||
MAINTAINER=nik@FreeBSD.ORG
|
||||
|
||||
DOC?= book
|
||||
|
||||
FORMATS?= html-split html
|
||||
|
||||
INSTALL_COMPRESSED?= gz
|
||||
INSTALL_ONLY_COMPRESSED?=
|
||||
|
||||
#
|
||||
# SRCS lists the individual SGML files that make up the document. Changes
|
||||
# to any of these files will force a rebuild
|
||||
#
|
||||
|
||||
# SGML content
|
||||
SRCS= book.sgml
|
||||
SRCS+= overview/chapter.sgml
|
||||
SRCS+= psgml-mode/chapter.sgml
|
||||
SRCS+= see-also/chapter.sgml
|
||||
SRCS+= sgml-markup/chapter.sgml
|
||||
SRCS+= sgml-primer/chapter.sgml
|
||||
SRCS+= stylesheets/chapter.sgml
|
||||
SRCS+= the-faq/chapter.sgml
|
||||
SRCS+= the-handbook/chapter.sgml
|
||||
SRCS+= the-website/chapter.sgml
|
||||
SRCS+= tools/chapter.sgml
|
||||
SRCS+= translations/chapter.sgml
|
||||
SRCS+= writing-style/chapter.sgml
|
||||
|
||||
# Entities
|
||||
SRCS+= chapters.ent
|
||||
SRCS+= ../handbook/mailing-lists.ent
|
||||
SRCS+= ../../../en_US.ISO_8859-1/books/handbook/authors.ent
|
||||
|
||||
DOC_PREFIX?= ${.CURDIR}/../../..
|
||||
|
||||
.include "${DOC_PREFIX}/share/mk/doc.project.mk"
|
||||
303
fr_FR.ISO_8859-1/books/fdp-primer/book.sgml
Normal file
303
fr_FR.ISO_8859-1/books/fdp-primer/book.sgml
Normal file
|
|
@ -0,0 +1,303 @@
|
|||
<!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.
|
||||
|
||||
Redistribution and use in source (SGML DocBook) and 'compiled' forms
|
||||
(SGML, HTML, PDF, PostScript, RTF and so forth) with or without
|
||||
modification, are permitted provided that the following conditions
|
||||
are met:
|
||||
|
||||
1. Redistributions of source code (SGML DocBook) must retain the above
|
||||
copyright notice, this list of conditions and the following
|
||||
disclaimer as the first lines of this file unmodified.
|
||||
|
||||
2. Redistributions in compiled form (transformed to other DTDs,
|
||||
converted to PDF, PostScript, RTF and other formats) must reproduce
|
||||
the above copyright notice, this list of conditions and the
|
||||
following disclaimer in the documentation and/or other materials
|
||||
provided with the distribution.
|
||||
|
||||
THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
|
||||
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
||||
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||||
DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
|
||||
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
||||
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
||||
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
||||
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
||||
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
|
||||
POSSIBILITY OF SUCH DAMAGE.
|
||||
|
||||
The FreeBSD Documentation Project
|
||||
The FreeBSD French Documentation Project
|
||||
|
||||
$Id: book.sgml,v 1.1 2000-06-12 15:46:26 gioria Exp $
|
||||
Original revision: 1.7
|
||||
-->
|
||||
|
||||
<!DOCTYPE BOOK PUBLIC "-//FreeBSD//DTD DocBook V3.1-Based Extension//EN" [
|
||||
<!ENTITY % man PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN"> %man;
|
||||
<!ENTITY % urls PUBLIC "-//FreeBSD//ENTITIES Common Document URL Entities//FR"> %urls;
|
||||
<!ENTITY % bookinfo PUBLIC "-//FreeBSD//ENTITIES DocBook BookInfo Entities//FR"> %bookinfo;
|
||||
<!ENTITY % translators PUBLIC "-//FreeBSD//ENTITIES DocBook Translator Entities//FR"> %translators;
|
||||
<!ENTITY % chapters SYSTEM "chapters.ent"> %chapters;
|
||||
<!ENTITY % authors SYSTEM "../../../en_US.ISO_8859-1/books/handbook/authors.ent"> %authors;
|
||||
<!ENTITY % mailing-lists SYSTEM "../handbook/mailing-lists.ent"> %mailing-lists;
|
||||
<!ENTITY rel.current CDATA "3.2">
|
||||
<!-- We need the followings until the translation is completed -->
|
||||
<!ENTITY sgml.in-progress SYSTEM "../handbook/in-progress.sgml">
|
||||
<!ENTITY sgml.todo SYSTEM "../handbook/todo.sgml">
|
||||
]>
|
||||
|
||||
<book lang="fr">
|
||||
<bookinfo>
|
||||
<title>Introduction au Projet de Documentation de FreeBSD pour les
|
||||
nouveaux participants</title>
|
||||
|
||||
<author>
|
||||
<firstname>Nik</firstname>
|
||||
<surname>Clayton</surname>
|
||||
<affiliation>
|
||||
<address><email>nik@FreeBSD.ORG</email></address>
|
||||
</affiliation>
|
||||
</author>
|
||||
|
||||
<copyright>
|
||||
<year>1998</year>
|
||||
<year>1999</year>
|
||||
<holder role="mailto:nik@FreeBSD.ORG">Nik Clayton</holder>
|
||||
</copyright>
|
||||
|
||||
<pubdate role="rcs">$Date: 2000-06-12 15:46:26 $</pubdate>
|
||||
|
||||
<releaseinfo>$Id: book.sgml,v 1.1 2000-06-12 15:46:26 gioria Exp $</releaseinfo>
|
||||
|
||||
<legalnotice>
|
||||
<para>La redistribution et l'utilisation du code source (SGML), et
|
||||
compilé (HTML, PostScript, etc.), modifiés ou non, sont soumises aux
|
||||
conditions suivantes :</para>
|
||||
|
||||
<orderedlist>
|
||||
<listitem>
|
||||
<para>Le code source (SGML DocBook) distribué doit conserver le
|
||||
copyright ci-dessus, la présente liste de conditions et
|
||||
l'avertissement qui la suit, sans modifications, en tête de ce
|
||||
fichier.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para>Le code source distribué sous forme compilé (transformation
|
||||
vers d'autres DTDs, conversion en PDF, PostScript, RTF et autres
|
||||
formats) doit faire apparaître dans la documentation et/ou les
|
||||
autres composants distribués, le copyright ci-dessus, la présente
|
||||
liste de conditions et l'avertissement qui la suit.</para>
|
||||
</listitem>
|
||||
</orderedlist>
|
||||
|
||||
<important>
|
||||
<para>CE DOCUMENT EST FOURNI PAR NIK CLAYTON “TEL QUEL” ET
|
||||
AUCUNE GARANTIE EXPRESSE OU IMPLICITE, Y COMPRIS, MAIS NON
|
||||
LIMITÉE, GARANTIES IMPLICITES DE COMMERCIABILITÉ ET
|
||||
D'ADÉQUATION À UN BUT PARTICULIER N'EST DONNÉE.
|
||||
EN AUCUN CAS NIK CLAYTON NE SAURAIT ÊTRE TENU RESPONSABLE DES
|
||||
DOMMAGES DIRECTS, INDIRECTS, ACCIDENTELS, SPÉCIAUX,
|
||||
EXEMPLAIRES OU CONSÉQUENTS (Y COMPRIS, MAIS SANS LIMITATION,
|
||||
LA FOURNITURE DE BIENS ET SERVICES ANNEXES DÉFAUT
|
||||
D'UTILISABILITÉ, PERTE DE DONNÉES OU DE PROFITS ;
|
||||
OU INTERRUPTION DE TRAVAIL) QUELLE QU'EN SOIT LA CAUSE ET SELON
|
||||
TOUTE DÉFINITION DE RESPONSABILITÉ, SOIT PAR CONTRAT,
|
||||
RESPONSABILITÉ STRICTE, OU PRÉJUDICE (Y COMPRIS
|
||||
NÉGLIGENCE OU AUTRES) IMPUTABLES D'UNE FAÇON OU D'UNE
|
||||
AUTRE À L'UTILISATION DE CE DOCUMENT, MÊME APRES AVOIR
|
||||
ÉTÉ AVISÉ DE LA POSSIBILITÉ DE TELS
|
||||
DOMMAGES.</para>
|
||||
</important>
|
||||
</legalnotice>
|
||||
|
||||
<abstract>
|
||||
<para>Merci de votre participation au Projet de Documentation de
|
||||
FreeBSD. Votre contribution est très utile.</para>
|
||||
|
||||
<para>Cette introduction décrit tout ce que vous devez savoir pour
|
||||
commencer à participer au projet de documentation de FreeBSD, des
|
||||
outils et logiciels que vous utiliserez (indispensables et
|
||||
facultatifs) à la philosophie sous-jacente au Projet de
|
||||
Documentation.</para>
|
||||
|
||||
<para>Ce document est en cours de rédaction et n'est pas terminé. Les
|
||||
sections inachevées sont indiquées par un
|
||||
astérisque - <literal>*</literal> - qui précède
|
||||
leur nom.</para>
|
||||
|
||||
&trans.a.haby;
|
||||
</abstract>
|
||||
</bookinfo>
|
||||
|
||||
<preface>
|
||||
<title>Préface</title>
|
||||
|
||||
<sect1>
|
||||
<title>Invites de l'interpréteur de commandes</title>
|
||||
|
||||
<para>La table ci-dessous donne les invites par défaut du système pour
|
||||
un utilisateur normal et pour le super-utilisateur. Elles sont
|
||||
utilisées dans les exemples pour indiquer quel utilisateur doit
|
||||
appliquer l'exemple.</para>
|
||||
|
||||
<informaltable frame="none">
|
||||
<tgroup cols="2">
|
||||
<thead>
|
||||
<row>
|
||||
<entry>Utilisateur</entry>
|
||||
<entry>Invite</entry>
|
||||
</row>
|
||||
</thead>
|
||||
|
||||
<tbody>
|
||||
<row>
|
||||
<entry>Utilisateur normal</entry>
|
||||
<entry>&prompt.user;</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry><username>root</username></entry>
|
||||
<entry>&prompt.root;</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</informaltable>
|
||||
</sect1>
|
||||
|
||||
<sect1>
|
||||
<title>Conventions Typographiques</title>
|
||||
|
||||
<para>La table ci-dessous décrit les conventions typographiques
|
||||
utilisées dans le présent ouvrage.</para>
|
||||
|
||||
<informaltable frame="none">
|
||||
<tgroup cols="2">
|
||||
<thead>
|
||||
<row>
|
||||
<entry>Signification</entry>
|
||||
<entry>Exemples</entry>
|
||||
</row>
|
||||
</thead>
|
||||
|
||||
<tbody>
|
||||
<row>
|
||||
<entry>Noms de commandes, fichiers et répertoires. Affichage à
|
||||
l'écran de l'ordinateur.</entry>
|
||||
|
||||
<entry><para>Modifiez votre fichier
|
||||
<filename>.login</filename>.</para><para>Utilisez
|
||||
<command>ls -a</command> pour avoir la liste de tous les
|
||||
fichiers.</para><para><screen>Vous avez reçu du courrier.</screen></para></entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry>Ce que vous tapez, par opposition à ce que l'ordinateur
|
||||
affiche.</entry>
|
||||
|
||||
<entry><screen>&prompt.user; <userinput>su</userinput>
|
||||
Password:</screen></entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry>Références aux pages de manuel</entry>
|
||||
|
||||
<entry>Utilisez <citerefentry><refentrytitle>su</refentrytitle>
|
||||
<manvolnum>1</manvolnum></citerefentry> pour changer de nom
|
||||
d'utilisateur.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry>Noms d'utilisateurs et de groupes</entry>
|
||||
|
||||
<entry>Seul <username>root</username> peut le faire.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry>Mise en valeur</entry>
|
||||
|
||||
<entry>Vous <emphasis>devez</emphasis> le faire.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry>Variables sur la ligne de commande ; à remplacer par
|
||||
le nom ou la valeur effectif.</entry>
|
||||
|
||||
<entry>Pour supprimer un fichier, tapez <command>rm
|
||||
<filename><replaceable>nom_du_fichier</replaceable></filename></command>.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry>Variables d'environnement</entry>
|
||||
|
||||
<entry><envar>$HOME</envar> est votre répertoire
|
||||
utilisateur.</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</informaltable>
|
||||
</sect1>
|
||||
|
||||
<sect1>
|
||||
<title>Notes, avertissements et exemples</title>
|
||||
|
||||
<para>Dans le cours du texte, il peut y avoir des notes, des
|
||||
avertissements et des exemples.</para>
|
||||
|
||||
<note>
|
||||
<para>Les notes apparaissent comme ceci, et contiennent des
|
||||
informations que vous devriez prendre en considération, parce
|
||||
qu'elles peuvent avoir une incidence sur ce que vous faites.</para>
|
||||
</note>
|
||||
|
||||
<warning>
|
||||
<para>Les avertissements apparaissent comme ceci, et vous préviennent
|
||||
de problèmes potentiels si vous n'appliquez pas ces instructions.
|
||||
Des dégats peuvent être causés à votre matériel, ou ne pas être
|
||||
physiques, suppression inopinée de fichiers importants par
|
||||
exemple.</para>
|
||||
</warning>
|
||||
|
||||
<example>
|
||||
<title>Un exemple d'exemple</title>
|
||||
|
||||
<para>Les exemples apparaissent comme ceci, et sont généralement des
|
||||
exemples que vous devriez tester ou qui vous montrent quels doivent
|
||||
être les résultats d'une opération donnée.</para>
|
||||
</example>
|
||||
</sect1>
|
||||
|
||||
<sect1>
|
||||
<title>Remerciements</title>
|
||||
|
||||
<para>Mes remerciements à Sue Blake, Patrick Durusau, Jon Hamilton,
|
||||
Peter Flynn et Christopher Maden, qui ont pris le temps de lire les
|
||||
premières versions de ce document et ont apporté de nombreux
|
||||
commentaires et critiques utiles.</para>
|
||||
</sect1>
|
||||
</preface>
|
||||
|
||||
&chap.overview;
|
||||
&chap.tools;
|
||||
&chap.sgml-primer;
|
||||
&chap.sgml-markup;
|
||||
&chap.stylesheets;
|
||||
&chap.the-faq;
|
||||
&chap.the-handbook;
|
||||
&chap.the-website;
|
||||
&chap.translations;
|
||||
&chap.writing-style;
|
||||
&chap.psgml-mode;
|
||||
&chap.see-also;
|
||||
</book>
|
||||
|
||||
<!--
|
||||
Local Variables:
|
||||
mode: sgml
|
||||
sgml-indent-data: t
|
||||
sgml-omittag: nil
|
||||
sgml-always-quote-attributes: t
|
||||
End:
|
||||
-->
|
||||
23
fr_FR.ISO_8859-1/books/fdp-primer/chapters.ent
Normal file
23
fr_FR.ISO_8859-1/books/fdp-primer/chapters.ent
Normal file
|
|
@ -0,0 +1,23 @@
|
|||
<!--
|
||||
Creates entities for each chapter in the Documentation Project Primer.
|
||||
Each entity is named chap.foo, where foo is the value of the id
|
||||
attribute on that chapter, and corresponds to the name of the
|
||||
directory in which that chapter's .sgml file is stored.
|
||||
|
||||
Chapters should be listed in the order in which they are referenced.
|
||||
|
||||
$Id: chapters.ent,v 1.1 2000-06-12 15:46:26 gioria Exp $
|
||||
-->
|
||||
|
||||
<!ENTITY chap.overview SYSTEM "overview/chapter.sgml">
|
||||
<!ENTITY chap.sgml-primer SYSTEM "sgml-primer/chapter.sgml">
|
||||
<!ENTITY chap.tools SYSTEM "tools/chapter.sgml">
|
||||
<!ENTITY chap.sgml-markup SYSTEM "sgml-markup/chapter.sgml">
|
||||
<!ENTITY chap.stylesheets SYSTEM "stylesheets/chapter.sgml">
|
||||
<!ENTITY chap.the-faq SYSTEM "the-faq/chapter.sgml">
|
||||
<!ENTITY chap.the-handbook SYSTEM "the-handbook/chapter.sgml">
|
||||
<!ENTITY chap.the-website SYSTEM "the-website/chapter.sgml">
|
||||
<!ENTITY chap.translations SYSTEM "translations/chapter.sgml">
|
||||
<!ENTITY chap.writing-style SYSTEM "writing-style/chapter.sgml">
|
||||
<!ENTITY chap.psgml-mode SYSTEM "psgml-mode/chapter.sgml">
|
||||
<!ENTITY chap.see-also SYSTEM "see-also/chapter.sgml">
|
||||
187
fr_FR.ISO_8859-1/books/fdp-primer/overview/chapter.sgml
Normal file
187
fr_FR.ISO_8859-1/books/fdp-primer/overview/chapter.sgml
Normal file
|
|
@ -0,0 +1,187 @@
|
|||
<!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.
|
||||
|
||||
Redistribution and use in source (SGML DocBook) and 'compiled' forms
|
||||
(SGML HTML, PDF, PostScript, RTF and so forth) with or without
|
||||
modification, are permitted provided that the following conditions
|
||||
are met:
|
||||
|
||||
1. Redistributions of source code (SGML DocBook) must retain the above
|
||||
copyright notice, this list of conditions and the following
|
||||
disclaimer as the first lines of this file unmodified.
|
||||
|
||||
2. Redistributions in compiled form (transformed to other DTDs,
|
||||
converted to PDF, PostScript, RTF and other formats) must reproduce
|
||||
the above copyright notice, this list of conditions and the
|
||||
following disclaimer in the documentation and/or other materials
|
||||
provided with the distribution.
|
||||
|
||||
THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
|
||||
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
||||
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||||
DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
|
||||
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
||||
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
||||
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
||||
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
||||
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
|
||||
POSSIBILITY OF SUCH DAMAGE.
|
||||
|
||||
The FreeBSD Documentation Project
|
||||
The FreeBSD French Documentation Project
|
||||
|
||||
$Id: chapter.sgml,v 1.1 2000-06-12 15:46:30 gioria Exp $
|
||||
Original revision: 1.3
|
||||
-->
|
||||
|
||||
<chapter id="overview">
|
||||
<title>Introduction</title>
|
||||
|
||||
<para>Bienvenue au Projet de Documentation de FreeBSD. Une documentation de
|
||||
bonne qualité est un facteur important de succès pour FreeBSD, et le
|
||||
Projet de Documentation de
|
||||
FreeBSD - “<foreignphrase>The FreeBSD Documentation
|
||||
Project</foreignphrase>” - est la source d'une grande
|
||||
part de cette documentation. Votre participation est importante.</para>
|
||||
|
||||
<para>L'objectif principal de ce document est d'expliquer clairement
|
||||
<emphasis>comment est organisé le FDP</emphasis>, <emphasis>comment
|
||||
écrire et soumettre de la documentation au FDP</emphasis> et
|
||||
<emphasis>comment utiliser les outils disponibles pour produire de la
|
||||
documentation</emphasis>.</para>
|
||||
|
||||
<para>La participation de chacun au FDP est bienvenue. Il n'y a pas de
|
||||
cotisation minimum, pas de quota de documentation à produire par mois. Il
|
||||
vous suffit de vous inscrire sur la &a.doc;.</para>
|
||||
|
||||
<para>Après avoir lu ce document, vous :</para>
|
||||
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>Saurez quelles sont les documentations maintenues par le
|
||||
FDP.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para>Serez capable de lire et comprendre le code SGML source des
|
||||
documentations maintenues par le FDP.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para>Serez capable de modifier la documentation.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para>Saurez comment soumettre vos modifications pour qu'elles soient
|
||||
revues et incorporées à la documentation de FreeBSD.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
|
||||
<sect1>
|
||||
<title>Le jeu de documentations de FreeBSD</title>
|
||||
|
||||
<para>Le FDP a la responsabilité de quatre catégories de documents.</para>
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term>Les pages de manuel</term>
|
||||
|
||||
<listitem>
|
||||
<para>Les pages de manuel système en anglais ne sont pas rédigées
|
||||
par le FDP, puisqu'elles font partie du système de base. Le FDP,
|
||||
néanmoins, peut (et a) récrit des pages de manuel existantes pour
|
||||
les clarifier ou corriger des inexactitudes.</para>
|
||||
|
||||
<para>Les équipes de traductions sont responsables de la traduction
|
||||
des pages de manuel dans les différentes langues. Ces traductions
|
||||
sont archivées par le FDP.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term>FAQ</term>
|
||||
|
||||
<listitem>
|
||||
<para>L'objectif de la FAQ est de répondre (sous forme de courtes
|
||||
questions/réponses) aux questions qui sont posées, ou devraient
|
||||
être posées, sur les différentes listes de diffusion et forums de
|
||||
discussion consacrées à FreeBSD. Son format n'autorise pas de
|
||||
réponses longues et exhaustives.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term>Manuel de
|
||||
référence - “<foreignphrase>Handbook</foreignphrase>”</term>
|
||||
|
||||
<listitem>
|
||||
<para>Le Manuel cherche à être la ressource en ligne exhaustive et
|
||||
de référence pour les utilisateurs de FreeBSD.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term>Le site Web</term>
|
||||
|
||||
<listitem>
|
||||
<para>C'est le point de présence central de FreeBSD sur le
|
||||
<foreignphrase>World Wide Web</foreignphrase>, dont le site
|
||||
principal est <ulink
|
||||
url="http://www.freebsd.org/">http://www.freebsd.org/</ulink>
|
||||
et qui a de nombreux sites miroirs dans le monde. Pour beaucoup
|
||||
de gens, ce site est leur première rencontre avec FreeBSD.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
|
||||
<para>Ces quatres catégories de documentation sont disponibles dans les
|
||||
archives CVS de FreeBSD. Ce qui signifie que les modifications et les
|
||||
notifications sont accessibles à tous, et que chacun peut utiliser un
|
||||
programme comme <application>CVSup</application> ou
|
||||
<application>CTM</application> pour maintenir à jour son propre
|
||||
exemplaire local.</para>
|
||||
|
||||
|
||||
<para>En plus de ces documents, de nombreuses personnes ont écrit des
|
||||
guides ou réalisé des sites Web se rapportant à FreeBSD. Certains sont
|
||||
aussi archivés dans l'arborescence CVS (quand l'auteur a donné son
|
||||
accord). Dans d'autre cas, l'auteur a choisi de conserver ses
|
||||
documentations en dehors des archives FreeBSD. Le FDP essaie de donner
|
||||
le maximum de liens possible sur ces documents.</para>
|
||||
</sect1>
|
||||
|
||||
<sect1>
|
||||
<title>Avant de commencer</title>
|
||||
|
||||
<para>Ce document fait l'hypothèse que vous savez déjà :</para>
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>Vous procurer et tenir à jour une copie locale de la
|
||||
documentation. Soit en maintenant une copie locale des archives CVS
|
||||
de FreeBSD (avec <application>CVS</application>,
|
||||
<application>CVSup</application> ou <application>CTM</application>),
|
||||
ou en vous servant de <application>CVSup</application> pour ne
|
||||
télécharger que la version
|
||||
extraite - <emphasis>courante</emphasis>.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para>Comment télécharger et installer de nouveaux logiciels en vous
|
||||
servant soit du catalogue des logiciels de FreeBSD soit de
|
||||
&man.pkg.add.1;.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</sect1>
|
||||
</chapter>
|
||||
|
||||
<!--
|
||||
Local Variables:
|
||||
mode: sgml
|
||||
sgml-declaration: "../chapter.decl"
|
||||
sgml-indent-data: t
|
||||
sgml-omittag: nil
|
||||
sgml-always-quote-attributes: t
|
||||
sgml-parent-document: ("../book.sgml" "part" "chapter")
|
||||
End:
|
||||
-->
|
||||
|
||||
154
fr_FR.ISO_8859-1/books/fdp-primer/psgml-mode/chapter.sgml
Normal file
154
fr_FR.ISO_8859-1/books/fdp-primer/psgml-mode/chapter.sgml
Normal file
|
|
@ -0,0 +1,154 @@
|
|||
<!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.
|
||||
|
||||
Redistribution and use in source (SGML DocBook) and 'compiled' forms
|
||||
(SGML HTML, PDF, PostScript, RTF and so forth) with or without
|
||||
modification, are permitted provided that the following conditions
|
||||
are met:
|
||||
|
||||
1. Redistributions of source code (SGML DocBook) must retain the above
|
||||
copyright notice, this list of conditions and the following
|
||||
disclaimer as the first lines of this file unmodified.
|
||||
|
||||
2. Redistributions in compiled form (transformed to other DTDs,
|
||||
converted to PDF, PostScript, RTF and other formats) must reproduce
|
||||
the above copyright notice, this list of conditions and the
|
||||
following disclaimer in the documentation and/or other materials
|
||||
provided with the distribution.
|
||||
|
||||
THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
|
||||
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
||||
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||||
DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
|
||||
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
||||
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
||||
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
||||
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
||||
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
|
||||
POSSIBILITY OF SUCH DAMAGE.
|
||||
|
||||
$Id: chapter.sgml,v 1.1 2000-06-12 15:46:33 gioria Exp $
|
||||
-->
|
||||
|
||||
<chapter id="psgml-mode">
|
||||
<title> Utiliser <literal>sgml-mode</literal> avec
|
||||
<application>Emacs</application></title>
|
||||
|
||||
<para>Les versions récentes d'Emacs ou Xemacs (disponibles au catalogue des
|
||||
logiciels portés) incluent un paquetage très utile appelé PSGML. Il est
|
||||
automatiquement appelé au chargement d'un fichier avec l'extension
|
||||
<filename>.sgml</filename>, ou lorsque l'on tape <command>M-x
|
||||
sgml-mode</command>. C'est un mode majeur pour traiter les fichiers
|
||||
SGML, les éléments et les attributs.</para>
|
||||
|
||||
<para>Connaître certaines des commandes de ce mode peut rendre le travail
|
||||
sur des documents comme le Manuel de Référence beaucoup plus
|
||||
facile.</para>
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><command>C-c C-e</command></term>
|
||||
|
||||
<listitem>
|
||||
<para>Exécute <literal>sgml-insert-element</literal>. On vous
|
||||
demandera le nom de l'élement à insérer là ou se trouve le
|
||||
curseur. Vous pouvez utiliser la touche <keycap>Tab</keycap> pour
|
||||
compléter le nom de l'élément. Seuls les éléments syntaxiquement
|
||||
valides à cet endroit seront acceptés.</para>
|
||||
|
||||
<para>L'éditeur insérera les marques de début et de fin de l'élément.
|
||||
S'il y a d'autres éléments obligatoires qui doivent être inclus
|
||||
dans cet élément, ils seront aussi inclus.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><command>C-c =</command></term>
|
||||
|
||||
<listitem>
|
||||
<para>Exécute <literal>sgml-change-element-name</literal>. Mettez-vous
|
||||
dans un élément et utilisez cette commande. On vous demandera le nom
|
||||
de l'élément par lequel il faut le remplacer. Les marques de début
|
||||
et de fin de l'élément seront remplacées.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><command>C-c C-r</command></term>
|
||||
|
||||
<listitem>
|
||||
<para>Exécute <literal>sgml-tag-region</literal>. Sélectionnez du
|
||||
texte (placez-vous au début, <command>C-espace</command>, allez à
|
||||
la fin du texte, <command>C-espace</command>) et lancez ensuite
|
||||
cette commande. On vous demandera quel élement utiliser. Celui-ci
|
||||
sera inséré immédiatement avant et après la région choisie.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><command>C-c -</command></term>
|
||||
|
||||
<listitem>
|
||||
<para>Exécute <literal>sgml-untag-element</literal>. Mettez-vous sur
|
||||
la marque de début ou de fin de l'élément que vous voulez supprimer
|
||||
et lancez cette commande. Les marques de début et de fin de
|
||||
l'élément seront supprimées.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><command>C-c C-q</command></term>
|
||||
|
||||
<listitem>
|
||||
<para>Exécute <literal>sgml-fill-element</literal>.
|
||||
“Remplira” (i.e., reformatera) le contenu de l'élément
|
||||
courant. Cela affectera aussi le contenu dont les blancs sont
|
||||
significatifs, comme celui des éléments
|
||||
<sgmltag>programlisting</sgmltag>, utilisez donc cette commande avec
|
||||
précaution.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><command>C-c C-a</command></term>
|
||||
|
||||
<listitem>
|
||||
<para>Exécute <literal>sgml-edit-attributes</literal>. Ouvre un
|
||||
deuxième tampon donnant la liste des attributs de l'élément
|
||||
qui inclut le contenu courant, avec leurs valeurs. La touche
|
||||
<keycap>Tab</keycap> vous permet de passer d'un attribut à l'autre,
|
||||
<command>C-k</command> de modifier une valeur existante, et
|
||||
<command>C-c</command> de fermer le tampon et de revenir au
|
||||
document principal.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><command>C-c C-v</command></term>
|
||||
|
||||
<listitem>
|
||||
<para>Exécute <literal>sgml-validate</literal>. Vous propose de
|
||||
sauvegarder le document en cours (si besoin est) et passe ensuite un
|
||||
programme de validation du SGML. Les résultats de cette validation
|
||||
sont affichés dans un nouveau tampon et vous pouvez ensuite naviguer
|
||||
d'une erreur à l'autre, pour les corriger au fur et à mesure.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
|
||||
<para>Il y a sans aucun doute d'autres fonctions utiles, mais j'ai décrit
|
||||
celles que j'utilise le plus souvent.</para>
|
||||
</chapter>
|
||||
|
||||
|
||||
<!--
|
||||
Local Variables:
|
||||
mode: sgml
|
||||
sgml-declaration: "../chapter.decl"
|
||||
sgml-indent-data: t
|
||||
sgml-omittag: nil
|
||||
sgml-always-quote-attributes: t
|
||||
sgml-parent-document: ("../book.sgml" "part" "chapter")
|
||||
End:
|
||||
-->
|
||||
|
||||
124
fr_FR.ISO_8859-1/books/fdp-primer/see-also/chapter.sgml
Normal file
124
fr_FR.ISO_8859-1/books/fdp-primer/see-also/chapter.sgml
Normal file
|
|
@ -0,0 +1,124 @@
|
|||
<!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.
|
||||
|
||||
Redistribution and use in source (SGML DocBook) and 'compiled' forms
|
||||
(SGML HTML, PDF, PostScript, RTF and so forth) with or without
|
||||
modification, are permitted provided that the following conditions
|
||||
are met:
|
||||
|
||||
1. Redistributions of source code (SGML DocBook) must retain the above
|
||||
copyright notice, this list of conditions and the following
|
||||
disclaimer as the first lines of this file unmodified.
|
||||
|
||||
2. Redistributions in compiled form (transformed to other DTDs,
|
||||
converted to PDF, PostScript, RTF and other formats) must reproduce
|
||||
the above copyright notice, this list of conditions and the
|
||||
following disclaimer in the documentation and/or other materials
|
||||
provided with the distribution.
|
||||
|
||||
THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
|
||||
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
||||
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||||
DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
|
||||
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
||||
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
||||
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
||||
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
||||
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
|
||||
POSSIBILITY OF SUCH DAMAGE.
|
||||
|
||||
$Id: chapter.sgml,v 1.1 2000-06-12 15:46:35 gioria Exp $
|
||||
-->
|
||||
|
||||
<chapter id="see-also">
|
||||
<title> A consulter</title>
|
||||
|
||||
<para>Ce document ne décrit délibérement pas exhaustivement, ni le SGML, ni
|
||||
les DTDs citées, ni le Projet de Documentation de FreeBSD. Pour plus
|
||||
d'information sur ces sujets, il est recommandé de consulter les sites Web
|
||||
ci-dessous.</para>
|
||||
|
||||
<sect1>
|
||||
<title>Projet de Documentation de FreeBSD</title>
|
||||
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para><ulink url="http://www.freebsd.org/docproj/">Les pages Web du
|
||||
Projet de Documentation de FreeBSD</ulink>,</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><ulink url="http://www.freebsd.org/handbook/">Le Manuel de
|
||||
Référence de FreeBSD</ulink>.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</sect1>
|
||||
|
||||
<sect1>
|
||||
<title>SGML</title>
|
||||
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para><ulink url="http://www.oasis-open.org/cover/">La page Web
|
||||
SGML/XML</ulink>, un ressource SGML exhaustive,</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><ulink
|
||||
url='http://etext.virginia.edu/bin/tei-tocs?div=DIV1&id=SG">http://etext.virginia.edu/bin/tei-tocs?div=DIV1&id=SG'>L'Introduction en
|
||||
douceur au SGML</ulink>.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</sect1>
|
||||
|
||||
<sect1>
|
||||
<title>HTML</title>
|
||||
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para><ulink url="http://www.w3.org/">Le consortium World Wide
|
||||
Web</ulink>,</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><ulink url="http://www.w3.org/TR/REC-html40/">Les spécifications
|
||||
du HTML 4.0</ulink>.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</sect1>
|
||||
|
||||
<sect1>
|
||||
<title>DocBook</title>
|
||||
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para><ulink url="http://www.oreilly.com/davenport/">Le
|
||||
<foreignphrase>Davenport Group</foreignphrase></ulink>, qui
|
||||
maintient la DTD DocBook.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</sect1>
|
||||
|
||||
<sect1>
|
||||
<title>Le Projet de Documentation de Linux</title>
|
||||
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para><ulink url="http://metalab.unc.edu/LDP/">Les pages Web du Projet
|
||||
de Documentation de Linux</ulink>.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</sect1>
|
||||
</chapter>
|
||||
|
||||
<!--
|
||||
Local Variables:
|
||||
mode: sgml
|
||||
sgml-declaration: "../chapter.decl"
|
||||
sgml-indent-data: t
|
||||
sgml-omittag: nil
|
||||
sgml-always-quote-attributes: t
|
||||
sgml-parent-document: ("../book.sgml" "part" "chapter")
|
||||
End:
|
||||
-->
|
||||
|
||||
2356
fr_FR.ISO_8859-1/books/fdp-primer/sgml-markup/chapter.sgml
Normal file
2356
fr_FR.ISO_8859-1/books/fdp-primer/sgml-markup/chapter.sgml
Normal file
File diff suppressed because it is too large
Load diff
1645
fr_FR.ISO_8859-1/books/fdp-primer/sgml-primer/chapter.sgml
Normal file
1645
fr_FR.ISO_8859-1/books/fdp-primer/sgml-primer/chapter.sgml
Normal file
File diff suppressed because it is too large
Load diff
72
fr_FR.ISO_8859-1/books/fdp-primer/stylesheets/chapter.sgml
Normal file
72
fr_FR.ISO_8859-1/books/fdp-primer/stylesheets/chapter.sgml
Normal file
|
|
@ -0,0 +1,72 @@
|
|||
<!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.
|
||||
|
||||
Redistribution and use in source (SGML DocBook) and 'compiled' forms
|
||||
(SGML HTML, PDF, PostScript, RTF and so forth) with or without
|
||||
modification, are permitted provided that the following conditions
|
||||
are met:
|
||||
|
||||
1. Redistributions of source code (SGML DocBook) must retain the above
|
||||
copyright notice, this list of conditions and the following
|
||||
disclaimer as the first lines of this file unmodified.
|
||||
|
||||
2. Redistributions in compiled form (transformed to other DTDs,
|
||||
converted to PDF, PostScript, RTF and other formats) must reproduce
|
||||
the above copyright notice, this list of conditions and the
|
||||
following disclaimer in the documentation and/or other materials
|
||||
provided with the distribution.
|
||||
|
||||
THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
|
||||
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
||||
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||||
DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
|
||||
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
||||
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
||||
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
||||
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
||||
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
|
||||
POSSIBILITY OF SUCH DAMAGE.
|
||||
|
||||
$Id: chapter.sgml,v 1.1 2000-06-12 15:46:47 gioria Exp $
|
||||
-->
|
||||
|
||||
<chapter id="stylesheets">
|
||||
|
||||
<title>* Feuilles de style</title>
|
||||
|
||||
<para>SGML ne décrit pas comment un document doit être affiché ou imprimé.
|
||||
A cet effet, différents langages ont été conçus pour définir des feuilles
|
||||
de style, dont DynaText, Panorama, SPICE,
|
||||
JSSS, FOSI, CSS, et DSSSL.</para>
|
||||
|
||||
<para>Pour DocBook, nous utilisons des feuilles de style écrites en DSSSL.
|
||||
Pour le HTML, nous utilisons CSS.</para>
|
||||
|
||||
<sect1>
|
||||
<title>* DSSSL</title>
|
||||
|
||||
<para>Le Projet de Documentation utilise une version un minimum
|
||||
personnalisée des feuilles de style DocBook modulaires de Norm
|
||||
Walsh.</para>
|
||||
|
||||
<para>Vous les trouverez dans
|
||||
<filename>textproc/dsssl-docbook-modular</filename>.</para>
|
||||
</sect1>
|
||||
|
||||
<sect1>
|
||||
<title>* CSS</title>
|
||||
|
||||
<para></para>
|
||||
</sect1>
|
||||
</chapter>
|
||||
|
||||
<!--
|
||||
Local Variables:
|
||||
mode: sgml
|
||||
sgml-declaration: "../chapter.decl"
|
||||
sgml-indent-data: t
|
||||
sgml-omittag: nil
|
||||
sgml-always-quote-attributes: t
|
||||
sgml-parent-document: ("../book.sgml" "part" "chapter")
|
||||
End:
|
||||
-->
|
||||
49
fr_FR.ISO_8859-1/books/fdp-primer/the-faq/chapter.sgml
Normal file
49
fr_FR.ISO_8859-1/books/fdp-primer/the-faq/chapter.sgml
Normal file
|
|
@ -0,0 +1,49 @@
|
|||
<!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.
|
||||
|
||||
Redistribution and use in source (SGML DocBook) and 'compiled' forms
|
||||
(SGML HTML, PDF, PostScript, RTF and so forth) with or without
|
||||
modification, are permitted provided that the following conditions
|
||||
are met:
|
||||
|
||||
1. Redistributions of source code (SGML DocBook) must retain the above
|
||||
copyright notice, this list of conditions and the following
|
||||
disclaimer as the first lines of this file unmodified.
|
||||
|
||||
2. Redistributions in compiled form (transformed to other DTDs,
|
||||
converted to PDF, PostScript, RTF and other formats) must reproduce
|
||||
the above copyright notice, this list of conditions and the
|
||||
following disclaimer in the documentation and/or other materials
|
||||
provided with the distribution.
|
||||
|
||||
THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
|
||||
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
||||
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||||
DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
|
||||
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
||||
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
||||
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
||||
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
||||
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
|
||||
POSSIBILITY OF SUCH DAMAGE.
|
||||
|
||||
$Id: chapter.sgml,v 1.1 2000-06-12 15:46:49 gioria Exp $
|
||||
-->
|
||||
|
||||
<chapter id="the-faq">
|
||||
<title>* La Foire Aux Questions</title>
|
||||
|
||||
<para></para>
|
||||
</chapter>
|
||||
|
||||
<!--
|
||||
Local Variables:
|
||||
mode: sgml
|
||||
sgml-declaration: "../chapter.decl"
|
||||
sgml-indent-data: t
|
||||
sgml-omittag: nil
|
||||
sgml-always-quote-attributes: t
|
||||
sgml-parent-document: ("../book.sgml" "part" "chapter")
|
||||
End:
|
||||
-->
|
||||
|
||||
282
fr_FR.ISO_8859-1/books/fdp-primer/the-handbook/chapter.sgml
Normal file
282
fr_FR.ISO_8859-1/books/fdp-primer/the-handbook/chapter.sgml
Normal file
|
|
@ -0,0 +1,282 @@
|
|||
<!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.
|
||||
|
||||
Redistribution and use in source (SGML DocBook) and 'compiled' forms
|
||||
(SGML HTML, PDF, PostScript, RTF and so forth) with or without
|
||||
modification, are permitted provided that the following conditions
|
||||
are met:
|
||||
|
||||
1. Redistributions of source code (SGML DocBook) must retain the above
|
||||
copyright notice, this list of conditions and the following
|
||||
disclaimer as the first lines of this file unmodified.
|
||||
|
||||
2. Redistributions in compiled form (transformed to other DTDs,
|
||||
converted to PDF, PostScript, RTF and other formats) must reproduce
|
||||
the above copyright notice, this list of conditions and the
|
||||
following disclaimer in the documentation and/or other materials
|
||||
provided with the distribution.
|
||||
|
||||
THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
|
||||
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
||||
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||||
DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
|
||||
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
||||
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
||||
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
||||
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
||||
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
|
||||
POSSIBILITY OF SUCH DAMAGE.
|
||||
|
||||
$Id: chapter.sgml,v 1.1 2000-06-12 15:46:54 gioria Exp $
|
||||
-->
|
||||
|
||||
<chapter id="the-handbook">
|
||||
<title>* Le Manuel de Référence</title>
|
||||
|
||||
<sect1>
|
||||
<title>Organisation logique</title>
|
||||
|
||||
<para>Le Manuel de Référence est rédigé en conformité avec la DTD DocBook
|
||||
étendue de FreeBSD.</para>
|
||||
|
||||
<para>Le Manuel de Référence est un <sgmltag>book</sgmltag> DocBook. Il
|
||||
est ensuite divisé en <sgmltag>part</sgmltag>s, qui contiennent
|
||||
elles-mêmes plusieurs <sgmltag>chapter</sgmltag>s. Les
|
||||
<sgmltag>chapter</sgmltag>s sont eux-mêmes composés de sections
|
||||
(<sgmltag>sect1</sgmltag>) et sous-sections
|
||||
(<sgmltag>sect2</sgmltag>, <sgmltag>sect3</sgmltag>) et ainsi de
|
||||
suite.</para>
|
||||
</sect1>
|
||||
|
||||
<sect1>
|
||||
<title>Organisation physique</title>
|
||||
|
||||
<para>Le Manuel de Référence (et ses traductions) sont dans le
|
||||
sous-répertoire
|
||||
<filename>doc/<replaceable>langue</replaceable>/handbook</filename>
|
||||
des archives CVS principales. <replaceable>langue</replaceable> est le
|
||||
code ISO pour la langue, <literal>en</literal>, pour l'Anglais,
|
||||
<literal>ja</literal> pour le Japonais, et ainsi de suite.</para>
|
||||
|
||||
<para>Il y a un certain nombre de fichiers et répertoires dans le
|
||||
répertoire <filename>handbook</filename>.</para>
|
||||
|
||||
<note>
|
||||
<para>L'organisation du Manuel de Référence sera peut-être modifiée avec
|
||||
le temps, et le présent document peut ne pas être en phase avec ces
|
||||
changements. Si vous avez des questions sur la façon dont le Manuel de
|
||||
Référence est organisé, contactez s'il vous plaît le Projet de
|
||||
Documentation de FreeBSD, <email>doc@FreeBSD.ORG</email>.</para>
|
||||
</note>
|
||||
|
||||
<sect2>
|
||||
<title><filename>Makefile</filename></title>
|
||||
|
||||
<para>Le <filename>Makefile</filename> décrit les règles utilisées pour
|
||||
convertir le Manuel de Référence à partir du source (DocBook) dans
|
||||
plusieurs formats cibles (dont HTML, PostScript, et texte).</para>
|
||||
|
||||
<para>Le <filename>Makefile</filename> est décrit plus en détail à la
|
||||
<xref linkend="the-handbook-converting">.</para>
|
||||
</sect2>
|
||||
|
||||
<sect2>
|
||||
<title><filename>handbook.sgml</filename></title>
|
||||
|
||||
<para>C'est la racine du Manuel de Référence. Il contient la
|
||||
<link linkend="sgml-primer-doctype-declaration">déclaration
|
||||
DOCTYPE</link> du Manuel, ainsi que les éléments qui décrivent sa
|
||||
structure.</para>
|
||||
|
||||
<para><filename>handbook.sgml</filename> utilise des <link
|
||||
linkend="sgml-primer-parameter-entities">entités paramètres</link>
|
||||
pour charger les fichiers d'extensions <filename>.ent</filename>. Ces
|
||||
fichiers (décrits plus loin) définissent à leur tour des
|
||||
<link linkend="sgml-primer-general-entities">entités générales</link>
|
||||
qui sont elles-mêmes employées dans le reste du Manuel.</para>
|
||||
</sect2>
|
||||
|
||||
<sect2>
|
||||
<title><filename><replaceable>répertoire</replaceable>/chapter.sgml</filename></title>
|
||||
|
||||
<para>Chaque chapitre du manuel est composé d'un fichier
|
||||
<filename>chapter.sgml</filename> dans un sous-répertoire séparé pour
|
||||
chaque chapitre. Chaque répertoire prend le nom de l'attribut
|
||||
<literal>id</literal> de l'élément <sgmltag>chapter</sgmltag>.</para>
|
||||
|
||||
<para>Si par exemple, un des chapitres contient :</para>
|
||||
|
||||
<programlisting><![ CDATA [
|
||||
<chapter id="kernelconfiguration">
|
||||
...
|
||||
</chapter>]]></programlisting>
|
||||
|
||||
<para>il s'appelera alors <filename>chapter.sgml</filename> dans le
|
||||
répertoire <filename>kernelconfiguration</filename>. Habituellement,
|
||||
il y aura un seul fichier pour tout le chapitre.</para>
|
||||
|
||||
<para>A la génération de la version HTML du Manuel, on obtiendra un
|
||||
<filename>kernelconfiguration.html</filename>. C'est dû à la valeur
|
||||
du <literal>id</literal>, et non au nom du répertoire.</para>
|
||||
|
||||
<para>Dans les versions précédentes du Manuel, ces fichiers étaient dans
|
||||
le même répertoire que <filename>handbook.sgml</filename>, avec le
|
||||
même nom que l'attribut <literal>id</literal> de l'élément
|
||||
<sgmltag>chapter</sgmltag> du fichier. Ils ont été déplacés dans des
|
||||
répertoires séparés en prévision des évolutions à venir du Manuel. Il
|
||||
sera en particulier bientôt possible d'inclure des images dans chaque
|
||||
chapitre. Il est donc plus logique que celles-ci soient rangées dans
|
||||
un répertoire où se trouve aussi le texte du chapitre plutôt que de
|
||||
mettre le texte de chaque chapitre, et donc toutes les images dans un
|
||||
même répertoire. Il y aurait fatalement des conflits de nom, alors
|
||||
qu'il est plus facile de travailler avec plusieurs répertoires
|
||||
contenant quelques fichiers qu'avec un seul répertoire dans lequel il
|
||||
y a beaucoup de fichiers.</para>
|
||||
|
||||
<para>Un bref coup d'oeil montre qu'il y a de nombreux répertoires avec
|
||||
chacun un fichier <filename>chapter.sgml</filename> dont
|
||||
<filename>basics/chapter.sgml</filename>,
|
||||
<filename>introduction/chapter.sgml</filename> et
|
||||
<filename>printing/chapter.sgml</filename>.</para>
|
||||
|
||||
<important>
|
||||
<para>Les noms des chapitres et/ou répertoires ne doivent pas faire
|
||||
réference à leur place dans le Manuel. Cet ordre peut changer quand
|
||||
le contenu du Manuel est réorganisé ; ce type de réorganisation
|
||||
ne devrait (normalement) pas entraîner de modification des noms des
|
||||
fichiers (à moins que des chapitres entiers ne changent de niveau
|
||||
dans la hiérarchie).</para>
|
||||
</important>
|
||||
|
||||
<para>Chaque fichier <filename>chapter.sgml</filename> n'est pas un
|
||||
document SGML intégral. Ils n'ont en particulier pas de déclaration
|
||||
DOCTYPE en tête du fichier.</para>
|
||||
|
||||
<para>C'est dommage pour deux raisons :</para>
|
||||
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>Il n'est pas possible de les traiter comme des fichiers SGML
|
||||
et de les convertir en HTML, RTF, PS et autres formats de la même
|
||||
manière que le Manuel. Cela vous <emphasis>oblige</emphasis> à
|
||||
recompiler tout le Manuel chaque fois que vous voulez vérifier les
|
||||
effets d'une modification d'un seul chapitre.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para>Le <literal>sgml-mode</literal> d'Emacs ne peut pas s'en
|
||||
servir pour déterminer quelle DTD utiliser, ce qui fait perdre les
|
||||
bénéfices de fonctionnalités utiles du
|
||||
<literal>sgml-mode</literal> (complétion des éléments, validation
|
||||
automatique, et ainsi de suite).</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
||||
<sect1>
|
||||
<title>Guide de style</title>
|
||||
|
||||
<para>Respectez s'il vous plaît les conventions de style ci-dessous pour
|
||||
garder aux sources du Manuel une consistance malgré les nombreuses
|
||||
personnes qui interviennent dessus.</para>
|
||||
|
||||
<sect2>
|
||||
<title>Majuscules et minuscules</title>
|
||||
|
||||
<para>Les marques doivent être en minuscules
|
||||
<literal><para></literal> et <emphasis>non</emphasis>
|
||||
<literal><PARA></literal>.</para>
|
||||
|
||||
<para>Le texte dans les contextes SGML est normalement en majuscules,
|
||||
<literal><!ENTITY…></literal> ou
|
||||
<literal><!DOCTYPE…></literal> et
|
||||
<emphasis>non</emphasis> <literal><!entity…></literal>
|
||||
ou <literal><!doctype…></literal>.</para>
|
||||
</sect2>
|
||||
|
||||
<sect2>
|
||||
<title>Indentation</title>
|
||||
|
||||
<para>Chaque fichier est indenté à partir de la colonne 0,
|
||||
<emphasis>quel que soit</emphasis> le niveau d'indentation dans le
|
||||
fichier où il est inclus.</para>
|
||||
|
||||
<para>Chaque marque de début augmente l'indentation de 2 blancs et
|
||||
chaque marque de fin la décrémente d'autant. Le contenu des éléments
|
||||
doit être indenté de 2 blancs s'il court sur plusieurs lignes.</para>
|
||||
|
||||
<para>A titre d'exemple, voici à quoi ressemble le source de cette
|
||||
section :</para>
|
||||
|
||||
<programlisting>
|
||||
<![ CDATA [+--- C'est la colonne 0
|
||||
|
||||
<chapter>
|
||||
<title>...</title>
|
||||
|
||||
<sect1>
|
||||
<title>...</title>
|
||||
|
||||
<sect2>
|
||||
<title>Indentation</title>
|
||||
|
||||
<para>Chaque fichier est indenté à partir de la colonne 0,
|
||||
<emphasis>quel que soit</emphasis> le niveau d'indentation dans le
|
||||
fichier où il est inclus.</para>
|
||||
|
||||
<para>Chaque marque de début augmente l'indentation de 2 blancs et
|
||||
chaque marque de fin la décrémente d'autant. Le contenu des éléments
|
||||
doit être indenté de 2 blancs s'il court sur plusieurs lignes.</para>
|
||||
|
||||
...
|
||||
</sect2>
|
||||
</sect1>
|
||||
</chapter>]]></programlisting>
|
||||
|
||||
<para>Si vous vous servez d'<application>Emacs</application> ou
|
||||
<application>Xemacs</application> pour éditer les fichiers, le
|
||||
<literal>sgml-mode</literal> doit être chargé automatiquement, et les
|
||||
variables Emacs locales en fin de chaque fichier doivent mettre ces
|
||||
indentations en pratique.</para>
|
||||
</sect2>
|
||||
|
||||
<sect2>
|
||||
<title>Modifications de présentation des sources</title>
|
||||
|
||||
<para>Quand vous intégrez des modifications, <emphasis>ne faites pas en
|
||||
même temps de modification de contenu et de présentation des
|
||||
sources</emphasis>.</para>
|
||||
|
||||
<para>Cela pour que les équipes de traductions du Manuel puissent
|
||||
rapidement voir les modifications de contenu que vous avez intégrées,
|
||||
sans avoir à se demander si une ligne a changé de contenu ou
|
||||
simplement de présentation.</para>
|
||||
|
||||
<para>Si vous avez par exemple ajouté deux phrases à un paragraphe, de
|
||||
sorte que les lignes du paragraphe débordent maintenant des 80
|
||||
colonnes, intégrez d'abord la modification avec les lignes trop
|
||||
longues. Puis corrigez ensuite ce problème, en précisant qu'il ne
|
||||
s'agit que d'une modification de présentation, dont les équipes de
|
||||
traduction n'ont pas à se soucier.</para>
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
||||
<sect1 id="the-handbook-converting">
|
||||
<title>* Conversion du Manuel dans d'autres formats</title>
|
||||
|
||||
<para></para>
|
||||
</sect1>
|
||||
</chapter>
|
||||
|
||||
<!--
|
||||
Local Variables:
|
||||
mode: sgml
|
||||
sgml-declaration: "../chapter.decl"
|
||||
sgml-indent-data: t
|
||||
sgml-omittag: nil
|
||||
sgml-always-quote-attributes: t
|
||||
sgml-parent-document: ("../book.sgml" "part" "chapter")
|
||||
End:
|
||||
-->
|
||||
|
||||
49
fr_FR.ISO_8859-1/books/fdp-primer/the-website/chapter.sgml
Normal file
49
fr_FR.ISO_8859-1/books/fdp-primer/the-website/chapter.sgml
Normal file
|
|
@ -0,0 +1,49 @@
|
|||
<!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.
|
||||
|
||||
Redistribution and use in source (SGML DocBook) and 'compiled' forms
|
||||
(SGML HTML, PDF, PostScript, RTF and so forth) with or without
|
||||
modification, are permitted provided that the following conditions
|
||||
are met:
|
||||
|
||||
1. Redistributions of source code (SGML DocBook) must retain the above
|
||||
copyright notice, this list of conditions and the following
|
||||
disclaimer as the first lines of this file unmodified.
|
||||
|
||||
2. Redistributions in compiled form (transformed to other DTDs,
|
||||
converted to PDF, PostScript, RTF and other formats) must reproduce
|
||||
the above copyright notice, this list of conditions and the
|
||||
following disclaimer in the documentation and/or other materials
|
||||
provided with the distribution.
|
||||
|
||||
THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
|
||||
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
||||
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||||
DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
|
||||
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
||||
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
||||
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
||||
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
||||
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
|
||||
POSSIBILITY OF SUCH DAMAGE.
|
||||
|
||||
$Id: chapter.sgml,v 1.1 2000-06-12 15:46:59 gioria Exp $
|
||||
-->
|
||||
|
||||
<chapter id="the-website">
|
||||
<title>* Le site Web</title>
|
||||
|
||||
<para></para>
|
||||
</chapter>
|
||||
|
||||
<!--
|
||||
Local Variables:
|
||||
mode: sgml
|
||||
sgml-declaration: "../chapter.decl"
|
||||
sgml-indent-data: t
|
||||
sgml-omittag: nil
|
||||
sgml-always-quote-attributes: t
|
||||
sgml-parent-document: ("../book.sgml" "part" "chapter")
|
||||
End:
|
||||
-->
|
||||
|
||||
301
fr_FR.ISO_8859-1/books/fdp-primer/tools/chapter.sgml
Normal file
301
fr_FR.ISO_8859-1/books/fdp-primer/tools/chapter.sgml
Normal file
|
|
@ -0,0 +1,301 @@
|
|||
<!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.
|
||||
|
||||
Redistribution and use in source (SGML DocBook) and 'compiled' forms
|
||||
(SGML, HTML, PDF, PostScript, RTF and so forth) with or without
|
||||
modification, are permitted provided that the following conditions
|
||||
are met:
|
||||
|
||||
1. Redistributions of source code (SGML DocBook) must retain the above
|
||||
copyright notice, this list of conditions and the following
|
||||
disclaimer as the first lines of this file unmodified.
|
||||
|
||||
2. Redistributions in compiled form (transformed to other DTDs,
|
||||
converted to PDF, PostScript, RTF and other formats) must reproduce
|
||||
the above copyright notice, this list of conditions and the
|
||||
following disclaimer in the documentation and/or other materials
|
||||
provided with the distribution.
|
||||
|
||||
THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
|
||||
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
||||
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||||
DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
|
||||
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
||||
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
||||
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
||||
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
||||
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
|
||||
POSSIBILITY OF SUCH DAMAGE.
|
||||
|
||||
The FreeBSD Documentation Project
|
||||
The FreeBSD French Documentation Project
|
||||
|
||||
$Id: chapter.sgml,v 1.1 2000-06-12 15:47:01 gioria Exp $
|
||||
Original revision: 1.6
|
||||
-->
|
||||
|
||||
<chapter id="tools">
|
||||
<title>Outils</title>
|
||||
|
||||
<para>Le FDP utilise un certain nombre de logiciels pour faciliter la
|
||||
gestion de la documentation de FreeBSD, la convertir en différents
|
||||
formats, et ainsi de suite. Vous devrez vous-même vous servir de ces
|
||||
outils, si vous travaillez à la documentation de FreeBSD.</para>
|
||||
|
||||
<para>Tous ces outils existent sous forme de logiciels portés ou
|
||||
pré-compilés pour FreeBSD, ce qui vous simplifie beaucoup la tâche de leur
|
||||
installation.</para>
|
||||
|
||||
<para>Vous devrez les installer avant de mettre en pratique les exemples
|
||||
donnés dans les chapitres suivants. Ces chapitres vous expliquent comment
|
||||
vous servir de ces outils.</para>
|
||||
|
||||
<important>
|
||||
<title>Utilisez <filename>textproc/docproj</filename> si possible</title>
|
||||
|
||||
<para>Vous pouvez gagner beaucoup de temps si vous les installez avec
|
||||
<filename>textproc/docproj</filename>. C'est un
|
||||
<emphasis>méta-port</emphasis> qui ne contient pas lui-même de
|
||||
logiciels. Au lieu de cela, il dépend de l'installation correcte de
|
||||
divers autres logiciels portés. Son installation
|
||||
<emphasis>devrait</emphasis> télécharger et installer automatiquement
|
||||
tous les paquetages listés dans ce chapitre dont vous aurez besoin,
|
||||
s'ils n'existent pas déjà sur votre système.</para>
|
||||
|
||||
<para>L'un des paquetages dont vous aurez peut-être besoin est le jeu de
|
||||
macro-instructions JadeTeX. Celui-ci, à son tour, a besoin que TeX soit
|
||||
installé. TeX est un paquetage volumineux, dont vous n'aurez besoin que
|
||||
si vous voulez générer les versions PostScript et PDF.</para>
|
||||
|
||||
<para>Pour économiser du temps et de l'espace disque, vous pouvez préciser
|
||||
si vous voulez ou non installer JadeTeX (et donc TeX). Faites
|
||||
soit :</para>
|
||||
|
||||
<informalexample>
|
||||
<screen>&prompt.root; <userinput>make JADETEX=yes install</userinput></screen>
|
||||
</informalexample>
|
||||
|
||||
<para>ou :</para>
|
||||
|
||||
<informalexample>
|
||||
<screen>&prompt.root; <userinput>make JADETEX=no install</userinput></screen>
|
||||
</informalexample>
|
||||
|
||||
<para>selon le cas.</para>
|
||||
</important>
|
||||
|
||||
<sect1>
|
||||
<title>Outils indispensables</title>
|
||||
|
||||
<sect2>
|
||||
<title>Logiciels</title>
|
||||
|
||||
<para>Vous aurez besoin de ces programmes avant de pouvoir utilement
|
||||
travailler sur la documentation de FreeBSD. Ils font tous partie de
|
||||
<filename>textproc/docproj</filename>.</para>
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><application>SP</application>
|
||||
(<filename>textproc/sp</filename>)</term>
|
||||
|
||||
<listitem>
|
||||
<para>Une série d'applications, dont un analyseur syntaxique SGML
|
||||
et un outil de normalisation du source SGML.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><application>Jade</application>
|
||||
(<filename>textproc/jade</filename>)</term>
|
||||
|
||||
<listitem>
|
||||
<para>Une implémentation des DSSSL. Cela sert à convertir des
|
||||
documents marqués vers d'autres formats, dont HTML et
|
||||
TeX.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><application>Tidy</application>
|
||||
(<filename>www/tidy</filename>)</term>
|
||||
|
||||
<listitem>
|
||||
<para>Un formateur HTML, qui sert à remettre en forme le code HTML
|
||||
généré automatiquement pour qu'il soit plus lisible.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><application>Lynx</application>
|
||||
(<filename>www/lynx-current</filename>)</term>
|
||||
|
||||
<listitem>
|
||||
<para>Navigateur WWW en mode texte, &man.lynx.1; peut aussi
|
||||
convertir des fichiers HTML en fichiers texte.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
</sect2>
|
||||
|
||||
<sect2>
|
||||
<title>DTDs et Entités</title>
|
||||
|
||||
<para>Ce sont les DTDs et jeux d'entités utilisés par le FDP. Il faut
|
||||
les installer avant de pouvoir travailler à la documentation.</para>
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term>DTD HTML (<filename>textproc/html</filename>)</term>
|
||||
|
||||
<listitem>
|
||||
<para>HTML est le langage principal du <foreignphrase>World Wide
|
||||
Web</foreignphrase>, il est utilisé constamment par le site
|
||||
Web de FreeBSD.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term>DTD LinuxDoc
|
||||
(<filename>textproc/linuxdoc</filename>)</term>
|
||||
|
||||
<listitem>
|
||||
<para>Une partie de la documentation de FreeBSD est marquée avec
|
||||
LinuxDoc. Le FDP migre activement de LinuxDoc à DocBook.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term>DTD DocBook
|
||||
(<filename>textproc/docbook</filename>)</term>
|
||||
|
||||
<listitem>
|
||||
<para>DocBook est conçu pour le marquage de documentation
|
||||
technique et le FDP est en cours de migration de LinuxDoc à
|
||||
DocBook. A la date de rédaction de cette documentation, celle-ci
|
||||
et le Manuel de Référence de FreeBSD sont au format
|
||||
DocBook.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term>Entités ISO 8879
|
||||
(<filename>textproc/iso8879</filename>)</term>
|
||||
|
||||
<listitem>
|
||||
<para>19 de jeux de caractères ISO 8879:1986 utilisés par de
|
||||
nombreuses DTDs. Cela comprend des symboles mathématiques
|
||||
nommés, les caractères “latins” supplémentaires
|
||||
(accents, signes diacritiques et ainsi de suite) et les lettres
|
||||
grecques.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
</sect2>
|
||||
|
||||
<sect2>
|
||||
<title>Feuilles de style</title>
|
||||
|
||||
<para>Les feuilles de style sont utilisées pour convertir et formater
|
||||
la documentation pour l'affichage à l'écran, l'impression, et ainsi de
|
||||
suite.</para>
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term>Les <foreignphrase>Modular DocBook Stylesheets</foreignphrase>
|
||||
(<filename>textproc/dsssl-docbook-modular</filename>)</term>
|
||||
|
||||
<listitem>
|
||||
<para>Les <foreignphrase>Modular DocBook
|
||||
Stylesheets</foreignphrase> sont utilisées pour convertir la
|
||||
documentation marqué en DocBook aux autres formats, comme HTML
|
||||
ou RTF.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
||||
<sect1>
|
||||
<title>Outils facultatifs</title>
|
||||
|
||||
<para>Il n'est pas obligatoire d'installer les outils qui suivent. Si vous
|
||||
le faites cependant, vous trouverez peut-être plus facile de travailler
|
||||
à la documentation et ils vous donneront plus de possibilité de choix du
|
||||
format de sortie.</para>
|
||||
|
||||
<sect2>
|
||||
<title>Logiciels</title>
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><application>JadeTeX</application> et
|
||||
<application>teTeX</application>
|
||||
(<filename>print/jadetex</filename> et
|
||||
<filename>print/teTeX</filename>)</term>
|
||||
|
||||
<listitem>
|
||||
<para><application>Jade</application> et
|
||||
<application>teTeX</application> servent à convertir les
|
||||
documents DocBook en DVI, Postscript et PDF. Il faut pour cela
|
||||
les macro-instructions
|
||||
<application>JadeTeX</application>.</para>
|
||||
|
||||
<para>Si vous n'avez pas l'intention de convertir votre
|
||||
documentation à l'un de ces formats (i.e., HTML, texte et RTF
|
||||
vous suffisent), il n'est pas nécessaire d'installer
|
||||
<application>JadeTeX</application> et
|
||||
<application>teTeX</application>. Cela vous fera gagner du temps
|
||||
et de l'espace disque, <application>teTeX</application>, en
|
||||
effet occupe plus de 30 Mo.</para>
|
||||
|
||||
<important>
|
||||
<para>Si vous choisissez d'installer
|
||||
<application>JadeTeX</application> et
|
||||
<application>teTeX</application>, vous devrez configurer
|
||||
<application>teTeX</application> après avoir installé
|
||||
<application>JadeTeX</application>.
|
||||
<filename>print/jadetex/pkg/MESSAGE</filename> vous donnera
|
||||
des instructions détaillées sur la façon de procéder.</para>
|
||||
</important>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><application>Emacs</application> ou
|
||||
<application>xemacs</application>
|
||||
(<filename>editors/emacs</filename> ou
|
||||
<filename>editors/xemacs</filename>)</term>
|
||||
|
||||
<listitem>
|
||||
<para>Ces deux éditeurs ont un mode spécialisé pour travailler sur
|
||||
des documents marqués conformément à une DTD SGML. Cela vous
|
||||
permet d'avoir moins de choses à saisir et limite la possibilité
|
||||
d'erreurs.</para>
|
||||
|
||||
<para>Vous n'êtes pas obligé de les utiliser, n'importe quel
|
||||
éditeur peut servir avec des documents marqués. Mais vous
|
||||
trouverez peut-être qu'ils vous permettent d'être plus
|
||||
efficace.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
|
||||
<para>Si quelqu'un a d'autres outils utiles pour manipuler des documents
|
||||
SGML, merci de transmettre l'information à Nik Clayton
|
||||
(nik@freebsd.org), de façon à ce qu'il les ajoute à cette
|
||||
liste.</para>
|
||||
</sect2>
|
||||
</sect1>
|
||||
</chapter>
|
||||
|
||||
<!--
|
||||
Local Variables:
|
||||
mode: sgml
|
||||
sgml-declaration: "../chapter.decl"
|
||||
sgml-indent-data: t
|
||||
sgml-omittag: nil
|
||||
sgml-always-quote-attributes: t
|
||||
sgml-parent-document: ("../book.sgml" "part" "chapter")
|
||||
End:
|
||||
-->
|
||||
497
fr_FR.ISO_8859-1/books/fdp-primer/translations/chapter.sgml
Normal file
497
fr_FR.ISO_8859-1/books/fdp-primer/translations/chapter.sgml
Normal file
|
|
@ -0,0 +1,497 @@
|
|||
<!-- Copyright (c) 1999 Nik Clayton, All rights reserved.
|
||||
|
||||
Redistribution and use in source (SGML DocBook) and 'compiled' forms
|
||||
(SGML HTML, PDF, PostScript, RTF and so forth) with or without
|
||||
modification, are permitted provided that the following conditions
|
||||
are met:
|
||||
|
||||
1. Redistributions of source code (SGML DocBook) must retain the above
|
||||
copyright notice, this list of conditions and the following
|
||||
disclaimer as the first lines of this file unmodified.
|
||||
|
||||
2. Redistributions in compiled form (transformed to other DTDs,
|
||||
converted to PDF, PostScript, RTF and other formats) must reproduce
|
||||
the above copyright notice, this list of conditions and the
|
||||
following disclaimer in the documentation and/or other materials
|
||||
provided with the distribution.
|
||||
|
||||
THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
|
||||
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
||||
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||||
DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
|
||||
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
||||
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
||||
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
||||
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
||||
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
|
||||
POSSIBILITY OF SUCH DAMAGE.
|
||||
|
||||
$Id: chapter.sgml,v 1.1 2000-06-12 15:47:06 gioria Exp $
|
||||
-->
|
||||
|
||||
<chapter id="translations">
|
||||
<title>Traductions</title>
|
||||
|
||||
<para>Ceci est la Foire aux Questions pour les gens qui traduisent la
|
||||
documentation de FreeBSD (FAQ, Manuel de Référence, guides, pages de
|
||||
manuel et autres) en différentes langues.</para>
|
||||
|
||||
<para>Elle est <emphasis>très</emphasis> largement basée sur la FAQ du
|
||||
Projet Allemand de Documentation de FreeBSD, rédigée à l'origine par
|
||||
Frank Grnder <email>elwood@mc5sys.in-berlin.de</email> et traduite en
|
||||
Anglais par Bernd Warken <email>bwarken@mayn.de</email>.</para>
|
||||
|
||||
<para>Nik Clayton <email>nik@FreeBSD.org</email> maintient cette FAQ.</para>
|
||||
|
||||
<qandaset>
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>Pourquoi une FAQ ?</para>
|
||||
</question>
|
||||
|
||||
<answer>
|
||||
<para>De plus en plus de gens s'adressent à la &a.doc; et se proposent
|
||||
de traduire en d'autres langues la documentation de FreeBSD. Le but
|
||||
de cette FAQ est de répondre à leurs questions de façon à ce qu'ils
|
||||
puissent commencer le plus rapidement possible à traduire la
|
||||
documentation.</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>Que signfient <phrase>i18n</phrase> et
|
||||
<phrase>l10n</phrase> ?</para>
|
||||
</question>
|
||||
|
||||
<answer>
|
||||
<para><phrase>i18n</phrase> veut dire
|
||||
<phrase>internationalisation</phrase> et <phrase>l10n</phrase>
|
||||
<phrase>localisation</phrase>. Ce ne sont que des abréviations
|
||||
commodes.</para>
|
||||
|
||||
<para><phrase>i18n</phrase> se lit “i” suivi de 18
|
||||
lettres, suivies d'un “n”. De la même façon,
|
||||
<phrase>l10n</phrase> se lit “l” suivi de 10 lettres,
|
||||
suivies d'un “n”.</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>Y-a-t-il une liste de diffusion pour les
|
||||
traducteurs ?</para>
|
||||
</question>
|
||||
|
||||
<answer>
|
||||
<para>Oui, <email>freebsd-translate@ngo.org.uk</email>. Inscrivez-vous
|
||||
en envoyant un message à
|
||||
<email>freebsd-translate-request@ngo.org.uk</email> avec le mot
|
||||
<literal>subscribe</literal> dans le texte du message.</para>
|
||||
|
||||
<para>Vous recevrez une réponse vous demandant de confirmer votre
|
||||
inscription (de la même façon que pour les listes de FreeBSD sur
|
||||
<hostid role="domainname">FreeBSD.org</hostid>).</para>
|
||||
|
||||
<para>La langue de base sur la liste est l'Anglais, mais les messages
|
||||
en d'autres langues sont acceptés. La liste n'est pas modérée, mais
|
||||
vous devez vous y être inscrit avant d'y adresser des
|
||||
messages.</para>
|
||||
|
||||
<para>La liste est archivée, mais il n'est pas actuellement possible
|
||||
d'y faire des recherches. Vous aurez en retour des explications sur
|
||||
la façon d'accéder aux archives en envoyant le message
|
||||
<literal>help</literal> à
|
||||
<email>majordomo@ngo.org.uk</email>.</para>
|
||||
|
||||
<para>Il est prévue que la liste de diffusion soit transférée sur
|
||||
<hostid role="domainname">FreeBSD.org</hostid> et devienne donc
|
||||
<emphasis>officielle</emphasis> dans un avenir proche.</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>A-t-on besoin de nouveaux traducteurs ?</para>
|
||||
</question>
|
||||
|
||||
<answer>
|
||||
<para>Oui. Plus il y a de gens qui travaillent aux traductions, plus
|
||||
vite elles sont réalisées, et synchronisées avec les modifications
|
||||
de la version anglaise.</para>
|
||||
|
||||
<para>Il n'est pas nécessaire que vous soyez traducteur professionnel
|
||||
pour pouvoir contribuer.</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>Quelle langue faut-il que je connaisse ?</para>
|
||||
</question>
|
||||
|
||||
<answer>
|
||||
<para>Dans l'idéal, il faudrait que vous ayez une bonne connaissance
|
||||
de l'anglais écrit et bien sûr, il faut que vous pratiquiez
|
||||
couramment la langue dans laquelle vous traduisez.</para>
|
||||
|
||||
<para>L'anglais n'est pas strictement indispensable. Vous pourriez par
|
||||
exemple effectuez une traduction en Hongrois, à partir de la
|
||||
traduction espagnole de la FAQ.</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>Quels logiciels faut-il que je connaisse ?</para>
|
||||
</question>
|
||||
|
||||
<answer>
|
||||
<para>Il est fortement recommandé que vous teniez à jour une copie
|
||||
locale des archives CVS de FreeBSD (au moins de la documentation),
|
||||
soit à l'aide de <application>CTM</application>, soit en utilisant
|
||||
<application>CVSup</application>. Le chapitre “Se synchroniser
|
||||
avec la version <literal>-current</literal> de FreeBSD” du
|
||||
Manuel de Référence vous explique comment utiliser ces
|
||||
logiciels.</para>
|
||||
|
||||
<para>Il faudra que vous soyiez à l'aise avec
|
||||
<application>CVS</application>. Cela vous permettra de suivre les
|
||||
modifications apportées entre les différentes versions des
|
||||
fichiers qui constituent la documentation.</para>
|
||||
|
||||
<para>[A Faire -- écrire un mode d'emploi qui explique comment
|
||||
utiliser <application>CVSup</application> pour ne récupérer que la
|
||||
documentation, et voir ce qui a évolué entre deux versions
|
||||
données]</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>Comment savoir qui d'autre traduit la documentation dans la
|
||||
même langue ?</para>
|
||||
</question>
|
||||
|
||||
<answer>
|
||||
<para>La <ulink
|
||||
url="http://www.freebsd.org/docproj/translations.html">page des
|
||||
traductions du Projet de Documentation</ulink> liste les traductions
|
||||
en cours déjà connues. S'il y a déjà d'autres personnes qui
|
||||
travaillent à la traduction de documentation dans votre langue, s'il
|
||||
vous plaît, ne faites pas le même travail qu'eux en double. Au lieu
|
||||
de cela, prenez contact avec eux, pour savoir comment vous pouvez
|
||||
les aider.</para>
|
||||
|
||||
<para>S'il la page n'indique personne qui travaille dans votre langue,
|
||||
envoyez un message à la &a.doc; au cas où quelqu'un aurait déjà
|
||||
envisagé de commencer une traduction, mais que ne ce soit pas encore
|
||||
signalé.</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>Il n'y a personne d'autre qui traduise dans ma langue. Que
|
||||
faire ?</para>
|
||||
</question>
|
||||
|
||||
<answer>
|
||||
<para>Félicitations, vous venez juste de lancer le “Projet de
|
||||
Documentation <replaceable>dans-votre-langue</replaceable> de
|
||||
FreeBSD. Bien venu à bord.</para>
|
||||
|
||||
<para>Commencez par vous assurer que vous avez bien du temps
|
||||
disponible. Comme vous êtes pour le moment le seul volontaire pour
|
||||
la traduction dans votre langue, il sera de votre responsabilité
|
||||
de publier votre travail et de coordonner celui d'autres personnes
|
||||
qui voudraient y collaborer.</para>
|
||||
|
||||
<para>Envoyez un courrier électronique à la &a.doc; pour annoncer que
|
||||
vous allez traduire la documentation de façon à ce que la pages des
|
||||
traductions du Projet de Documentation puisse être tenue à
|
||||
jour.</para>
|
||||
|
||||
<para>Il faudra vous inscrire à la liste de diffusion
|
||||
<email>freebsd-translate@ngo.org.uk</email> (comme expliqué plus
|
||||
haut).</para>
|
||||
|
||||
<para>S'il y a déjà dans votre pays quelqu'un qui maintienne un site
|
||||
miroir de FreeBSD, vous devriez le contacter et voir s'il peut vous
|
||||
fournir un hébergement pour votre projet et, si possible, une
|
||||
adresse de courrier électronique et la possibilité de mettre en
|
||||
place une liste de diffusion.</para>
|
||||
|
||||
<para>Choisissez ensuite une documentation et commencez la traduction.
|
||||
Il vaut mieux commencer par quelque chose de pas trop
|
||||
volumineux—soit la FAQ, soit l'un des guides.</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>J'ai traduit une documentation, à qui dois-je
|
||||
l'envoyer ?</para>
|
||||
</question>
|
||||
|
||||
<answer>
|
||||
<para>Cela dépend. Si vous travaillez déjà au sein d'une équipe de
|
||||
traduction (comme l'équipe Japonaise ou l'équipe Allemande), elle
|
||||
aura ses propres procédures pour gérer la documentation soumise, qui
|
||||
seront décrites dans ses pages Web.</para>
|
||||
|
||||
<para>Si vous êtes la seule personne à travailler dans une langue
|
||||
donnée (ou si vous êtes responsable d'un projet de traduction et
|
||||
voulez soumettre votre travail au Projet FreeBSD), vous devez alors
|
||||
l'envoyer au Projet FreeBSD (voir la question suivante).</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>Je suis la seule personne à traduire dans cette langue, comment
|
||||
soumettre mes traductions ?</para>
|
||||
|
||||
<para>ou</para>
|
||||
|
||||
<para>Nous sommes une équipe de traduction et voulons soumettre les
|
||||
traductions de nos membres ?</para>
|
||||
</question>
|
||||
|
||||
<answer>
|
||||
<para>Commencez par vérifier que vos traductions sont correctement
|
||||
structurées. C'est-à-dire qu'elles doivent s'intégrer à
|
||||
l'arborescence des documentations existantes et compiler sans
|
||||
problèmes.</para>
|
||||
|
||||
<para>La documentation de FreeBSD est actuellement archivée dans les
|
||||
répertoires en dessous de <filename>doc/</filename>. Les
|
||||
sous-répertoires de celui-ci prennent le nom codifiant la langue
|
||||
dans laquelle les documentations sont écrites, selon la norme
|
||||
ISO639 (<filename>/usr/share/misc/iso639</filename>, pour les
|
||||
versions de FreeBSD postérieures au 20 Janvier 1999).</para>
|
||||
|
||||
<para>S'il ya a différentes codifications pour votre langue
|
||||
(le Chinois,par exemple), il y aura au niveau en-dessous plusieurs
|
||||
sous-répertoires, un pour chacun des formats de codage que vous
|
||||
aurez fournis.</para>
|
||||
|
||||
<para>Vous aurez enfin des sous-répertoires pour chaque
|
||||
document.</para>
|
||||
|
||||
<para>Une éventuelle traduction en Suédois ressemblerait par exemple
|
||||
à ce qui suit :</para>
|
||||
|
||||
<programlisting> doc/
|
||||
sv/
|
||||
Makefile
|
||||
FAQ/
|
||||
Makefile
|
||||
*.sgml</programlisting>
|
||||
|
||||
<para><literal>sv</literal> est le code ISO639 pour le Suédois.
|
||||
Remarquez les deux <filename>Makefile</filename>s, qui servent à
|
||||
compiler la documentation. Il n'y a qu'une seule façon de coder le
|
||||
Suédois, il n'y a donc pas de niveau intermédiaire entre
|
||||
les répertoires <filename>sv</filename> et
|
||||
<filename>FAQ</filename><footnote><para>Cette organisation va
|
||||
radicalement changer très bientôt. Suivez ce qui ce dit sur la
|
||||
&a.doc; pour plus d'information.</para></footnote>.</para>
|
||||
|
||||
<para>Utilisez &man.tar.1; et &man.gzip.1; pour compresser votre
|
||||
documentation, et envoyez-la au projet.</para>
|
||||
|
||||
<screen>&prompt.user; <userinput>cd doc</userinput>
|
||||
&prompt.user; <userinput>tar cf swedish-docs.tar sv</userinput>
|
||||
&prompt.user; <userinput>gzip -9 swedish-docs.tar</userinput></screen>
|
||||
|
||||
<para>Mettez <filename>swedish-docs.tar.gz</filename> quelque part. Si
|
||||
vous ne disposez pas d'espace sur le Web (votre fournisseur d'accès
|
||||
n'en met peut-être pas à votre disposition), vous pouvez envoyer un
|
||||
courrier électronique à &a.nik;, pour vous mettre d'accord sur une
|
||||
date pour les lui envoyer par courrier.</para>
|
||||
|
||||
<para>De quelque façon que vous procédiez, il faudra que vous utilisez
|
||||
&man.send-pr.1; pour envoyer un rapport signalant que vous avez
|
||||
soumis de la documentation. Il serait très utile que d'autres
|
||||
puissent relire votre traduction d'abord, parce qu'il y a peu de
|
||||
chances que la personne qui l'intégrera connaisse bien votre
|
||||
langue.</para>
|
||||
|
||||
<para>Quelqu'un (probablement le Responsbale du Projet de
|
||||
Documentation, &a.nik; actuellement), récupérera votre traduction et
|
||||
s'assurera qu'elle compile. En particulier, les points suivants
|
||||
seront examinés :</para>
|
||||
|
||||
<orderedlist>
|
||||
<listitem>
|
||||
<para>Tous vos fichiers utilisent-ils de chaînes RCS (comme
|
||||
“ID”).</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><command>make all</command> fonctionne-t-il correctement
|
||||
dans le répertoire <filename>sv</filename>.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><command>make install</command> fonctionne-t-il
|
||||
correctement.</para>
|
||||
</listitem>
|
||||
</orderedlist>
|
||||
|
||||
<para>S'il y a des problèmes, la personne qui examine votre soumission
|
||||
vous en fera part pour que vous essayiez de les régler.</para>
|
||||
|
||||
<para>S'il n'y a pas de problèmes, votre traduction sera intégrée
|
||||
aussi vite que possible.</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>Puis-je inclure dans mon texte des considérations propres à la
|
||||
langue ou au pays ?</para>
|
||||
</question>
|
||||
|
||||
<answer>
|
||||
<para>Nous préférerions que vous ne le fassiez pas.</para>
|
||||
|
||||
<para>Supposons par exemple que vous traduisiez le Manuel de Référence
|
||||
en Coréen et que vous vouliez inclure une section sur les revendeurs
|
||||
en Corée dans votre Manuel.</para>
|
||||
|
||||
<para>Il n'y a pas vraiment de raison pour que cette information
|
||||
ne soit pas aussi présente dans la version anglaise (ou allemande,
|
||||
espagnole, …). Il se peut qu'un anglophone ait besoin d'un
|
||||
exemplaire de FreeBSD alors qu'il se trouve en Corée. Cela permet
|
||||
aussi de mettre en avant la pénétration de FreeBSD dans le monde
|
||||
entier, ce qui n'est pas une mauvaise chose.</para>
|
||||
|
||||
<para>Si vous avez des informations propres à un pays donné,
|
||||
soumettez-les d'abord sous forme de modifications à la version
|
||||
anglaise du Manuel de Référence (avec &man.send-pr.1;) et
|
||||
traduisez-les ensuite dans votre langue dans le Manuel de
|
||||
Référence dans cette langue.</para>
|
||||
|
||||
<para>Merci.</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>Comment faut-il coder les caractères propres à une
|
||||
langue ?</para>
|
||||
|
||||
<para>Dans les documentations, les caractères Non-ASCII doivent
|
||||
apparaître sous forme d'entités SGML.</para>
|
||||
|
||||
<para>Brièvement, celles-ci sont constituées d'une perluette (&),
|
||||
du nom de l'entité, et d'un point-virgule (;).</para>
|
||||
|
||||
<para>Les noms des entités sont définis par la norme ISO8879, que vous
|
||||
trouverez dans le catalogue des logiciels portés, sous
|
||||
<filename>textproc/iso8879</filename>.</para>
|
||||
|
||||
<para>Voici quelques examples :</para>
|
||||
|
||||
<segmentedlist>
|
||||
<seglistitem>
|
||||
<seg>&eacute;</seg>
|
||||
<seg>é</seg>
|
||||
<seg>“e” accent aigu minuscule</seg>
|
||||
</seglistitem>
|
||||
|
||||
<seglistitem>
|
||||
<seg>&Eacute;</seg>
|
||||
<seg>É</seg>
|
||||
<seg>“e” accent aigu majuscule</seg>
|
||||
</seglistitem>
|
||||
|
||||
<seglistitem>
|
||||
<seg>&uuml;</seg>
|
||||
<seg>ü</seg>
|
||||
<seg>“u” tréma minuscule</seg>
|
||||
</seglistitem>
|
||||
</segmentedlist>
|
||||
|
||||
<para>Après installation du logiciel porté “iso8879”, le
|
||||
fichier <filename>/usr/local/share/sgml/iso8879</filename> en donne
|
||||
la liste complète.</para>
|
||||
</question>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>Comment doit-on s'adresser au lecteur ?</para>
|
||||
</question>
|
||||
|
||||
<answer>
|
||||
<para>Dans les documents anglais, le
|
||||
“<foreignphrase>you</foreignphrase>” est employé, il n'y
|
||||
a qu'une seule forme, à l'inverse d'autres langues.</para>
|
||||
|
||||
<para>Si vous traduisez dans une langue qui dispose de plusieurs
|
||||
formes, utilisez celle que l'on emploie habituellement dans les
|
||||
documentations techniques. En cas de doute, servez-vous d'une forme
|
||||
de politesse courante.</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>Y'a-t-il des informations supplémentaires à inclure dans les
|
||||
traductions ?</para>
|
||||
</question>
|
||||
|
||||
<answer>
|
||||
<para>Oui.</para>
|
||||
|
||||
<para>Les en-têtes de la version anglaise du document ressembleront à
|
||||
ceci :</para>
|
||||
|
||||
<programlisting><![ CDATA [<!--
|
||||
The FreeBSD Documentation Project
|
||||
|
||||
$Id: chapter.sgml,v 1.11 1999/06/20 21:18:57 billf Exp $
|
||||
-->]]></programlisting>
|
||||
|
||||
<para>La forme exacte peut changer, mais elles comporteront toujours
|
||||
la ligne “Id” et la phrase <literal>The FreeBSD
|
||||
Documentation Project</literal>.</para>
|
||||
|
||||
<para>Vos traductions doivent comporter leur propre ligne
|
||||
“Id” et <literal>FreeBSD Documentation Project</literal>
|
||||
doit être remplacé par <literal>The FreeBSD
|
||||
<replaceable>Langue</replaceable> Documentation
|
||||
Project</literal>.</para>
|
||||
|
||||
<para>Vous devrez aussi ajouter une troisième ligne qui donne la
|
||||
version anglaise d'origine sur laquelle est basée la
|
||||
traduction.</para>
|
||||
|
||||
<para>Donc, la version espagnole du présent fichier commencerait
|
||||
par :</para>
|
||||
|
||||
<programlisting><![ CDATA [<!--
|
||||
The FreeBSD Spanish Documentation Project
|
||||
|
||||
$Id: chapter.sgml,v 1.3 1999/06/24 19:12:32 jesusr Exp $
|
||||
Original revision: 1.11
|
||||
-->]]></programlisting>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
</qandaset>
|
||||
</chapter>
|
||||
|
||||
<!--
|
||||
Local Variables:
|
||||
mode: sgml
|
||||
sgml-declaration: "../chapter.decl"
|
||||
sgml-indent-data: t
|
||||
sgml-omittag: nil
|
||||
sgml-always-quote-attributes: t
|
||||
sgml-parent-document: ("../book.sgml" "part" "chapter")
|
||||
End:
|
||||
-->
|
||||
149
fr_FR.ISO_8859-1/books/fdp-primer/writing-style/chapter.sgml
Normal file
149
fr_FR.ISO_8859-1/books/fdp-primer/writing-style/chapter.sgml
Normal file
|
|
@ -0,0 +1,149 @@
|
|||
<!-- Copyright (c) 1998 Nik Clayton, All rights reserved.
|
||||
|
||||
Redistribution and use in source (SGML DocBook) and 'compiled' forms
|
||||
(SGML HTML, PDF, PostScript, RTF and so forth) with or without
|
||||
modification, are permitted provided that the following conditions
|
||||
are met:
|
||||
|
||||
1. Redistributions of source code (SGML DocBook) must retain the above
|
||||
copyright notice, this list of conditions and the following
|
||||
disclaimer as the first lines of this file unmodified.
|
||||
|
||||
2. Redistributions in compiled form (transformed to other DTDs,
|
||||
converted to PDF, PostScript, RTF and other formats) must reproduce
|
||||
the above copyright notice, this list of conditions and the
|
||||
following disclaimer in the documentation and/or other materials
|
||||
provided with the distribution.
|
||||
|
||||
THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
|
||||
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
||||
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||||
DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
|
||||
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
||||
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
||||
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
||||
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
||||
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
|
||||
POSSIBILITY OF SUCH DAMAGE.
|
||||
|
||||
$Id: chapter.sgml,v 1.1 2000-06-12 15:47:08 gioria Exp $
|
||||
-->
|
||||
|
||||
<chapter id="writing-style">
|
||||
<title> Style</title>
|
||||
|
||||
<para>Pour conserver une certaine cohérence entre le travail des nombreux
|
||||
rédacteurs de la documentation de FreeBSD, on a défini quelques règles à
|
||||
suivre.</para>
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term>N'utilisez pas de formes contractées</term>
|
||||
|
||||
<listitem>
|
||||
<para>N'utilisez pas de formes contractées. Utilisez toujours les mots
|
||||
entiers. “<foreignphrase>Don't use
|
||||
contractions</foreignphrase>” n'est pas
|
||||
correct<footnote><para>N.d.T.: Ceci s'applique bien sûr aux textes
|
||||
rédigés en anglais.</para></footnote>.</para>
|
||||
|
||||
<para>Ne pas contracter donne au texte un ton plus formel, est plus
|
||||
précis, et facilite la tâche des traducteurs.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term>Utilisez la virgule dans les énumérations</term>
|
||||
|
||||
<listitem>
|
||||
<para>Dans une énumération au sein d'un paragraphe, séparez avec des
|
||||
virgules les éléments les uns des autres. Mettez aussi un virgule et
|
||||
la conjonction “et” avant le dernier élément.</para>
|
||||
|
||||
<para>Examinez par exemple la phrase suivante :</para>
|
||||
|
||||
<blockquote>
|
||||
<para>C'est une liste d'un, deux et trois éléments.</para>
|
||||
</blockquote>
|
||||
|
||||
<para>Est-ce une liste de trois éléments, “un”,
|
||||
“deux”, et “trois”, ou une liste de deux
|
||||
éléments, “un” et “deux et
|
||||
trois” ?</para>
|
||||
|
||||
<para>Il vaut mieux être explicite et ajouter la dernière
|
||||
virgule :</para>
|
||||
|
||||
<blockquote>
|
||||
<para>C'est une liste d'un, deux, et trois éléments.</para>
|
||||
</blockquote>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term>Evitez les redondances</term>
|
||||
|
||||
<listitem>
|
||||
<para>Evitez les redondances. En particulier, “la
|
||||
commande”, “le fichier”, et “man
|
||||
commande” sont probablement redondants.</para>
|
||||
|
||||
<para>Voici deux exemples pour ce qui concerne les commandes. Il est
|
||||
préférable d'utiliser le second.</para>
|
||||
|
||||
<informalexample>
|
||||
<para>Utilisez la commande <command>cvsup</command> pour mettre à
|
||||
jour vos sources.</para>
|
||||
</informalexample>
|
||||
|
||||
<informalexample>
|
||||
<para>Utilisez <command>cvsup</command> pour mettre à jour vos
|
||||
sources.</para>
|
||||
</informalexample>
|
||||
|
||||
<para>Voici deux exemples pour ce qui concerne les noms de fichiers.
|
||||
Il est préférable d'utiliser le second.</para>
|
||||
|
||||
<informalexample>
|
||||
<para>… dans le fichier
|
||||
<filename>/etc/rc.local</filename>…</para>
|
||||
</informalexample>
|
||||
|
||||
<informalexample>
|
||||
<para>… dans
|
||||
<filename>/etc/rc.local</filename>…</para>
|
||||
</informalexample>
|
||||
|
||||
<para>Voici enfin deux exemples pour les références aux pages de
|
||||
manuel. Il est préférable d'utiliser le second (il emploie
|
||||
<sgmltag>citerefentry</sgmltag>).</para>
|
||||
|
||||
<informalexample>
|
||||
<para>Voyez <command>man csh</command> pour plus
|
||||
d'information.</para>
|
||||
</informalexample>
|
||||
|
||||
<informalexample>
|
||||
<para>Voyez &man.csh.1;</para>
|
||||
</informalexample>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
|
||||
<para>Pour des détails sur le style, consultez les <ulink
|
||||
url="http://www.columbia.edu/acis/bartleby/strunk/"><foreignphrase>Eléments
|
||||
de Style</foreignphrase></ulink>, de William Strunk.</para>
|
||||
</chapter>
|
||||
|
||||
<!--
|
||||
Local Variables:
|
||||
mode: sgml
|
||||
sgml-declaration: "../chapter.decl"
|
||||
sgml-indent-data: t
|
||||
sgml-omittag: nil
|
||||
sgml-always-quote-attributes: t
|
||||
sgml-parent-document: ("../book.sgml" "part" "chapter")
|
||||
End:
|
||||
-->
|
||||
|
||||
Loading…
Reference in a new issue