collect_stx_titles - Online na nuvem

PROGRAMA:

NOME

collect_stx_titles - reúna declarações de títulos de documentos Stx

SINOPSE

reunir_stx_titles [-f de-sufixo ] [-t para-sufixo ] [ m4 opções ] lima [ lima ...]

DESCRIÇÃO

collect_stx_titles extrai declarações de metadados Stx da lista arquivos, e despeja o
título e informações de identificação do documento como definições m4 na saída padrão. Esse
as informações podem ser usadas posteriormente por w_crosslink para vincular os documentos por seus metadados.

Por que isso é útil? Bem, imagine que você tem um grande site com muitos links cruzados.
O nome de um documento aparecerá em vários lugares: no menu de links (se houver) e em
o corpo das diferentes páginas de onde ele tem um link cruzado. collect_stx_titles permite que você coloque
todas as informações em um só lugar e onde elas pertencem, ou seja, o próprio arquivo. Você vai ser
feliz se você fez isso, quando chegar a hora de alterar os títulos dos documentos ou movê-los
por aí; especialmente se o seu site tem magia multilíngue.

OPÇÕES

collect_stx_titles usa m4 internamente e aceitará qualquer opção aceita por m4. Além disso
para aqueles, leva as seguintes opções:

-f de-sufixo
Nos dados do nome do arquivo, substitua o sufixo de-sufixo. Na realidade,
from_suffix pode ser uma expressão regular; estúpido, mas é verdade, no GNU m4 é um
Regexp “tradicional”, enquanto no BSD m4 é uma regexp “estendida”. Padrão para
sem sufixo (nada para tirar).

-t para-sufixo
Nos dados do nome do arquivo, substitua o sufixo retirado por de-sufixo com para-
sufixo. Se de-sufixo é nulo (o padrão), anexar para-sufixo para todos os nomes de arquivos.

-p prefixo
Retire o prefixo fornecido por (expressão regular) prefixo de nomes de arquivos. o
equivalente de -t para isso não existe, porque você pode especificar um diretório
prefixo para w_crosslink por w_base.

--versão, -V
Apenas mostre as informações da versão e saia.

--ajuda, -?
Basta mostrar uma breve mensagem de ajuda e sair.

EXEMPLOS

Acho que na maioria das vezes você desejará automatizar o uso de collect_stx_titles, para
exemplo com um Makefile como este:

FONTES = $ (curinga * .stx)
TARGETS = $ (FONTES: .stx = .html)

todos: $ (TARGETS)

títulos.m4: $ (FONTES)
reunir_stx_titles -f stx -t html $ ^> $ @

% .html:% .stx title.m4
stx2any -T títulos html.m4 $ <> $ @

Se você não quiser ser tão correto, elimine a dependência .html de title.m4 ou
Dependência de Títulos.m4 de FONTES. O uso de arquivos temporários não é necessário: isso também deve
trabalhos:

$ collect_stx_titles * .stx | stx2any - mydoc.stx

Use collect_stx_titles online usando serviços onworks.net