History for UseSTX

changed:
-
<h1>Что такое структурированный текст?</h1>
<p>Структурированный текст (STX) - это быстрый способ разметки веб
страниц, причем результат практически не отличается от полноценной
XHTML разметки. Для составления структурированных текстов не требуется
никаких специальных средств (текстовых или HTML редакторов). Формат
структурированного текста предполагает, что Вы будет использовать его
непосредственно в диалоговых формах, отображающихся непосредственно в
браузере. </p>
<h2>STX - Это не экзотика</h2>
<p>Правила структурированный текст соответствуют стандартам обработки
текстов (Standard Generalized Markup Language, SGML, ISO 8879:1986(E),
но сильно упрощенны. Это прикладной уровень применения правил SGML. По
своему построению документ, составленный по правилам структурированного
текста и является полноценным SGML документом. </p>
<h2>Задачи STX</h2>
<p>При разработке правил структурированного текста ставились следующие задачи:</p>
<ul>
<li>структурированный текст должен быть пригоден для непосредственного использования в Интернет;</li>
<li>структурированный текст должен иметь широкий круг применения;</li>
<li>структурированный текст должен быть совместим с SGML;</li>
<li>правила разметки текста должны быть просты в написании;</li>
<li>количество факультативных свойств структурированного текста должно
быть сведено к абсолютному минимуму, в идеале число их вообще не должно
быть;</li>
<li>документы, размеченные правилами структурированного текста, должны
быть удобны для чтения и достаточно понятны без применения каких-либо
специальных программ (любой браузер или простейший текстовый редактор);</li>
<li>подготовка и разметка текста должна осуществляться быстро;</li>
<li>процедура построения структурированного текста должна быть формальной и точной;</li>
<li>процедура создания текста должна быть проста;</li>
<li>разметка должна быть краткой и не должна загромождать само содержание текста.</li></ul>
<h2>Терминология и объектная модель STX документа</h2>
<p>Разметка -- это описание схемы размещения текста и его логической структуры.</p>
<p>Для разметки текста используются следующие символы разметки:</p>
<ul>
<li>пустая строка (клавиша Enter);</li>
<li>отступ (клавиша Tab или 4 пробела);</li>
<li>некоторые специальные значки типа *звездочки, "кавычки, _подчеркивание, : двоеточие.</li>
<p>Документ -- это то, что Вы собираетесь опубликовать в целом. Документ имеет заголовок (титул) и содержательную часть.</p>
<p>Заголовок -- это наименование части, абзац в одну строку. Заголовок
ставится на уровне абзаца содержательного текста предыдущего (верхнего)
уровня.</p>
<p>Содержательная часть -- это обычная последовательность симоволов
(буквы, цифры и знаки препинания). Содержательную часть Вы делите на
некоторые смысловые части (разделы, главы, статьи и т.п.). Каждая часть
может иметь свой заголовок и содеражательную часть. Число вложений не
ограничено, но желательно не делать более 5-6 уровней, т.к. текст
становится очень сложен по структуре и читателю сложно следить за
иерархией содержательных частей. Содержательная часть состоит из
следующих конструкций:</p>
<ul>
<li>абзац текста</li>
<li>интерпретированный текст</li>
<li>ненумерованный список</li>
<li>нумерованный список</li>
<li>описательный список</li>
<li>гиперссылка</li>
<li>закладка</li>
<li>сноска.</li></ul>
<p>Интерпретированный текст -- это текст, который должен выглядеть так,
как его написал автор, т.е. без изменений в словах или расположении
строк. Например, может использоваться при цитировании.</p>
<p>Описательный список -- это некоторое описание. Обычно используется в
глоссариях и словарях. По форме это термин и его определение или
описание.</p>
<p>Гиперссылка -- это ссылка на другой документ.</p>
<p>Закладка -- это ссылка на часть текста, находящегося в этом же документе.</p>
<p>Сноска -- это ссылка на примечание, как правило расположенное в конце документа.</p>
<p>Строка -- единица структурированного текста. Различаются пустые и не пустые строки.</p>
<p>Пустая строка -- служит для разделения частей документа (заголовков
от содержательной части, абзацев друг от друга и т.п.). Образуется при
переводе строки (клавиша Enter).</p>
<p>Не пустая строка -- это любая последовательность слов или символов.</p>
<p>Абзац -- это группа строк не разделенных пустой строкой.</p>
<p>Слово -- это любая последовательность символов (букв, цифр, знаков
препинания). Выделение элемента "слово" необходимо только при разметке
слова (курсив, жирный, подчеркнутый).</p>
<p>Символ -- это элементарная единица текста, описанная в "ISO/IEC
10646":http://www.online.ru/it/helpdesk/xml01.htm (см. также "ISO/IEC
10646-2000":http://www.online.ru/it/helpdesk/xml01.htm). Допустимы
символы табуляции, возврата каретки, конца строки, а также разрешенные
символы из наборов Unicode и ISO/IEC 10646.</p>
<p>Отступ -- это одно нажатие на клавишу <TAB>или 4 пробела подряд.</TAB></p>
<h2>Логическая структура STX текста</h2>
<p>Рассмотрим логическую структуру STX текста. Предполагается, что
текст имеет заголовок и содержание. Содержание, в свою очередь может
состоять из неограниченного числа заголовков и содержаний (разделов,
глав и т.д.). </p>
<p>Логическая структура STX текста выделяется отступами. Это означает,
что на одном уровне по отступам находятся элементы (заголовки и
содержание) одного и того же логического уровня текста. </p>
<p>Например, заголовок первого уровня находится прямо у левой границы
страницы безо всяких отступов. Содержание первого уровня будет
находиться на уровне одного отступа относительно заголовка. Заголовок
второго уровня будет находиться на уровне одного отступа от края
документа, т.е. на уровне содержания первого уровня. А вот содержание
второго уровня будет находиться на расстоянии двух отступов от края или
одного отступа от уровня заголовока. Такая ступенчатая структура
определяет логику текста. </p>
<h2>Правила разметки текста</h2>
<p>Для выделения логических элементов и объектов текста применяются следующие правила разметки.</p>
<h3>Заголовок</h3>
<p>Заголовок - это одна строка символов, сверху и снизу отделенная
пустой строкой. Уровень заголовка определяется отступом. Первый уровень
без отступа, второй уровень один отступ слева и т.д.</p>
<h3>Абзац текста</h3>
<p>Абзац текста отделяется от других частей (содержания и заголовков)
пустой строкой. Уровень абзаца определяется отступом от левого края
страницы. Абзац текста всегда сдвинут вправо на один отступ
относительно своего заголовка. Например, если заголовок без отступа,
значит содержание имеет один отступ или если заголовок имеет пять
отступов, то абзац - шесть. </p>
<p>Если необходимо вставить больше одной пустой строки, то лучше это
сделать следующим образом. Добавить специальный абзац, в котором будет
написано только '&nbsp;'. Не забудьте, что специальный абзац должен
быть разделена пустыми строками. Таким способом можно раздвинуть
текстовые абзацы на любое расстояние. </p>
<h3>Выделение слов</h3>
<p>Для того, чтобы выделить слово <i>курсивом</i> необходимо без
пробелов вначале и конце слова поставить звездочки*. Точно также можно
выделить группу слов, поставив звездочки* вначале и конце группы слов. </p>
<p>Для того, чтобы выделить слово <b>жирным шрифтом</b> необходимо заключить это слово в двойные звездочки **. Для группы слов - вначале и конце группы поставить звойные звездочки. </p>
<p>Для того, чтобы подчеркнуть слово достаточно в начале и конце слова
поставить знак подчеркивания_. Для группы слов - аналогично. </p>
<h3>Списки - нумерованные, не нумерованные, описательные</h3>
<p>Список размечается следующим образом:</p>
<ul>
<li>В конце описательной строки списка ставится знак двоеточия.</li>
<li>затем вставляется пустая строка</li>
<li>вставляется отступ и первая строка списка</li>
<li>вставляется пустая строка, разделяющая строки списка</li>
<li>вставляются вторая строка и т.д.</li></ul>
<p>После последней строки нумерованного списка не забудьте вставить пустую строку. </p>
<p>Для нумерации можно использовать цифру или букву с точкой (например 1. или A.), цифру со скобкой (например, 1) или a) ). </p>
<p>Для не нумерованных списков можно использовать любой из следующих символов - + = *. </p>
<p>Для того, чтобы отличить строку нумерованного списка от абзаца,
начинающегося с цифры, поступают следующим образом. Номер абзаца должен
выглядеть следующим образом .1. (точка - цифра - точка). </p>
<p>Для того, чтобы отличить не нумерованный список от прямой речи,
абзац с прямой речью можно размечать одним из следующих способов: </p>
<ul>
<li>поставить два символа тире подряд</li>
<li>использовать знак ~тильда</li>
<li>использовать любой из кодов '-' '–' '—' '−'</li></ul>
<p>В описательном списке между термином и определением нужно просто
вставить два символа тире. Например, Термин -- определение или описание.</p>
<h3>Интерпретированный текст</h3>
<p>Интерпретированный текст - это текст, в авторской форме. Например, стихи. </p>
<p>Если текст вмещается в одну строку (например, это несколько слов),
то для этого выделяемый текст заключается в одинарные 'кавычки. </p>
<p>В случаях, когда необходимо выделить достаточно большой кусок текста
(например, стихи, песни, примеры программного кода, формулы), поступают
следующим образом: </p>
<ul>
<li>после описания (как в списке) без пробела от последнего слова ставится подряд два символа двоеточия </li>
<li>вставляется пустая строка</li>
<li>вставляется отступ от уровня текущего абзаца</li>
<li>интерпретированный текст пишется без пустых строк</li>
<li>первая же вставленная пустая строка означает окончание абзаца с интерпретированным текстом.</li></ul>
<h3>Гиперссылки</h3>
<p>Для того, чтобы связать документы между собой используются
гиперссылки. Гиперссылка позволяет перейти от текущего
(просматриваемого) документа к любому другому документу. </p>
<p>Чтобы разметить гиперссылку: </p>
<ul>
<li>текст, который будет являться ссылкой, заключают в двойные кавычки"</li>
<li>без пробела ставится :двоеточие</li>
<li>за двоеточием без пробела пишется адрес (URL) ссылки.</li></ul>
<p>Обратите внимание, что точку в конце предложения нужно ставить внутрь кавычек, а не после ссылки. </p>
<p>Для создание ссылки на электронный адрес используется другая конструкция, </p>
<ul>
<li>текст ссылки также заключается в двойные кавычки"</li>
<li>затем без пробела ставится запятая</li>
<li>затем пробел и адрес почтовой ссылки.</li></ul>
<p>Например:</p>
<p>"Администратор портала", mailto:webmaster@yourname.ru</p>
<p>Адрес ссылки может быть абсолютным (полным) или локальным.
Абсолютный адрес должен начинаться с http:// Например,
http://yourname.ru/org/a/str/vasya Локальный адрес - имя объекта или
веб страницы. Например, tula </p>
<h3>Закладки, сноски и ссылки внутри документа</h3>
<p>Закладка это место в которое можно переходить по ссылкам,
находящимся в этом же документе. Классическое использование закладок -
это концевые сноски примечаний к тексту документа или ссылки из текста
на использованную литературу, приведенную в библиографии. </p>
<p>Сначала нужно поставить закладу в ту точку документа, в которую предполагаются переходы: </p>
<ul>
<li>в начало строки от левого края ставятся подряд две точки ..</li>
<li>затем пробел</li>
<li>имя закладки, заключенное в квадратные скобки.</li>
<li>строка поясления закладки</li></ul>
<p>Практичнее вместо символьного имени использовать просто порядковый
номер закладки. Например, [12] - означает закладка 12. Пример
обозначения закладки:: </p>
<p>.. [12] Толстой Л.Н. Война и мир ... </p>
<p>Для того, чтобы установить сноску на закладку необходимо в тексте
поставить имя закладки в квадратных скобках [12]. Нельзя устанавливать
ссылки с заголовков, только из абзаца текста. </p>
<h2>Графика</h2>
<p>Для того, чтобы вставить графический файл используется следующая нотация: </p>
<p>"Альтернативный текст":img:http://yourname.ru/image/myimage_gif </p>
<p>В готовом виде "альтернативный текст" будет всплывать, если
установить курсор на картинку. Это то же самое, что аттрибут тега
alt="Альтернативный текст". </p>
<p>В ссылке обязательно используйте абсолютный адрес месторасположения
графического файла, начиная с http://. Относительные адреса не
поддерживаются. </p></ul>
<hr size="1" width="100%">
<a href="http://maximaster.ru/" target="_blank">http://maximaster.ru</a> <br><a href="http://netlander.org/" target="_blank">http://netlander.org</a>
From sergey_v Thu Jun 17 05:48:29 +0400 2004
From: sergey_v
Date: Thu, 17 Jun 2004 05:48:29 +0400
Subject: Замечательный урл
Message-ID: &lt;20040617054829+0400@plone.org.ru&gt;
А что это за замечательный урл у этой статьи?
From xen Fri Jul 2 18:54:13 +0400 2004
From: xen
Date: Fri, 02 Jul 2004 18:54:13 +0400
Subject: Исправил
Message-ID: &lt;20040702185413+0400@plone.org.ru&gt;
From unknown Tue Jul 6 14:39:57 +0400 2004
From: Date: Tue, 06 Jul 2004 14:39:57 +0400
Subject: Ссылка на оригинал документа
Message-ID: &lt;20040706143957+0400@plone.org.ru&gt;
Конечно очень приятно, что вы приводите на своем сайте мои документы.
Но порядочные люди указывают при этом автора и точное место нахождения
оригинала данного документа. Точная ссылка на оригинал:
http://netlander.org/groups/helps/stx1
Кстати, для новичков там есть еще краткая версия
http://netlander.org/groups/helps/stx , проверенная временем (все это
написано в 2000 году). Краткой версией предпочитают пользоваться даже
бухгалтеры. Привет, Netlander
From xen Wed Jul 7 18:47:44 +0400 2004
From: xen
Date: Wed, 07 Jul 2004 18:47:44 +0400
Subject: я не совсем понял в чем прблема
Message-ID: &lt;20040707184744+0400@plone.org.ru&gt;
свяжитесб со мной по электронной почте. на сайте http://netlander.org
выдается ошибка 404 документ не найден.
From unknown Mon Jul 19 00:51:13 +0400 2004
From: Date: Mon, 19 Jul 2004 00:51:13 +0400
Subject: Более точная ссылка на документ :)
Message-ID: &lt;20040719005113+0400@plone.org.ru&gt;
http://netlander.org/technology/contents/

From DKorolkov Mon Aug 16 13:05:55 +0400 2004
From: DKorolkov
Date: Mon, 16 Aug 2004 13:05:55 +0400
Subject: Ссылки на оригиналы
Message-ID: <20040816130555+0400@plone.org.ru>

http://netlander.org/technology/contents/stx -- краткая версия.
http://netlander.org/technology/contents/stx1 -- полная версия (приведённая здесь).

From vitaly80 Fri Oct 8 12:25:27 +0400 2004
From: vitaly80
Date: Fri, 08 Oct 2004 12:25:27 +0400
Subject: Эскейп-символы
Message-ID: <20041008122527+0400@plone.org.ru>

а как в _Structured Text_ сделать так, чтобы, например, &#39;lalala&#39; не преобразовывалось в 'lalala'?