VitaliyFilippov: 1 версия

2009-03-27T10:04:41Z

1 версия

StasFomin: орфография/пунктуация

2009-02-09T11:47:38Z

орфография/пунктуация

85.140.242.27: /* FEATURES */

2008-10-23T20:03:03Z

‎FEATURES

85.140.242.27: /* NAMES */

2008-10-23T20:02:26Z

‎NAMES

WikiSysop: 1 версия

2008-08-04T09:55:49Z

1 версия

BenderBot: реплицировано из внутренней CustisWiki

2006-02-01T16:43:19Z

реплицировано из внутренней CustisWiki

Новая страница

SGML декларация определяет самый нижний, лексический уровень [[SGML]]-документа:
* используемый алфавит
** спецсимволы
** разделители

== Пример ==
Рассмотрим основные части SGML-декларации, на основе этого минимального примера.

<code-xml>
<!SGML "ISO 8879:1986"
CHARSET
BASESET "ISO 646-1983//CHARSET International Reference
Version (IRV)//ESC 2/5 4/0"
DESCSET
0 9 UNUSED
9 2 9
11 2 UNUSED
13 1 13
14 18 UNUSED
32 95 32
127 1 UNUSED
CAPACITY PUBLIC "ISO 8879-1986//CAPACITY Reference//EN"
SCOPE DOCUMENT
SYNTAX PUBLIC "ISO 8879-1986//SYNTAX Reference//EN"
FEATURES
MINIMIZE DATATAG NO OMITTAG NO RANK NO
SHORTTAG NO
LINK SIMPLE NO IMPLICIT NO EXPLICIT NO
OTHER CONCUR NO SUBDOC NO FORMAL NO
APPINFO NONE
>
</code-xml>

Итак, сама SGML-декларация всегда кодируется в синтаксисе
«Reference Concrete Syntax», т. е. состоит из набора ключевых слов, чисел и литералов, разделенных пробелами, символами табуляции и перевода строк и комментариями, которые начинаются и оканчиваются «--» (разделителем COM).
Декларация начинается с заголовка содержащего литерал, указывающий версию стандарта. Правда сейчас версия стандарта всего одна (и маловероятно, что появится другая версия), поэтому, можно считать, что этот литерал должен всегда быть «ISO 8879:1986», что означает опубликованную в 1986, версию [[ISO]] стандарта № 8879.
Далее рассмотрим остальные разделы.

== CHARSET ==
Определяет алфавит документов. Состоит из раздела «BASESET», определяющего базовый набор символов (алфавит), как правило это ASCII (т. е. ISO 646) и раздела «DESCSET» (''described character set portion''), определяющего правила отображения алфавита документа на базовый алфавит. DESCSET-правила просты, строчка «kk mm nn», означает, что диапазон символов с кодами в алфавите документа от <tt>kk</tt> до <tt>kk+mm-1</tt> отображается на диапазон символов в базовом алфавите с кодами от <tt>nn</tt> до <tt>nn+mm-1</tt>.
Третья колонка, кроме кода стартового символа в базовом алфавите, может содержать:
;константу «UNUSED»: Это значит, что указанные символьные коды являются неопределенными, а соответствующие символы есть «non-SGML characters».
;строковый литерал: Это значит, что символы с указанными кодами являются незначительными ("non-significant SGML data character"), т.е. могут встречаться в документе, но не могут нести никакой разметочной нагрузки, например, не могут служить разделителями. Так, следующая строчка позволит использовать в документах верхнюю половину ASCII-таблицы:
128 128 "High-order characters"

