ctanify - En ligne dans le Cloud

PROGRAMME:

Nom

ctanify - Préparer un package à télécharger sur CTAN

SYNOPSIS

tanifier [--nompkg=string] [--[aucune]auto] [--tdsonly=spécif_fichier ...] [--[aucune]unixifier]
[--[aucune]sauter] [--tdsdir=dis-moi ...] [--Texas=macro_paquet] [--[aucune]miscifier] spécif_fichier[=dis-moi]
...

tanifier [--Aidez-moi]

tanifier [--version]

DESCRIPTION

tanifier est destiné aux développeurs qui ont un package LaTeX qu'ils souhaitent distribuer
via le réseau complet d'archives TeX (CTAN). Étant donné une liste de noms de fichiers, tanifier
crée une archive (un .tar.gz fichier) avec les fichiers présentés dans la structure préférée du CTAN.
L'archive contient en plus un ZIP (.zip) fichier avec des copies de tous les fichiers présentés dans
la structure de répertoire TeX standard (TDS), qui facilite l'inclusion du package dans
la distribution TeX Live.

OPTIONS

tanifier accepte les options de ligne de commande suivantes :

-h, --Aidez-moi
Affichez les informations d'utilisation de base et quittez.

-V, --version
Sortie tanifierle numéro de version de et quittez.

-p string, --nompkg=string
Spécifiez explicitement un nom de package. Normalement, tanifier utilise le nom de base du premier
.ins or .porcherie fichier répertorié comme nom de package. Le nom du package forme le nom de base
de l'archive qui tanifier produit.

--noauto
N'ajoutez pas automatiquement de fichiers à l'archive tar. Normalement, tanifier automatiquement
comprend tous les fichiers mentionnés dans un .ins fichier.

-t spécif_fichier, --tdsonly=spécif_fichier
Spécifiez un sous-ensemble des fichiers nommés sur la ligne de commande à inclure uniquement dans le TDS
ZIP, pas dans le répertoire du package CTAN. Les caractères génériques sont autorisés (cités si
nécessaire), et --tdsonly peut être utilisé plusieurs fois sur la même ligne de commande.

Au moins un nom de fichier doit être spécifié sur la ligne de commande. tanifier place automatiquement
fichiers dans l'arborescence TDS en fonction de leur extension, mais cela peut être remplacé en spécifiant
explicitement un répertoire TDS cible en utilisant le formulaire spécif_fichier=dis-moi. Les caractères génériques sont autorisés
pour le filespec (cité si nécessaire).

COMPLÉMENTAIRES OPTIONS

Il est peu probable que les options suivantes soient nécessaires dans le cadre d'une utilisation ordinaire. ils sont fournis
pour les circonstances particulières qui peuvent survenir.

-d dis-moi, --tdsdir=dis-moi
Au lieu de créer une archive tar pour CTAN, créez simplement l'arborescence TDS du package enracinée dans
annuaire dis-moi.

-T macro_paquet, --Texas=macro_paquet
Affirmez que les fichiers en cours de package pour CTAN ciblent un package de macro TeX autre que
Latex. Quelques exemples courants de macro_paquet sont « générique », « ordinaire » et « contexte ».

-nou, --no-unixifier
Stockez les fichiers texte non modifiés au lieu de convertir leur caractère de fin de ligne en Unix
format (un seul caractère de saut de ligne sans caractère de retour chariot), même si
Le CTAN préfère recevoir tous les fichiers avec des caractères de fin de ligne au format Unix.

-non, --no-saut
Force tanifier pour inclure des fichiers tels que des fichiers cachés Unix, des fichiers de sauvegarde Emacs et
fichiers de métadonnées de contrôle de version, que le CTAN n'aime pas recevoir.

-m, --miscifier
Renommez les répertoires contenant un seul fichier en « misc ». (Par exemple, renommez
"tex/latex/mypackage/mypackage.sty" à "tex/latex/misc/mypackage.sty".) C'était
pratique courante dans le passé, mais est maintenant fortement déconseillée.

DIAGNOSTIC

"Impossible de copier nom de fichier (Non tel filet or annuaire)"
Ce message est généralement causé par un .ins fichier qui génère nom de fichier mais cela a
pas déjà été parcouru Texas or latex produire réellement nom de fichier. tanifier ne
ne s'exécute pas automatiquement Texas or latex; cela doit être fait manuellement par l'utilisateur. Voir
"MISE EN GARDE" pour plus d'informations.

