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

---

---