Démarrage rapide

Écrire un document LATEX avec Kile pour les débutants
Les utilisateurs de Kile ont deux possibilités lorsqu'ils commencent un nouveau document : ils peuvent utiliser l'assistant pour commencer un nouveau document, choisir le type de document à créer et des options comme la taille des polices, la taille du papier, Ils peuvent également écrire le code à la main.

\documentclass[12pt]{article}
\begin{document}
        Voici un morceau de code \LaTeX.
\end{document}

Chaque document LATEX commence par la commande \documentclass[arguments optionnels]{classe}, où classe spécifie le type de document.
En saisissant le code de l'exemple précédent dans la zone de texte, vous obtiendrez la sortie suivante :
Texte compilé dans la sortie
Texte compilé dans la sortie
Texte compilé dans la sortie
Les crochets qui se trouvent après la commande \documentclass contiennent les options pour la commande. L'option [12pt] règle la taille de la police pour votre article, si vous ne réglez pas la taille de la police au début, vous pourrez le faire plus tard.
Une fois que vous avez saisi le code de l'exemple ci-dessus, vous devez compiler votre code source LATEX. La façon la plus simple pour vous de compiler est d'utiliser le menu Compilation, ou d'utiliser le bouton Quickbuild.
2 est le raccourci clavier pour compiler votre code source.
Vous devez enregistrer votre code source avant de pouvoir le compiler. Kile fera ceci pour vous automatiquement.
Si votre document ne compile pas, vérifiez les erreurs qui se trouvent dans le journal (log). Lorsque vous utilisez la touche Quickbuild, l'afficheur devrait se lancer automatiquement. Si ce n'est pas le cas, regardez le journal.

