sdf - Интернет в облаке

ПРОГРАММА:

ИМЯ

sdf - Утилита преобразования SDF

ЦЕЛЬ

SDF преобразует SDF файлы в другие форматы документов.

ИСПОЛЬЗОВАНИЕ

использование: sdf [+ псевдоним] [-h [помощь]] [-o [out_ext]]
[-l [log_ext]] [-O [out_dir]] [формат -2]
[-D переменная, ..] [-n split_level]
[-f флаг, ..] [-I include_path, ..]
[-p [предварительный фильтр]] [-a параметры] [-P [план]]
[-N [номера_строк]] [-g [get_report]]
[-r отчет] [-L локаль] [-k смотреть]
[-s стиль] [-S размер_страницы] [-c конфигурация]
[-u использует, ..] [-H head_level] [-K head_look]
[-d драйвер] [-y post_filter]
[-z пост_процесс, ..] [-t цель]
[-v [подробный]] [-T уровни_трассировки, ..]
[-w width] [-Y путь_библиотеки, ..]
sdf_файл ...
цель: преобразовать файл sdf в другой формат
версия: 2.001 (SDF 2.001)

Возможные варианты:

Вариант Описание
-h отобразить справку по параметрам
-o расширение выходного файла
-l расширение файла журнала
-O вывод в каталог входного файла (или явный)
-2 желаемый формат вывода
-D определить переменные
-n уровень заголовка для автоматического разделения на темы
-f определить флаги (т.е. переменные DOC_ *)
-I ищу путь для включаемых файлов, шаблонов и т. Д.
-p входной файл предварительной фильтрации по каждому аргументу
-a параметры для предварительного фильтра
-P предварительный фильтр как язык программирования
-N числовых строк в красиво напечатанном исходном коде
-g предварительная фильтрация с использованием sdfget с указанным отчетом
-r отчет для запуска в SDF, чтобы преобразовать его перед форматированием
-L локаль
-k смотреть библиотеку
-s стиль документа
-S размер страницы для бумажных документов
-c конфигурационная библиотека
-u модули для использования
-H начальный уровень заголовка
-K вид заголовка (H, A или P)
-d драйвер формата - по умолчанию раскрывается
-y фильтр для пост-фильтрации вывода с помощью
-z список действий постобработки, которые нужно сделать
-t логический целевой формат
-v подробный режим
-T уровни трассировки отладки
-w ширина для текстовых выводов
-Y путь поиска библиотек

Псевдонимы:

Псевдоним Описание
mc создать главу MIMS
мс генерирует спецификацию MIMS
mt создать тему MIMS
sdf2doc_fm генерирует двоичный формат кадра через FrameMaker
sdf2dvi_sgml генерирует формат DVI через SGML
sdf2fvo_fm генерирует формат FrameViewer через FrameMaker
sdf2hlp_mif генерирует входные файлы справки Windows через MIF
sdf2html_ создать HTML-документ
sdf2html_dir создать каталог SDF в HTML
sdf2html_fm сгенерировать HTML-документ через FrameMaker
sdf2html_topicsсоздать темы HTML
sdf2htx_ генерировать формат MIMS HTX
sdf2info_sgml генерировать информационный формат GNU через SGML
sdf2latex_ генерировать LaTeX
sdf2latex_pod создать формат LaTeX через POD
sdf2latex_sgml создать формат LaTeX через SGML
sdf2lyx_sgml сгенерировать файл LyX через SGML
sdf2man_pod генерирует формат страницы Man через POD
sdf2mf6_ генерировать формат справки MIMS F6
sdf2mif_ генерировать формат кадра MIF
sdf2pdf_html генерировать PDF через HTML
sdf2pdf_mif генерировать PostScript и PDF через FrameMaker
sdf2pod_ генерировать формат POD
sdf2ps_fm генерирует PostScript через FrameMaker
sdf2ps_fmbook: создание PostScript с помощью книги FrameMaker.
sdf2ps_html генерировать PostScript через HTML
sdf2ps_pod генерирует PostScript через POD
sdf2ps_sgml генерировать PostScript через SGML
sdf2rtf_fm генерирует формат RTF через FrameMaker
sdf2rtf_mif генерировать формат RTF через MIF
sdf2rtf_sgml генерирует формат RTF через формат SGML
sdf2sdf_expand создать расширенный SDF
sdf2sdf_raw генерирует необработанный SDF
sdf2sgml_ генерировать формат SGML
sdf2txt_ генерировать простой текстовый формат
sdf2txt_fm генерирует простой текстовый формат через FrameMaker
sdf2txt_pod генерирует простой текстовый формат через POD

ОПИСАНИЕ

Параметр -h предоставляет справку. Если он указан без параметра, краткое описание
каждого параметра отображается. Чтобы отобразить атрибуты для параметра, укажите параметр
буква как параметр.

По умолчанию сгенерированный вывод переходит в стандартный вывод. Чтобы направить вывод в файл для каждого ввода
file используйте параметр -o, чтобы указать расширение для выходных файлов. Если опция -o -
указано без параметра, расширение внешний предполагается.

