-\begin_layout Subsection
-Préparer et utiliser un document LinuxDoc
-\end_layout
-
-\begin_layout Subsubsection
-Pour commencer
-\end_layout
-
-\begin_layout Standard
-En premier lieu, sélectionnez la classe LinuxDoc dans la fenêtre
-\family sans
-Format\SpecialChar \menuseparator
-Document\SpecialChar \menuseparator
-Document
-\family default
-.
- Vous verrez alors que le nombre des environnements de paragraphe disponibles
- a diminué ; vous les trouverez comme toujours dans le menu déroulant en
- haut à gauche.
- Le fonctionnement général des environnements de paragraphe est décrit dans
- la section\InsetSpace ~
-
-\begin_inset LatexCommand \ref{sec:sgml-paragraphes}
-
-\end_inset
-
-.
-\end_layout
-
-\begin_layout Standard
-Il vous
-\emph on
-faut
-\emph toggle
- entrer un titre de document, ainsi que le nom d'un auteur, en utilisant
- à chaque fois l'environnement de paragraphe approprié.
- Si vous ne le faites pas, vous obtiendrez des erreurs à l'impression du
- document.
- Vous pouvez ensuite entrer une date et un résumé.
- Le document en lui-même doit commencer par un environnement de
-\family sans
-Section
-\family default
-, et non par un environnement standard.
-\end_layout
-
-\begin_layout Standard
-Ensuite, vous pouvez composer votre document comme d'habitude en utilisant
- les différents environnements de paragraphe.
- Voyez la section\InsetSpace ~
-
-\begin_inset LatexCommand \ref{sec:sgml-paragraphes}
-
-\end_inset
-
- pour en avoir la liste complète ainsi que leur rôle.
-\end_layout
-
-\begin_layout Subsubsection
-Le format LinuxDoc
-\end_layout
-
-\begin_layout Standard
-Vous pouvez imprimer et enregistrer ces documents de la manière habituelle,
- mais pour utiliser les autres fonctionalités du paquetage SGML, vous devrez
- enregistrer votre document sous le format LinuxDoc.
- Dans ce cas, votre document sera transcrit en langage SGML.
- Pour cela, utilisez
-\family sans
-Fichier\SpecialChar \menuseparator
-Exporter\SpecialChar \menuseparator
-LinuxDoc
-\family default
-.
- Vous obtiendrez un fichier avec le même nom, mais avec
-\family typewriter
-.sgml
-\family default
- pour extension à la place de
-\family typewriter
-.lyx
-\family default
-.
- Voyez la section\InsetSpace ~
-
-\begin_inset LatexCommand \ref{sec:scripts-sgml}
-
-\end_inset
-
- pour apprendre comment utiliser ce nouveau fichier.
-\end_layout
-
-\begin_layout Subsection
-Utilisation des environnements de paragraphe dans LinuxDoc
-\end_layout
-
-\begin_layout Subsubsection
-Structure des documents LinuxDoc
-\end_layout
-
-\begin_layout Standard
-Les documents LinuxDoc ont une structure formelle qui limite les endroits
- ou vous placerez les balises.
- Chaque document a deux parties :
-\end_layout
-
-\begin_layout Description
-Header\InsetSpace ~
-(l'en-tête)\InsetSpace ~
-: On désigne sous ce nom tout ce qui précède la première
- section.
- L'en-tête peut comprendre le titre, l'auteur, la date, un résumé, et la
- Table des Matières.
- Vous devez remplir les deux premiers.
-\end_layout
-
-\begin_layout Description
-Body\InsetSpace ~
-(le\InsetSpace ~
-corps)\InsetSpace ~
-: Tout ce qui suit le début de la première section.
- Toutes les autres balises y sont admises.
-\end_layout
-
-\begin_layout Subsubsection
-Environnements de paragraphe LinuxDoc
-\end_layout
-
-\begin_layout Standard
-\begin_inset LatexCommand \label{sec:sgml-paragraphes}
-
-\end_inset
-
-Voici une liste de toutes les balises que vous trouverez dans le même ordre
- dans le menu de la barre d'outils, ainsi que quelques remarques sur leur
- usage :
-\end_layout
-
-\begin_layout Itemize
-
-\family sans
-Standard
-\family default
- :
-\family roman
-
-\family default
-Fonctionne comme c'est décrit dans (référence croisée).
-\end_layout
-
-\begin_layout Itemize
-
-\family sans
-Titre
-\family default
- : Va apparaître en haut à gauche du document imprimé, au dessus d'un trait
- horizontal, trait que vous ne verrez pas sous LyX.
-\end_layout
-
-\begin_layout Itemize
-
-\family sans
-Section
-\family default
-,
-\family sans
-SousSection
-\family default
-,
-\family sans
-SousSousSection
-\family default
-,
-\family sans
-Paragraph
-\family default
- et
-\family sans
-Subparagraph
-\family default
- :
-\family sans
-
-\family default
-Tout cela fonctionne comme normalement et avec la hiérarchie habituelle.
- La présence ou l'absence de numérotation est contrôlée par le réglage de
- la
-\family sans
-Profondeur\InsetSpace ~
-de\InsetSpace ~
-la\InsetSpace ~
-numérotation
-\family default
- dans
-\family sans
-Format\SpecialChar \menuseparator
-Document\SpecialChar \menuseparator
-Extra
-\family default
-.
- Vous ne pourrez pas obtenir de titres non numérotés autrement : il n'y
- a pas d'équivalent à
-\family sans
-Section*
-\family default
-.
-\end_layout
-
-\begin_layout Itemize
-
-\family sans
-Enumerate
-\family default
- : Comme d'habitude, produit une liste numérotée et indentée comme indiqué
- dans le
-\emph on
-Guide\InsetSpace ~
-de\InsetSpace ~
-l'Utilisateur
-\emph default
-.
-\end_layout
-
-\begin_layout Itemize
-
-\family sans
-Itemize
-\family default
- :
-\family sans
-
-\family default
-De nouveau, même effet qu'avec les autres classes : voir le
-\emph on
-Guide\InsetSpace ~
-de\InsetSpace ~
-l'Utilisateur
-\emph default
-.
-\end_layout
-
-\begin_layout Itemize
-
-\family sans
-Description
-\family default
- : Comme indiqué dans le
-\emph on
-Guide\InsetSpace ~
-de\InsetSpace ~
-l'Utilisateur
-\emph toggle
-.
- Rappelez-vous que si vous voulez que l'élément en gras fasse plus d'un
- mot, il vous faudra mettre des espaces insécables entre les mots.
-\end_layout
-
-\begin_layout Itemize
-
-\family sans
-Verbatim
-\family default
- :
-\family sans
-
-\family default
-Comme d'habitude.
-\end_layout
-
-\begin_layout Itemize
-
-\family sans
-Code
-\family default
- : Comparable à l'environnement
-\family sans
-Lyx-Code
-\family default
-.
-\end_layout
-
-\begin_layout Itemize
-
-\family sans
-Auteur
-\family default
- : Tout ce que vous y entrez apparaîtra à gauche de l'en-tête du document,
- sous la ligne épaisse.
-\end_layout
-
-\begin_layout Itemize
-
-\family sans
-Date
-\family default
-: Tout ce que vous y entrerez apparaîtra à droite de l'en-tête, sous la
- ligne.
- Ce ne sera pas forcément une date : vous pouvez entrer tout type de texte,
- par exemple un numéro de version.
-\end_layout
-
-\begin_layout Itemize
-
-\family sans
-Abstract
-\family default
- : Vous pouvez utiliser cet environnement pour obtenir un paragraphe libre
- après l'auteur et la date, et avant la première section.
- Vous n'avez le droit qu'à un seul paragraphe de ce type
-\begin_inset Foot
-status collapsed
-
-\begin_layout Standard
-
-\emph on
-Note de l'auteur :
-\emph toggle
-Ce point est à vérifier --
-\emph on
-pe
-\emph default
-.
-\end_layout
-
-\end_inset
-
-.
-\end_layout
-
-\begin_layout Itemize
-
-\family sans
-Displaymath
-\family default
- :
-\begin_inset Foot
-status collapsed
-
-\begin_layout Standard
-
-\emph on
-Note de l'auteur :
-\emph toggle
-Je ne l'ai pas encore essayé
-\emph default
- --
-\emph on
- pe.
-\end_layout
-
-\end_inset
-
-
-\end_layout
-
-\begin_layout Subsubsection
-Autres possibilités avec ces documents
-\end_layout
-
-\begin_layout Standard
-Vous pouvez utiliser le menu
-\family sans
-Format
-\family default
- pour choisir une police de caractère ou pour mettre des mots en valeur.
- Vous pouvez aussi utiliser la table des matières comme d'habitude ; voir
- la section correspondante du
-\emph on
-Guide\InsetSpace ~
-de\InsetSpace ~
-l'Utilisateur
-\emph default
-.
- Vous pouvez trouver d'autres fonctions dans les menus de LyX.
- Certaines fonctionneront, d'autres pas
-\begin_inset Foot
-status collapsed
-
-\begin_layout Standard
-
-\emph on
-Note de l'auteur :
-\emph toggle
- A moins que ça ne vienne de mon système...
- --
-\emph on
-pe.
-\end_layout
-
-\end_inset
-
-.
-\end_layout
-
-\begin_layout Subsubsection
-Références croisées et HTML
-\end_layout
-
-\begin_layout Standard
-Vous trouverez dans le menu
-\family sans
-Insérer
-\family default
- deux nouvelles options relatives aux inclusions d'adresses URL.
- Si vous utilisez l'une de ces options, du code TeX sera inséré dans votre
- document, en trois blocs séparés par des espaces.
- Les trois blocs seront :
-\end_layout
-
-\begin_layout Quote
-
-\family typewriter
-
-\backslash
-htmlurl{
-\family default
- ou
-\family typewriter
-
-\backslash
-url{
-\family roman
-
-\hfill
-
-\family default
-espace
-\family typewriter
-
-\hfill
-}{
-\family roman
-
-\hfill
-
-\family default
-espace
-\family roman
-
-\hfill
-
-\family typewriter
-}
-\end_layout
-
-\begin_layout Standard
-Vous pouvez insérer une adresse HTML entre le premier et le deuxième bloc.
- Ça peut être
-\begin_inset LatexCommand \url{http://adresse.quelconque}
-
-\end_inset
-
- ou d'autres balises valides comme
-\begin_inset LatexCommand \url{mailto:moi@mon.adresse}
-
-\end_inset
-
-.
- Ensuite vous pouvez mettre une description entre le deuxième et le troisième
- bloc.
- Les différences sont :
-\end_layout
-
-\begin_layout Itemize
-
-\family sans
-URL:
-\family roman
-
-\family default
-L'adresse HTML et la description apparaîtront toutes deux dans le document
- ;
-\end_layout
-
-\begin_layout Itemize
-
-\family sans
-HTML\InsetSpace ~
-URL:
-\family default
-seule la description apparaîtra dans la version imprimée.
-\end_layout
-
-\begin_layout Subsection
-Utiliser les scripts Sgml pour LinuxDoc
-\begin_inset LatexCommand \label{sec:scripts-sgml}
-
-\end_inset
-
-
-\begin_inset Foot
-status collapsed
-
-\begin_layout Standard
-NdT : Ce paragraphe n'est pas du tout à jour, les adresses fournies sont
- périmées.
-\end_layout
-
-\end_inset
-
-
-\end_layout
-
-\begin_layout Standard
-Vous pouvez utiliser LinuxDoc comme une classe de texte sans script ou programme
- supplémentaire, mais ça ne présente pas grand intérêt.
- Ce que vous voulez obtenir est un document qui ressemblera à un
-\emph on
-Howto
-\emph default
- du
-\emph on
-Linux Doucmentation Project
-\emph toggle
-.
- Pour effectuer la transcription du document, vous devez avoir installé
- le paquetage
-\family typewriter
-sgml-tools-1.0.x.tar.gz
-\family default
- (avec
-\begin_inset Formula $x\geq3$
-\end_inset
-
-) que vous trouverez sur la page des SGML-Tools à l'adresse
-\end_layout
-
-\begin_layout LyX-Code
-
-\family roman
-\begin_inset LatexCommand \url{http://pobox.com/~cg/sgmltools}
-
-\end_inset
-
-
-\end_layout
-
-\begin_layout Standard
-Vous pouvez aussi le trouver sur les archives
-\family typewriter
-sunsite
-\family default
- à
-\begin_inset Foot
-status collapsed
-
-\begin_layout Standard
-Notez que, au moment où ceci est écrit (janvier 1998), la version 1.0.3 de
- sgml-tools n'était pas encore disponible sur
-\family typewriter
-sunsite
-\family default
-.
-\end_layout
-
-\end_inset
-
-
-\end_layout
-
-\begin_layout LyX-Code
-
-\family roman
-\begin_inset LatexCommand \url{ftp://sunsite.unc.edu/pub/Linux/utils/text/sgml-tools-1.0.x.tar.gz}
-
-\end_inset
-
-
-\end_layout
-
-\begin_layout Standard
-Le fichier
-\family typewriter
-sgml-tools-1.0.x.tar.gz
-\family default
- contient tout ce dont vous avez besoin pour écrire des documents SGML et
- les convertir en groff, LaTeX, HTML, GNU info, LyX ou RTF.
-\end_layout
-
-\begin_layout Standard
-Ce paquetage a été renommé en janvier 1997.
- Il s'appelait auparavant
-\family typewriter
-linuxdoc-\SpecialChar \-
-sgml-\SpecialChar \-
-1.5.tar.gz
-\family default
-.
-\end_layout
-
-\begin_layout Standard
-Suivez les instructions de ce paquetage pour l'installer et l'utiliser.
- Tout ceci devra être fait en dehors de LyX, avant que vous ne puissiez
- utiliser la fonction
-\family sans
-Fichier\SpecialChar \menuseparator
-Exporter\SpecialChar \menuseparator
-LinuxDoc
-\family default
-.
-\end_layout
-
-\begin_layout Subsection
-Erreurs avec LinuxDoc
-\end_layout
-
-\begin_layout Standard
-Lorsque vous visualisez ou imprimez un document LinuxDoc, certaines vérification
-s sont effectuées avant de lancer LaTeX.
- Quelques erreurs sont détectées à ce moment-là, notamment celles concernant
- la structure des documents.
- LyX peut produire un message d'erreur, mais ne laisse pas de boîte d'erreur
- que vous puissiez ouvrir dans le document.
- Il vous faudra donc regarder directement le fichier pour trouver ce qui
- ne va pas.
- La plupart des problèmes semblent venir de l'utilisation d'options qui
- ne sont pas disponibles dans cette classe de texte.
-\end_layout
-
-\begin_layout Section
-Correcteur TeX
-\end_layout
-
-\begin_layout Standard
-par
-\noun on
-Asger Alstrup
-\end_layout
-
-\begin_layout Subsection
-Introduction
-\end_layout
-
-\begin_layout Standard
-Vous trouverez dans le menu
-\family sans
-Éditer
-\family default
- la commande
-\family sans
-Correction\InsetSpace ~
-TeX
-\family default
-.
- Cette fonctionnalité requière le programme
-\family typewriter
-chktex
-\family default
- et la commande est donc grisée si celui-ci n'est pas installé.
- Vous pouvez vous le procurer sur le miroir du CTAN le plus proche, ou à
- l'adresse
-\begin_inset LatexCommand \url{http://www.ifi.uio.no/~jensthi/chktex/}
-
-\end_inset
-
-.
-\end_layout
-
-\begin_layout Standard
-Le paquetage
-\family sans
-ChkTeX
-\family default
- est un programme qui a été écrit par
-\noun on
-Jens T.
- Berger Thielemann
-\noun default
- qui se plaignait que certaines commandes de LaTeX n'étaient pas naturelles
- et s'oubliaient facilement.
- Ce programme parcourt votre fichier LaTeX et en vérifie la bonne écriture.
- C'est donc l'équivalent de
-\family typewriter
-Lint
-\family default
-\noun toggle
-, mais pour LaTeX.
-\end_layout
-
-\begin_layout Standard
-La question est donc : mais que vient faire ce logiciel sous LyX alors que
- LyX est déjà censé produire du LaTeX exempt de fautes ? La réponse est
- simple : tout comme
-\family typewriter
-Lint
-\family default
- ne vérifie pas seulement la
-\emph on
-syntaxe
-\emph toggle
- d'un fichier C, mais aussi la bonne utilisation des types,
-\family sans
-ChkTeX
-\family default
- détecte en plus des erreurs syntaxiques quelques erreurs typographiques.
- Entre autres,
-\family sans
-ChkTeX
-\family default
- est à même de détecter des erreurs courantes comme
-\begin_inset Foot
-status collapsed
-
-\begin_layout Standard
-NdT : Certaines de ces règles me sont totalement inconnues.
- Il est possible qu'elles ne s'appliquent pas à la langue française.
-
-\emph on
--- of
-\end_layout
-
-\end_inset
-
- :
-\end_layout
-
-\begin_layout Itemize
-De mauvais points de suspension :
-\newline
-Utiliser \SpecialChar \ldots{}
- et non pas ...
-\end_layout
-
-\begin_layout Itemize
-Des espaces à l'intérieur des parenthèses :
-\newline
-( mauvais espacement )