0 - en to fr translation catalogue (33 entries)

en: Using sets
fr: Utilisation des collections

en: A <firstterm>set</firstterm> is a collection of books, published as a single output. The <citetitle>Services Plan</citetitle> for example is a set comprised of many books such as the <citetitle>Developer Guide</citetitle>, <citetitle>Engineering Content Services Guide</citetitle> and the <citetitle>Engineering Operations Guide</citetitle> to name just a few. The <prompt>$</prompt> <command>create_book</command> command creates a template for a set by setting the <parameter>type</parameter> parameter to <literal>Set</literal>.
fr: Une <firstterm>collection</firstterm> est un ensemble d'ouvrages, publiés sur une sortie unique. Par exemple, l'<citetitle>Organisation des services</citetitle> est un ensemble de plusieurs ouvrages comme le <citetitle>Guide du développeur</citetitle>, <citetitle>Guide des Services Ingénierie des contenus</citetitle> et le <citetitle>Guide d'Ingénierie des Opérations</citetitle> pour n'en citer que quelques uns. La commande <prompt>$</prompt> <command>create_book</command> crée un canevas pour une collection en fixant la valeur du paramètre <parameter>type</parameter> à <literal>Set</literal>.

en: There are two types of set:
fr: Il y a deux types de collections :

en: <firstterm>stand-alone sets</firstterm>
fr: les <firstterm>ensembles autonomes</firstterm>,

en: <firstterm>distributed sets</firstterm>
fr: les <firstterm>ensembles distribués</firstterm>.

en: Stand-alone sets
fr: Ensembles autonomes

en: A stand-alone set contains the XML files for each book, all of which are located inside the directory of the set. Stand-alone sets are always built as a set; you cannot build the individual books on their own without modification.
fr: Un ensemble autonome contient les fichiers XML de chaque ouvrage, chacun d'entre eux situé dans le répertoire de la collection. Les ensembles autonomes sont toujours construits en tant qu'ensemble ; vous ne pouvez pas construire isolément chaque livre de la collection sans modification.

en: The procedure that follows will guide you through the process of creating a stand-alone set named <citetitle>My Set</citetitle> located in a directory called <filename>books/My_Set/</filename>. The set will contain <citetitle>Book A</citetitle> and <citetitle>Book B</citetitle> both of which will be manually created inside the <filename>books/My_Set/en-US</filename> directory.
fr: La procédure suivante vous guide dans le processus de création d'une collection autonome nommée <citetitle>My Set</citetitle>, située dans un répertoire nommé <filename>books/My_Set/</filename>. Cet ensemble contient <citetitle>Book A</citetitle> et <citetitle>Book B</citetitle>, chacun d'entre eux rédigé manuellement et placé dans le répertoire <filename>books/My_Set/en-US</filename>.

en: Creating a stand-alone set
fr: Création d'un ensemble autonome

en: Run the following command in a shell in the <filename>books/</filename> directory to create a set named <literal>My_Set</literal> branded in the Red Hat style and in which the XML will be written in American English.
fr: Exécutez, dans un terminal, la commande suivante en vous plaçant dans le répertoire <filename>books/</filename> pour créer un ensemble nommé <literal>My_Set</literal> avec la charte graphique Red Hat et dans laquelle les XML sont écrits en anglais (américain).

en: <prompt>$</prompt> <command>cd</command> into the <filename>My_Set/en-US</filename> directory and create two <emphasis>directories</emphasis> (not books) called <filename>Book_A</filename> and <filename>Book_B</filename>.
fr: À l'aide de la commande <prompt>$</prompt> <command>cd</command>, placez-vous dans le répertoire <filename>My_Set/en-US</filename> et créez deux <emphasis>répertoires</emphasis> (et non livres) nommés <filename>Book_A</filename> et <filename>Book_B</filename>.

