recueillir_stx_titles - En ligne dans le cloud

PROGRAMME:

Nom

rassemble_stx_titles - rassemble les déclarations de titre à partir de documents Stx

SYNOPSIS

rassembler_stx_titles [ -f de-suffixe ] [ -t au-suffixe ] [ m4 Options ] filet [ filet ...]

DESCRIPTION

rassemble_stx_titles extrait les déclarations de métadonnées Stx de la liste fichiers, et vide le
les informations sur le titre et l'ID du document sous forme de définitions m4 dans la sortie standard. Cette
les informations peuvent ensuite être utilisées par w_crosslink pour lier les documents par leurs métadonnées.

Pourquoi est-ce utile ? Eh bien, imaginez que vous ayez un grand site avec beaucoup de liens croisés.
Le nom d'un document apparaîtra à plusieurs endroits : dans le menu des liens (si vous en avez un), et dans
le corps des différentes pages à partir desquelles il est réticulé. rassemble_stx_titles vous permet de mettre
toutes les informations en un seul endroit et à leur place, c'est-à-dire le fichier lui-même. Vous serez
content si vous l'avez fait, quand vient le temps de changer les titres des documents ou de déplacer les documents
environ; surtout si votre site Web a une magie multilingue.

OPTIONS

rassemble_stx_titles utilise m4 en interne et acceptera toutes les options acceptées par m4. en outre
à ceux-ci, il prend les options suivantes:

-f de-suffixe
Dans les données du nom de fichier, remplacez le suffixe de-suffixe. Réellement,
de_suffixe peut être une expression régulière ; stupide mais vrai, dans GNU m4 c'est un
regexp "traditionnelle", alors que dans BSD m4 c'est une regexp "étendue". Par défaut à
pas de suffixe (rien à retirer).

-t au-suffixe
Dans les données du nom de fichier, remplacez le suffixe supprimé par de-suffixe avec à-
suffixe. Si de-suffixe est nul (valeur par défaut), ajoutez au-suffixe à tous les noms de fichiers.

-p préfixe
Supprimez le préfixe donné par (expression régulière) préfixe à partir des noms de fichiers. Les
l'équivalent de -t pour cela n'existe pas, car vous pouvez spécifier un répertoire
préfixe à w_crosslink par w_base.

--version, -V
Affichez simplement les informations de version et quittez.

--aider, -?
Affichez simplement un court message d'aide et quittez.

EXEMPLES

Je suppose que la plupart du temps, vous voudrez automatiser l'utilisation de rassemble_stx_titles, par
exemple avec un Makefile comme ceci :

SOURCES = $(caractère générique *.stx)
CIBLES = $(SOURCES:.stx=.html)

tout : $(CIBLES)

titres.m4 : $(SOURCES)
rassembler_stx_titles -f stx -t html $^ > $@

%.html : %stx titres.m4
stx2any -T titres html.m4 $< > $@

Si vous ne voulez pas être aussi correct, supprimez la dépendance .html sur titles.m4 ou
titles.m4 dépendance sur SOURCES. L'utilisation de fichiers temporaires n'est pas nécessaire : cela devrait également
travail:

$ rassemble_stx_titles *.stx | stx2any - mondoc.stx

Utilisez rassembler_stx_titles en ligne à l'aide des services onworks.net