gather_stx_titles - Dalam talian di Awan

JADUAL:

NAMA

gather_stx_titles - kumpulkan pengisytiharan tajuk daripada dokumen Stx

SINOPSIS

gather_stx_titles [ -f dari-akhiran ] [ -t kepada-akhiran ] [ m4 pilihan ] fail [ fail ... ]

DESCRIPTION

gather_stx_titles mencungkil pengisytiharan metadata Stx daripada yang disenaraikan fail, dan membuang
tajuk dan maklumat ID dokumen sebagai definisi m4 ke dalam output standard. ini
maklumat kemudiannya boleh digunakan oleh w_crosslink untuk memautkan dokumen dengan metadata mereka.

Mengapa ini berguna? Nah, bayangkan anda mempunyai tapak yang besar dengan banyak pautan silang.
Nama dokumen akan muncul di banyak tempat: dalam menu pautan (jika anda mempunyai satu), dan dalam
badan halaman yang berbeza dari mana ia dipaut silang. gather_stx_titles membolehkan anda meletakkan
semua maklumat di satu tempat dan di mana ia berada, iaitu fail itu sendiri. Awak akan menjadi
gembira jika anda melakukannya, apabila tiba masanya untuk menukar tajuk dokumen atau memindahkan dokumen
sekeliling; terutamanya jika tapak web anda mempunyai keajaiban berbilang bahasa.

PILIHAN

gather_stx_titles menggunakan m4 secara dalaman dan akan menerima sebarang pilihan yang diterima oleh m4. Sebagai tambahan
kepada mereka, ia memerlukan pilihan berikut:

-f dari-akhiran
Dalam data nama fail, gantikan akhiran dari-akhiran. Sebenarnya,
dari_akhiran mungkin ungkapan biasa; bodoh tetapi benar, dalam GNU m4 ia adalah a
regexp "tradisional", manakala dalam BSD m4 ia adalah regexp "dilanjutkan". Lalai kepada
tiada akhiran (tiada apa-apa untuk diambil).

-t kepada-akhiran
Dalam data nama fail, gantikan akhiran yang diambil oleh dari-akhiran bersama to-
akhiran. Jika dari-akhiran adalah nil (lalai), tambah kepada-akhiran kepada semua nama fail.

-p awalan
Tanggalkan awalan yang diberikan oleh (ungkapan biasa) awalan daripada nama fail. The
bersamaan dengan -t untuk ini tidak wujud, kerana anda boleh menentukan direktori
awalan kepada w_crosslink oleh w_base.

--versi, -V
Hanya tunjukkan maklumat versi dan keluar.

--tolong, -?
Hanya tunjukkan mesej bantuan ringkas dan keluar.

CONTOH

Saya rasa kebanyakan masa anda akan mahu mengautomasikan penggunaan gather_stx_titles, untuk
contoh dengan Makefile seperti ini:

SUMBER = $(wildcard *.stx)
SASARAN = $(SUMBER:.stx=.html)

semua: $(SASARAN)

titles.m4: $(SUMBER)
gather_stx_titles -f stx -t html $^ > $@

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

Jika anda tidak mahu menjadi agak betul, lepaskan pergantungan .html pada titles.m4 atau
titles.m4 pergantungan pada SOURCES. Menggunakan fail sementara tidak perlu: ini juga sepatutnya
kerja:

$ gather_stx_titles *.stx | stx2any - mydoc.stx

Gunakan gather_stx_titles dalam talian menggunakan perkhidmatan onworks.net