Mettre un paragraphe en évidence

Tu seras peut-être amené à vouloir donner une apparence particulière à une partie de ton texte soit parce que c'est un aparté, une définition, une longue citation ou une biographie d'un personnage cité,. . .. Il y a plusieurs solutions pour y arriver. Nous allons les étudier de la plus facile à mettre en place à la plus complexe.

L'environnement narrower

Cet environnement permet de mettre en retrait une portion de texte.

\input tufte permet d'écrire automatiquement un paragraphe bidon.

Tu peux lui adjoindre trois options : middle (option par défaut) le retrait de texte se fait de façon identique à droite et à gauche, left retrait uniquement à gauche et right retrait uniquement à droite.

Si tu veux affecter tous les environnements narrower de ton document tu utilises la commande :

Tu peux préciser des dimensions :

Attention à bien rappeler left et right au niveau de \startnarrower sinon c'est middle, l'option par défaut qui est pris en compte.

Modifier la taille ou l'aspect de la fonte utilisée

La commande \switchtobodyfont[option,. . .] permet de modifier facilement la fonte. Les options possibles sont :

serif regular roman sans support sansserif mono type teletype handwritten calligraphic 5pt ... 12pt small big

On peut coupler les deux méthodes que l'on vient de voir :

\blank[big] permet d'augmenter l'espace entre les paragraphes.

Ajouter des lignes avant et après le texte

La commande la plus simple pour ajouter une ligne est :

Voici un exemple d'utilisation :

Une commande plus intéressante pour gérer les lignes encadrant un paragraphe, car acceptant plusieurs options, est

Cette commande peut prendre deux options et un argument. Les deux options sont top et bottom. Dans le cas de bottom le trait est situé sous le paragraphe précédent (c'est l'option par défaut) :

Avec top le trait est placé juste au-dessus du paragraphe suivant :

L'argument permet d'ajouter un titre :

Il existe une autre façon d'utiliser textrule c'est d'employer un environnement :

Comme pour \textrule les options ne peuvent être que top et left et l'argument est le titre. Le code suivant produit exactement le même résultat que ci-dessus. Attention toute fois à son utilisation, pour ne pas avoir de titre il faut mette des {} vide :

Tu peux adjoindre à \textrule d'autres options, mais pour cela il faut utiliser

Les options possibles sont : location before after inbetween width distance bodyfont color style rulecolor

location

Prend deux valeurs left (valeur par défaut) place le titre à gauche comme dans l'exemple précédent, et inmargin qui place le titre dans la marge.

width

La distance du titre par rapport au début du trait.

distance

Controle l'espace à droite et à gauche entre le titre et le trait :

bodyfont

Permet de modifier la taille et l'aspect du texte encadré. Prend les valeurs suivantes : serif regular roman sans support sansserif mono type teletype handwritten calligraphic 5pt ... 12pt small big. Il n'affecte pas le titre.

Je n'ai pu faire fonctionner cette option uniquement avec l'environement \starttextrule \stoptextrule.

Attention si tu mets plusieurs options n'oublie pas de les encadrer avec des {}

Un autre exemple :

style

Permet de modifier l'apparence du titre, prend les valeurs suivantes : normal bold slanted boldslanted type cap small COMMANDE

Attention n'accepte qu'une seule option, tu ne peux avoir par exemple style={cap,small}

Pour modifier plus en profondeur le titre il faut utiliser des commandes par exemple \switchtobodyfont :

N'oublie pas les {} encadrant \switchtobodyfont.

color

Permet de changer la couleur du titre :

rulecolor

Permet de changer la couleur des traits :

before, inbetween et after

Ces trois options permettent d'ajouter des commandes dont l'action interviendra respectivement avant entre et après le paragraphe mis en évidence. C'est de cette façon que tu peux modifier l'espacement entre le corps du texte et le paragraphe modifé ou entre les traits et le paragraphe modifié :

Un trait dans la marge

Cette commande affiche dans la marge un trait vertical. [nombre] permet de préciser l'épaisseur du filet.

