docbook-2-rtf - Інтернет у хмарі

ПРОГРАМА:

ІМ'Я

sgml2x — Легко форматує документи SGML/XML за допомогою таблиць стилів DSSSL

СИНТАКСИС

sgml2x [опції] [sgmfile | xmfile ]

докклас-2-цільовий формат [опції] [sgmfile | xmfile ]

Опис

sgml2x дозволяє легко форматувати документ SGML або XML за допомогою таблиць стилів DSSSL, і
надає такі функції:

· Кілька можливих таблиць стилів на клас документа

· Проста специфікація таблиць стилів за допомогою псевдонімів з підтримкою параметрів
спадкування

· Проста інтеграція нових таблиць стилів шляхом додавання простого нового файлу визначення в a
каталог конфігурації

· Абонент може вказати PATH-подібний список каталогів конфігурації, за замовчуванням
каталоги конфігурації для всієї системи, для кожного користувача та для кожного проекту

· Автоматичний вибір таблиці стилів за замовчуванням, яка буде використовуватися, на основі призначених
пріоритети

· Передати довільні параметри до нефрит(1)

Клас документа, який використовувався для пошуку таблиць стилів, і вихідний формат наразі є
походить лише від імені, з яким викликається програма, тому вам захочеться викликати це
програму через символічні посилання, як docbook-2-pdf.

sgml2x є реалізованим у вигляді оболонки нефрит(1) (або, бажано, опенджад(1),
хоча ми використовуємо загальну назву нефрит всю цю документацію), жадетекс(1) та інші
інструментів.

Якщо немає jadetex.cfg файл біля документа, копіюється стандартний, що вмикає
виготовлення PDF закладок.

Опції

-c|--каталог каталог
Використовуйте вказаний каталог SGML замість системного за замовчуванням.

-C|--confdirs список каталогів
Використовуйте (розділений пробілами) список каталогів конфігурації. Цей варіант є
кумулятивні, тобто можна використовувати кілька -C параметри і списки будуть
зчеплені.

Елементи списку слід упорядковувати з найбільш загальної конфігурації (наприклад, для всієї системи)
до найбільш конкретних (наприклад, для всього проекту).

Якщо через цю опцію надається будь-який каталог, буде список каталогів за замовчуванням
ігнорується.

-D|--dssslproc dsssl-процесор
Скористайтесь dsssl-процесор щоб застосувати таблицю стилів замість стандартної. Це
процесор має підтримувати нефрит-подібні варіанти, наприклад -V.

Якщо цієї опції немає, перший знайдеться в dssslproc файли з confdirs є
взяті. Побачити "Файли" для більш докладної інформації.

-h|--допомога Відобразити довідкове повідомлення та вийти.

-j|--нефрит dsssl-процесор
Застарілий синонім до --dssslproc.

--жадетексфільтр perl-фільтр
Опрацюйте вихідні дані jadetex за допомогою фільтра perl.

Це може бути корисно для примусового розриву сторінок у певних місцях, щоб подолати таблицю стилів
проблеми, або примусово розставляти переноси, коли TeX не має достатньо шаблонів, або робити якісь
інше розумне перетворення, про яке ви могли б подумати.

Див приклади/командні рядки файл для можливого використання.

-n|--ні дії
Друкуйте команди замість їх виконання. Корисно дізнатися про нижчий рівень
інструменти, а також для налагодження командного рядка.

-o|--відкрити
це варіант is застарілий. опенджад тепер за замовчуванням, коли доступний. Використовуйте
--dssslproc або dssslproc конфігураційний файл для примусового використання певного процесора.

Цей параметр використовувався раніше опенджад(1) як процесор DSSSL замість нефрит(1).

-O|-- жадеопти нефритові варіанти
Додаткові параметри для переходу нефрит(1). Цей варіант є сукупним, ви можете
вкажіть кілька з них, надані параметри будуть об’єднані.

