Différences

Ci-dessous, les différences entre deux révisions de la page.

--- 3_composition:langues:traduction_de_la_documentation_de_ctex [2021/11/25 00:25] – Ajout d'un exemple avec Beamer. jejust
+++ 3_composition:langues:traduction_de_la_documentation_de_ctex [2022/08/03 19:04] (Version actuelle) – Suite de traduction. Vérification que la nouvelle version de CTeX ne change pas ce qui a déjà été traduit. jejust
@@ Ligne 4: / Ligne 4: @@
 <note important>
-Cette page est une traduction du [[texdoc>ctex|Manuel de CTeX]] (version v2.5.7, du 2021/06/20).
+Cette page est une traduction du [[texdoc>ctex|Manuel de CTeX]] (version v2.5.10, du 2022/07/14).
 </note>
@@ Ligne 15: / Ligne 15: @@
 tels que des articles, des rapports, des livres, des diaporamas, etc.
-Le jeu de macros CTEX prend en charge de nombreuses méthodes de compilation telles que LaTeX, pdfLATEX,
+L'extension CTeX prend en charge de nombreuses méthodes de compilation telles que LaTeX, pdfLaTeX,
-XƎLaTeX, LuaLATEX et upLATEX, et fournit une interface unifiée pour celles-ci.
+XƎLaTeX, LuaLaTeX et upLaTeX, et fournit une interface unifiée pour celles-ci.
 L'essentiel des fonctionnalités est mis en œuvre par l'extension ''ctex'' elle-même
 et les classes de documents en chinois: ''ctexart'', ''ctexrep'', ''ctexbook'' et ''ctexbeamer''.
@@ Ligne 25: / Ligne 25: @@
 ==== Histoire ====
-Le jeu de macros CTeX a deux origines: la classe de document ''cjkbook'' écrite par Wang Lei
+L'extension CTeX a deux origines: la classe de document ''cjkbook'' écrite par Wang Lei
 et ''GB.cap'' écrite par Wu Lingyun. Ces débuts n'ont pas été conçus de façon très rigoureuse ni systématique
 et n'avaient pas de documentation utilisateur, ce qui n'en facilitait pas la maintenance et l'amélioration.
@@ Ligne 40: / Ligne 40: @@
 En mars 2014, afin de s'adapter aux plus récents développements de LaTeX, notamment aux nouvelles fonctionnalités
 de [[1_generalites/histoire/c_est_quoi_latex3|LaTeX3]], Qing Li a remanié le code de l'ensemble des macros