Encadrer du texte

Pour encadrer du texte c'est très simple il suffit d'utiliser l'environnement :

Si on reprend nos exemples précédents :

La première série d'options ne peut prendre que les valeurs suivantes : left right middle none. Elle règle le positionement du texte encadré, left étant l'option par défaut. Avec middle on obtient :

Comme pour les autre commandes tu peux ajouter des options à l'aide de :

Ou bien avec

La première option ([identifiant]) est optionelle et n'est utile que dans le cas ou tu as créé ton propre cadre avec \defineframedtexts, revoie la fiche sur les commandes.

bodyfont

Modifie la taille du texte encadré, son comportement est identique à l'option bodyfont de \setuptextrules.

style

Modifie l'aspect du texte encadré, son comportement est identique à l'option style de \setuptextrules.

left right before after inner

Ces options permettent d'ajouter des commandes dont l'action interviendra respectivement à gauche, à droite, avant, après et à l'intérieur du paragraphe encadré. Son comportement est identique à aux mêmes options de \setuptextrules.

width

Règle la largeur du cadre, prend les valeurs : fit broad fixed local DIMENSION Avec broad le cadre occupe toute la taille du texte.

height

Règle la hauteur du cadre, prend les valeurs : fit broad DIMENSION.

offset

Règle la distance entre le cadre et le texte interne, prend les valeurs : none overlay default DIMENSION.

Avec overlay il n'y a pas d'espace entre les filets et le texte.

frame topframe bottomframe leftframe rightframe

Permet d'afficher tout ou partie du cadre

frame prend les valeurs : on off none overlay

Les autres seulement on off.

frameoffset

Règle l'espace entre le texte et le cadre. L'exemple ci-dessous montre la différence avec offset :

rulethickness

Gére la taille des filets. N'accepte qu'une dimension.

framecolor

Gére la couleur des filets.

corner

Permet de choisir la forme des coins du cadre arrondis ou rectangulaire, prend deux valeurs : corner rectangular (rectangular est la valeur par défaut).

corner peut prendre également une valleur comprise entre 00 et 28, dont le résultat est donné par l'image ci-dessous :

radius

Associé à corner ou framecorner, permet de choisir la taille de l'arrondi.

foregroundcolor

Pour modifier la couleur du texte encadré.

foregroundstyle

Pour modifier le styledu texte encadré, prend les valeurs suivantes :

normal bold slanted boldslanted type cap small COMMANDE

Je te rappelle que tu peux utiliser des commandes comme \switchtobodyfont pour modifier plus profondément le texte encadré.

background

Permet de choisir un fond pour le cadre, avec les valeurs screen color none foreground IDENTIFIANT

Avec screen le fond sera composé avec une échelle de gris et avec color en couleur.

backgroundscreen

Permet d'attirbuer une valeur de gris au fond. La valleur ets comprise entre 0 (noir) et 1 (blanc). La valeur par défaut est 0.95.

backgroundcolor

Permet de choisir la couleur du fond.

Je te rapelle que pour utiliser la couleur dans ConT_eXt il faut mettre dans le prologue de ton source \setupcolors[states=start]. Ceci n'est plus utile dans les versions récentse de conTeXt (2013).

backgroundoffset

Règle la distance entre le fond et le cadre. Prend les valeurs frame DIMENSION. frame est la valeur par défaut, le fond est collé au cadre.

backgroundcorner backgroundradius

Même effets et même utilisation que framecorner et frameradius mais appliqué au fond.

La différence entre corner, framecorner et backgroundcorner est que le premier affecte à la fois le cadre et le fond alors que les deux autres uniquement le cadre pour framecorner et seulement le fond pour backgroundcorner :

Quelques exemples

Voici une exemple tiré du manuel de ConT_eXt :

Un autre exemple plus complexe qui fait appel à metafun. La partie du code metafun n'est pas expliqué dans cette fiche. Le code est directement repompé du manuel de Hans Hagen. Grace à l'option randomized de metafun, aucun des cadres n'aura la même forme.