en: <prompt>$</prompt> <command>cd</command> into the <filename>books/My_Set/en-US/Book_A</filename> directory. Create and edit the <filename>Book_A.xml</filename>, <filename>Book_Info.xml</filename>, and any other xml files required for your book such as those required for individual chapters. Ensure that <filename>Book_A.xml</filename> contains the correct <tag>xi:include</tag> references to all of your xml files in the directory. For example, if <citetitle>Book A</citetitle> contained <filename>Book_Info.xml</filename> and <filename>Chapter_1.xml</filename>, the <filename>Book_A.xml</filename> file would look like this:
fr: Placez-vous à l'aide de <prompt>$</prompt> <command>cd</command> dans le répertoire <filename>books/My_Set/en-US/Book_A</filename>. Créer et modifiez <filename>Book_A.xml</filename>, <filename>Book_Info.xml</filename> et les autres fichiers XML nécessaires à l'ouvrage tels ceux requis pour des chapitres individualisés. S'assurer que <filename>Book_A.xml</filename> contient les références correctes <sgmltag>xi:include</sgmltag> vers tous les fichiers XML du répertoire. Par exemple, si <citetitle>Book A</citetitle> contient <filename>Book_Info.xml</filename> et <filename>Chapter_1.xml</filename>, le fichier <filename>Book_A.xml</filename> doit ressembler à :

en: Use the same process for <citetitle>Book_B</citetitle>, located in the <filename>books/My_Set/en-US/Book_B</filename> directory, as per the step above.
fr: Suivez un processus identique pour <citetitle>Book_B</citetitle>, situé dans le répertoire <filename>books/My_Set/en-US/Book_B</filename>.

en: Open the <filename>books/My_Set/en-US/My_Set.xml</filename> file in an editor. For each book in the set, add an <tag>xi:include</tag> reference to the primary xml file from the book. The primary xml file for <citetitle>Book A</citetitle> will be <filename>Book_A.xml</filename> and for <citetitle>Book B</citetitle>, <filename>Book_B.xml</filename>. The <filename>My_Set.xml</filename> file should now look like this:
fr: Ouvrez le fichier <filename>books/My_Set/en-US/My_Set.xml</filename> dans un traitement de texte brut. Pour chacun des ouvrages dans la collection, ajoutez une référence <sgmltag>xi:include</sgmltag> au fichier XML principal de l'ouvrage. Le fichier XML principal de <citetitle>Book A</citetitle> est <filename>Book_A.xml</filename> et celui de <citetitle>Book B</citetitle>, <filename>Book_B.xml</filename>. Le fichier <filename>My_Set.xml</filename> ressemble maintenant à quelque chose comme :

en: To make your set XML valid, you will need to change the following:
fr: Pour rendre votre ensemble XML valide, modifiez :

en: In <filename>My_Set.xml</filename>, comment out the following lines:
fr: Dans <filename>My_Set.xml</filename>, mettez en commentaire les lignes :

en: In the <filename>Preface.xml</filename> and <filename>Book_Info.xml</filename> for each book you are using, add ../../ to the front of every Common_Content string you see. For example:
fr: Dans <filename>Preface.xml</filename> et <filename>Book_Info.xml</filename> de chaque ouvrage utilisé, ajoutez ../../ en tête de chaque chaîne Common_Content que vous voyez. Par exemple :

en: This will need to become:
fr: doit devenir :

en: This is because in a standalone set, the Common Content folder is two directories further away from where Publican usually looks for it, so it has to be told manually. To build your book individually, without building the entire set, undo this step.
fr: Dans un ensemble autonome, le dossier « Common Content » est deux répertoires au dessous de l'emplacement dans lequel Publican le cherche généralement : il faut indiquer cette particularité manuellement. Pour construire vos ouvrages individuellement, sans construire la collection, passez cette étape.

en: Test your set by running the <command>publican build --formats=test --langs=en-US</command> command.
fr: Testez l'ensemble en exécutant la commande <command>publican build --formats=test --langs=en-US</command>.

en: If you are using pre-existing books, you will need to rearrange them so the XML files are at the level of the set and all images are inside the images directory at the same level. For example:
fr: Si vous utilisez des ouvrages existants, vous devez les aménager de façon à ce que les fichiers XML soient au niveau de l'ensemble et toutes les images dans le répertoire images sur un même niveau. Par exemple :

en: The XML files can also be within sub-folders to keep them separate. This is true within the images directory, as well. For example:
fr: Les fichiers XML peuvent aussi être dans des sous-répertoires pour les garder séparées. Ce qui est également vrai pour le répertoire images. Par exemple :

en: Distributed sets
fr: Ensembles distribués

