summaryrefslogtreecommitdiffstats
path: root/kdoctools/customization/dtd
diff options
context:
space:
mode:
Diffstat (limited to 'kdoctools/customization/dtd')
-rw-r--r--kdoctools/customization/dtd/kdex.dtd129
-rw-r--r--kdoctools/customization/dtd/modifications.elements77
-rw-r--r--kdoctools/customization/dtd/rdbhier2.elements61
-rw-r--r--kdoctools/customization/dtd/rdbpool.elements213
4 files changed, 480 insertions, 0 deletions
diff --git a/kdoctools/customization/dtd/kdex.dtd b/kdoctools/customization/dtd/kdex.dtd
new file mode 100644
index 000000000..c31d11a57
--- /dev/null
+++ b/kdoctools/customization/dtd/kdex.dtd
@@ -0,0 +1,129 @@
+<!--
+ Document Type Definition for DocBook XML as used in the KDE documentation
+
+ Copyright (C) 2002 Frederik Fouvry
+
+ This program is free software; you can redistribute it and/or
+ modify it under the terms of the GNU General Public License
+ as published by the Free Software Foundation; either version 2
+ of the License, or (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program; if not, write to the Free Software
+ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+
+ Send suggestions, comments, etc. to the KDE docbook list
+ <kde-docbook@kde.org>.
+
+
+ USAGE
+
+ Refer to this DTD as
+
+ "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
+
+ For instance:
+
+ <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
+ "customization/dtd/kdex.dtd">
+
+ and use catalog.xml or docbook.cat as the catalogue file.
+ Note: the system identifier is interpreted relative to the place
+ where it is defined, unless otherwise defined by the application you use.
+ If you have permanent internet access, you can use any URLs (and
+ you don't have to install docbook).
+
+ After a version number change, plenty of problems may occur because
+ of non-compatibilities (or DTDs not found, etc). That doesn't mean your
+ document is invalid; it just means that the reference DTD has changed
+ (new documentation and documentation updates). Check out the previous
+ version and point to the appropriate catalog or DTD and things should
+ work again (=still ;-).
+-->
+
+
+<!-- ============================================================= -->
+<!-- Modifications to the original DocBook DTD -->
+<!-- ============================================================= -->
+<!-- Declarations in this part should only *restrict* the DocBook
+ DTD -->
+
+<!-- copied from docbookx.dtd: these values are for
+ %xml.features; = "INCLUDE"
+ Files that define elements need them (currently only
+ modifications.elements) -->
+<!ENTITY % ho "">
+<!ENTITY % ubiq.inclusion "">
+<!ENTITY % beginpage.exclusion "">
+
+<!-- Modifications in pool
+ %rdbpool; is called in the DocBook DTD
+ NEEDS TO BE CHECKED ON CHANGES
+ -->
+<!ENTITY % rdbpool PUBLIC
+ "-//KDE//ELEMENTS DocBook XML Pool Redeclarations V1.1//EN"
+ "rdbpool.elements" >
+<!ENTITY % dbpool.redecl.module "INCLUDE" >
+
+<!-- Modifications in hierarchy
+ %rdbhier2; is called in the DocBook DTD
+ NEEDS TO BE CHECKED ON CHANGES
+ -->
+<!ENTITY % rdbhier2 PUBLIC
+ "-//KDE//ELEMENTS DocBook XML Hierarchy Redeclarations 2 V1.0//EN"
+ "rdbhier2.elements" >
+<!ENTITY % dbhier.redecl2.module "INCLUDE" >
+
+<!-- For Java-style refentries
+ Based on DocBook 4.0. -->
+<!--ENTITY % jrefentry PUBLIC
+ "-//Norman Walsh//DTD JRefEntry V1.0//EN" >
+%jrefentry; -->
+
+<!-- Temporary solution -->
+<!ENTITY copy "(c)"> <!--=copyright sign-->
+<!ENTITY trade "[tm]"> <!--=trade mark sign-->
+<!ENTITY reg "(R)"> <!--/circledR =registered sign-->
+
+
+<!-- ============================================================= -->
+<!-- Original DocBook DTD -->
+<!-- ============================================================= -->
+
+<!ENTITY % DocBookDTD PUBLIC
+ "-//OASIS//DTD DocBook XML V4.2//EN"
+ "../../docbook/xml-dtd-4.2/docbookx.dtd" >
+%DocBookDTD;
+
+
+<!-- ============================================================= -->
+<!-- Modifications to the original DocBook DTD -->
+<!-- ============================================================= -->
+<!-- ONLY to supply declarations that were switched off in the
+ first "Modifications" section -->
+
+<!ENTITY % kde.modifications PUBLIC
+ "-//KDE//ELEMENTS DocBook XML Modifications V1.1//EN"
+ "modifications.elements" >
+%kde.modifications;
+
+
+<!-- ============================================================= -->
+<!-- Extensions to the DocBook DTD -->
+<!-- ============================================================= -->
+<!-- Is empty, except for what could go in dbgenent.mod -->
+
+<!ENTITY % kde.general.entities PUBLIC
+ "-//KDE//ENTITIES DocBook XML General Entity Declarations V1.2//EN"
+ "../entities/general.entities" >
+%kde.general.entities;
+
+<!ENTITY % kde.i18n.entities PUBLIC
+ "-//KDE//ENTITIES DocBook XML Localisation Entity Declarations V1.0//EN"
+ "../entities/l10n.entities" >
+%kde.i18n.entities;
diff --git a/kdoctools/customization/dtd/modifications.elements b/kdoctools/customization/dtd/modifications.elements
new file mode 100644
index 000000000..e0cbd1474
--- /dev/null
+++ b/kdoctools/customization/dtd/modifications.elements
@@ -0,0 +1,77 @@
+<!-- -*- dtd -*-
+ Fills in declarations that were switched off earlier (to provide them
+ anew and more restrictive this time)
+
+ Copyright (C) 2001,2002 Frederik Fouvry
+
+ This program is free software; you can redistribute it and/or
+ modify it under the terms of the GNU General Public License
+ as published by the Free Software Foundation; either version 2
+ of the License, or (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program; if not, write to the Free Software
+ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+
+ Send suggestions, comments, etc. to the KDE docbook list
+ <kde-docbook@kde.org>.
+
+ USAGE
+
+ Refer to this DTD as
+
+ "-//KDE//ELEMENTS DocBook XML Modifications (Restrictions) V1.1//EN"
+
+ For instance
+
+ <!ENTITY % kde.modifications PUBLIC
+ "-//KDE//ELEMENTS DocBook XML Modifications (Restrictions) V1.1//EN">
+
+-->
+
+<!-- ONLY to supply declarations that were switched off earlier
+ Take care to make it only _more_ restrictive. -->
+
+<!-- One modification: BookInfo is compulsory, because
+ it contains ReleaseInfo, which is compulsory -->
+<!ELEMENT book %ho; ((%div.title.content;)?, bookinfo,
+ (dedication | toc | lot
+ | glossary | bibliography | preface
+ | %chapter.class; | reference | part
+ | %article.class;
+ | %appendix.class;
+ | %index.class;
+ | colophon)*)
+ %ubiq.inclusion;>
+
+<!-- Modification: ReleaseInfo, Date, Abstract and Keywordset are
+ compulsory. Not all orders that could be valid are allowed (the
+ number increases factorial). The current restrictions are quite
+ strict, and it is foreseen that they will be relaxed. Date and
+ ReleaseInfo must come together, as must Abstract and Keywordset.
+ Abstract and Keywordset must follow Date and ReleaseInfo when they
+ are used the first time.
+-->
+<!ELEMENT bookinfo %ho; ((%kde.info.class;)*, date, releaseinfo,
+ (%kde.info.class;)*, abstract, keywordset,
+ (%info.class;)*)
+ %beginpage.exclusion;>
+
+<!-- value of Type changed from IMPLIED CDATA
+ default value of LinkMode set from #IMPLIED to kdems-default -->
+<!ATTLIST olink
+ targetdocent ENTITY #IMPLIED
+ linkmode IDREF "kdems-default"
+ localinfo CDATA #IMPLIED
+ type (href|other) "href"
+ targetdoc CDATA #IMPLIED
+ targetptr CDATA #IMPLIED
+ %common.attrib;
+ %olink.role.attrib;
+ %local.olink.attrib;
+>
diff --git a/kdoctools/customization/dtd/rdbhier2.elements b/kdoctools/customization/dtd/rdbhier2.elements
new file mode 100644
index 000000000..005934f87
--- /dev/null
+++ b/kdoctools/customization/dtd/rdbhier2.elements
@@ -0,0 +1,61 @@
+<!-- -*- dtd -*-
+ Modified hierarchy elements for DocBook as used in the KDE documentation
+ (instantiates %rdbhier2;). The actual changes are done in
+ modifications.elements.
+
+ Copyright (C) 2001 Frederik Fouvry
+
+ This program is free software; you can redistribute it and/or
+ modify it under the terms of the GNU General Public License
+ as published by the Free Software Foundation; either version 2
+ of the License, or (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program; if not, write to the Free Software
+ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+
+ Send suggestions, comments, etc. to the KDE docbook list
+ <kde-docbook@kde.org>.
+
+ USAGE
+
+ Refer to this DTD as
+
+ "-//KDE//ELEMENTS DocBook Hierarchy Redeclarations 2 V1.0//EN"
+
+ For instance
+
+ <!ENTITY % rdbhier2 PUBLIC
+ "-//KDE//ELEMENTS DocBook Hierarchy Redeclarations 2 V1.0//EN">
+
+ Set to IGNORE: to revert from KDE customisation for:
+ kde.remove.unused.elements some elements unlikely to be used
+ kde.book.meta.info extra requirements for bookinfo element
+-->
+
+
+<!-- Elements which are unlikely to be useful in the KDE documentation,
+ because their purpose is either to markup already existing documents
+ or because there are automatic means of obtaining the same effect
+
+ %kde.remove.unused.elements; is set in kde-rdbpool.elements.
+ -->
+<![ %kde.remove.unused.elements; [
+<!ENTITY % toc.content.module "IGNORE">
+<!ENTITY % lot.content.module "IGNORE">
+<!-- end of kde.remove.unused.elements -->]]>
+
+
+<!-- For translation and revision bookkeeping mechanisms, some elements
+ are required to be present in bookinfo.
+ -->
+<!ENTITY % kde.book.meta.info "INCLUDE">
+<![ %kde.book.meta.info; [
+<!ENTITY % book.element "IGNORE">
+<!ENTITY % bookinfo.element "IGNORE">
+<!-- end of kde.book.meta.info -->]]>
diff --git a/kdoctools/customization/dtd/rdbpool.elements b/kdoctools/customization/dtd/rdbpool.elements
new file mode 100644
index 000000000..b3c452027
--- /dev/null
+++ b/kdoctools/customization/dtd/rdbpool.elements
@@ -0,0 +1,213 @@
+<!-- -*- dtd -*-
+ Modified element pool for DocBook as used in the KDE documentation
+ (instantiates %rdbpool;)
+
+ Copyright (C) 2001,2002 Frederik Fouvry
+
+ This program is free software; you can redistribute it and/or
+ modify it under the terms of the GNU General Public License
+ as published by the Free Software Foundation; either version 2
+ of the License, or (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program; if not, write to the Free Software
+ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+
+ Send suggestions, comments, etc. to the KDE docbook list
+ <kde-docbook@kde.org>.
+
+ USAGE
+
+ Refer to this DTD as
+
+ "-//KDE//ELEMENTS DocBook XML Pool Redeclarations V1.1//EN"
+
+ For instance
+
+ <!ENTITY % rdbpool PUBLIC
+ "-//KDE//ELEMENTS DocBook XML Pool Redeclarations V1.1//EN">
+
+ Set to IGNORE: to revert from KDE customisation for:
+ kde.remove.unused.elements some elements unlikely to be used
+-->
+
+<!-- Elements which are unlikely to be useful in the KDE documentation,
+ because their purpose is either to markup already existing documents
+ or because there are automatic means of obtaining the same effect
+ -->
+<!ENTITY % kde.remove.unused.elements "INCLUDE">
+<![ %kde.remove.unused.elements; [
+<!ENTITY % beginpage.module "IGNORE">
+<!ENTITY % bridgehead.module "IGNORE">
+<!ENTITY % confgroup.content.module "IGNORE">
+<!ENTITY % graphic.module "IGNORE">
+<!ENTITY % graphicco.module "IGNORE">
+<!ENTITY % imageobjectco.module "IGNORE">
+<!ENTITY % inlinegraphic.module "IGNORE">
+<!ENTITY % revhistory.content.module "IGNORE">
+<!-- end of kde.remove.unused.elements -->]]>
+
+<!-- KDE Languages
+ To keep the language tags conform to RFC 3066 (successor to 1766)
+ (http://www.rfc-editor.org/rfc/rfc3066.txt)
+ Syntax (RE): [a-zA-Z]{1,8}(-[a-zA-Z]{1,8})*
+
+ The compulsory part is either a language tag from ISO 639 (ISO
+ 639-1 (2 character tag) if there is a tag, ISO 639-2/T (three
+ character tag) otherwise, "i" (for IANA) or "x" (for private use,
+ e.g. languages that are not in ISO 639).
+ The optional part may consist of any value. However, if the
+ first repetition consists of two letters, it must be an ISO
+ 3166a2 country tag (so Nynorsk cannot be indicated by no-NY or
+ no-ny).
+ Official site for ISO 639-2: http://lcweb.loc.gov/standards/iso639-2/
+ For ISO 639-1, only the latest version (currently Feb 2000) counts!
+
+ Countries are currently only needed when the language is different.
+ -->
+<!ENTITY % lang.attrib
+ "lang (af|ar|az|be|bg|bn|bo|br|bs|ca|cs|cy|da|de|el|en|en-GB
+ |en-US|eo|es|et|eu|fa|fi|fo|fr|fy|ga|gl|gu|he|hi|hr|hu
+ |id|is|it|ja|kn|km|ko|ku|lo|lt|lv|mi|mk|mn|mr|ms|mt|nb
+ |nds|nl|nn|no|nso|oc|pl|pt|pt-BR|pt-PT|ro|ru|se|si|sk
+ |sl|sq|sr|ss|st|sv|ta|te|tg|th|tr|uk|uz|ven|vi|wa|xh
+ |zh|zh-CN|zh-TW|zu)
+ #IMPLIED">
+<!-- List of languages
+ (Languages that only have a three-character code from 639-2, must use
+ that one)
+af Afrikaans
+ar Arabic
+az Azerbaijani
+be Belarusian
+bg Bulgarian
+bn Bengali
+bo Tibetan
+br Breton
+bs Bosnian
+ca Catalan
+cs Czech
+cy Welsh
+da Danish
+de German
+el Greek, Modern (1453-)
+en English
+eo Esperanto
+es Spanish
+et Estonian
+eu Basque
+fa Persian (Farsi)
+fi Finnish
+fo Faroese
+fr French
+fy Frisian
+ga Irish
+gl Gallegan
+gu Gujarati
+he Hebrew
+hi Hindi
+hr Croatian
+hu Hungarian
+id Indonesian
+is Icelandic
+it Italian
+ja Japanese
+km Khmer
+kn Kannada
+ko Korean
+ku Kurdish
+lo Lao
+lt Lituanian
+lv Latvian
+mi Maori
+mk Macedonian
+mn Mongolian
+mr Marathi
+ms Malay
+mt Maltese
+nb Norwegian Bokmal
+nds Low Saxon, Low German
+nl Dutch
+nn Norwegian Nynorsk
+no Norwegian (in KDE = nb)
+nso Northern Sotho
+oc Occitan (post 1500); Provençal
+pl Polish
+pt Portuguese
+ro Romanian
+ru Russian
+se Northern Sami
+si Sinhalese
+sk Slovak
+sl Slovenian
+sq Albanian
+sr Serbian
+ss Swati
+st Sesotho (souther Sotho)
+sv Swedish
+ta Tamil
+te Telugu
+tg Tajik
+th Thai
+tr Turkish
+uk Ukrainian
+uz Uzbek
+ven Venda
+vi Vietnamese
+wa Walloon
+xh Xhosa
+zh Chinese
+zu Zulu
+-->
+<!-- end of KDE languages -->
+<!-- Languages could be made compulsory for books -->
+
+<!ENTITY % remap.attrib "">
+
+<!-- Not used -->
+<!ENTITY % revisionflag.attrib "">
+
+<!ENTITY % othercredit.role.attrib
+ "role (translator|developer|reviewer|graphist|musician|tester)
+ #REQUIRED">
+
+<!ENTITY % kde.compulsory.datereleaseinfo "INCLUDE">
+<![ %kde.compulsory.datereleaseinfo; [
+<!-- Unchanged -->
+<!ENTITY % local.person.ident.mix "">
+<!ENTITY % person.ident.mix
+ "honorific|firstname|surname|lineage|othername|affiliation
+ |authorblurb|contrib %local.person.ident.mix;">
+
+<!ENTITY % local.bibliocomponent.mix "">
+<!-- Copy of bibliocomponent.mix without ReleaseInfo, Date or Abstract -->
+<!ENTITY % kde.bibliocomponent.mix
+ "abbrev|address|artpagenums|author
+ |authorgroup|authorinitials|bibliomisc|biblioset
+ |collab|confgroup|contractnum|contractsponsor
+ |copyright|corpauthor|corpname|edition
+ |editor|invpartnumber|isbn|issn|issuenum|orgname
+ |biblioid|citebiblioid|bibliosource|bibliorelation|bibliocoverage
+ |othercredit|pagenums|printhistory|productname
+ |productnumber|pubdate|publisher|publishername
+ |pubsnumber|revhistory|seriesvolnums
+ |subtitle|title|titleabbrev|volumenum|citetitle
+ |personname|%person.ident.mix;
+ |%ndxterm.class;
+ %local.bibliocomponent.mix;">
+<!-- Unchanged -->
+<!ENTITY % local.info.class "">
+<!-- Copy of info.class with %kde.bibliocomponent.mix; -->
+<!ENTITY % kde.info.class
+ "graphic | mediaobject | legalnotice | modespec
+ | subjectset | keywordset | itermset | %kde.bibliocomponent.mix;
+ %local.info.class;">
+<!-- End of compulsory ReleaseInfo -->]]>
+
+<!-- KDE uses a more specific list of attributes -->
+<!ENTITY % olink.attlist "IGNORE">
generated by cgit v1.2.3 (git 2.25.1) at 2024-06-21 23:07:28 +0000