-q|--спокійно
Встановити багатослівність на тихий

-r|-- зауваження
Відобразити зміст зауважень до документа в документі (зауваження елементи в
DocBook 4, коментар елементів у DocBook 3), що робить отриманий результат an
тільки для внутрішнього використання документ, друкуючи жирне попередження на обкладинці.

Це спеціальна функція доккласу та таблиці стилів, і не всі таблиці стилів будуть використовуватися
це.

-s|-- стиль стиль
Виберіть стиль виводу, щоб замінити (зрештою, отриманий від документа) стиль за замовчуванням.

На даний момент доступні стилі для певного класу документа та для кожного вихідного формату
залежить від вмісту каталогів конфігурації та може відображатися за допомогою
--допомога варіант.

Зауважте, що доцільно вказати цей параметр у процедурі збірки, щоб ви отримали
відтворювані результати незалежно від наявних таблиць стилів.

-v|-багатослівний
Збільште багатослівність. Цю опцію можна вказати кілька разів.

-- багатослівність N
Встановити багатослівність на N. Рівні багатослівності визначаються таким чином:

тихий Тільки помилки друку

дефолт Тільки помилки друку та попередження

докладний Також роздрукуйте повідомлення

простежувати Також друкуйте важливі команди під час їх виконання (як --ні дії робить).

відлагоджувати Також друкуйте повідомлення про налагодження

-V|-- версія
Роздрукуйте версію програми та вийдіть.

конфігурація

sgml2x використовує дерево каталогів конфігурації замість файлу конфігурації, щоб він був
легко підключати інші пакети з низьким ризиком поломки існуючих налаштувань.

Ієрархії стилів розташовані в каталогах з іменем Стилі у кожній конфігурації
каталог. Старі версії цієї програми використовували для розміщення цих ієрархій безпосередньо в файлі
каталоги конфігурації.

Каталог конфігурації містить один каталог для кожного відомого класу документів, іменований with
псевдонім класу документа (напр книга документів). Ці каталоги docclass містять один під-
каталог для кожного класу вихідного формату (наразі тільки HTML та друк підтримуються).

Наразі проблеми з впровадженням накладають обмеження на псевдоніми для класів документів
та таблиці стилів: вони можуть містити лише буквено-цифрові символи та символи підкреслення. Це
обмеження може бути знято в наступному випуску, але цього не станеться раніше
сценарій переписується іншою мовою.

Кожен із цих каталогів містить один файл для кожного доступного стилю. Назви цих файлів
може містити лише буквено-цифрові символи та використовуються як псевдоніми для стилів. Це
файл містить рядки з a ключ: значення шаблон, на даний момент діють наступні ключі
підтримується:

Id Загальнодоступний ідентифікатор таблиці стилів

Клацніть, щоб подивитися Короткий опис стилів, який відображатиметься в довідковому повідомленні

pdfOverride, psOverride,
rtfOverride, mifOverride" 10 Символ dsssl із таблиці стилів друку, який потрібно встановити
до #t (або а символ=значення пара, підходить як аргумент до нефрит's -V варіант),
використовувати для даного формату друку.

Допускається лише один символ на рядок заміни. Щоб визначити значення для кількох символів, використовуйте
кілька рядків.

Успадковує Псевдонім таблиці стилів, від якого він успадкував, щоб уникнути зайвого
дублювання визначень стилю.

Наразі це викликає лише успадкування *Перевизначити параметри

Пріоритет Додатне ціле число, яке допомагає вибрати стиль за замовчуванням, коли його неможливо
отримані з документа. Більш високі значення мають вищі шанси бути прийнятими як
за замовчуванням. Подбайте про використання низьких пріоритетів для гіперспеціалізованих стилів для a
загальний тип документа, щоб він не використовувався помилково.

Наприклад, поточна рекомендована політика для таблиць стилів DocBook, отриманих з
Норман Уолш виглядає наступним чином (і може змінитися, якщо досвід доведе, що він недостатній).