en: A <firstterm>distributed set</firstterm> contains books that are located in a version-controlled repository. Although several version control systems exist, this version of <application>Publican</application> supports only one: <application>Subversion</application> (<application>SVN</application>). By setting the repository location and titles of the included books in the <filename>publican.cfg</filename> file, each book can be exported to build the entire set. The procedure that follows will guide you through the process of creating a set named <citetitle>My Set</citetitle> containing <citetitle>Book A</citetitle> and <citetitle>Book B</citetitle>.
fr: Une <firstterm>collection distribuée</firstterm> est constituée d'ouvrages situés dans un dépôt à versions contrôlées. Bien qu'il existe plusieurs systèmes de contrôle des versions, <application>Publican</application> ne prend en charge qu'un seul système : <application>Subversion</application> (<application>SVN</application>). En définissant l'emplacement du dépôt et les titres des ouvrages à inclure dans le fichier <filename>publican.cfg</filename>, chacun d'entre eux peut être exporté pour construire la totalité de la collection. La procédure suivante est un guide pour créer une collection nommée <citetitle>My Set</citetitle> contenant <citetitle>Book A</citetitle> et <citetitle>Book B</citetitle>.

en: The following procedure assumes that <citetitle>Book A</citetitle> and <citetitle>Book B</citetitle> already exist and are available in your <application>SVN</application> repository. Currently <application>Publican</application> only supports <application>SVN</application>.
fr: Elle suppose que <citetitle>Book A</citetitle> et <citetitle>Book B</citetitle> existent déjà et sont disponibles dans le dépôt <application>SVN</application>. Actuellement, <application>Publican</application> ne prend en charge que <application>SVN</application>.

en: Creating a set
fr: Création d'une collection

en: Run the following command in a shell to create a set named <literal>My_Set</literal> branded in the Red Hat style and in which the XML will be written in American English.
fr: Exécutez la commande suivante dans un terminal pour créer une collection nommée <literal>My_Set</literal> avec la charte graphique Red Hat et dans laquelle les XML sont écrits en anglais (américain).

en: Add the following lines to the <filename>publican.cfg</filename> file:
fr: Ajouter les lignes suivantes au fichier <filename>publican.cfg</filename> :

en: books: Book_A Book_B
    repo: <replaceable>http://PATH-TO-YOUR-SVN-REPOSITORY</replaceable>
    scm: SVN
fr: books: Book_A Book_B
    repo: <replaceable>http://CHEMIN-VERS-LE-DÉPÔT-SVN</replaceable>
    scm: SVN

en: Your repository path should end in the directory before the book you need.
fr: Le chemin vers le dépôt doit mener dans le répertoire contenant le livre dont vous avez besoin.

en: Open the <filename>My_Set.xml</filename> file in an editor. For each book in the set, add an <tag>xi:include</tag> reference to the primary XML file from the book. The primary XML file for <citetitle>Book A</citetitle> will be <filename>Book_A.xml</filename> and for <citetitle>Book B</citetitle>, <filename>Book_B.xml</filename>. The <filename>My_Set.xml</filename> file should now look like this:
fr: Ouvrez le fichier <filename>My_Set.xml</filename> dans un éditeur de texte. Pour chaque ouvrage de la collection, ajoutez une référence <sgmltag>xi:include</sgmltag> sur le fichier XML principal du livre. Le fichier XML principal pour <citetitle>Book A</citetitle> doit être <filename>Book_A.xml</filename> et pour <citetitle>Book B</citetitle>, <filename>Book_B.xml</filename>. Le fichier <filename>My_Set.xml</filename> doit maintenant ressembler à ceci :

en: To make your set XML valid, you will need to comment out the following lines in <filename>My_Set.xml</filename>
fr: Pour que le XML soit valide, mettez en commentaire dans <filename>My_Set.xml</filename> les lignes :

en: When building a set, the <command>publican clean_ids</command> command will be run over each book because of the constraint that IDs must be unique across all books. Be careful of creating IDs that rely on content that may not be available when building books independently of the set.
fr: En construisant une collection, la commande <command>publican clean_ids</command> doit être lancée pour chaque ouvrage étant donné qu'il est obligatoire d'avoir un identifiant unique dans l'ensemble des livres. Soyez attentif à créer des identifiants en rapport avec le contenu et qui ne soient pas disponibles pour la construction d'ouvrages indépendants de la collection.
