ConTeXt/Installation
La suite ConTeXt est une distribution complète, mise à jour régulièrement et qui peut être améliorée très efficacement. Elle peut être utilisée seule ou bien en parallèle avec des installations telles que MikTeX pour Microsoft Windows, ou TeXLive pour les autres OS, comme ceux issus du monde Linux et BSD et ainsi de suite. Cette suite n'inclut pas les paquets , ni les binaires, les add-on et autres paquets spécifiques. Elle est donc autonome vis-à-vis de .
Parfois, les versions "bêta" de ConTeXt (éditée tous les 8 à 10 jours) peuvent produire des bugs. La suite ConTeXt vous permet de tester les dernières versions de ConTeXt sans se soucier de savoir si la mise à jour va corrompre un projet en production. De multiples installations de la suite ConTeXt sont possibles côte à côte dans des répertoires différents. Cela permet, par exemple, de disposer en parallèle d'une version "figée" et d'une version "bêta" sur le même ordinateur. Vous pouvez choisir, par exemple, de travailler en production avec une version de ConTeXt directement dans le répertoire codice_1, tout en testant du code avec une version mise à jour régulièrement dans le répertoire codice_2. Même chose sous Linux et Mac OSX.
ConTeXt est inclus aussi dans la distribution TeXLive. Si la suite ConTeXt est bien mise à jour en permanence, la version de ConTeXt contenue dans TeXlive ne l'est qu'une fois par an. En particulier, LuaTeX et Metapost, qui font l'objet d'un développement très actif et leurs paquets binaires sont mis à jour fréquemment; l'équipe de ConTeXt suit ces développements et même initie très souvent ces les nouveautés. Comme les fichiers binaires inclus dans la distribution TeXLive sont seulement mis à jour annuellement, ConTeXt avec TeXlive sera nécessairement un peu daté par rapport à la suite ConTeXt. ConTeXt avec TeXlive peut être un peu mieux à jour en utilisant cette source. La suite ConTeXt est donc auto-suffisante et peut heureusement cohabiter avec une autre installation d'une distribution TeX.
Notez donc que l'installation peut se faire dans un répertoire différent pour chaque projet d'édition et de composition, ce qui permet d'affiner et de régler les commandes en fonction du projet envisagé. ConTeXt ne touche à rien indépendamment de son répertoire : on peut donc le désinstaller avec simplicité et facilité en supprimant son répertoire d'installation (et le réinstaller par la suite). Une précaution doit être prise : les fichiers d'édition au format *.tex, *.log, *.tuc et de sortie *.pdf doivent être situés dans un répertoire à l'intérieur du répertoire codice_3. Si vous effacez le répertoire de la distribution, songez à sauvegarder avant vos fichiers de travail.
Plateformes supportées.
La liste des systèmes supportés par ConTeXt est disponible ici : codice_4
Installation de ConTeXt sur Microsoft Windows, Mac OS X et Linux.
Généralités.
Une installation "propre" de ConTeXt est une installation "fonctionnelle", sur laquelle il n'y a plus à revenir, sinon pour mettre à jour le logiciel. Au risque de nombreuses répétitions, on a choisi ici de détailler pour le débutant les procédures d'installation système par système (Microsoft Windows, Mac OS X, Linux), alors que ces procédures sont "presque" identiques. Il existe néanmoins quelques subtilités à connaître et on se rend compte assez vite que certaines légères différences dans les procédures d'installation peuvent s'avérer gênantes pour l'utilisateur débutant.
Installation de ConTeXt Standalone sur Mac OS X.
Quoique les commandes d'installation soient très similaires aux commandes Linux, il apparaît que Mac OS X oblige l'utilisateur à passer par des procédures d'identification et par l'App Store pour acquérir des outils comme codice_22 ou codice_21, ou oblige l'utilisateur à passer par des procédures complexes pour compiler et installer des outils comme codice_21 et codice_25 nécessaire à l'installation de codice_21. Dans l'ordre, on vérifiera, si on choisit la procédure l'installation par téléchargement via codice_21 la présence de codice_28 sur le système (par la commande, dans un terminal de codice_29. Si codice_28 n'est pas présent, on l'installera grâce à la commande simple codice_28 ! Puis on téléchargera codice_25 et ensuite on pourra télécharger et installer codice_21. Il faudra compiler codice_25 par les commandes codice_35, puis codice_36 en cas de présence d'une version ancienne de la librairie codice_37. Ensuite, après téléchargement de codice_21, on le compilera et l'installera de la même manière. Il faut veiller après le téléchargement de ces paquets, à les décompresser (par la commande codice_39) et à se rendre ensuite dans le dossier du paquet en question afin de le compiler (par la commande codice_35).
en mode 'Terminal' se rendre dans le répertoire /MonRépertoire/context/tex/, puis taper la commande : codice_45. On doit avoir comme retour la formule suivante : "Setting "/Users/adeimantos/Documents/context/tex" as ConTeXt root";
codice_51 (la spécification codice_52 permet d'installer la version Mark IV);
codice_56, puis :
codice_57
Installation de ConTeXt sur Linux.
Démarche à suivre pour installer ConTeXt Standalone par téléchargement.
A) création de répertoire : codice_61; 
B) Se rendre dans le répertoire : codice_62
C) Cette création de répertoire, puis s'y rendre, peuvent être automatisés par la commande suivante :
codice_63
codice_64
1. codice_63
2. codice_68
3. codice_69
codice_70.
codice_53
codice_72. 
On se rend donc dans le répertoire indiqué pour passer la commande :
codice_45 (Attention ! Il y a bien un point suivi d'une espace avant "setuptex" !) .
1) codice_48 
2) codice_49.
Ces deux commandes ont pour effet de développer toutes arborescences dont ConTeXt a besoin et de compiler un certain nombre de scripts. Vous pouvez regarder et suivre ces compilations, ou aller boire un café. L'opération prend deux à 3 minutes.
codice_78
Installation des Polices sous Linux.
codice_81. (Remarquez ici que les polices se trouvent dans 3 répertoires différents).
codice_84 
et on tape la commande : 
codice_50. 
Si cette dernière ne donne rien, on saisira la commande suivante : 
codice_86, qui a pour but de scanner tous les répertoires où se trouvent les polices.
codice_87;
codice_88.
Si vous ne voyez toujours pas les polices installées, cherchez le répertoire où elles sont installées, puis, commande ultime, vous pouvez vider le cache des polices, avant de le recharger, avec la commande : codice_89
ATTENTION !
Il se peut que le système vous indique que ConTeXt n'est pas installé et vous propose de le faire. Cela tient au fait que vous n'avez pas suivi correctement la procédure de lancement de ConteXt, cest-à-dire de lancer codice_45.
À chaque fois que vous voudrez utiliser ConTeXt, vous aurez besoin d'abord de signaler à "bash" où le trouver. Cela est possible en lançant :
Vous pouvez coller cette ligne par exemple dans codice_93.
Installation et configuration.
codice_100
Cette commande retourne, sous Linux, l'affichage suivant :"codice_101", mais rien de tel sous Windows (Windows n'est jamais bavard, dans ces cas-là !). Une fois cette configuration établie, on passera les commandes suivantes.
codice_106. 
Enfin, on tapera successivement les commandes suivantes : 
codice_50. Si cette commande ne donne rien, passez celle-ci : 
codice_110.
codice_112 
(étant entendu que ~/home/utilisateur/.fonts// désigne votre identifiant réel sous Linux. En principe, on n'a pas besoin de recharger la base de données des polices à chaque utilisation de ConTeXt, ni de procéder à la série des codice_48 et codice_49. Mais en cas de doute, ou bien parce que ne voit pas les polices être bien prises en charge dans la sortie PDF, il ne paraît pas inutile de vider le cache des polices et de régler de nouveau le codice_115 (ou le codice_116, sous Linux). 
Cette dernière commande vide le cache et le réinitialise; elle fonctionne bien sous Windows, même si un message d'erreur peut apparaître, comme celui-ci :
codice_120.
Si vous avez bien réglé OSFONTDIR comme ceci :
codice_121, il n'y a pas de souci. Vous pouvez en outre ouvrir le fichier codice_122 et modifier la ligne 49 en conséquence.
"mtxrun", le "couteau suisse" de ConTeXt.
mtxrun --script fonts --reload
On remarque que la structure de la commande codice_123 fait appel à plusieurs codice_129; ici il s'agit d'appeler le script "fonts", ainsi que le script "reload" ("recharger"). Une fois la base rechargée, on pourra regarder l'ensemble des polices présentes sur le système. La commande pour lister toutes les polices est la suivante :
mtxrun --script fonts --list --all
Vous voyez s'afficher 3 colonnes dans votre console, avec toutes les polices installées par ConTeXt, ainsi que celles qui ont été installées par vos soins (le chemin de ces dernières polices est même indiqué; par exemple, si vous avez installé la police EBGaramond dans codice_130 (sous Linux), la sortie de la commande donnera quelque chose du genre codice_131 Si nous cherchons maintenant à vérifier et à isoler un groupe particulier de polices, nous pouvons passer la commande suivante :
mtxrun --script fonts --list --pattern=texgyre* --all
Cette commande liste toutes les polices de la famille TeX Gyre, ce qui donne (sur notre système) :
Et ainsi de suite... "Nous ne donnons pas ici la totalité de l'affichage, pour des raisons de place".
codice_132.
codice_133. Cela provient du fait que la commande retourne d'abord le résultat qui concerne les polices livrées avec ConTeXt. Si l'on veut afficher l'ensemble des polices disponibles sur le système, il faudra ajouter codice_134.
ConTeXt Standalone avec TexWorks.
Si vous utilisez ConTeXt seul ("ConTeXt Standalone"), cela implique que vous n'avez pas installé une distribution telle que MikTeX (ou TeXLive).
La mise à jour de la version "bêta" avec tous les modules, les polices et les "goodies" se fait par la commande suivante :
codice_144
C'est très probablement une excellente idée de rendre ConTeXt visible à partir du PATH. Dans Windows 7, allez dans Système > Avancé > Variables Environnement et ajoutez codice_145 (ou bien codice_146 si ConTeXt est installé dans le répertoire "Documents" sur une machine avec un processeur Intel x64 ou AMD x64) à votre chemin d'utilisateur (PATH), si naturellement vous avez installé le répertoire ConTeXt dans C:\. Si vous l'avez installé dans C:\Users\"Dugenou"\MonRepertoire\Documents\Context\, modifiez l'information en conséquence. Cela vous permettra d'utiliser ConTeXt en ligne de commande de n'importe quel répertoire avec la commande codice_147, ou avec TeXWorks.
Autres éditeurs.
Il vous est proposé ici d'utiliser TEXWorks. Mais il est tout à fait possible, selon vos besoins et vos goûts d'installer et d'utiliser d'autres éditeurs; d'autant que l'on a souvent besoin, outre de rédiger le code de compilation et les instructions de commande, de vérifier la conformité du texte avec des correcteurs orthographiques, voire des dictionnaires. En ce qui concerne la qualité du texte, il est conseillé de préparer celui-ci sans se préoccuper de la mise en page ou des questions typographiques. Parmi les éditeurs en dehors de TeXWorks , en voici quelques uns :
Les utilisateurs chevronnés de Linux et autres distributions ont leurs préférences, comme emacs, vim, gedit, geany, etc. Il peut être utile de se référer à un tableau comparatif pour faire son choix et tester ce qui convient le mieux.
Tests.
Maintenant, vous pouvez procéder aux réglages de TeXworks (coloration syntaxique, etc.) et commencer à rédiger du code, afin de tester l'installation et le bon fonctionnement de ConTeXt, par exemple en copiant-collant le code ci-dessous dans TeXworks :
\startext
Mon premier test de ConTeXt !
\stoptext
ou le test ci-dessous :
\startxtable
\startxrow
\startxcell a 1 \stopxcell \startxcell b 1 \stopxcell 
\stopxrow
\startxrow 
\startxcell a 2 \stopxcell \startxcell b 2 \stopxcell 
\stopxrow 
\stopxtable 
Sélectionnez maintenant "ConTeXt MKIV" dans TEXWorks et cliquez sur "Typeset" (ou les touches "CTRL+T"). Un écran PDF devrait s'ouvrir et afficher le document, ici la phrase codice_151, ou un tableau de 4 colonnes.
\starttext
En guise d'introduction, il est remarquable de commencer par une distinction essentielle : la philosophie n'est ni un discours rationnel sur la nature (et en ce sens, elle n'est pas une “science de la nature”), ni un ensemble de recettes pratiques qui porteraient sur les techniques : la philosophie ne permet pas de bâtir une maison, ni d'élever des chiens, ou de moissonner un champ. Elle ne permet pas non plus de tirer au clair à elle seule les questions difficiles qui touchent à la révélation divine, même si on peut parler d'un dieu des philosophes. Devant cette impossibilité, la philosophie n'est pas non plus une théologie.\par
\blank[big]
Si nous reprenons l'ordre de nos énoncés, nous disons que :\par
\startitemize[a]
 \item La philosophie n'est pas une science de la nature (elle n'est pas un discours sur la biologie, la physique ou la chimie, elle n'est pas une étude de la science, une épistémologie);\par
\item Elle n'est pas un ensemble de techniques utiles et pratiques, comme peut l'être le yoga ; on ne démonte pas un carburateur avec un livre de philosophie entre les mains;\par
\item Elle n'est pas un discours sur le ou les dieux : elle n'est pas une théologie.\par
\stopitemize
\stoptext
Si par malchance ces tests avec TEXWorks ne donnent rien et échouent, veuillez vérifier que :
Modules.
ConTeXt possède de multiples ressources applicables à de très nombreux besoins, comme rédiger une lettre avec le module codice_154, un article, un livre, etc. Cependant, il faut savoir que contrairement à , la plupart des codice_155 et des environnements dont on peut avoir besoin appartiennent à la structure ("core structure") de ConTeXt. Dès lors, il n'existe pas beaucoup de modules pour ConTeXt (en fait, on en compte 32 pour "ConTeXt Standalone" — sans TeXLive — y compris le module pour codice_156 et le module codice_157) et vous n'aurez certainement pas besoin d'installer tous les modules. La liste des modules et leur description se trouve sur la page du Wiki de ConTeXt Garden. Vous pouvez installer les modules via la commande suivante : codice_158
Modules de tierces parties.
Afin d'installer les modules de tierces parties, il faut savoir que la suite ConTeXt est chargée avec quelques modules, comme le module de Taco Hoekwater, "t-bib". Si vous désirez installer un module supplémentaire dont vous connaissez l'intitulé, par exemple le module de Wolfgang Schuster relatif au format "letter", vous pouvez utiliser la commande suivante :
codice_159
Si vous désirez installer plus d'un module à la fois, vous pouvez séparer les options de commande par une virgule. Par exemple, si vous voulez installer le module "t-letter", ainsi que le module "t-mathsets", la commande sera :
codice_160
Bien entendu, l'installation de tous les modules en une seule fois se fait — comme nous l'avons dit au paragraphe concernant les modules — par la commande :
codice_158
Pour tout installer.
sh ./first-setup.sh --context=beta --fonts=all --modules=all --goodies=all
Mise à jour.
Pour mettre à jour la suite ConTeXt, il suffit de lancer codice_53 pour les sytèmes Linux/Mac OS X ou codice_15 avec Microsoft Windows. On peut aussi créer un alias ou un petit script nommé “ctx-update” avec le contenu donné en exemple ci-dessous :
La présentation de ConTeXt est maintenant achevée, de même que les procédures d'installation et de mise à jour. L'objet du chapitre suivant est de créer un document simple et d'expliquer les commandes utilisées. Une fois détaillées les principales commandes qui permettent d'éditer un document simple, nous aborderons la confection d'un document complexe. Ce qui nous conduira "in fine", à aborder la structure d'un "projet" d'édition. Cette documentation s'adresse avant tout aux "littéraires" qui sont intéressés par la maîtrise des documents complexes, tels qu'on peut en rencontrer dans les divers champs des "humanités" (littérature, langues anciennes, histoire, éditions savantes de manuscrits, etc.). Un Wikilivre sur la manière de rassembler et d'imprimer des documents de mathématiques ou de physique devrait légitimement être développé dans un autre ouvrage.
Dans les pages qui suivent, vous trouverez en majeure partie un ensemble de scripts (tous testés et fonctionnels) qui sont pour la majeure partie d'entre eux repris de la documentation officielle, repris, traduits, modifiés si nécessaire et testés par l'auteur de ce Wikilivre. Il est fortement conseillé de lire ce Wikilivre en ayant à sa disposition ConTeXt Standalone installé et fonctionnel. Il est de même conseillé de tirer partie des scripts, afin d'en comprendre la logique et la structure.
Bien travailler avec ConTeXt : Git.
L'expérience montre que le travail d'élaboration d'un texte, d'un article, d'un document complexe, d'un livre, peut se faire sur diverses machines et dans des conditions différentes. Si on prend un exemple-type courant, on est souvent conduit à travailler chez soi, dans un train, dans une maison de vacances, etc. L'idée la plus simple est d'enregistrer ses fichiers sur un CD-ROM, une clé USB ou un serveur distant. Cependant, la version de travail doit porter la mention de la date et de l'heure à laquelle vous avez fait votre dernier enregistrement. En l'occurrence, quelqu'un d'organisé (et de prévoyant) aura tendance à enregistrer les dernières modifications de son travail en portant la mention de la date dans le titre du fichier. Ainsi, il n'est pas rare de voir des répertoires entièrement remplis de fichiers comme "ConTeXt_Manuscrit-Virginia-Fox-Biographie_20-05-2016", "ConTeXt_Manuscrit-Virginia-Fox-Biographie_23-05-2016", "ConTeXt_Manuscrit-Virginia-Fox-Biographie_24-05-2016", et ainsi de suite. Lorsqu'il s'agit de travailler sur la "même" machine, cette méthode n'est pas dénuée de fondement. Mais à partir du moment où l'on se promène avec une clé USB dans la poche d'une machine à une autre, une manière de se simplifier la vie consiste à avoir recours à un script de "versioning". Vous le savez, la méthode de "versioning" consiste à enregistrer des modifications d'un fichier et à placer ces modifications sur un serveur, lequel calcule ces modifications et vous avertit sur l'état de la version sur laquelle vous êtes en train de travailler, travail qui naturellement modifie la dernière version "enregistrée".
L'intérêt d'un outil comme Git (et du serveur de dépôt GitLab), c'est que vous n'avez plus à vous préoccuper du nom de la version du fichier sur lequel vous voulez travailler : vous vous installez devant votre clavier et votre écran, vous allez dans le répertoire où se trouve le fichier à modifier et vous importez la dernière version par la commande codice_167 sur laquelle vous désirez travailler. Une fois que la séance de travail est achevée, vous enregistrez votre fichier sur le serveur distant avec la commande codice_168, fichier que vous pouvez retrouver sur n'importe quelle machine où codice_169 est installé.
Ce n'est pas ici le lieu de développer un chapitre sur l'installation et l'usage de Git, mais sachez, si vous êtes un débutant, que l'installation et l'usage de codice_169 sont simples et apportent un véritable confort de travail. Bien sûr, cela ne disqualifie pas l'usage des clés USB, où l'enregistrement d'une copie de votre travail sur un disque dur externe (on n'est jamais trop prudent !), notamment si on ne dispose pas de connexion Internet, connexion requise pour autoriser l'enregistrement de vos travaux sur un serveur distant.
Pour en savoir plus, vous pouvez vous rendre sur la page de GitLab qui fournit quelques explications simples.