aleph - manuel de référence, options, exemples de commandes


NOM

aleph - Unicode TeX étendu

SYNOPSIS

aleph [options] [&format] [file|\commands]

DESCRIPTION

Exécutez le compositeur Aleph sur fichier, en créant généralement fichier.dvi. Si l'argument file n'a pas d'extension, ".tex" lui sera ajouté. Au lieu d'un nom de fichier, un ensemble de commandes Aleph peut être donné, dont le premier doit commencer par une barre oblique inverse. Avec un argument &format, Aleph utilise un ensemble différent de commandes précompilées, contenues dans format.fmt ; il est généralement préférable d'utiliser l'option -fmt format à la place.

Aleph est une version du programme TeX modifiée pour la composition multilingue. Il utilise Unicode et possède des primitives supplémentaires pour (entre autres) la composition bidirectionnelle.

Les options de ligne de commande d'Aleph sont similaires à celles de TeX.

Aleph n'est plus activement développé ; voir LuaTeX pour l'activité en cours.

OPTIONS

Exécutez aleph --help pour voir la liste complète des options ; ceci n'est pas exhaustif.

-cnf-line string

Analyser string comme une ligne de configuration texmf.cnf. Voir le manuel de Kpathsea.

--fmt format

Utilisez format comme nom du format à utiliser, au lieu du nom par lequel Aleph a été appelé ou d'une ligne %&.

--halt-on-error

Sort avec un code d'erreur lorsqu'une erreur est rencontrée pendant le traitement.

--help

Imprimer le message d'aide et quitter.

--ini

Soyez `initial' Aleph pour les formats de vidage ; c'est implicitement vrai si le programme est appelé en tant que inialeph.

--interaction mode

Définit le mode d'interaction. Le mode peut être l'un des batchmode, nonstopmode, scrollmode et errorstopmode. La signification de ces modes est la même que celle des \commandes correspondantes.

--ipc

Envoyez la sortie DVI vers une prise ainsi que le fichier de sortie habituel. La disponibilité de cette option est au choix de l'installateur.

--ipc-start

En tant que --ipc, et démarre également le serveur à l'autre bout. La disponibilité de cette option est au choix de l'installateur.

--kpathsea-debug bitmask

Définit les indicateurs de débogage de recherche de chemin en fonction du masque de bits. Voir le manuel de Kpathsea pour plus de détails.

--maketex fmt

Activez mktexfmt, où fmt doit être l'un de tex ou tfm.

--no-maketex fmt

Désactivez mktexfmt, où fmt doit être l'un de tex ou tfm.

--output-comment string

Utilisez string pour le commentaire du fichier DVI au lieu de la date.

--output-directory directory

Écrivez les fichiers de sortie dans le répertoire au lieu du répertoire courant. Recherchez d'abord les fichiers d'entrée dans le répertoire, puis le long du chemin de recherche normal.

--parse-first-line

Si la première ligne du fichier d'entrée principal commence par %&, analysez-le pour rechercher un nom de vidage.

--progname name

Faire semblant d'être le programme nom. Cela affecte à la fois le format utilisé et les chemins de recherche.

--recorder

Activez l'enregistreur de nom de fichier. Cela laisse une trace des fichiers ouverts en entrée et en sortie dans un fichier avec l'extension .ofl. (Cette option est toujours activée.)

--shell-escape

Activez la construction \write18{commande}. La commande peut être n'importe quelle commande Bourne shell. Par défaut, cette construction est activée en mode restreint, pour des raisons de sécurité.

--version

Imprimer les informations de version et quitter.

ENVIRONNEMENT

Voir la documentation de la bibliothèque Kpathsearch (le nœud `Spécifications du chemin') pour des détails précis sur la façon dont les variables d'environnement sont utilisées. L'utilitaire kpsewhich peut être utilisé pour interroger les valeurs des variables.

Une mise en garde : dans la plupart des formats Aleph, vous ne pouvez pas utiliser ~ dans un nom de fichier que vous donnez directement à Aleph, car ~ est un caractère actif, et donc développé, et non considéré comme faisant partie du nom de fichier. D'autres programmes, tels que Metafont, n'ont pas ce problème.

TEXMFOUTPUT

Normalement, Aleph place ses fichiers de sortie dans le répertoire courant. Si un fichier de sortie ne peut pas y être ouvert, il essaie de l'ouvrir dans le répertoire spécifié dans la variable d'environnement TEXMFOUTPUT. Il n'y a pas de valeur par défaut pour cette variable. Par exemple, si vous dites tex paper et que le répertoire courant n'est pas accessible en écriture, si TEXMFOUTPUT a la valeur /tmp, Aleph tente de créer /tmp/paper. log (et /tmp/paper.dvi, si une sortie est produite.) TEXMFOUTPUT est également vérifié pour les fichiers d'entrée, car TeX génère souvent des fichiers qui doivent être lus ultérieurement ; pour l'entrée, aucun suffixe (tel que ``.tex'') n'est ajouté par défaut, le nom de l'entrée est simplement vérifié comme indiqué.

TEXINPUTS

Chemin de recherche des fichiers \input et \openin. Cela devrait commencer par ``.'', afin que les fichiers utilisateur soient trouvés avant les fichiers système. Un composant de chemin vide sera remplacé par les chemins définis dans le fichier texmf.cnf. Par exemple, définissez TEXINPUTS sur ".:/home/user/tex:" pour ajouter le répertoire courant et ``/home/user/tex'' au chemin de recherche standard.

TEXEDIT

Modèle de commande pour passer à l'éditeur. La valeur par défaut, généralement vi, est définie lors de la compilation d'Aleph.

REMARQUES

Cette page de manuel ne se veut pas exhaustive. La documentation complète de cette version d'Aleph se trouve dans le manuel d'information Web2C : une implémentation de TeX. Voir http://tug/org/web2c.

INSECTES

Cette version d'Aleph implémente un certain nombre d'extensions optionnelles. En fait, beaucoup de ces extensions sont plus ou moins en conflit avec la définition d'Aleph. Lorsque de telles extensions sont activées, la bannière imprimée au démarrage d'Aleph est modifiée pour imprimer Alephk au lieu de Aleph.

Cette version d'Aleph ne parvient pas à piéger le débordement arithmétique lorsque des dimensions sont ajoutées ou soustraites. Les cas où cela se produit sont rares, mais lorsque cela se produit, le fichier DVI généré sera invalide.

VOIR ÉGALEMENT

tex(1), mf(1)

AUTEURS

Les principaux auteurs d'Aleph sont John Plaice et Yannis Haralambous.