verzamel_stx_titles - Online in de cloud

PROGRAMMA:

NAAM

verzamel_stx_titles - verzamel titelverklaringen uit Stx-documenten

KORTE INHOUD

verzamel_stx_titles [ -f van-achtervoegsel ] [ -T naar-achtervoegsel ] [ m4 opties ] filet [ filet ...]

PRODUCTBESCHRIJVING

collect_stx_titles haalt Stx-metadatadeclaraties uit de lijst bestanden, en dumpt de
titel- en document-ID-informatie als m4-definities in standaarduitvoer. Dit
informatie kan later door w_crosslink worden gebruikt om de documenten aan elkaar te koppelen via hun metadata.

Waarom is dit nuttig? Stel je voor dat je een grote site hebt met veel crosslinks.
De naam van een document verschijnt op veel plaatsen: in het linkmenu (als je dat hebt) en in
de hoofdtekst van verschillende pagina's waar de link vandaan komt. collect_stx_titles laat je plaatsen
alle informatie op één plek en waar deze thuishoort: het bestand zelf. Je zal zijn
Ik ben blij als je dat gedaan hebt, als het tijd is om de documenttitels te wijzigen of de documenten te verplaatsen
rondom; vooral als uw website meertalige magie heeft.

OPTIES

collect_stx_titles gebruikt m4 intern en accepteert elke optie die m4 accepteert. In aanvulling
daarvoor zijn de volgende opties nodig:

-f van-achtervoegsel
Vervang in de bestandsnaamgegevens het achtervoegsel van-achtervoegsel. Werkelijk,
van_achtervoegsel kan een reguliere expressie zijn; stom maar waar, in GNU m4 is het een
“traditionele” regexp, terwijl het in BSD m4 een “uitgebreide” regexp is. Standaard naar
geen achtervoegsel (niets om weg te nemen).

-t naar-achtervoegsel
Vervang in de bestandsnaamgegevens het achtervoegsel dat is weggenomen door van-achtervoegsel Met naar-
achtervoegsel. Indien van-achtervoegsel is nul (de standaardwaarde), toevoegen naar-achtervoegsel voor alle bestandsnamen.

-p voorvoegsel
Verwijder het voorvoegsel gegeven door (reguliere expressie) voorvoegsel uit bestandsnamen. De
Het equivalent van -t hiervoor bestaat niet, omdat u een map kunt opgeven
voorvoegsel voor w_crosslink door w_base.

--versie, -V
Toon gewoon versie-informatie en sluit af.

--helpen, -?
Toon gewoon een kort helpbericht en sluit af.

Voorbeelden

Ik denk dat je meestal het gebruik van collect_stx_titles wilt automatiseren, voor
voorbeeld met een Makefile zoals deze:

BRONNEN = $(wildcard *.stx)
DOELEN = $(BRONNEN:.stx=.html)

alles: $(DOELSTELLINGEN)

titels.m4: $(BRONNEN)
verzamel_stx_titles -f stx -t html $^ > $@

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

Als je het niet helemaal juist wilt hebben, laat dan de .html-afhankelijkheid van titles.m4 of
titles.m4 afhankelijkheid van BRONNEN. Het gebruik van tijdelijke bestanden is niet nodig: dat zou ook moeten
werk:

$ verzamel_stx_titles *.stx | stx2any - mijndoc.stx

Gebruik collect_stx_titles online met behulp van onworks.net-services