Environnements
Un environnement est un segment de texte qui est géré différemment du reste du document. Par exemple, vous créez un rapport avec une police de taille 12, mais vous devez modifier la taille de la police pour quelques phrases. Les commandes \begin{environment}, \huge et \end{environment} vous permettront de modifier temporairement le texte contenu entre les commandes d'environnement afin qu'il soit de taille huge.
Les changements ne sont effectifs que de \begin{environment} à \end{environment}. Il n'y a aucune limitation quant au nombre de changements que vous pouvez effectuer dans un environnement.
Vous pouvez ajouter un grand nombre de caractéristiques afin de rendre votre document plus lisible et plus accessible. Vous pouvez utiliser des polices spécifiques, le gras, l'italique, le souligné, dans votre document, et ces commandes se termineront soit avec une commande \end, soit à la fin de votre environnement.
\begin{emph} : cette commande met le texte en italique, et est valable jusqu'à ce qu'on rencontre dans le code soit \end{emph}, ou un autre environnement. Pour mettre en emphase un mot dans une phrase, vous pouvez utiliser la syntaxe suivante : ceci est \emph{ma} phrase.
\textbf{J'affiche en gras ce texte entre accolades} : cette commande met votre texte en gras.
\quote : pour créer une citation dans votre document ; commencez votre citation par \begin{quote} et terminez-là par \end{quote}.
\center : centre le texte.
\verse : crée du texte décalé pour les poèmes.
\itemize : crée une liste d'éléments.

Utilisation de Kile
Maintenant que nous vous avons donné quelques bases sur la façon d'écrire le code en utilisant le langage LATEX, nous allons vous montrer comment créer un document en utilisant Kile, pas à pas.
Démarrez Kile,
choisissez Assistant Démarrage rapide, puis choisissez un format, et réglez vos préférences dans l'assistant,
une fois que l'assistant a inséré le texte, faites quelques personnalisations pour rendre le document plus lisible, ajoutez au minimum une citation, du texte en gras, en italique, et un vers pour voir la différence entre les commandes,
enregistrez votre fichier et donnez-lui le nom intro.tex,
compilez votre document en utilisant 2, ou le bouton nommé LaTeX,
choisissez ForwardDVI,
vérifiez votre nouveau texte,
lorsque vous avez terminé de regarder votre document, cliquez sur le bouton Vue éditeur ou appuyez sur E pour retourner dans l'éditeur si vous avez utilisé l'afficheur embarqué, sinon, fermez la fenêtre de l'afficheur si vous utilisez un afficheur séparé.
C'est fait ! Vous venez de créer votre premier document LATEX !
Une fois que vous avez créé votre fichier , vous pourrez imprimer votre document, ou le transformer en fichier ou PDF si vous le souhaitez. Expérimentez et amusez-vous !

Fichiers
signifie fichier DeVice Independent (indépendant du périphérique). Ces fichiers sont produits par TEX ou LATEX afin d'être lus par un pilote sur votre ordinateur. Vous pouvez envoyer un .dvi vers un grand nombre de sorties, comme une imprimante, un convertisseur vers un fichier ou PDF, ou l'écran de votre ordinateur.

Afficher un
Vous avez déjà vu comment afficher un fichier à l'écran en utilisant le bouton ForwardDVI de la barre d'outils.

Imprimer un
Pour imprimer un , vous pouvez utiliser le même procédé que celui utilisé pour créer votre document précédemment (voir Utilisation de Kile). À l'étape 7, après avoir cliqué sur ForwardDVI, choisissez Fichier Imprimer dans l'afficheur, et si vous disposez d'une imprimante correctement configurée, vous pourrez imprimer le .

Convertir les fichiers
La barre d'outils fournit les options de conversion d'un fichier vers d'autres formats. Une fois que vous avez créé un fichier à partir de votre code source LATEX, vous pourrez l'exporter au format de votre choix en utilisant les boutons de la barre d'outils.

Recherche avant entre Kile et
Les fonctions de recherche avant vous permettent de passer de votre éditeur directement à la position correspondante dans le fichier ou PDF.
Kile offre une configuration pour cette option pour tous les exécutables LATEX. Allez dans Configuration Configurer Kile... Outils Compilation et choisissez toujours la configuration PDFLatTeX+ViewPDF.
Pour réaliser une recherche avant, positionnez le curseur sur la ligne du code source, et cliquez sur ForwardDVI pour aller à la position associée dans la fenêtre de l'afficheur ou PDF.

Recherche inverse entre Kile et
La recherche inverse est une caractéristique très utile lorsque vous écrivez un document LATEX vous-même. Si tout est configuré correctement, vous pouvez cliquer dans la fenêtre de avec le tout en maintenant enfoncée la touche . Après cela, Kile chargera le fichier source LATEX et ira au paragraphe approprié. Pour utiliser la recherche inverse, vous devez compiler votre fichier LATEX avec la configuration PDFLatTeX+ViewPDF.
La recherche inverse fonctionnera uniquement si :
le fichier source a été compilé correctement,
sait quel éditeur vous souhaitez utiliser.
Avec cette caractéristique de , un clic avec le bouton gauche de la souris dans le document ou PDF, tout en maintenant enfoncée la touche , fera s'ouvrir Kile avec le document LATEX correspondant, et tentera d'aller à la ligne correspondante. N'oubliez pas d'indiquer à d'utiliser Kile comme éditeur de texte, dans l'élément de menu de Configuration Configurer Okular... (sur la page Éditeur).
Configuration de
Configuration de
Configuration de

Résolution des erreurs
Si vous essayez d'utiliser QuickBuild, et que l'afficheur ne s'ouvre pas, il est probable que vous avez une erreur. Si c'est le cas, elle sera visible dans le fichier journal ou la zone de message, et le résumé de l'erreur sera donné.
Le fichier journal explique la source de l'erreur dans votre code. Dans l'éditeur, vous pouvez utiliser les boutons de la barre d'outils nommés Erreur LaTeX précédente et Erreur LaTeX suivante pour naviguer entre les erreurs. Le fichier journal indique toujours la ligne à laquelle l'erreur s'est produite. Pour voir cette ligne, cliquez sur l'erreur dans la fenêtre du journal, et Kile vous emmènera à cette ligne.