10 Базові таблиці стилів, які зазвичай потрібно налаштувати.

0 Будь-яка таблиця стилів, написана для гіперспеціалізованої мети (наприклад
лист маркетингової продукції).

1000 Стиль за замовчуванням для всіх документів, створених організацією. Зазвичай а
налаштування світла, показуючи переваги макета, організації
логотип або щось подібне.

10-100 Різні загальні налаштування базових таблиць стилів.

Коли ви пишете покращену версію таблиці стилів з пріоритетом n, Ви
зазвичай хочуть вибрати вищий пріоритет.

Файли

/etc/sgml/sgml2x/

~/.sgml2x/

./sgml2x/ Каталоги конфігурації за замовчуванням, у яких знаходяться файли конфігурації
шукали. Дивіться документацію для --confdirs для більш докладної інформації.

confdir/стиль/
Ієрархія, яка визначає стилі, які можна використовувати. Побачити "Конфігурація" більше
подробиці

confdir/dssslproc
Файл, що містить упорядкований список процесорів dsssl, які потрібно шукати, розділений символами
новий рядок та/або пробіли. Рядки, які починаються на а # характер трактуються як
коментарі. Загальні значення включають опенджад та нефрит.

Процесори DSSSL, вказані тут, повинні приймати -V та -D сумісні з нефритом
параметри командного рядка.

Каталоги конфігурації шукають, починаючи з найбільш конкретних
один, так що за умовчанням налаштування проекту можуть замінити користувача
налаштування, які, у свою чергу, можуть замінити налаштування системи.

Особлива цінність false можна використовувати для зупинки пошуку та запобігання перегляду
більш загальні каталоги. Якщо, наприклад, проект повинен використовувати
openjade-1.4devel команду і жодну іншу, вона може вказати openjade-1.4devel false
в його dssslproc файлу.

Застереження

При використанні openjade-1.4devel як процесор DSSSL, ви побачите скаргу на
рівень потоку-об'єкта, створений doctype.dsl, і автоматичне визначення документа-
тип вийде з ладу. В іншому випадку ця помилка нешкідлива. Ідеї, як з цим боротися, або
підтвердження того openjade-1.4devel занадто суворий, буде вдячний :)

Команда майбутнє

Заплановані функції для майбутніх випусків включають:

· Інтеграція генератора індексів

· Інтеграція механізму красивого друку для прикладів коду

· Специфікація перетворень, які потрібно зв'язати

· Оголошення підмножини доккласів, щоб дозволити використання з будь-яким доккласом стилю-
аркушів, які застосовуються до його наднабірних доккласів.

· Працювати в тимчасовому місці, щоб не забруднювати робочий каталог
тимчасові файли. Це не так просто, як здається, оскільки це порушує документ
посилається на файли зображень із використанням відносних шляхів. Це можна розглядати як нефриту,
однак.

Перегляньте повний список TODO та надішліть нам більше ідей!

Copyright

Авторські права © 2001-2003 Alcove & Yann Dirson.

sgml2x має ліцензію GNU General Public License, версія 2.

Ця документація ліцензована за ліцензією GNU Free Documentation License, версія 1.

Контакти us

sgml2x є частиною AlcoveBook проект (посилання до URL http://www.alcove-
labs.org/en/software/alcovebook/) . Будь ласка, використовуйте AlcoveBook розсилки списки (посилання до URL
https://savannah.gnu.org/mail/?group_id=533) щоб зв’язатися з розробниками та користувачами.

Список помилок і запитів на функції доступний через a Сайт інтерфейс (посилання до URL
https://savannah.gnu.org/support/?group_id=533) . Будь ласка, використовуйте його для подання проблем і
ідеї.

Читати Також

опенджад(1), нефрит(1), жадетекс(1), collateindex.pl(1).

sgml2x(1)

Використовуйте docbook-2-rtf онлайн за допомогою служб onworks.net