Différences

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

--- texworks [Le 29/01/2011, 11:52]
PAC2 consulter la liste des fichiers de complétion
+++ texworks [Le 11/09/2022, 11:50] (Version actuelle)
moths-art Suppression des espaces en fin de ligne (détecté et corrigé via le bot wiki-corrector (https://forum.ubuntu-fr.org/viewtopic.php?id=2067892)
@@ Ligne 1: / Ligne 1: @@
+{{tag>LaTeX bureautique éditeur_de_texte}}
+----
-TeXworks est un éditeur [[latex|LaTeX]] à la fois très simple et très puissant. Inspiré de l'éditeur TeXShop qui n'existe que sous Mac OS, TeXworks possède les fonctionnalités habituelles d'un éditeur de texte, comme la coloration syntaxique, la recherche par expressions régulières, ou encore le correcteur orthographique, mais il offre aussi d'étonnantes possibilités pour naviguer facilement entre le code source et le document compilé.
+====== TeXworks ======
-=== Synctex : Du document compilé au code source ===
+**TeXworks** est un éditeur [[latex|LaTeX]] à la fois très simple et très puissant. Inspiré de l'éditeur TeXShop qui n'existe que sous Mac OS, TeXworks possède les fonctionnalités habituelles d'un éditeur de texte, comme la coloration syntaxique, la recherche par expressions régulières, ou encore le correcteur orthographique, mais il offre aussi d'étonnantes possibilités pour naviguer facilement entre le code source et le document compilé.
-Créez un document et compilez le. Naviguez ensuite au sein du document compilé. Vous repérez une erreur : plutôt que de parcourir tout le code source pour retrouver où se trouve l'erreur, procédez à un simple CTRL + Clic sur l'erreur en question et TeXworks vous renverra directement au point du code source correspondant.
+===== Pré-requis =====
+  * Disposer des [[:sudo|droits d'administration]].
+  * Disposer d'une connexion à Internet configurée et activée.
+  * Avoir activé l'accès au [[:depots#universe_et_multiverse|dépôt Universe]]
-=== La complétion automatique ===
+===== Installation =====
-TeXworks propose aussi un système de complétion automatique. Il suffit de taper "bmin" + TAB pour que TeXworks propose un environnement minipage, etc.
+==== Depuis les dépôts ====
+Pour installer ce logiciel, il suffit d'[[:tutoriel:comment_installer_un_paquet|installer le paquet]] **[[apt>texworks|texworks]]**.
-Quelques mots clés de complétion :
+==== Depuis le PPA ====
-  * bmin : environnement minipage
-  * sec : section
-  * xa : \alpha
-Pour obtenir la liste complète des mots clés de complétion, on peut consulter les fichier texte sités dans le répertoire completion :
+Pour obtenir la dernière version, on peut ajouter le PPA du projet ppa:texworks/ppa au fichiers des sources de logiciel.
+  * [[:PPA|Ajoutez le PPA]] **ppa:texworks/ppa**((https://launchpad.net/~texworks/+archive/ppa)) dans vos sources de logiciels.
+  * [[:tutoriel:comment_modifier_sources_maj#recharger_la_liste_des_paquets|Rechargez la liste des paquets]].
+  * [[:tutoriel:comment_installer_un_paquet|Installez le paquet]] **[[apt>texworks|texworks]]**.
+==== Depuis les sources ====
+On peut aussi compiler Texworks depuis la source.
+  - [[:tutoriel:comment_installer_un_paquet|Installez]] les dépendances de compilation **[[apt>build-essential,subversion,libpoppler-qt4-dev,libhunspell-dev,libdbus-1-dev|build-essential subversion libpoppler-qt4-dev libhunspell-dev libdbus-1-dev]]**.
+  - Téléchargez la source depuis un [[terminal]] : <code>svn checkout http://texworks.googlecode.com/svn/trunk/ texworks-read-only</code>
+  - Placez-vous dans le répertoire de la source ainsi créé <code>cd texworks-read-only</code>
+  - Ensuite lancez la compilation avec ces commandes successives : <code>qmake-qt4
+make
+./texworks
+</code>
+===== Utilisation =====
+Lancez l'application depuis le menu //Applications -> Accessoires -> TeXworks// ou //via// la [[:commande_shell|commande]] suivante :
+<code>texworks</code>
+==== Synctex : Du document compilé au code source et inversement ====
+Créez un document et compilez-le. Naviguez ensuite au sein du document compilé. Vous repérez une erreur : plutôt que de parcourir tout le code source pour retrouver où se trouve l'erreur, procédez à un simple CTRL + Clic sur l'erreur en question et TeXworks vous renverra directement au point du code source correspondant.
+==== Combiner les documents sources ====
+En LaTeX, il arrive souvent qu'on écrive la source sur plusieurs documents tex. Par exemple, on peut avoir un document principal intitulé main.tex qui renvoie à d'autres documents (par exemple partie1.tex, partie2.tex) à l'aide de la commande ''\input{}''. Dans ce cas, il faut généralement revenir au document principal pour compiler le document. Cette opération peut vite s'avérer pénible. TeXworks permet d'indiquer le document principal à compiler dans chacun des documents sources et de compiler ainsi l'ensemble du document à partir de n'importe quel document source. Il suffit de placer en haut de chaque fichier l'instruction suivante :
+  % !TeX root = main.tex
+Malheureusement, il y a actuellement un bogue faisant que synctex ne marchera que pour le premier fichier inclus de cette manière(voir [[http://code.google.com/p/texworks/issues/detail?id=495&q=synctex|ici]]).
+==== Contrôler l'encodage des documents ====
+Toujours dans l'en tête du document, il est possible d'indiquer une ligne de code pour indiquer l'encodage du document :
+  % !TeX encoding = latin1
+==== La complétion automatique ====
+TeXworks propose aussi un système de complétion automatique. Il suffit de taper ''bmin'' + TAB pour que TeXworks propose un environnement //minipage//, etc. En tapant "be" + TAB plusieurs fois, on obtient successivement les différentes propositions enregistrées commençant par "be".
+Pour les lettres grecques, très utiles pour taper des formules mathématiques, les mots-clés de complétion commencent en général par ''x'' puis l'équivalent de la lettre grecque en français. Par exemple ''xa'' pour ''\alpha'' ou ''xm'' pour ''\mu'', etc. Pour les lettres majuscules, il faut utiliser le préfixe ''xc'' au lieu de ''x''. Par exemple ''xcp'' donne un ''\Pi''.
+Pour les environnements LaTeX, les mots-clés commencent en général par le préfixe ''b'' (comme ''begin'') suivi des premières lettres du nom de l'environnement. Par exemple ''bmin'' pour un environnement //minipage//, ''bcent'' pour un environnement //centre//, ''benu'' pour un environnement //enumerate//, etc.
+Pour obtenir la liste complète des mots-clés de complétion, qui pourront servir de modèles à vos propres créations, on peut consulter les fichiers textes cités dans le répertoire completion (dans lequel on peut créer son propre fichier txt) :
    cd ~/.TeXworks/completion/
    gedit tw-basic.txt
    gedit tw-latex.txt
+   gedit tw-beamer.txt
+A noter que pour créer une nouvelle entrée de complètement dans un fichiers txt, deux syntaxes sont possibles, on peut soit vouloir remplacer une abréviation par un mot ou une commande :
+   monex:=\monexemple{#INS#}#RET#
+soit compléter un mot tel que :
+   anticonstitutionnellement
+(liste de mots).
+Quelques commandes importantes :
+  * bmin pour un environnement minipage
+  * bite pour un environnement itemize
+ Pour Beamer, retenons quelques commandes importantes :
+  * bfrm pour un environnement frame.
+  * \fra pour \frametitle
-=== Les raccourcis clavier ===
+==== Les raccourcis clavier ====
   * CTRL + T : pour compiler
@@ Ligne 31: / Ligne 99: @@
   * CTRL + < : pour supprimer l'indentation
-=== Ajouter des modèles ===
+==== Les modèles ====
+TeXworks contient des modèles d'article ou de présentation qui sont très utiles pour commencer un nouveau document.
 Pour ajouter des modèles, il suffit d'enregistrer un document modèle dans le dossier suivant :
    ~/.TeXworks/templates/
+===== Désinstallation =====
+Pour supprimer cette application, il suffit de [[:tutoriel:comment_supprimer_un_paquet|supprimer son paquet]]. Selon la méthode choisie, la configuration globale de l'application est conservée ou supprimée. Les journaux du système, et les fichiers de préférence des utilisateurs dans leurs dossiers personnels sont toujours conservés.
+===== Voir aussi =====
-=== Des références ===
+  * **(fr)** [[https://github.com/TeXworks/manual/releases/download/2015-05-06/TeXworks-manual-fr.pdf|Un très bon manuel (PDF)]]
+  * **(en)** [[http://ftp.ctex.org/pub/tex/tools/editors/TeXworks/manual.pdf|Manuel en anglais (PDF)]]
+  * **(en)** [[http://www.tug.org/texworks/|Site web du projet]]
+  * [[http://www.framasoft.net/article5057.html|L'article Framasoft]]
+  * [[wpfr>TeXworks|TeXworks sur Wikipédia]]
+  * **(en)** [[http://code.google.com/p/texworks/wiki/Building|Construire depuis la source]]
-  * Un très bon manuel en Français http://fj.legendre.free.fr/LaTeX/Delmotte-A.-Petit-manuel-pour-TEXworks.pdf
+----
-  * Un manuel en Anglais http://ftp.ctex.org/pub/tex/tools/editors/TeXworks/manual.pdf
+//Contributeurs principaux : ...//
-  * Le site web du projet http://www.tug.org/texworks/
-  * La page framasoft http://www.framasoft.net/article5057.html
-  * La page wikipédia http://fr.wikipedia.org/wiki/TeXworks