Это команда gather_stx_titles, которую можно запустить в бесплатном хостинг-провайдере OnWorks, используя одну из наших многочисленных бесплатных онлайн-рабочих станций, таких как Ubuntu Online, Fedora Online, онлайн-эмулятор Windows или онлайн-эмулятор MAC OS.
ПРОГРАММА:
ИМЯ
gather_stx_titles - собирать объявления заголовков из документов Stx
СИНТАКСИС
collect_stx_titles [-f от-суффикс ] [-t к-суффикс ] [ m4 кредита ] файл [ файл ...]
ОПИСАНИЕ
gather_stx_titles выкапывает объявления метаданных Stx из перечисленных файлов, и сбрасывает
информацию о заголовке и идентификаторе документа в виде определений m4 в стандартный вывод. Этот
информация может позже использоваться w_crosslink для связывания документов по их метаданным.
Почему это полезно? Что ж, представьте, что у вас большой сайт с множеством перекрестных ссылок.
Название документа будет отображаться во многих местах: в меню ссылок (если оно у вас есть) и в
тело разных страниц, откуда на него есть перекрестные ссылки. gather_stx_titles позволяет вам поставить
вся информация в одном месте и где она принадлежит, то есть в самом файле. Ты будешь
рад, если вы это сделали, когда придет время изменить заголовки документов или переместить документы
около; особенно если на вашем сайте есть многоязычная магия.
ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ
gather_stx_titles использует m4 внутри и принимает любую опцию, которую принимает m4. Кроме того
тем, требуются следующие варианты:
-f от-суффикс
В данных имени файла замените суффикс от-суффикс. Фактически,
from_suffix может быть регулярным выражением; глупо, но факт, в GNU m4 это
«Традиционное» регулярное выражение, тогда как в BSD m4 это «расширенное» регулярное выражение. По умолчанию
без суффикса (нечего убирать).
-t к-суффикс
В данных имени файла замените удаленный суффикс на от-суффикс to-
суффикс. Если от-суффикс равно нулю (по умолчанию), добавить к-суффикс ко всем именам файлов.
-p префикс
Удалите префикс, заданный как (регулярное выражение) префикс из имен файлов. В
эквивалент -t для этого не существует, потому что вы можете указать каталог
префикс к w_crosslink от w_base.
--версия, -V
Просто покажите информацию о версии и выйдите.
--помощь, -?
Просто покажите короткое справочное сообщение и выйдите.
ПРИМЕРЫ
Я предполагаю, что в большинстве случаев вы захотите автоматизировать использование gather_stx_titles для
пример с Makefile следующим образом:
ИСТОЧНИКИ = $ (подстановочный знак * .stx)
ЦЕЛИ = $ (ИСТОЧНИКИ: .stx = .html)
все: $ (ЦЕЛИ)
title.m4: $ (ИСТОЧНИКИ)
gather_stx_titles -f stx -t html $ ^> $ @
% .html:% .stx title.m4
stx2any -T html title.m4 $ <> $ @
Если вы не хотите быть настолько точным, отбросьте зависимость .html от title.m4 или
title.m4 зависимость от ИСТОЧНИКОВ. Использование временных файлов не обязательно: это также должно
Работа:
$ gather_stx_titles * .stx | stx2any - mydoc.stx
Используйте gather_stx_titles онлайн с помощью сервисов onworks.net