"Modifié nom de fichier à utilisé Unix en ligne terminaisons (utilisation --no-unixifier à empêcher cette)"
Par souci de cohérence, CTAN stocke tous les fichiers texte avec des fins de ligne de style Unix (un seul
caractère de saut de ligne sans caractère de retour chariot). Pour aider dans cet effort,
tanifier remplace automatiquement les fins de ligne non-Unix. Le précédent simplement
message avertit l'utilisateur qu'il ne doit pas être alarmé de voir une taille différente pour
nom de fichier dans l'archive par rapport à l'original nom de fichier sur disque (qui tanifier jamais
modifie). S'il y a une bonne raison de conserver les fins de ligne d'origine (et là
l'est rarement), le --no-unixifier l'option peut être utilisée pour empêcher tanifier de modifier tout
fichiers lors de leur stockage dans l'archive tar.

"À l'exclusion nom de fichier (utilisation --no-saut à forcer inclusion)"
tanifier ignore normalement les fichiers - même lorsqu'ils sont spécifiés explicitement sur la commande
ligne - que le CTAN préfère ne pas recevoir. Il s'agit notamment des fichiers dont les noms commencent par
"." (fichiers cachés Unix), terminer par "~" (sauvegardes automatiques Emacs), ou qui proviennent d'un
CVS or .svn répertoire (fichiers de métadonnées de contrôle de version). S'il y a une bonne raison de
soumettre de tels fichiers au CTAN (et c'est rarement le cas), le --no-saut l'option peut être utilisée pour
empêcher tanifier de les ignorer.

"CTAN préfère n'avoir que de la documentation PDF (re : nom de fichier)"
En raison de la popularité du format PDF, le CTAN souhaite disposer d'autant de documentation
que possible distribué en PDF. Le message précédent demande à l'utilisateur de remplacer tout
Documentation PostScript ou DVI avec PDF si possible. (tanifier comprendra toujours
Documentation PostScript et DVI dans l'archive ; le message précédent n'est qu'un
demande polie.)

"Non compris nom de fichier in le TDS arbre (inconnu extension)"
tanifier place les fichiers dans l'arborescence TDS en fonction d'une table d'extensions de fichiers. Pour
exemple, tout .porcherie les fichiers sont placés dans tex/latex/nom-du-paquet. Si tanifier ne collecte
savoir où mettre un fichier il ne le met nulle part. Voir le dernier paragraphe de
"OPTIONS" pour une explication sur la façon de spécifier explicitement l'emplacement cible d'un fichier dans
l'arborescence TDS. Pour les extensions de fichiers courantes qui sont absentes de tanifier's
tableau, pensez également à notifier tanifierde l'auteur à l'adresse indiquée ci-dessous sous
"AUTEUR".

EXEMPLES

Le Commun Témoignage client
Normalement, il suffit de dire tanifier le nom du .ins fichier (ou .porcherie si le
package n'utilise pas DocStrip) et la documentation prédéfinie, le cas échéant :

$ ctanify monpaquet.ins monpaquet.pdf LISEZMOI

490347 monpaquet.tar.gz

1771 monpaquet/README
15453 monpaquet/monpaquet.dtx
1957 monpaquet/monpaquet.ins
277683 monpaquet/monpaquet.pdf
246935 monpaquet.tds.zip

1771 doc/latex/monpaquet/LISEZMOI
277683 doc/latex/monpaquet/monpaquet.pdf
15453 source/latex/monpaquet/monpaquet.dtx
1957 source/latex/monpaquet/monpaquet.ins
1725 tex/latex/monpaquet/monpaquet.sty

tanifier affiche la taille en octets de l'archive tar résultante, chaque fichier qu'il contient et chaque
fichier dans le fichier ZIP contenu. Dans l'exemple précédent, remarquez comment tanifier
effectué automatiquement toutes les opérations suivantes :

· comprenant monpaquet.dtx (trouvé par l'analyse monpaquet.ins) dans les deux mon colis
répertoire et le fichier ZIP,

· comprenant monpaquet.sty (trouvé par l'analyse monpaquet.ins) dans le fichier ZIP mais, parce que
c'est un fichier généré, pas dans le mon colis répertoire, et

· placer tous les fichiers dans les répertoires TDS appropriés (documentation, source,
package) dans le fichier ZIP.

Considérez ce qu'il faudrait pour produire manuellement un équivalent monpaquet.tar.gz fichier.
tanifier est certainement une alternative plus simple et plus rapide.

Avancé Utilisation
tanifier suppose que les fichiers PostScript sont de la documentation et les stocke donc sous
doc/latex/nom-du-paquet/ dans l'arborescence TDS dans le fichier ZIP. Supposons cependant qu'un
Le package LaTeX utilise un ensemble de fichiers PostScript pour contrôler dvipsla sortie de. Dans ce cas,
tanifier doit être dit d'inclure ces fichiers PostScript dans le répertoire du package, pas le
répertoire de documentation.

$ ctanify monpaquet.ins "monpaquet*.ps=tex/latex/monpaquet"

Utiliser ctanify en ligne à l'aide des services onworks.net