Це команда gather_stx_titles, яку можна запустити в постачальнику безкоштовного хостингу OnWorks за допомогою однієї з наших численних безкоштовних робочих станцій, таких як Ubuntu Online, Fedora Online, онлайн-емулятор Windows або онлайн-емулятор MAC OS
ПРОГРАМА:
ІМ'Я
gather_stx_titles - збирає оголошення заголовків з документів Stx
СИНТАКСИС
gather_stx_titles [ -f від-суфікс ] [ -т до-суфікс ] [ m4 опції ] файл [ файл ...]
ОПИС
gather_stx_titles витягує оголошення метаданих Stx зі списку файли, і скидає
Інформацію про назву та ідентифікатор документа як визначення m4 у стандартний вихід. Це
інформація пізніше може бути використана w_crosslink для зв'язування документів за їх метаданими.
Чому це корисно? Ну, уявіть, що у вас великий сайт з великою кількістю перехресних посилань.
Ім’я документа з’явиться в багатьох місцях: у меню посилань (якщо воно у вас є) і в
тіло різних сторінок, з яких воно перехресне. gather_stx_titles дозволяє помістити
вся інформація в одному місці і де вона знаходиться, тобто сам файл. Ви будете
радий, якщо ви це зробили, коли прийде час змінити назви документів або перемістити документи
навколо; особливо якщо ваш веб-сайт має багатомовну магію.
ВАРІАНТИ
gather_stx_titles використовує m4 внутрішньо і приймає будь-який варіант, який приймає m4. В додаток
для них потрібні такі варіанти:
-f від-суфікс
У даних імені файлу замініть суфікс від-суфікс. Власне,
від_суфікса може бути регулярним виразом; дурно, але правда, в GNU m4 це a
«традиційний» регулярний вираз, тоді як у BSD m4 це «розширений» регулярний вираз. За замовчуванням
немає суфікса (нічого забрати).
-t до-суфікс
У даних імені файлу замініть суфікс, вилучений від-суфікс з до-
Суфікс. Якщо від-суфікс дорівнює нулю (за замовчуванням), доп до-суфікс до всіх імен файлів.
-p префікс
Видаліть префікс, заданий (регулярний вираз) префікс з імен файлів. The
еквівалент -t для цього не існує, тому що ви можете вказати каталог
префікс до w_crosslink від w_base.
--версія, -В
Просто покажіть інформацію про версію та вийдіть.
--допомога,-?
Просто покажіть коротке повідомлення довідки та вийдіть.
ПРИКЛАДИ
Я думаю, що більшість часу вам захочеться автоматизувати використання gather_stx_titles, для
приклад з Makefile, як це:
ДЖЕРЕЛА = $(підстановка *.stx)
ЦІЛІ = $(ДЖЕРЕЛА:.stx=.html)
все: $(ЦІЛІ)
titles.m4: $(ДЖЕРЕЛА)
gather_stx_titles -f stx -t html $^ > $@
%.html: %.stx titles.m4
stx2any -T html titles.m4 $< > $@
Якщо ви не хочете бути настільки правильними, відкиньте залежність .html від titles.m4 або
titles.m4 залежність від ДЖЕРЕЛ. Використання тимчасових файлів не є обов'язковим: це також повинно
робота:
$ gather_stx_titles *.stx | stx2any - mydoc.stx
Використовуйте gather_stx_titles онлайн за допомогою служб onworks.net