{{tag>LaTeX bureautique éditeur_de_texte}}
----

====== TeXworks ======

**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é.

===== 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]]

===== Installation =====

==== Depuis les dépôts ====
Pour installer ce logiciel, il suffit d'[[:tutoriel:comment_installer_un_paquet|installer le paquet]] **[[apt>texworks|texworks]]**.

==== Depuis le PPA ====

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 ====

  * CTRL + T : pour compiler
  * CTRL + ' : pour passer de la source au document compilé et inversement
  * CTRL + clic : pour aller au point correspondant dans la source ou le document compilé
  * CTRL + ( : pour mettre en commentaire le texte sélectionné
  * CTRL + ) : pour ne plus mettre en commentaire le texte sélectionné
  * CTRL + > : pour indenter
  * CTRL + < : pour supprimer l'indentation

==== 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 =====

  * **(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]]

----
//Contributeurs principaux : ...//