-pour utiliser LaTeX3 et réutilisé les outils [[ctanpkg>doc]] et [[ctanpkg>DocStrip]] pour la gestion du code,
+pour utiliser LaTeX3 et utilisé de nouveau les outils [[ctanpkg>doc]] et [[ctanpkg>DocStrip]] pour la gestion du code,
-faisant passer le numéro de version à 2.0 et le renommant «CTeX macro set».
+faisant passer le numéro de version à 2.0 et le renommant «//CTeX macro set//».
 En mars 2015, le projet ''ctex-kit'' a été [[https://github.com/CTeX-org/ctex-kit|migré vers GitHub]] en raison
@@ Ligne 57: / Ligne 57: @@
 En outre, des détails tels que le formatage de la date, l'indentation de la première ligne, la taille du texte en chinois
 et l'espacement des caractères ont dû être réglés avec précision.
-L'un des objectifs de la conception du jeu de macros CTeX était de résoudre ces difficultés dans la sinisation des documents LaTeX.
+L'un des objectifs de la conception de l'extension CTeX était de résoudre ces difficultés dans la sinisation des documents LaTeX.
 D'autre part, comme le moteur TeX et les extensions LaTeX continuent d'évoluer, les façons dont LaTeX peut prendre en charge la langue chinoise
@@ Ligne 70: / Ligne 70: @@
 pour les différentes méthodes de prise en charge de la langue chinoise, de sorte que le même document puisse être échangé
 et utilisé dans différents environnements.
 De nombreux détails de la mise en œuvre de l'ensemble de macros CTEX n'auraient pu être réalisés sans la discussion d'amis enthousiastes
 sur le forum ''bbs.ctex.org'' (ce forum CTeX est fermé depuis 2018, pour une raison inconnue et ce lien est désormais mort),
 et nous tenons à remercier ceux qui ont participé.
@@ Ligne 84: / Ligne 82: @@
-La collection de macros CTeX est une collection de fichiers de style LaTeX et de classes de documents initiée et maintenue par la communauté CTeX.
+L'extension CTeX est une collection de fichiers de style LaTeX et de classes de documents initiée et maintenue par la communauté CTeX.
 La communauté publie également une distribution TeX appelée //CTeX Suite//, qui n'est pas la même chose que le jeu de macros CTeX décrit dans ce document.
-''ctex'' désigne le fichier du ''ctex.sty'' dans cet ensemble de macros.
+''ctex'' désigne le fichier du ''ctex.sty'' fourni par l'extension.
 Ce nom entièrement minuscule a également été utilisé dans le passé pour désigner l'ensemble des macros CTeX,
 mais il fait désormais spécifiquement référence au jeu de macros ''ctex.sty''.
@@ Ligne 98: / Ligne 96: @@
 Afin de répondre aux différents besoins des utilisateurs, nous avons organisé les principales fonctions
-du jeu de macros CTeX en quatre classes de documents pour le chinois, et trois fichiers de style,
+de l'extension CTeX en quatre classes de documents pour le chinois, et trois fichiers de style,
 dont la composition spécifique est présentée dans le tableau ci-dessous.
@@ Ligne 113: / Ligne 111: @@
 ==== Installation et mise à jour du jeu de macros CTeX ====
-Les distributions TeX les plus courantes (TeX(nbsp)Live et MiKTeX) incluent déjà le jeu de macros CTeX
+Les distributions TeX les plus courantes (TeX(nbsp)Live et MiKTeX) incluent déjà l'extension CTeX
-et ses paquets de macros et ensembles de macros dépendants.
+et ses collections de macros, et ses dépendances.
 <note warning>
@@ Ligne 124: / Ligne 122: @@
 Si une installation locale de TeX Live ou MiKTeX n'est pas la version complète, il peut être nécessaire
-d'installer les paquets de macros via les gestionnaires de paquets fournis par ces deux distributions.
+d'installer les extensions via les gestionnaires de paquets fournis par ces deux distributions.
 === Avec TeX Live ===
@@ Ligne 148: / Ligne 146: @@
 Après s'être connecté au dépôt distant, recherchez ''ctex'' pour l'installer.
 L'interface graphique de ''tlmgr'' est écrite en Perl/Tk et s'est avérée dans la pratique encline à planter.
-Les utilisateurs qui rencontrent ce problème peuvent également installer le jeu de macros CTeX directement
+Les utilisateurs qui rencontrent ce problème peuvent également installer l'extension CTeX directement
 à partir de la ligne de commande du système en exécutant la commande suivante:
@@ Ligne 160: / Ligne 158: @@
 === Avec MiKTeX ===
-FIXME
+MiKTEX s'occupe automatiquement d'installer une extension quand celle-ci manque pour compiler un document.
+Pour une installation manuelle, vous pouvez utiliser la console MiKTeX, qui vous permet d'ouvrir le gestionnaire,
+de choisir un serveur distant, de rechercher ''ctex'' dans l'onglet //Package// et de l'installer.
+Enfin, vous pouvez aussi utiliser ''mpm'' (//MiKTeX Package Manager//) en ligne de commande et exécuter:
+<code bash>
+mpm --admin --install=ctex
+</code>
+pour installer l'extension CTeX.
+Pour plus d'informations sur les dépendances spécifiques de CTeX ou sur la manière de l'installer manuellement,
+voir la section 12.
+=== Mises à jour ===
+À chaque mise à jour de CTeX sur le CTAN, une fois le catalogue local également mis à jour,
+l'utilisateur peut installer la nouvelle version localement via le gestionnaire de paquets.
+Pour TeX Live, ceci peut être fait à partir de l'interface graphique ''tlmgr'' en cliquant sur le bouton //update all installed//
+ou en ligne de commande, avec
+<code bash>
+tlmgr update --all
+</code>
+pour mettre à jour complètement les fichiers installés.
+Pour MiKTeX, trouvez l'onglet //Updates// dans la console MiKTeX, vérifiez les mises à jour
+et sélectionnez les extensions à mettre à jour.
+Alternativement, vous pouvez utiliser ''mpm'' en exécutant la ligne de commande
+<code bash>
+mpm --admin --update
+</code>
+pour effectuer la mise à jour.
@@ Ligne 250: / Ligne 278: @@
 ==== Utilisation de l'extension “ctex” ====
-FIXME
+On peut utiliser l'extension ''ctex'' si on a besoin d'ajouter le support de la langue chinoise
+et de ses spécificités de mise en page lorsqu'on utilisent des classes de documents ou des styles beamers non standards.
+Pour les classes de documents construites à partir des classes de documents standards de LaTeX,
+l'extension ''ctex'' peut être utilisée avec l'option ''heading'' pour définir les titres de section en style chinois:
 <WRAP column 60ex>
@@ Ligne 277: / Ligne 309: @@
 <WRAP clear />
-===== Options de l'extension et commande “\ctexset” =====
+===== 3. Options de l'extension et commande “\ctexset” =====
+L'extension CTeX a été adaptée et configurée pour le texte chinois et les conventions de mise en page chinoises, dans la mesure du possible,
+et ces configurations s'avèrent généralement adéquates.
+Par conséquent, nous ne recommandons pas aux utilisateurs réguliers de modifier les valeurs par défaut, sauf si cela est nécessaire.
+Si vous pensez que les macros CTeX pourraient être améliorées, vous pouvez faire un rapport de bug ou une suggestion sur la page d'accueil du projet
+et nous le faire savoir, et nous apporterons les améliorations nécessaires dans les versions ultérieures.
+Toutefois, l'extension CTeX offre également un certain nombre d'options. Les utilisateurs peuvent utiliser ces options pour contrôler
+le comportement des macros de CTeX. Classées par type, ces options sont soit fournies de manière traditionnelle,
+soit sous forme ''<//clef//>=<//valeur//>''. Elles peuvent être subdivisées en trois catégories comme suit.
+  * Les options avec un signe ☆ après leur nom, qui ne peuvent être utilisées que comme options d'extension ou de classe de document et doivent être spécifiées lorsque l'extension ou la classe de document est chargée.
+  * les options comportant un signe ★ après leur nom, qui ne peuvent être définies que par l'intermédiaire de l'interface utilisateur ''\ctexset'' fournie par l'extension CTeX.
+  * Les options dont le nom n'est pas suivi d'un symbole spécial peuvent être définies en tant qu'option d'extension ou de classe de document, ou via ''\ctexset''.
+Certaines options spéciales seront décrites dans suite de la documentation.
+==== Commande “\ctexset” ====
+La commande ''\ctexset{<//clefs-valeurs//>}'' est permet de choisir des options pour l'extension CTeX après son chargement.
+L'argument de ''\ctexset'' est une liste de clefs et valeurs, qui permet de définir chaque option avec une interface uniforme.
+Cette liste de clefs et valeurs se présente sous forme d'une liste d'options séparées par des virgules, chacune dans un format ''<//clef//>=<//valeur//>''.
+Par exemple, pour définir le titre du résumé et le titre de la bibliographie (voir section 6.2), on peut écrire:
+<code latex>
+\ctexset{abstractname={Titre du résumé},
+         bibname={Titre de la bibliographie}%
+        }
+</code>
+''\ctexset'' utilise des clefs du même format que LaTeX3 et supporte différents types d'options avec une structure hiérarchique,
+voir la section 7 pour un exemple.
+===== 4. Méthodes de compilation, codage et bibliothèques en langue chinoise =====
+==== 4.1 Méthodes de compilation ====
+Selon le mode de compilation utilisé par l'utilisateur (parmi LaTeX, pdfLaTeX, XeLaTeX, LuaLaTeX et upLATEX),
+CTeX choisira quelle extension employer pour supporter la langue chinoise:
+^ Méthode de compilation  ^  (pdf)LaTeX  ^  XeLaTeX  ^  LuaLaTeX  ^  upLaTeX  ^
+| Extension utilisée  |  CJK  |  xeCJK  |  LuaTeX-ja   |  //Native//  |
+<note>
+pLaTeX-ng (ou ApLaTeX) est compatible avec upLaTeX.
+Lors de la compilation avec pLaTeX-ng, CTeX utilise les mêmes paramètres que upLaTeX.
+</note>
+Les différentes méthodes de compilation et le mode de support de la langue chinoise affecteront
+dans une certaine mesure le comportement de l'extension CTEX, par exemple en ce qui concerne l'encodage des documents,
+la sélection des polices, les espacements, la ponctuation, etc.
+Les détails seront abordés dans les sections suivantes de ce document.
+==== 4.2 Codage chinois ====
+Spécifie le codage utilisé pour le document ; les macros CTeX ne cherchent pas à détecter
+le codage réel du fichier source du document, et celui-ci doit donc être déclaré
+par l'utilisateur, par une option.
+S'il n'est pas explicitement spécifié, le codage par défaut est UTF-8.
+Lors de la compilation avec XƎLaTeX, LuaLaTeX ou upLaTeX, les macros CTeX forcent l'utilisation du codage UTF-8
+et l'option GBK n'est pas disponible; lors de la compilation avec (pdf)LATEX, les macros CTeX utilisent par défaut
+le codage UTF-8, mais l'utilisateur peut explicitement déclarer l'option GBK pour que les macros CTeX
+traitent les documents comme étant codés en GBK.
+Les macros CTeX utilisent par défaut le codage GBK, mais l'utilisateur peut déclarer explicitement l'option GBK
+pour que les macros CTeX traitent les documents en codage GBK.
+Les utilisateurs doivent s'assurer que la méthode de compilation, l'encodage du fichier source
+et les options d'encodage des macros sont cohérents entre eux.
+<note tip>
+Nous recommandons de toujours utiliser l'encodage UTF-8 lors de l'écriture de nouveaux documents
+et de réserver l'encodage GBK aux documents existants.
+</note>
+==== 4.3 Bibliothèques en langue chinoise ====
+FIXME: À poursuivre.
+===== 5. Formatage de la mise en page =====
+FIXME Section à compléter.
+==== 5.1 Taille de police par défaut du document ====
+==== 5.2 Styles d'en-tête de section ====
+==== 5.3 Options de schéma de composition ====
+===== 6. Sinisation des documents =====
+FIXME Section à compléter.
+==== 6.1 Manipulation des dates ====
+==== 6.2 Personnalisation du titre du document ====
+==== 6.3 Mise en page des pages et sinisation ====
+===== 7. Mise en forme des titres de chapitre =====
+FIXME Section à compléter.
+==== 7.1 En rapport avec la numérotation ====
+==== 7.2 Formatage lié ====
+==== 7.3 Espacement, lié à l'indentation ====
+==== 7.4 Table des matières, annexes ====
+==== 7.5 Commandes auxiliaires ====
+==== 7.6 Exemples ====
+===== 8. Commandes pratiques =====
+FIXME Section à compléter.
+==== 8.1 Taille et espacement des caractères ====
+==== 8.2 Conversions numériques chinoises ====
+==== 8.3 Divers ====
+===== 9. Comment le chinois est pris en charge sous LuaLaTeX =====
+Sous LuaLaTeX, CTeX s'appuie sur l'extension [[ctanpkg>luatexja|LuaTeX-ja]] pour la prise en charge de la langue chinoise.
+Cette extension a été développée par Hiroyori Kitagawa, Kazutaka Maeda, Takayuki Yaten et d'autres membres de la communauté TeX japonaise,
+et a été conçu pour mettre en œuvre (la plupart) des fonctionnalités du [[1_generalites:glossaire:ptex_et_uptex|moteur pTeX]] japonais sous le moteur LuaTeX.
+Il apporte un certain nombre de modifications et d'extensions au [[5_fichiers:fontes:utiliser_des_fontes_non_standard_en_plain_tex|schéma NFSS]] de LaTeX2𝜀
+afin d'être compatible avec les habitudes d'utilisation de pLaTeX.
+Cela n'est pas nécessaire pour les utilisateurs de chinois simplifié, c'est pourquoi CTeX désactive la plupart de ses paramètres dans le format LaTeX,
+ne conservant que les éléments nécessaires. La méthode de définition des polices a également été modifiée de sorte que les commandes pertinentes
+sont plus ou moins les mêmes que dans le paquet de macros xeCJK.
+Le paquet de macros LuaTeX-ja à partir de la version 20150420 prend désormais en charge la typographie verticale,
+mais CTeX ne le fait pas pour le moment.
+==== 9.1 Définition de polices alternatives sous LuaLaTeX ====
+===== 10. Fichiers de configuration pour le jeu de macros CTeX =====
+FIXME Section à compléter.
+==== 10.1 Modifier les options par défaut des macro-paquets ====
+==== 10.2 Configuration des macro-paquets après le chargement ====
+==== 10.3 Configuration de la traduction chinoise du titre ====
+==== 10.4 Personnalisation des jeux de polices ====
+===== 11. Compatibilité avec les anciennes versions =====
-FIXME À poursuivre
+FIXME Section à compléter.