== CAPACITY ==
Определяет различные мощностные ограничения на свойства документа. Например, «ELEMCAP» ограничивает произведение числа различных SGML-элементов на свойство «NAMELEN» (см. [[#SYNTAX]]).
Аналогичным образом, можно задать и другие ограничения: «ENTCAP», «ENTCHCAP», «ELEMCAP», «GRPCAP», «EXGRPCAP», «EXNMCAP», «ATTCAP», «ATTCHCAP», «AVGRPCAP», «NOTCAP», «NOTCHCAP», «IDCAP», «IDREFCAP», «MAPCAP», «LKSETCAP», «LKNMCAP».
Можно использовать параметр «TOTALCAP», для ограничения сверху всех вышеупомянутых параметров.

Можно использовать «Reference Capacity Set»
CAPACITY PUBLIC "ISO 8879-1986//CAPACITY Reference//EN"
который установит все ограничения в <tt>35000</tt>.

А можно и вовсе отключить эти ограничения:
CAPACITY NONE -- Capacities are not restricted in XML --

== SCOPE ==
Определяет, к чему будет применяться «concrete syntax», определяемый в следующем разделе ([[#SYNTAX]])
Тут всего два варианта:
;SCOPE DOCUMENT: «concrete syntax» применяется целиком, ко всему SGML-документу, включая «document type declaration».
;SCOPE INSTANCE: «concrete syntax» применяется только к части документа, следующей за прологом, т. е. не применяется к «document type declaration».

== SYNTAX ==
Определяет «concrete syntax».

=== Стандартные синтаксисы ===
Можно воспользоваться четыремя стандартными синтаксисами, определенными в стандарте SGML:

;the Reference Concrete Syntax:
SYNTAX PUBLIC "ISO 8879-1986//SYNTAX Reference//EN"

;the Core Concrete Syntax: отличается от «the Reference Concrete Syntax» отсутствием определений «Short Reference Delimiters».
SYNTAX PUBLIC "ISO 8879- 1986//SYNTAX Core//EN"

;the Multicode Basic Concrete Syntax: отличается от «the Reference Concrete Syntax» наличием некоторого количества определений символов, подавляющих разметку.
SYNTAX PUBLIC "ISO 8879- 1986//SYNTAX Multicode Basic//EN"

;the Multicode Core Concrete Syntax: отличается от «the Reference Concrete Syntax» наличием некоторого количества определений символов, подавляющих разметку и отсутствием определений «Short Reference Delimiters».
SYNTAX PUBLIC "ISO 8879- 1986//SYNTAX Multicode Core//EN"

Далее, стандартный синтаксис можно донастраивать, например, строка
SWITCHES 47 92
приведет к переносу смысла символа с кодом 47 («/») на символ с кодом 92 («\»). При этом (если использовался стандартный синтаксис) разделитель «ETAGO» (закрывающий тэг элемента) станет «\>» вместо «/>», а разделитель «NET» сменится с «/» на «\». Заметим, что это не простая трансляция одних символьных кодов в другие — значения строковых литералов, например, при этом не изменятся.
Также это не «обмен», т. е. чтобы «обменять смыслы» двух символов, нужно соответственно повторить эту директиву, или продолжить:
SWITCHES 47 92 92 47

Cледующий пример, обменяет «стандартные» для всех [[SGML]]/[[XML]] разметок символы «<" и ">» на «{» и «}».

SYNTAX PUBLIC "ISO 8879-1986//SYNTAX Multicode Basic//EN"
SWITCHES 60 123 123 60 62 125 125 62

=== Variant Concrete Syntax ===
Можно декларировать конкретный синтаксис, определив его «с нуля». Для этого, рассмотрим определение самого «The Reference Concrete Syntax»:
SYNTAX
SHUNCHAR CONTROLS
0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
19 20 21 22 23 24 25 26 27 28 29 30 31 127 255
BASESET "ISO 646-1983//CHARSET International Reference
Version (IRV)//ESC 2/5 4/0"
DESCSET
0 128 0
FUNCTION
RE 13
RS 10
SPACE 32
TAB SEPCHAR 9
NAMING
LCNMSTRT ""
UCNMSTRT ""
LCNMCHAR "-."
UCNMCHAR "-."
NAMECASE GENERAL YES
ENTITY NO
DELIM
GENERAL SGMLREF
SHORTREF SGMLREF
NAMES SGMLREF
QUANTITY SGMLREF

==== SHUNCHAR ====
ISO 8879 требует избегать («Clause 4.297») «shunned» («опасных») символов,
«поскольку некоторые системы могут ошибочно трактовать такие символы как управляющие». В этом разделе, перечисляются коды таких символов.
Дополнительно, можно использовать ключевое слово «CONTROLS» в разделе «SHUNCHAR», что означает, что любой символ в алфавите документа, чей код является кодом управляющего символа, является «shunned» символом (в дополнении к перечисленным вручную).
Так что раздел «SHUNCHAR» из предыдущего примера можно эквивалентно переписать в виде:
SHUNCHAR 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
19 20 21 22 23 24 25 26 27 28 29 30 31 127 255

или
SHUNCHAR CONTROLS 255

Отсутствие «shunned» символов декларируется как:

SHUNCHAR NONE

==== The Syntax-Reference Character Set ====
Алфавит конкретного синтаксиса, определяется аналогично алфавиту документа, через
директивы BASESET и DESCSET.
Вот пример «the syntax-reference character set» полностью эквивалентного ISO 646:

BASESET "ISO 646-1983//CHARSET International Reference
Version (IRV)//ESC 2/5 4/0"
DESCSET
0 128 0

==== FUNCTION ====
В этом разделе определяются функциональные символы, имеющие особую важность, при разборе SGML-документа. Обязательно определить «RE», «RS», «SPACE», причем именно в этом порядке, далее можно определять дополнительные именованные символы, например «TAB»:

FUNCTION RE 13
RS 10
SPACE 32
TAB SEPCHAR 9

причем для «дополнительных» именованных символов можно указывать
их роль:

;SEPCHAR: разделитель, «white space»;
;MSSCHAR: «markup suppression character» — по сути «escape character», т. к. блокирует спецзначение у следующего за ним символа. Т.е. после обьявления
BACKSL MSSCHAR 92
:можно ввести амперсанд как «\&».
;MSOCHAR, MSICHAR: также «markup suppression character», только «действующие на интервале». Так, после декларации
MSO MSOCHAR 96
MSI MSICHAR 36
:строчка
<nowiki>`<foo></foo>$</nowiki>
:будет интерпретирована как поток символов, без разбора на элементы.

;FUNCHAR: нейтральный управляющий символ.

Коды символов в этот раздел можно вводить как численно (кроме трех упомянутых обязательных символов), так и с помощью механизма именованных ссылок, например:
<nowiki>
&#SPACE;
</nowiki>

==== NAMING ====
Этот раздел определяет символы, которые могут использоваться в именовании (элементов, сущностей и т. п.).

Например, этот блок объявляет, что имена могут быть алфавитно-цифровыми, начинаясь с буквы или цифры «7», могут содержать «.» и «-», причем имена, кроме имен entity, чувствительны к регистру.
NAMING LCNMSTRT "7"
UCNMSTRT "7"
LCNMCHAR "-."
UCNMCHAR "-."
NAMECASE GENERAL YES
ENTITY NO

Вообще, по умолчанию, имена являются алфавитно-цифровыми, начинающимися с буквы, но можно также начинать имена с символов встречающихся в литералах параметров
«LCNMSTRT» и «UCNMSTRT», и использовать в именах символы из литералов «LCNMCHAR» и «UCNMCHAR». Парность параметров с префиксами «LC» и «UC» объясняется тем, что таким способом для «дополнительных разрешенных» символов определяется, кто из них «lower case», а кто «upper case» соответственно.

=== DELIM ===

Если требуется использовать стандартные SGML-разделители, то достаточно сделать следующее:

DELIM
GENERAL SGMLREF

Таким образом, будут определены следующие стандартные разделители:
AND "&"
COM "--"
CRO "&#"
DSC "]"
DSO "["
DTGC "]"
DTGO "["
ERO "&"
ETAGO "</"
GRPC ")"
GRPO "("
LIT "
LITA ""
MDC ">"
MDO "<!"
MINUS "-"
MSC "]]"
NET "/"
OPT "?"
OR "|"
PERO "%"
PIC ">"
PIO "<?"
PLUS "+"
REFC ";"
REP "*"
RNI "#"
SEQ ","
STAGO "<"
TAGC ">"
VI "="

Если мы захотим переопределить некоторые разделители, то это также можно сделать,
учитывая, что длина строки-разделителя не должна быть больше LITLEN=240, и не должна состоять только из функциональных символов. Например, следующим образом мы меняем стандартные разделители «GRPO» и «GRPC», которые по умолчанию есть "(" и «)» на фигурные скобки:

DELIM GENERAL SGMLREF
GRPO "{"
GRPC "}"

Аналогично определяются SHORTREFы. Отказаться от них можно с помощью
SHORTREF NONE

А стандартный набор, включаемый строкой
SHORTREF SGMLREF

включает следующие определения:
SHORTREF NONE
"&#SPACE;" "&#TAB;" "&#RE;" "&#RS;"
"&#RS;&#RE;" "&#RS;B" "B&#RE;" "B&#RE;" "BB"
" "#" "%" "" "(" ")" "*" "," "-"
":" ";" "=" "@" "+" "[" "]"
"^" "_" "{" "|" "}" "~" "--"

Дополнительные shortrefы определяются следующим образом:
SHORTREF SGMLREF
"\"
"---"

===NAMES===

Стандартный набор зарезервированых имен
ANY ATTLIST CDATA CONREF
CURRENT DEFAULT DOCTYPE ELEMENT
EMPTY ENDTAG ENTITIES ENTITY
FIXED ID IDLINK IDREF
IDREFS IGNORE IMPLIED INCLUDE
INITIAL LINK LINKTYPE MS
NAME NAMES NDATA MNTOKEN
NMTOKENS MD NOTATION NUMBER
NUMBERS NUTOKEN NUTOKENS O
PCDATA PI POSTLINK PUBLIC
RCDATA REQUIRED RESTORE SDATA
SHORTREF SIMPLE STARTTAG SUBDOC
SYSTEM TEMP USELINK USEMAP

включается следующей строчкой
NAMES SGMLREF

Можно переопределять зарезервированные имена (новые имена должны быть алфавитно-цифровые, возможно содержащие «.» или «-»):
NAMES SGMLREF
DOCTYPE DTD
ELEMENT EL
PCDATA TEXT

В этом примере, SGML-документы будут начинаться с «<!DTD», а не «<!DOCTYPE», декларации элементов — c «<!EL», а не «<!ELEMENT», а символьные данные — с «#TEXT», вместо rather «#PCDATA».

===QUANTITY===
В этом разделе, схожим с [[#CAPACITY]] задаются (или переопределяются) численные величины-ограничения, на длины имен и литералов.

QUANTITY SGMLREF
NAMELEN 32
LITLEN 2048

В отличие от раздела [[#CAPACITY]], если используется формула "QUANTITY SGMLREF", не требуется переопределять ни одну количественную величину. Если NAMELEN сделать меньшим 8, то необходимо переопределить все зарезервированные имена, чтобы уложиться в это ограничение.

== FEATURES ==
В этом разделе, должны быть перечислены все дополнительные SGML-свойства, причем обязательно в указанном порядке:

FEATURES
MINIMIZE DATATAG NO OMITTAG NO RANK NO
SHORTTAG NO
LINK SIMPLE NO IMPLICIT NO EXPLICIT NO
OTHER CONCUR NO SUBDOC NO FORMAL NO

Эти свойства деляться на три группы:
* свойства минимизации
* ссылочные свойства
* иные

Для разрешения свойств
;DATATAG:
;OMITTAG:
;RANK:
;SHORTTAG:
;IMPLICIT:
;FORMAL:
нужно заменить «NO» на «YES».

Для разрешения свойств
;SIMPLE:
;EXPLICIT:
;CONCUR:
;SUBDOC:
нужно заменить «NO» на «YES» и число, означающее число одновременно разрешенных активных простых ссылок, активных явных ссылок, активных конкурирующих или вложенных документов соответственно.

== APPINFO ==

Информация из этого раздела не используется при разборе, но передается приложению, получающему результат работы SGML-парсера.
Соответственно, команда может быть либо
APPINFO NONE

либо задается какой-либо литерал:
APPINFO "xyz"

[[Category:Документирование]]
{{replicate-from-custiswiki-to-lib}}

StasFomin: DSP@-->

2006-01-31T16:23:53Z

DSP@-->

← Предыдущая		Версия 11:47, 9 февраля 2009
Строка 331:		Строка 331:
	либо задается какой-либо литерал:		либо задается какой-либо литерал:
	APPINFO "xyz"		APPINFO "xyz"
−

@@ Строка 281: / Строка 281: @@
         PCDATA    TEXT
-В этом примере, SGML-документы будут начинаться с «&lt;!DTD», а не «&lt;!DOCTYPE», декларации элементов — c «&lt;!EL», а не «&lt;!ELEMENT», а символьные данные — с  «#TEXT», вместо  rather «#PCDATA».
+В этом примере, SGML-документы будут начинаться с «&lt;!DTD», а не «&lt;!DOCTYPE», декларации элементов — c «&lt;!EL», а не «&lt;!ELEMENT», а символьные данные — с  «#TEXT», вместо «#PCDATA».
 ===QUANTITY===

← Предыдущая		Версия 09:55, 4 августа 2008
(не показана 1 промежуточная версия 1 участника)
Строка 333:		Строка 333:


−	~~<!--BEGINDSP@-->~~

−	~~==Ссылки==~~
−	* http://home.chello.no/~mgrsby/sgmlintr/chapter3.htm
−	~~<!--ENDDSP@-->~~

	[[Category:Документирование]]		[[Category:Документирование]]
	{{replicate-from-custiswiki-to-lib}}		{{replicate-from-custiswiki-to-lib}}

← Предыдущая		Версия 16:23, 31 января 2006
Строка 333:		Строка 333:


		+	<!--BEGINDSP@-->

		+	==Ссылки==
		+	* http://home.chello.no/~mgrsby/sgmlintr/chapter3.htm
		+	<!--ENDDSP@-->

	[[Category:Документирование]]		[[Category:Документирование]]
	{{replicate-from-custiswiki-to-lib}}		{{replicate-from-custiswiki-to-lib}}

← Предыдущая	Версия 10:04, 27 марта 2009
(нет различий)

@@ Строка 301: / Строка 301: @@
        OTHER    CONCUR   NO  SUBDOC   NO   FORMAL   NO
-Эти свойства деляться на три группы:
+Эти свойства делятся на три группы:
 * свойства минимизации
 * ссылочные свойства