gather_stx_titles - Online sa Cloud

PROGRAMA:

NAME

gather_stx_titles - mangalap ng mga deklarasyon ng pamagat mula sa mga dokumento ng Stx

SINOPSIS

gather_stx_titles [ -f mula sa-panlapi ] [ -t to-suffix ] [ m4 pagpipilian ] file [ file ... ]

DESCRIPTION

Ang gather_stx_titles ay naghuhukay ng mga deklarasyon ng Stx metadata mula sa nakalista file, at itinatambak ang
pamagat at impormasyon ng ID ng dokumento bilang mga kahulugan ng m4 sa karaniwang output. Ito
ang impormasyon ay magagamit sa ibang pagkakataon ng w_crosslink upang i-link ang mga dokumento sa pamamagitan ng kanilang metadata.

Bakit ito kapaki-pakinabang? Well, isipin na mayroon kang isang malaking site na may maraming cross-linking.
Lalabas ang pangalan ng isang dokumento sa maraming lugar: sa menu ng link (kung mayroon ka), at sa
ang katawan ng iba't ibang pahina kung saan ito pinag-cross-link. Hinahayaan ka ng gather_stx_titles na ilagay
lahat ng impormasyon sa isang lugar at kung saan ito nabibilang, ibig sabihin, ang file mismo. Ikaw ay magiging
natutuwa kung ginawa mo, pagdating ng oras upang baguhin ang mga pamagat ng dokumento o ilipat ang mga dokumento
sa paligid; lalo na kung ang iyong website ay may multilingual na magic.

Opsyon

Ang gather_stx_titles ay gumagamit ng m4 sa loob at tatanggap ng anumang opsyon na tinatanggap ng m4. At saka
sa mga iyon, kinakailangan ang mga sumusunod na opsyon:

-f mula sa-panlapi
Sa data ng filename, palitan ang suffix mula sa-panlapi. Talaga,
from_suffix maaaring isang regular na pagpapahayag; hangal ngunit totoo, sa GNU m4 ito ay a
"tradisyonal" na regexp, samantalang sa BSD m4 ito ay isang "pinalawak" na regexp. Default sa
walang panlapi (nothing to take away).

-t to-suffix
Sa data ng filename, palitan ang suffix na inalis ni mula sa-panlapi sa to-
suffix. Kung mula sa-panlapi ay nil (ang default), idagdag to-suffix sa lahat ng filename.

-p unlapi
Tanggalin ang prefix na ibinigay ng (regular na expression) unlapi mula sa mga filename. Ang
katumbas ng -t para dito ay hindi umiiral, dahil maaari mong tukuyin ang isang direktoryo
prefix sa w_crosslink ng w_base.

--bersyon, -V
Ipakita lamang ang impormasyon ng bersyon at lumabas.

--tulong, -?
Magpakita lamang ng maikling mensahe ng tulong at lumabas.

HALIMBAWA

Sa palagay ko karamihan ng oras ay gusto mong i-automate ang paggamit ng gather_stx_titles, para sa
halimbawa na may Makefile tulad nito:

SOURCES = $(wildcard *.stx)
TARGETS = $(SOURCES:.stx=.html)

lahat: $(TARGETS)

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

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

Kung hindi mo gustong maging masyadong tama, i-drop ang .html dependency sa titles.m4 o
titles.m4 dependency sa SOURCES. Ang paggamit ng mga pansamantalang file ay hindi kinakailangan: ito ay dapat din
trabaho:

$ gather_stx_titles *.stx | stx2any - mydoc.stx

Gumamit ng gather_stx_titles online gamit ang mga serbisyo ng onworks.net