LinuxDoc+Emacs+Ispell-HOWTO: Ваш первый документ

Next Previous Contents

## 3. Ваш первый документ

## 3.1 From a text document

Если вы хотите превратить текстовый документ в SGML для переноса его в другие форматы, то вот как это делается:

1. Добавте следующие строки в самое начало документа:

         <!doctype linuxdoc system>

         <article>

         <title>Title Goes Here</title>

         <author>

           name of author, author's e-mail, etc.

         </author>

         <date>

          version and date

         </date>

2. Если вы кратко описываете содержание документа в самом начале документа, то окружите этот параграф тагами `<abstract>` и `</abstract>`.
3. Затем вставьте таг `<toc>`, который обозначает Содержание.
4. В начале каждой главы замените каждую строку дающую номер и заголовок главы на:

        <sect>Заголовок Главы

   и добавьте таг `</sect>` в конец главы.

   Замечание : Вам не надо помещать номер главы, это сделается автоматически.

5. Сделайте то же самое для разделов. Вам необходимо удалить их номера и отметить их тагами `<sect1>` в начале раздела и тагами `</sect1>` в конце раздела.
6. Вы можете также определить 4 уровня вложенности в разделах, используя `<sectN>` и `</sectN>`, где `N=` 2, 3, или 4 также как и в предыдущем случае.
7. В начале каждого параграфа вставьте таг `<p>`.
8. Если вам необходимо выделить некоторые части, то обозначьте их тагами `<it>` и `</it>` (курсив), `<bf>` и `</bf>` (жирный шрифт), или `<tt>` и `</tt>` (`стиль пишущей машинки`).
9. Для вставки примерно такого списка:

               Это четырехстрочный список:

                - здесь первая строка

                - затем вторая строка

                - и еще одна

                - это все

   вы должны заменить его на:

               Это четырехстрочный список:

              <itemize>

              <item>здесь первая строка

              <item>затем вторая строка

              <item>и еще одна

              <item>это все

              </itemize>

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

               <verb>

                10 REM Oh my God what's this?

                20 REM I thought this had long disappeared!

                30 PRINT "I am back to";

                40 PRINT "save the world."

                50 INPUT "From whom, do you reckon? ",M$

                60 IF M$="Bill" THEN PRINT "Thou art wise.":GOTO PARADISE

                70 ELSE PRINT "You ain't got a clue...":GOTO RICHMOND

                </verb>

11. Таким образом, ваше мастерство форматирования SGML будет довольно приличным. Если вы хотите усовершенствовать ваш документ, вы можете заглянуть в руководство пользователя SGML-Tools, которое дает более детальную информацию о типе документа LinuxDoc.

Next Previous Contents