Точно так же сообщения об ошибках по умолчанию переходят в стандартную ошибку. Используйте параметр -l, чтобы создать
файл журнала для каждого входного файла. Если опция -l указана без параметра, расширение
of журнал предполагается.

По умолчанию сгенерированные файлы вывода и журнала создаются в текущем каталоге. Использовать
-O параметр, чтобы указать явный выходной каталог. Если опция -O указана без
параметр, используется каталог входного файла.

Параметр -2 - удобный способ указать псевдоним (набор параметров), который
генерирует желаемый результат. например

sdf -2html азбука

эквивалентно:

sdf + sdf2html abc

Параметр -D используется для определения переменных. Обычно они используются для управления
условный текст и заменяющий текст, который изменяется. Используемый формат:

-Dvariable1 = значение1, variable2 = value2

Флаг - это сокращенный способ указания переменных в семействе DOC. т.е. -ftoc = 3 является
эквивалент -DDOC_TOC = 3. Формат опции -f:

-fflag1 = значение1, флаг2 = значение2

Если переменная или флаг указаны без значения, предполагается 1.

Чтобы генерировать HTML темы, команда:

sdf -2 темы abc

По умолчанию это создает подтемы для каждого заголовка уже в отдельном файле. Это
будет также автосплит заголовки уровня 1 на подтемы. Параметр -n может использоваться для управления
на какие уровни разделены заголовки:

· 1 авторазбиение на заголовки уровня 1 (по умолчанию)

· 2 авторазбиения на заголовки 2 уровня

· 3 авторазбиения на заголовки 3 уровня

· 0 отключает автоматическое разделение.

Включаемые файлы ищутся в текущем каталоге, затем в каталогах, заданных
параметр -I, затем в каталоге библиотеки по умолчанию.

По умолчанию SDF настроен на предварительный фильтр файлы с определенными расширениями. Например:

SDF mytable.tbl

эквивалентно выполнению SDF в файле, который содержит только:

! include "mytable.pl"; стол

Параметр -p может использоваться для явной предварительной фильтрации файлов или для отмены значения по умолчанию.
используется предварительный фильтр. Если параметр не указан, предполагается, что предварительный фильтр (см. таблицу ниже).

Опцию -a можно использовать для указания параметров для предварительного фильтра. Например:

sdf -aformat = '15,75,10, XNUMX 'mytable.tbl

Параметр -P выполняет предварительную фильтрацию входных файлов как языков программирования. Параметр - это
язык для использования. Если ничего не указано, предполагается, что расширение является названием языка.
Например:

sdf -P myapp.c

эквивалентно выполнению SDF в файле, который содержит только:

! include "myapp.c"; пример; широкий; lang = 'c'

Параметр -N добавляет номера строк с заданной частотой. Частота по умолчанию - 1. т.е.
каждую строчку.

Параметр -g выполняет предварительную фильтрацию входных файлов путем выполнения sdfget используя отчет по умолчанию
(default.sdg). Чтобы изменить используемый отчет, укажите имя отчета в качестве параметра. Если
имя отчета не включает расширение, предполагается sdg.

Примечание: sdfget ищет отчеты в текущем каталоге, затем в стандартная библиотека каталог
в каталоге библиотеки SDF.

Параметр -r запускает назначенный отчет SDR для каждого ввода перед форматированием. В других
Словом, отчеты SDR обеспечивают механизм для:

· Анализ SDF непосредственно перед его форматированием, и

· Заменяя этот SDF выводом отчета (также SDF), чтобы окончательный вывод
отчет в красивом формате.

Так, например, sdf_dir отчет формирует каталог (дерево) компонентов (файлов)
включены в документ SDF. Отчеты хранятся в СПЗ файлы и ищутся с помощью
обычные правила.

Параметр -L можно использовать для указания местный. Имя локали по умолчанию указано в
sdf.ini. Именование языкового стандарта соответствует соглашениям POSIX (например, language_country), поэтому языковой стандарт
название для американского английского ru_us. Информация для каждой локали хранится в
местный каталог, поэтому вам нужно будет заглянуть туда, чтобы узнать, какие локали
доступный. (Поскольку локаль по умолчанию может быть установлена ​​в sdf.ini, это не так уродливо, как раньше
звуки.)

Примечание: На данный момент файл локали просто содержит список строк для конкретного языка.
В конечном итоге его следует расширить для поддержки локализации форматов даты и времени.

Параметр -k используется для указания смотреть. Библиотека внешнего вида по умолчанию указана в sdf.ini.

Параметр -s может использоваться для указания документа. стиль. Типичные значения:

· документ - технический документ

· меморандум - памятка

· факсу - факсимиле

· минут - протокол встречи.

Параметр -S используется для указания размера страницы. Поддерживаемые значения включают:

Имя Ширина Высота Комментарий
global 21.0cm 11.0in подойдет как для A4, так и для Letter
A3 29.7 см 42.0 см
A4 21.0 см 29.7 см
A5 14.8 см 21.0 см
B4 25.7 см 36.4 см
B5 17.6 см 25.0 см
письмо 8.5 дюйма 11.0 дюйма
Legal 8.5 дюйма 14.0 дюйма
таблоид 11.0 дюйма 17.0 дюйма

Дополнительные размеры страниц можно настроить в sdf.ini. Чтобы указать повернутую версию
названный размер страницы, добавьте R. Например, A4R подразумевает ширину 29.7 см и высоту
21см. Пользовательский размер страницы также можно указать с помощью формата:

{{width}}x{{height}}

в котором ширина и высота - соответствующие размеры в пунктах.

Параметр -c используется для указания библиотеки конфигурации.

Список используемых модулей можно указать с помощью опции -u.

Начальный уровень заголовка можно указать с помощью опции -H. Это полезно
если вы хотите предварительно просмотреть, как будет отображаться тема, без восстановления всего
документ. Если тема начинается с заголовка уровня 1 (например, H1) и вы хотите отформатировать ее как
документ (т.е. текст уровня 1 становится DOC_NAME для build_title) используйте параметр -H
со значением 0.

Также можно настроить внешний вид заголовков. По умолчанию заголовки в стиле H нумеруются,
Заголовки в стиле A пишутся буквами, а заголовки в стиле P - просто. Чтобы заставить определенный стиль
для всех заголовков можно использовать параметр -K. Разумные значения параметров: H, A и P.
хотя другие значения могут работать в зависимости от того, какие стили абзацев настроены в вашем
сайт.

Параметр -d используется для указания драйвера формата. Поддерживаемые значения включают:

· расширять - форматировать как развернутый текст (по умолчанию)

· МИФ - Формат обмена Maker

· стручок - Обычная старая документация (используемая Perl).

Дополнительные драйверы можно настроить в sdf.ini.

Параметр -y можно использовать для указания пост-фильтра.

Параметр -z можно использовать для указания списка действий постобработки, которые вы хотите выполнить.
для каждого выходного файла после его создания. Поддерживаемые действия включают:

· ps - генерировать PostScript

· док - сгенерировать фрейм (бинарный) файл

· фво - создать файл только для просмотра кадра

· текст - создать текстовый файл

· RTF - создать файл RTF

· чистым - удалить выходной файл (должен быть последним).

Дополнительные действия можно настроить в sdf.ini. По соглашению сгенерированные файлы
с теми же именами, что и ключевые слова действия.

Параметр -t используется для указания формата логической цели. Если ничего не указано,
default - это первое действие постобработки, если таковое имеется. В противном случае по умолчанию используется формат
имя драйвера.

Параметр -v включает подробный режим. Это полезно для отладки проблем, связанных с публикацией
обработка. В частности, действия постобработки, содержащие шаблон чистым
пропущено в подробном режиме. Вы также можете отключить сообщения пост-обработки, используя
подробное значение -1. Значения выше 1 включают дополнительные сообщения трассировки следующим образом:

· 2 - показать, как разрешаются имена файлов и библиотек

3 - показать каталоги, в которых ищутся библиотеки

4 - показать каталоги, в которых ищутся модули

5 - показать каталоги, в которых ищутся нормальные файлы.

Параметр -T можно использовать для включения трассировки отладки. Параметр разделяется запятыми.
список пар имя-значение, где каждое имя является трассировка группы и каждое значение - это уровень
отслеживание этой группы. Чтобы получить вывод трассировки, предоставленный опцией -v, можно использовать
пользователь группа как это:

sdf -Tuser = 2 ...

Это немного отличается от опции -v тем, что промежуточные файлы не
неявно сохраняется. Со временем будут добавляться дополнительные группы трассировки (возможно, по одной на
драйвер вывода).

Параметр -w используется для указания ширины текстовых выходных данных.

Параметры -z, -D, -f и -I являются параметрами списка. т.е. несколько значений могут быть разделены
запятые и / или параметры могут указываться несколько раз.

ПРИМЕРЫ

Конвертировать mydoc.sdf в технический документ в формате MIF вывод mydoc.mif:

sdf -2mif mydoc.sdf

Конвертировать mydoc.sdf к онлайн-документации в Средство просмотра кадров формат, вывод mydoc.fvo:

sdf -2fvo mydoc.sdf

Конвертировать mydoc.sdf в онлайн-документацию в HTML, вывод mydoc.html:

sdf -2html mydoc.sdf

Следующая команда создаст справочную документацию для модуля SDF в HTML:

sdf-2html abc.sdm

ОГРАНИЧЕНИЯ И БУДУЩЕЕ НАПРАВЛЕНИЯ

Многие действия постобработки по умолчанию (-z) работают только с Юникс as FrameMaker для
Windows не поддерживает пакетное преобразование.

Режим тем имеет несколько ограничений:

· Конвертировать можно только документы в текущем каталоге

· Все подтемы также должны быть в текущем каталоге.

Используйте sdf онлайн с помощью сервисов onworks.net