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/27 23:06] – Suite de traduction en français. 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 321: / Ligne 321: @@
 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 de package/classe de document et doivent être spécifiées lorsque le package/la classe de document est chargé.
+  * 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 de package/classe de documentation ou via ''\ctexset''. Certaines options spéciales seront décrites dans la documentation ultérieure dans les notes d'utilisation.
+  * 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''.
-FIXME: À poursuivre.
+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 ====
@@ Ligne 344: / Ligne 402: @@
 ===== 6. Sinisation des documents =====
+FIXME Section à compléter.
 ==== 6.1 Manipulation des dates ====
@@ Ligne 352: / Ligne 412: @@
 ===== 7. Mise en forme des titres de chapitre =====
+FIXME Section à compléter.
 ==== 7.1 En rapport avec la numérotation ====
@@ Ligne 366: / Ligne 428: @@
 ===== 8. Commandes pratiques =====
+FIXME Section à compléter.
 ==== 8.1 Taille et espacement des caractères ====
@@ Ligne 375: / Ligne 439: @@
 ===== 9. Comment le chinois est pris en charge sous LuaLaTeX =====
-Sous LuaLaTeX, CTeX s'appuie sur l'extension [[ctanpkg>LuaTeX-ja]] pour la prise en charge de la langue chinoise.
+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.
@@ Ligne 388: / Ligne 452: @@
 ==== 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 ====
@@ Ligne 401: / Ligne 468: @@
 ===== 11. Compatibilité avec les anciennes versions =====
+FIXME Section à compléter.