box - En ligne dans le Cloud

PROGRAMME:

Nom

cases - zone de mode texte et filtre de dessin de commentaire

SYNOPSIS

boîtes [-hlmrv] [-a format] [-d design] [-f fichier] [-i indent] [-k bool] [-p pad] [-s size]
[-t tabops] [fichier d'entrée [fichier de sortie]]

DESCRIPTION

Boites est un filtre de texte qui peut dessiner n'importe quel type de boîte autour de son texte d'entrée. Conception de la boîte
les choix vont des simples boîtes à l'art ASCII complexe. Une boîte peut également être retirée et
réparé, même s'il a été gravement endommagé par l'édition du texte à l'intérieur. Étant donné que les boîtes peuvent
être ouvert de n'importe quel côté, boîtes peut également être utilisé pour créer des commentaires régionaux dans n'importe quelle programmation
Langue. De nouvelles conceptions de boîtes de toutes sortes peuvent facilement être ajoutées et partagées en les ajoutant à un
fichier de configuration au format libre.
boîtes était à l'origine destiné à être utilisé avec le entrain(1) éditeur de texte, mais il peut être lié
à n'importe quel éditeur de texte prenant en charge les filtres, ainsi qu'appelé depuis la ligne de commande en tant que
outil autonome.

OPTIONS

Options offertes par boîtes sont les suivants:

-a un magnifique
Alignement/positionnement du texte à l'intérieur de la boîte. Cette option prend un argument de chaîne de format
qui se lit de gauche à droite. La chaîne de format ne peut pas contenir d'espace et
doit comprendre un ou plusieurs des éléments suivants :

hx - alignement horizontal du bloc de texte d'entrée à l'intérieur d'une boîte potentiellement plus grande.
Valeurs possibles pour x l (ell, pour l'alignement à gauche), c (centre), ou r (droite).
Cela n'affecte pas la justification des lignes de texte dans le bloc de texte d'entrée
(Utilisez le j argument à la place).
vx - alignement vertical du bloc de texte d'entrée à l'intérieur d'une boîte potentiellement plus grande.
Valeurs possibles pour x t (pour l'alignement supérieur), c (centre), ou b (bas).
jx - justification des lignes dans le bloc de texte d'entrée. Valeurs possibles pour x l
(eh bien, pour la justification à gauche), c (centre), ou r (droit). Cela n'affecte pas le
alignement du bloc de texte d'entrée lui-même dans la boîte. Utilisez le h ainsi que v arguments
pour le positionnement du bloc de texte d'entrée.

Notations abrégées (peuvent être combinées avec les arguments ci-dessus) :
l (ell) - abréviation de hlvcjl
c - court pour hcvcjc
r - court pour hrvcjr

Le réglage d'usine par défaut pour -a is hlvt.

-c un magnifique
Définition de la conception de la ligne de commande pour les cas simples. L'argument de cette option est le
définition de la forme « ouest » (W). La forme définie doit être constituée d'exactement un
ligne, c'est-à-dire qu'aucune forme multiligne n'est autorisée. Les -c l'option est conçue comme un raccourci
pour les cas où de simples commentaires régionaux doivent être créés, qui ne nécessitent qu'un
certain caractère ou séquence de caractères à placer devant chaque ligne. Dans
de tels cas, il est beaucoup plus pratique de spécifier simplement -c que de faire un complet
définition de conception dans son fichier de configuration, où la seule forme définie est l'ouest
forme.
Cette option implique une -d et n'accède pas au fichier de configuration. -c peut bien sûr être
utilisé en conjonction avec l'une des autres options. Par défaut, -c n'est pas spécifié.

-d un magnifique
Sélection de conception. Le seul argument de cette option est le nom de la conception à utiliser.

-f un magnifique
Utilisez un autre fichier de configuration. Le seul argument de cette option est le nom d'un
boîtes config, contenant des designs nouveaux et passionnants !

-h Imprimer les informations d'utilisation.

-i un magnifique
Mode d'indentation. Les arguments possibles sont « texte » (texte en retrait à l'intérieur de la boîte), « boîte »
(boîte d'indentation, pas de texte à l'intérieur de la boîte), ou "aucun" (jeter l'indentation). Arguments
peut être abrégé. La valeur par défaut consiste à indenter la zone, mais pas le texte.

-k bool
Supprimez les lignes vierges de début/de fin lors de la suppression. La valeur de bool peut être spécifié comme
activé, oui, vrai, 1, ou t, tous signifiant oui, ou désactivé, non, faux, 0 ou f, ce qui signifie non.
Ceci est insensible à la casse. Cette option ne prend effet qu'en relation avec -r. Si
défini sur oui, les lignes vierges de début et de fin seront supprimées de la sortie. Si défini
à non, tout le contenu de l'ancienne boîte est renvoyé. La valeur par défaut est non, si les deux
la partie supérieure et la partie inférieure de la boîte sont ouvertes, comme c'est le cas avec la plupart des régions
commentaires. Si la conception de la boîte définit une partie supérieure ou une partie inférieure, la valeur par défaut est
Oui.

-l (ell) Énumérer les conceptions. Produit une liste de toutes les conceptions de boîtes disponibles dans la configuration
fichier, avec un exemple de boîte et des informations sur son créateur. Vérifie également
syntaxe de l'ensemble du fichier de configuration. S'il est utilisé en relation avec -d, affiche détaillée
informations sur la conception spécifiée.

-m Réparer la boîte. Cela supprime une boîte (potentiellement cassée) comme avec -r, et le redessine
après. La boîte réparée est dessinée selon les options données. Cela peut être
important de savoir quand il s'agit de restaurer le rembourrage, l'identification, etc. pour le
boîte réparée. Implique -k faux

-p un magnifique
Rembourrage. Spécifiez le remplissage dans les espaces autour du bloc de texte d'entrée pour tous les côtés du
boîte. La chaîne d'argument ne peut pas contenir d'espace et doit consister en un
combinaison des caractères suivants, chacun suivi d'un nombre indiquant le
remplissage dans les espaces :
a - (tous) donner un rembourrage pour tous les côtés à la fois
h - (horiz) donne un rembourrage pour les deux côtés horizontaux
v - (vertical) donne un rembourrage pour les deux côtés verticaux
b - (en bas) donne un rembourrage pour le côté inférieur (sud)
l - (gauche) donne un rembourrage pour le côté gauche (ouest)
t - (haut) donne un rembourrage pour le côté supérieur (nord)
r - (à droite) donner un rembourrage pour le côté droit (est)
Mise en situation : -p a4t2 définirait le remplissage comme étant de 4 caractères de tous les côtés, sauf
pour le haut de la boîte, où le bloc de texte d'entrée sera à seulement 2 lignes de
la boîte.
Par défaut, sauf indication contraire dans le fichier de configuration, aucun remplissage n'est utilisé.

-r Retirer la boîte. Supprime une boîte existante au lieu de la dessiner. Quelle conception utiliser est
détecté automatiquement. Afin de gagner du temps ou dans le cas où la détection ne
décider correctement, combiner avec -d pour spécifier la conception. La valeur par défaut est de dessiner un
nouvelle boîte.

-s largeurxla taille
Taille de boîte. Cette option spécifie la taille de la boîte souhaitée en unités de colonnes (pour la largeur)
et des lignes (pour la hauteur). Si un seul nombre est donné en argument, ce nombre
spécifie la largeur de boîte souhaitée. Un nombre unique préfixé par « x » spécifie uniquement le
hauteur de la boîte. La taille réelle de la boîte résultante peut varier en fonction de l'individu
tailles de forme de la conception choisie. En outre, d'autres options de ligne de commande peuvent influencer le
la taille de la boîte (comme -p).
Par défaut, le plus petit cadre possible est créé autour du texte.

-t un magnifique
Gestion des onglets. Cette option contrôle la façon dont les caractères de tabulation dans le texte d'entrée sont traités.
La chaîne d'option doit toujours commencer par un uint nombre indiquant la distance
entre les taquets de tabulation. Il est important que cette valeur soit correctement définie, ou la tabulatrice
caractères perturberont votre texte d'entrée. La valeur de distance de tabulation correcte dépend de
les paramètres utilisés pour le texte que vous traitez. Une valeur commune est 8.
Immédiatement après la distance de tabulation, un caractère facultatif peut être ajouté,
dire boîtes comment traiter les onglets principaux. Les options suivantes sont disponibles :
e - développer les onglets dans les espaces
k - garder un œil aussi proche que possible de ce qu'ils étaient
u - onglets non développés. Cela fait boîtes transformer autant d'espaces que possible en tabulations.

Afin de maintenir la rétrocompatibilité, le -t un magnifique peut être juste un nombre. Dans
ce cas, e est supposé pour la gestion des onglets, ce qui supprime tous les onglets et les remplace
avec des espaces. La valeur d'usine par défaut pour le -t l'option est simplement 8, ce qui est tellement
Cas.
Par exemple, vous pouvez spécifier -t 4u pour que vos onglets principaux ne soient pas développés.
Dans le contenu de la boîte, les tabulations sont toujours converties en espaces. La distance de tabulation dans ce
l'exemple est 4.

-v Imprimer le numéro de version actuel.

CONFIGURATION DES DOSSIERS

Boites utilisera le fichier de configuration spécifié sur la ligne de commande (en utilisant -f). Sinon
le fichier de configuration est spécifié sur la ligne de commande, boîtes vérifiera l'environnement BOXES
variable, qui peut contenir un nom de fichier à utiliser. Si BOXES n'est pas défini, boîtes va essayer de lire
$HOME/.boxes et utilisez-le comme fichier de configuration. A défaut, boîtes va essayer de lire le
fichier de configuration à l'échelle du système (voir FICHIERS).

La syntaxe de boîtes config est décrit sur le site Web (voir ci-dessous). Ils sont assez
explicite, cependant.

DISPONIBILITÉ

Boites est disponible sur son site Internet àhttp://boxes.thomasjensen.com/>. Le site Web
présente également un certain nombre d'exemples illustrant cette page de manuel ainsi que des
Documentation.

Vérifier entrain(1) àhttp://www.vim.org/>!

Utiliser des boîtes en ligne à l'aide des services onworks.net