mirror of
https://github.com/rkd77/elinks.git
synced 2024-06-26 01:15:37 +00:00
Import and use AsciiDoc 7.1.2 configuration files
In the past, we have hit annoying incompatibilities when people have attempted to rebuild ELinks documentation with new versions of AsciiDoc: http://bugzilla.elinks.cz/show_bug.cgi?id=989 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=491820 So now we bundle the configuration files from a known good version to let ELinks documentation be built with them regardless of which version has been installed on the machine.
This commit is contained in:
Kalle Olavi Niemitalo
Kalle Olavi Niemitalo
parent
e019038c17
commit
40715ffbd4
|
|
@ -14,7 +14,9 @@ PDF_DIR = $(DESTDIR)$(docdir)/$(PACKAGE)/pdf
|
|||
TXT_DIR = $(DESTDIR)$(docdir)/$(PACKAGE)/txt
|
||||
|
||||
ASCIIDOC_CONF = $(srcdir)asciidoc.conf
|
||||
ASCIIDOC_FLAGS += -f $(ASCIIDOC_CONF) \
|
||||
ASCIIDOC_FLAGS += --no-conf -f $(srcdir)tools/asciidoc/asciidoc.conf \
|
||||
-f $(srcdir)tools/asciidoc/$(call backend).conf \
|
||||
-f $(ASCIIDOC_CONF) \
|
||||
-a "builddir=$(CURDIR)/" \
|
||||
-a asciidoc7compatible \
|
||||
-a elinks_version=$(VERSION)
|
||||
|
|
|
|||
18
doc/tools/asciidoc/COPYRIGHT
Normal file
18
doc/tools/asciidoc/COPYRIGHT
Normal file
|
|
@ -0,0 +1,18 @@
|
|||
Copyright (C) 2000 Stuart Rackham
|
||||
|
||||
Email: srackham@methods.co.nz
|
||||
|
||||
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., 59 Temple Place - Suite 330, Boston, MA 02111-1307,
|
||||
USA.
|
||||
14
doc/tools/asciidoc/README
Normal file
14
doc/tools/asciidoc/README
Normal file
|
|
@ -0,0 +1,14 @@
|
|||
The files in this directory, except this README itself,
|
||||
have been copied from the AsciiDoc 7.1.2 source package.
|
||||
|
||||
In the past, we have hit annoying incompatibilities when
|
||||
people have attempted to rebuild ELinks documentation
|
||||
with new versions of AsciiDoc:
|
||||
|
||||
http://bugzilla.elinks.cz/show_bug.cgi?id=989
|
||||
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=491820
|
||||
|
||||
So now we bundle the configuration files from a known good version
|
||||
to let ELinks documentation be built with them regardless of which
|
||||
version has been installed on the machine. This should keep things
|
||||
working as long as the configuration file format remains compatible.
|
||||
335
doc/tools/asciidoc/asciidoc.conf
Normal file
335
doc/tools/asciidoc/asciidoc.conf
Normal file
|
|
@ -0,0 +1,335 @@
|
|||
#
|
||||
# asciidoc.conf
|
||||
#
|
||||
# Asciidoc global configuration file.
|
||||
# Contains backend independent configuration settings that are applied to all
|
||||
# AsciiDoc documents.
|
||||
#
|
||||
|
||||
[miscellaneous]
|
||||
tabsize=8
|
||||
textwidth=70
|
||||
newline=\r\n
|
||||
|
||||
[attributes]
|
||||
iconsdir=./images/icons
|
||||
encoding=UTF-8
|
||||
quirks=
|
||||
empty=
|
||||
amp=&
|
||||
lt=<
|
||||
gt=>
|
||||
brvbar=|
|
||||
nbsp= 
|
||||
backslash=\
|
||||
# Attribute and AttributeList element patterns.
|
||||
attributeentry-pattern=^:(?P<attrname>[a-zA-Z].*?):(?P<attrvalue>.*)$
|
||||
attributelist-pattern=(?u)(^\[\[(?P<id>[\w\-_]+)\]\]$)|(^\[(?P<attrlist>.*)\]$)
|
||||
|
||||
[titles]
|
||||
subs=specialcharacters,quotes,replacements,macros,attributes
|
||||
# Double-line title pattern and underlines.
|
||||
sectiontitle=^(?P<title>.*?)$
|
||||
underlines="==","--","~~","^^","++"
|
||||
# Single-line title patterns.
|
||||
sect0=^= (?P<title>[\S].*)$
|
||||
sect1=^== (?P<title>[\S].*)$
|
||||
sect2=^=== (?P<title>[\S].*)$
|
||||
sect3=^==== (?P<title>[\S].*)$
|
||||
sect4=^===== (?P<title>[\S].*)$
|
||||
blocktitle=^\.(?P<title>\S.*)$
|
||||
|
||||
[specialcharacters]
|
||||
&=&
|
||||
<=<
|
||||
>=>
|
||||
|
||||
[quotes]
|
||||
# Don't use "double-quote" characters -- they interfere with quoted element
|
||||
# attribute values (see ``alternative'' below).
|
||||
*=strong
|
||||
'=emphasis
|
||||
`=monospaced
|
||||
``|''=quoted
|
||||
\##|##=unquoted
|
||||
|
||||
[specialwords]
|
||||
emphasizedwords=
|
||||
strongwords=
|
||||
monospacedwords=
|
||||
|
||||
[tags]
|
||||
# $$ inline passthrough.
|
||||
passthrough=|
|
||||
|
||||
[replacements]
|
||||
# Replacements performed in order of configuration file entry. The first entry
|
||||
# of each replacement pair performs the (non-escaped) replacement, the second
|
||||
# strips the backslash from the esaped replacement.
|
||||
|
||||
# (C) Copyright (entity reference ©)
|
||||
(?<!\\)\(C\)=©
|
||||
\\\(C\)=(C)
|
||||
|
||||
# (R) registered trade mark (entity reference ®
|
||||
(?<!\\)\(R\)=®
|
||||
\\\(R\)=(R)
|
||||
|
||||
# (TM) Trademark (entity reference ™)
|
||||
(?<!\\)\(TM\)=™
|
||||
\\\(TM\)=(TM)
|
||||
|
||||
# -- Spaced and unspaced em dashes (entity reference —)
|
||||
# But disallow unspaced in man pages because double-dash option name prefixes
|
||||
# are pervasive.
|
||||
ifndef::doctype-manpage[]
|
||||
(^|[^-\\])--($|[^-])=\1—\2
|
||||
endif::doctype-manpage[]
|
||||
ifdef::doctype-manpage[]
|
||||
(^|\s*[^\S\\])--($|\s+)=\1—\2
|
||||
endif::doctype-manpage[]
|
||||
\\--(?!-)=--
|
||||
|
||||
# ... Ellipsis (entity reference …)
|
||||
(?<!\\)\.\.\.=…
|
||||
\\\.\.\.=...
|
||||
|
||||
##
|
||||
# The following require non-standard embedded fonts in PDF files so are not
|
||||
# enabled.
|
||||
# -> right arrow
|
||||
#->=→
|
||||
# => right double arrow
|
||||
#=>=⇒
|
||||
# <- left arrow
|
||||
#<-=←
|
||||
# <= left double arrow
|
||||
#<\==⇐
|
||||
|
||||
# Paragraphs.
|
||||
[paradef-default]
|
||||
delimiter=(?s)(?P<text>\S.*)
|
||||
template=paragraph
|
||||
posattrs=style
|
||||
verse-style=template="verseparagraph"
|
||||
NOTE-style=template="admonitionparagraph",name="note",caption="Note"
|
||||
TIP-style=template="admonitionparagraph",name="tip",caption="Tip"
|
||||
IMPORTANT-style=template="admonitionparagraph",name="important",caption="Important"
|
||||
WARNING-style=template="admonitionparagraph",name="warning",caption="Warning"
|
||||
CAUTION-style=template="admonitionparagraph",name="caution",caption="Caution"
|
||||
|
||||
[paradef-literal]
|
||||
delimiter=(?s)(?P<text>\s+.*)
|
||||
options=listelement
|
||||
template=literalparagraph
|
||||
subs=verbatim
|
||||
|
||||
[paradef-admonition]
|
||||
delimiter=(?s)^\s*(?P<style>NOTE|TIP|IMPORTANT|WARNING|CAUTION):\s+(?P<text>.+)
|
||||
NOTE-style=template="admonitionparagraph",name="note",caption="Note"
|
||||
TIP-style=template="admonitionparagraph",name="tip",caption="Tip"
|
||||
IMPORTANT-style=template="admonitionparagraph",name="important",caption="Important"
|
||||
WARNING-style=template="admonitionparagraph",name="warning",caption="Warning"
|
||||
CAUTION-style=template="admonitionparagraph",name="caution",caption="Caution"
|
||||
|
||||
[macros]
|
||||
# Inline macros.
|
||||
# Backslash prefix required for escape processing.
|
||||
# (?s) re flag for line spanning.
|
||||
(?su)[\\]?(?P<name>\w(\w|-)*?):(?P<target>\S*?)(\[(?P<attrlist>.*?)\])=
|
||||
# Anchor: [[[id]]]. Bibliographic anchor.
|
||||
(?su)[\\]?\[\[\[(?P<attrlist>[\w][\w-]*?)\]\]\]=anchor3
|
||||
# Anchor: [[id,xreflabel]]
|
||||
(?su)[\\]?\[\[(?P<attrlist>[\w"].*?)\]\]=anchor2
|
||||
# Link: <<id,text>>
|
||||
(?su)[\\]?<<(?P<attrlist>[\w"].*?)>>=xref2
|
||||
# Index term: ++primary,secondar,tertiary++
|
||||
#(?su)(?<!\S)[\\]?\+\+(?P<attrlist>.+?)\+\+(?!\+)=indexterm
|
||||
(?su)(?<!\S)[\\]?\+\+(?P<attrlist>[^+].*?)\+\+(?!\+)=indexterm
|
||||
# Index term: +primary+
|
||||
# Follows ++...++ macro otherwise it will match them.
|
||||
#(?<!\S)[\\]?\+(?P<attrlist>[^\s\+].*?)\+(?!\+)=indexterm2
|
||||
(?<!\S)[\\]?\+(?P<attrlist>[^\s\+][^+].*?)\+(?!\+)=indexterm2
|
||||
# Callout
|
||||
[\\]?<(?P<index>\d+)>=callout
|
||||
|
||||
# Block macros.
|
||||
(?u)^(?P<name>\w(\w|-)*?)::(?P<target>\S*?)(\[(?P<attrlist>.*?)\])$=#
|
||||
^'{4,}$=#ruler
|
||||
^//([^/].*|)$=#comment
|
||||
|
||||
# System macros.
|
||||
# The default macro which is hardwired into asciidoc.
|
||||
#(?u)^(?P<name>\w(\w|-)*?)::(?P<target>\S*?)(\[(?P<attrlist>.*?)\])$=+
|
||||
|
||||
# Delimited blocks.
|
||||
[blockdef-comment]
|
||||
delimiter=^/{4,}
|
||||
options=skip
|
||||
|
||||
[comment-blockmacro]
|
||||
# Outputs nothing.
|
||||
|
||||
[blockdef-sidebar]
|
||||
delimiter=^\*{4,}$
|
||||
template=sidebarblock
|
||||
options=sectionbody
|
||||
|
||||
[blockdef-list]
|
||||
delimiter=^--$
|
||||
template=listblock
|
||||
options=list
|
||||
|
||||
[listblock]
|
||||
|
|
||||
|
||||
[blockdef-passthrough]
|
||||
delimiter=^\+{4,}$
|
||||
template=passthroughblock
|
||||
subs=attributes,macros
|
||||
|
||||
[blockdef-listing]
|
||||
delimiter=^-{4,}$
|
||||
template=listingblock
|
||||
subs=verbatim
|
||||
|
||||
[blockdef-literal]
|
||||
delimiter=^\.{4,}$
|
||||
template=literalblock
|
||||
subs=verbatim
|
||||
posattrs=style
|
||||
verse-style=template="verseblock",subs="normal"
|
||||
|
||||
[blockdef-quote]
|
||||
delimiter=^_{4,}$
|
||||
template=quoteblock
|
||||
options=sectionbody
|
||||
subs=normal
|
||||
posattrs=attribution,citetitle
|
||||
|
||||
[blockdef-example]
|
||||
delimiter=^\={4,}$
|
||||
template=exampleblock
|
||||
options=sectionbody
|
||||
posattrs=style
|
||||
NOTE-style=template="admonitionblock",name="note",caption="Note"
|
||||
TIP-style=template="admonitionblock",name="tip",caption="Tip"
|
||||
IMPORTANT-style=template="admonitionblock",name="important",caption="Important"
|
||||
WARNING-style=template="admonitionblock",name="warning",caption="Warning"
|
||||
CAUTION-style=template="admonitionblock",name="caution",caption="Caution"
|
||||
|
||||
|
||||
# Lists.
|
||||
[listdef-bulleted]
|
||||
type=bulleted
|
||||
delimiter=^\s*- +(?P<text>.+)$
|
||||
listtag=ilist
|
||||
itemtag=ilistitem
|
||||
texttag=ilisttext
|
||||
|
||||
[listdef-bulleted2]
|
||||
type=bulleted
|
||||
delimiter=^\s*\* +(?P<text>.+)$
|
||||
listtag=ilist
|
||||
itemtag=ilistitem
|
||||
texttag=ilisttext
|
||||
|
||||
[listdef-numbered]
|
||||
type=numbered
|
||||
delimiter=^\s*(?P<index>\d*)\. +(?P<text>.+)$
|
||||
listtag=olist
|
||||
itemtag=olistitem
|
||||
texttag=olisttext
|
||||
|
||||
[listdef-numbered2]
|
||||
type=numbered
|
||||
delimiter=^\s*(?P<index>[.a-z])\. +(?P<text>.+)$
|
||||
listtag=olist2
|
||||
itemtag=olistitem
|
||||
texttag=olisttext
|
||||
|
||||
[listdef-vlabeled]
|
||||
type=labeled
|
||||
delimiter=^\s*(?P<label>[\S].*)::$
|
||||
listtag=vlist
|
||||
itemtag=vlistitem
|
||||
texttag=vlisttext
|
||||
entrytag=vlistentry
|
||||
labeltag=vlistterm
|
||||
|
||||
[listdef-vlabeled2]
|
||||
type=labeled
|
||||
delimiter=^\s*(?P<label>[\S].*);;$
|
||||
listtag=vlist
|
||||
itemtag=vlistitem
|
||||
texttag=vlisttext
|
||||
entrytag=vlistentry
|
||||
labeltag=vlistterm
|
||||
|
||||
[listdef-hlabeled]
|
||||
type=labeled
|
||||
delimiter=^\s*(?P<label>[\S].*)::\s+(?P<text>.+)$
|
||||
listtag=hlist
|
||||
itemtag=hlistitem
|
||||
texttag=hlisttext
|
||||
entrytag=hlistentry
|
||||
labeltag=hlistterm
|
||||
|
||||
[listdef-hlabeled2]
|
||||
type=labeled
|
||||
delimiter=^\s*(?P<label>[\S].*);;\s+(?P<text>.+)$
|
||||
listtag=hlist
|
||||
itemtag=hlistitem
|
||||
texttag=hlisttext
|
||||
entrytag=hlistentry
|
||||
labeltag=hlistterm
|
||||
|
||||
|
||||
# Question and Answer list.
|
||||
[listdef-qanda]
|
||||
type=labeled
|
||||
delimiter=^\s*(?P<label>[\S].*)\?\?$
|
||||
listtag=qlist
|
||||
itemtag=qlistitem
|
||||
texttag=qlisttext
|
||||
entrytag=qlistentry
|
||||
labeltag=qlistterm
|
||||
|
||||
# Bibliography list.
|
||||
[listdef-bibliography]
|
||||
type=bulleted
|
||||
delimiter=^\+ +(?P<text>.+)$
|
||||
listtag=blist
|
||||
itemtag=blistitem
|
||||
texttag=blisttext
|
||||
|
||||
# Glossary list.
|
||||
[listdef-glossary]
|
||||
type=labeled
|
||||
delimiter=^(?P<label>[\S].*):-$
|
||||
listtag=glist
|
||||
itemtag=glistitem
|
||||
texttag=glisttext
|
||||
entrytag=glistentry
|
||||
labeltag=glistterm
|
||||
|
||||
# Callout list.
|
||||
[listdef-callout]
|
||||
type=callout
|
||||
delimiter=^<?(?P<index>\d*)> +(?P<text>.+)$
|
||||
listtag=colist
|
||||
itemtag=colistitem
|
||||
texttag=colisttext
|
||||
|
||||
# Tables.
|
||||
[tabledef-default]
|
||||
fillchar=-
|
||||
format=fixed
|
||||
|
||||
[tabledef-csv]
|
||||
fillchar=~
|
||||
format=csv
|
||||
|
||||
[tabledef-dsv]
|
||||
fillchar=_
|
||||
format=dsv
|
||||
589
doc/tools/asciidoc/docbook.conf
Normal file
589
doc/tools/asciidoc/docbook.conf
Normal file
|
|
@ -0,0 +1,589 @@
|
|||
#
|
||||
# docbook.conf
|
||||
#
|
||||
# Asciidoc configuration file.
|
||||
# Default docbook backend.
|
||||
#
|
||||
|
||||
[miscellaneous]
|
||||
outfilesuffix=.xml
|
||||
# Printable page width in pts.
|
||||
pagewidth=380
|
||||
pageunits=pt
|
||||
|
||||
[attributes]
|
||||
basebackend=docbook
|
||||
basebackend-docbook=
|
||||
|
||||
[replacements]
|
||||
# Line break markup is dropped (there is no DocBook line break tag).
|
||||
(?m)^(.*)\s\+$=\1
|
||||
# Superscripts.
|
||||
\^(.+?)\^=<superscript>\1</superscript>
|
||||
# Subscripts.
|
||||
~(.+?)~=<subscript>\1</subscript>
|
||||
|
||||
[ruler-blockmacro]
|
||||
# Only applies to HTML so don't output anything.
|
||||
|
||||
[image-inlinemacro]
|
||||
<inlinemediaobject>
|
||||
<imageobject>
|
||||
<imagedata fileref="{target}"{width? contentwidth="{width}pt"}{height? contentdepth="{height}pt"}/>
|
||||
</imageobject>
|
||||
<textobject><phrase>{1={target}}</phrase></textobject>
|
||||
</inlinemediaobject>
|
||||
|
||||
[image-blockmacro]
|
||||
<figure{id? id="{id}"}><title>{title}</title>
|
||||
{title%}<informalfigure{id? id="{id}"}>
|
||||
<mediaobject>
|
||||
<imageobject>
|
||||
<imagedata fileref="{target}"{width? contentwidth="{width}pt"}{height? contentdepth="{height}pt"}/>
|
||||
</imageobject>
|
||||
<textobject><phrase>{1={target}}</phrase></textobject>
|
||||
</mediaobject>
|
||||
{title#}</figure>
|
||||
{title%}</informalfigure>
|
||||
|
||||
[indexterm-inlinemacro]
|
||||
# Inline index term.
|
||||
# Generate separate index entries for primary, secondary and tertiary
|
||||
# descriptions.
|
||||
# Primary only.
|
||||
{2%}<indexterm>
|
||||
{2%} <primary>{1}</primary>
|
||||
{2%}</indexterm>
|
||||
# Primary and secondary.
|
||||
{2#}{3%}<indexterm>
|
||||
{2#}{3%} <primary>{1}</primary><secondary>{2}</secondary>
|
||||
{2#}{3%}</indexterm>
|
||||
{2#}{3%}<indexterm>
|
||||
{2#}{3%} <primary>{2}</primary>
|
||||
{2#}{3%}</indexterm>
|
||||
# Primary, secondary and tertiary.
|
||||
{3#}<indexterm>
|
||||
<primary>{1}</primary><secondary>{2}</secondary><tertiary>{3}</tertiary>
|
||||
{3#}</indexterm>
|
||||
{3#}<indexterm>
|
||||
<primary>{2}</primary><secondary>{3}</secondary>
|
||||
{3#}</indexterm>
|
||||
{3#}<indexterm>
|
||||
<primary>{3}</primary>
|
||||
{3#}</indexterm>
|
||||
|
||||
[indexterm2-inlinemacro]
|
||||
# Inline index term.
|
||||
# Single entry index term that is visible in the primary text flow.
|
||||
<indexterm>
|
||||
<primary>{1}</primary>
|
||||
</indexterm>
|
||||
{1}
|
||||
|
||||
[footnote-inlinemacro]
|
||||
# Inline footnote.
|
||||
<footnote><simpara>{0}</simpara></footnote>
|
||||
|
||||
[callout-inlinemacro]
|
||||
# Inline callout.
|
||||
<co id="{coid}"/>
|
||||
|
||||
[tags]
|
||||
# Bulleted, numbered and labeled list tags.
|
||||
ilist=<itemizedlist{id? id="{id}"}>{title?<title>{title}</title>}|</itemizedlist>
|
||||
ilistitem=<listitem>|</listitem>
|
||||
ilisttext=<simpara>|</simpara>
|
||||
olist=<orderedlist{id? id="{id}"}>{title?<title>{title}</title>}|</orderedlist>
|
||||
olist2=<orderedlist{id? id="{id}"} numeration="loweralpha">|</orderedlist>
|
||||
olistitem=<listitem>|</listitem>
|
||||
olisttext=<simpara>|</simpara>
|
||||
vlist=<variablelist{id? id="{id}"}>{title?<title>{title}</title>}|</variablelist>
|
||||
vlistentry=<varlistentry>|</varlistentry>
|
||||
vlistterm=<term>|</term>
|
||||
vlisttext=<simpara>|</simpara>
|
||||
vlistitem=<listitem>|</listitem>
|
||||
# Horizontal labeled list (implemented with two column table).
|
||||
# Hardwired column widths to 30%,70% because the current crop of PDF
|
||||
# generators do not auto calculate column widths.
|
||||
hlist=<{title?table}{title!informaltable}{id? id="{id}"} tabstyle="{style=hlabeledlist}" pgwide="0" frame="none" colsep="0" rowsep="0">{title?<title>{title}</title>}<tgroup cols="2"><colspec colwidth="{1=3}*"/><colspec colwidth="{2=7}*"/><tbody valign="top">|</tbody></tgroup><{title?/table}{title!/informaltable}>
|
||||
hlistentry=<row>|</row>
|
||||
hlisttext=<simpara>|</simpara>
|
||||
hlistterm=<entry><simpara>|</simpara></entry>
|
||||
hlistitem=<entry>|</entry>
|
||||
|
||||
# Question and Answer list.
|
||||
qlist=<qandaset{id? id="{id}"}>{title?<title>{title}</title>}|</qandaset>
|
||||
qlistentry=<qandaentry>|</qandaentry>
|
||||
qlistterm=<question><simpara>|</simpara></question>
|
||||
qlistitem=<answer>|</answer>
|
||||
qlisttext=<simpara>|</simpara>
|
||||
# Bibliography list.
|
||||
blist=|
|
||||
blistitem=<bibliomixed>|</bibliomixed>
|
||||
blisttext=<bibliomisc>|</bibliomisc>
|
||||
# Glossary list.
|
||||
glist=|
|
||||
glistentry=<glossentry>|</glossentry>
|
||||
glistterm=<glossterm>|</glossterm>
|
||||
glistitem=<glossdef>|</glossdef>
|
||||
glisttext=<simpara>|</simpara>
|
||||
# Callout list.
|
||||
colist=<calloutlist{id? id="{id}"}>{title?<title>{title}</title>}|</calloutlist>
|
||||
colistitem=<callout arearefs="{coids}">|</callout>
|
||||
colisttext=<simpara>|</simpara>
|
||||
|
||||
# Quoted text
|
||||
emphasis=<emphasis>|</emphasis>
|
||||
strong=<emphasis role="strong">|</emphasis>
|
||||
monospaced=<literal>|</literal>
|
||||
quoted={amp}#8220;|{amp}#8221;
|
||||
unquoted=|
|
||||
|
||||
# $$ inline passthrough.
|
||||
passthrough=|
|
||||
|
||||
# Inline macros
|
||||
[http-inlinemacro]
|
||||
<ulink url="{name}:{target}">{0={name}:{target}}</ulink>
|
||||
[https-inlinemacro]
|
||||
<ulink url="{name}:{target}">{0={name}:{target}}</ulink>
|
||||
[ftp-inlinemacro]
|
||||
<ulink url="{name}:{target}">{0={name}:{target}}</ulink>
|
||||
[file-inlinemacro]
|
||||
<ulink url="{name}:{target}">{0={name}:{target}}</ulink>
|
||||
[mailto-inlinemacro]
|
||||
<ulink url="{name}:{target}">{0={target}}</ulink>
|
||||
#<email>{target}</email>
|
||||
[link-inlinemacro]
|
||||
<ulink url="{target}">{0={target}}</ulink>
|
||||
# anchor:id[text]
|
||||
[anchor-inlinemacro]
|
||||
<anchor id="{target}" xreflabel="{0=[{target}]}"/>
|
||||
# [[id,text]]
|
||||
[anchor2-inlinemacro]
|
||||
<anchor id="{1}" xreflabel="{2=[{1}]}"/>
|
||||
# [[[id]]]
|
||||
[anchor3-inlinemacro]
|
||||
<anchor id="{1}" xreflabel="[{1}]"/>[{1}]
|
||||
# xref:id[text]
|
||||
[xref-inlinemacro]
|
||||
<link linkend="{target}">{0}</link>
|
||||
{2%}<xref linkend="{target}"/>
|
||||
# <<id,text>>
|
||||
[xref2-inlinemacro]
|
||||
<link linkend="{1}">{2}</link>
|
||||
{2%}<xref linkend="{1}"/>
|
||||
|
||||
|
||||
# Special word macros
|
||||
[emphasizedwords]
|
||||
<emphasis>{words}</emphasis>
|
||||
[monospacedwords]
|
||||
<literal>{words}</literal>
|
||||
[strongwords]
|
||||
<emphasis role="strong">{words}</emphasis>
|
||||
|
||||
# Paragraph substitution.
|
||||
[paragraph]
|
||||
<formalpara{id? id="{id}"}><title>{title}</title><para>
|
||||
{title%}<simpara{id? id="{id}"}>
|
||||
|
|
||||
{title%}</simpara>
|
||||
{title#}</para></formalpara>
|
||||
{empty}
|
||||
|
||||
[admonitionparagraph]
|
||||
<{name}{id? id="{id}"}><simpara>|</simpara></{name}>
|
||||
|
||||
[literalparagraph]
|
||||
# The literal block employs the same markup.
|
||||
template::[literalblock]
|
||||
|
||||
[verseparagraph]
|
||||
template::[verseblock]
|
||||
|
||||
# Delimited blocks.
|
||||
[literalblock]
|
||||
<example><title>{title}</title>
|
||||
<literallayout{id? id="{id}"} class="{font=monospaced}">
|
||||
|
|
||||
</literallayout>
|
||||
{title#}</example>
|
||||
|
||||
[listingblock]
|
||||
<example><title>{title}</title>
|
||||
<screen>
|
||||
|
|
||||
</screen>
|
||||
{title#}</example>
|
||||
|
||||
[verseblock]
|
||||
<formalpara{id? id="{id}"}><title>{title}</title><para>
|
||||
{title%}<literallayout{id? id="{id}"}>
|
||||
{title#}<literallayout>
|
||||
|
|
||||
</literallayout>
|
||||
{title#}</para></formalpara>
|
||||
|
||||
[sidebarblock]
|
||||
<sidebar{id? id="{id}"}>
|
||||
<title>{title}</title>
|
||||
|
|
||||
</sidebar>
|
||||
|
||||
[passthroughblock]
|
||||
|
|
||||
|
||||
[quoteblock]
|
||||
# The epigraph element may be more appropriate than blockquote.
|
||||
<blockquote{id? id="{id}"}>
|
||||
<title>{title}</title>
|
||||
<attribution>
|
||||
{attribution}
|
||||
<citetitle>{citetitle}</citetitle>
|
||||
</attribution>
|
||||
|
|
||||
</blockquote>
|
||||
|
||||
[exampleblock]
|
||||
<{title?example}{title!informalexample}{id? id="{id}"}>
|
||||
<title>{title}</title>
|
||||
|
|
||||
</{title?example}{title!informalexample}>
|
||||
|
||||
[admonitionblock]
|
||||
<{name}{id? id="{id}"}>
|
||||
<title>{title}</title>
|
||||
|
|
||||
</{name}>
|
||||
|
||||
# Tables.
|
||||
[tabledef-default]
|
||||
template=table
|
||||
colspec=<colspec colwidth="{colwidth}{pageunits}" align="{colalign}"/>
|
||||
bodyrow=<row>|</row>
|
||||
bodydata=<entry>|</entry>
|
||||
|
||||
[table]
|
||||
<{title?table}{title!informaltable}{id? id="{id}"} pgwide="0"
|
||||
frame="{frame=topbot}"
|
||||
{grid%rowsep="0" colsep="0"}
|
||||
rowsep="{grid@none|cols:0:1}" colsep="{grid@none|rows:0:1}"
|
||||
>
|
||||
<title>{title}</title>
|
||||
<tgroup cols="{cols}">
|
||||
{colspecs}
|
||||
{headrows#}<thead>
|
||||
{headrows}
|
||||
{headrows#}</thead>
|
||||
{footrows#}<tfoot>
|
||||
{footrows}
|
||||
{footrows#}</tfoot>
|
||||
<tbody>
|
||||
{bodyrows}
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</{title?table}{title!informaltable}>
|
||||
|
||||
[specialsections]
|
||||
ifdef::doctype-article[]
|
||||
^Abstract$=sect-abstract
|
||||
endif::doctype-article[]
|
||||
|
||||
ifdef::doctype-book[]
|
||||
^Colophon$=sect-colophon
|
||||
^Dedication$=sect-dedication
|
||||
^Preface$=sect-preface
|
||||
endif::doctype-book[]
|
||||
|
||||
^Index$=sect-index
|
||||
^(Bibliography|References)$=sect-bibliography
|
||||
^Glossary$=sect-glossary
|
||||
^Appendix [A-Z][:.](?P<title>.*)$=sect-appendix
|
||||
|
||||
# Special sections.
|
||||
[sect-preface]
|
||||
<preface{id? id="{id}"}>
|
||||
<title>{title}</title>
|
||||
|
|
||||
</preface>
|
||||
|
||||
[sect-index]
|
||||
<index{id? id="{id}"}>
|
||||
<title>{title}</title>
|
||||
|
|
||||
</index>
|
||||
|
||||
[sect-bibliography]
|
||||
<bibliography{id? id="{id}"}>
|
||||
<title>{title}</title>
|
||||
|
|
||||
</bibliography>
|
||||
|
||||
[sect-glossary]
|
||||
<glossary{id? id="{id}"}>
|
||||
<title>{title}</title>
|
||||
|
|
||||
</glossary>
|
||||
|
||||
[sect-appendix]
|
||||
<appendix{id? id="{id}"}>
|
||||
<title>{title}</title>
|
||||
|
|
||||
</appendix>
|
||||
|
||||
|
||||
[header-declarations]
|
||||
<?xml version="1.0" encoding="{encoding}"?>
|
||||
<!DOCTYPE {doctype-article?article}{doctype-book?book}{doctype-manpage?refentry} PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
|
||||
|
||||
#-------------------------
|
||||
# article document type
|
||||
#-------------------------
|
||||
ifdef::doctype-article[]
|
||||
|
||||
[header]
|
||||
template::[header-declarations]
|
||||
|
||||
<article lang="en">
|
||||
{doctitle#}<articleinfo>
|
||||
<title>{doctitle}</title>
|
||||
<date>{date}</date>
|
||||
{authored#}<author>
|
||||
<firstname>{firstname}</firstname>
|
||||
<othername>{middlename}</othername>
|
||||
<surname>{lastname}</surname>
|
||||
<affiliation><address><email>{email}</email></address></affiliation>
|
||||
{authored#}</author>
|
||||
<authorinitials>{authorinitials}</authorinitials>
|
||||
|
||||
# If file named like source document with -revhistory.xml suffix exists
|
||||
# include it as the document history, otherwise use current revision.
|
||||
{revisionhistory#}{include:{docdir}/{docname}-revhistory.xml}
|
||||
{revisionhistory%}<revhistory><revision><revnumber>{revision}</revnumber><date>{date}</date>{authorinitials?<authorinitials>{authorinitials}</authorinitials>}{revremark?<revremark>{revremark}</revremark>}</revision></revhistory>
|
||||
|
||||
<corpname>{companyname}</corpname>
|
||||
{doctitle#}</articleinfo>
|
||||
|
||||
[footer]
|
||||
</article>
|
||||
|
||||
[preamble]
|
||||
# Untitled elements between header and first section title.
|
||||
|
|
||||
|
||||
[sect-abstract]
|
||||
<abstract{id? id="{id}"}>
|
||||
|
|
||||
</abstract>
|
||||
|
||||
[sect1]
|
||||
<section{id? id="{id}"}>
|
||||
<title>{title}</title>
|
||||
|
|
||||
</section>
|
||||
|
||||
[sect2]
|
||||
<section{id? id="{id}"}>
|
||||
<title>{title}</title>
|
||||
|
|
||||
</section>
|
||||
|
||||
[sect3]
|
||||
<section{id? id="{id}"}>
|
||||
<title>{title}</title>
|
||||
|
|
||||
</section>
|
||||
|
||||
[sect4]
|
||||
<section{id? id="{id}"}>
|
||||
<title>{title}</title>
|
||||
|
|
||||
</section>
|
||||
|
||||
endif::doctype-article[]
|
||||
|
||||
#-------------------------
|
||||
# manpage document type
|
||||
#-------------------------
|
||||
ifdef::doctype-manpage[]
|
||||
|
||||
[replacements]
|
||||
# The roff format does not substitute special characters so just print them as
|
||||
# text.
|
||||
\(C\)=(C)
|
||||
\(TM\)=(TM)
|
||||
|
||||
[header]
|
||||
template::[header-declarations]
|
||||
<refentry>
|
||||
<refmeta>
|
||||
<refentrytitle>{mantitle}</refentrytitle>
|
||||
<manvolnum>{manvolnum}</manvolnum>
|
||||
</refmeta>
|
||||
<refnamediv>
|
||||
<refname>{manname}</refname>
|
||||
<refpurpose>{manpurpose}</refpurpose>
|
||||
</refnamediv>
|
||||
|
||||
[footer]
|
||||
</refentry>
|
||||
|
||||
# Section macros
|
||||
[sect-synopsis]
|
||||
<refsynopsisdiv{id? id="{id}"}>
|
||||
|
|
||||
</refsynopsisdiv>
|
||||
|
||||
[sect1]
|
||||
<refsect1{id? id="{id}"}>
|
||||
<title>{title}</title>
|
||||
|
|
||||
</refsect1>
|
||||
|
||||
[sect2]
|
||||
<refsect2{id? id="{id}"}>
|
||||
<title>{title}</title>
|
||||
|
|
||||
</refsect2>
|
||||
|
||||
[sect3]
|
||||
<refsect3{id? id="{id}"}>
|
||||
<title>{title}</title>
|
||||
|
|
||||
</refsect3>
|
||||
|
||||
endif::doctype-manpage[]
|
||||
|
||||
#-------------------------
|
||||
# book document type
|
||||
#-------------------------
|
||||
ifdef::doctype-book[]
|
||||
|
||||
[header]
|
||||
template::[header-declarations]
|
||||
|
||||
<book lang="en">
|
||||
{doctitle#}<bookinfo>
|
||||
<title>{doctitle}</title>
|
||||
<date>{date}</date>
|
||||
{authored#}<author>
|
||||
<firstname>{firstname}</firstname>
|
||||
<othername>{middlename}</othername>
|
||||
<surname>{lastname}</surname>
|
||||
<affiliation><address><email>{email}</email></address></affiliation>
|
||||
{authored#}</author>
|
||||
<authorinitials>{authorinitials}</authorinitials>
|
||||
|
||||
# If file named like source document with -revhistory.xml suffix exists
|
||||
# include it as the document history, otherwise use current revision.
|
||||
{revisionhistory#}{include:{docdir}/{docname}-revhistory.xml}
|
||||
{revisionhistory%}<revhistory><revision><revnumber>{revision}</revnumber><date>{date}</date>{authorinitials?<authorinitials>{authorinitials}</authorinitials>}{revremark?<revremark>{revremark}</revremark>}</revision></revhistory>
|
||||
|
||||
<corpname>{companyname}</corpname>
|
||||
{doctitle#}</bookinfo>
|
||||
|
||||
[footer]
|
||||
</book>
|
||||
|
||||
[preamble]
|
||||
# Preamble is not allowed in DocBook book so wrap it in a preface.
|
||||
<preface{id? id="{id}"}>
|
||||
<title>Preface</title>
|
||||
|
|
||||
</preface>
|
||||
|
||||
[sect-dedication]
|
||||
<dedication{id? id="{id}"}>
|
||||
|
|
||||
</dedication>
|
||||
|
||||
[sect-colophon]
|
||||
<colophon{id? id="{id}"}>
|
||||
|
|
||||
</colophon>
|
||||
|
||||
[sect0]
|
||||
<part{id? id="{id}"}>
|
||||
<title>{title}</title>
|
||||
|
|
||||
</part>
|
||||
|
||||
[sect1]
|
||||
<chapter{id? id="{id}"}>
|
||||
<title>{title}</title>
|
||||
|
|
||||
</chapter>
|
||||
|
||||
[sect2]
|
||||
<section{id? id="{id}"}>
|
||||
<title>{title}</title>
|
||||
|
|
||||
</section>
|
||||
|
||||
[sect3]
|
||||
<section{id? id="{id}"}>
|
||||
<title>{title}</title>
|
||||
|
|
||||
</section>
|
||||
|
||||
[sect4]
|
||||
<section{id? id="{id}"}>
|
||||
<title>{title}</title>
|
||||
|
|
||||
</section>
|
||||
|
||||
endif::doctype-book[]
|
||||
|
||||
ifdef::sgml[]
|
||||
#
|
||||
# Optional DocBook SGML.
|
||||
#
|
||||
# Most of the differences between DocBook XML and DocBook SGML boils
|
||||
# down to the empty element syntax: SGML does not like the XML empty
|
||||
# element <.../> syntax, use <...> instead.
|
||||
#
|
||||
[miscellaneous]
|
||||
outfilesuffix=.sgml
|
||||
|
||||
[header-declarations]
|
||||
<!DOCTYPE {doctype-article?article}{doctype-book?book}{doctype-manpage?refentry} PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
|
||||
|
||||
[tabledef-default]
|
||||
colspec=<colspec colwidth="{colwidth}{pageunits}" align="{colalign}">
|
||||
|
||||
[image-inlinemacro]
|
||||
<inlinemediaobject>
|
||||
<imageobject>
|
||||
<imagedata fileref="{target}"{width? width="{width}pt"}{height? depth="{height}pt"}>
|
||||
</imageobject>
|
||||
<textobject><phrase>{1={target}}</phrase></textobject>
|
||||
</inlinemediaobject>
|
||||
|
||||
[image-blockmacro]
|
||||
<figure><title>{title}</title>
|
||||
{title%}<informalfigure>
|
||||
<mediaobject>
|
||||
<imageobject>
|
||||
<imagedata fileref="{target}"{width? width="{width}pt"}{height? depth="{height}pt"}>
|
||||
</imageobject>
|
||||
<textobject><phrase>{1={target}}</phrase></textobject>
|
||||
</mediaobject>
|
||||
{title#}</figure>
|
||||
{title%}</informalfigure>
|
||||
|
||||
# Inline macros
|
||||
[xref-inlinemacro]
|
||||
<link linkend="{target}">{0}</link>
|
||||
{2%}<xref linkend="{target}">
|
||||
[xref2-inlinemacro]
|
||||
# <<id,text>>
|
||||
<link linkend="{1}">{2}</link>
|
||||
{2%}<xref linkend="{1}">
|
||||
[anchor-inlinemacro]
|
||||
<anchor id="{target}" xreflabel="{0=[{target}]}">
|
||||
[anchor2-inlinemacro]
|
||||
# [[id,text]]
|
||||
<anchor id="{1}" xreflabel="{2=[{1}]}">
|
||||
|
||||
endif::sgml[]
|
||||
28
doc/tools/asciidoc/stylesheets/xhtml11-quirks.css
Normal file
28
doc/tools/asciidoc/stylesheets/xhtml11-quirks.css
Normal file
|
|
@ -0,0 +1,28 @@
|
|||
/* Workarounds for IE6's broken and incomplete CSS2. */
|
||||
|
||||
div.sidebar-content {
|
||||
background: #ffffee;
|
||||
border: 1px solid silver;
|
||||
padding: 0.5em;
|
||||
}
|
||||
div.sidebar-title, div.image-title {
|
||||
font-family: sans-serif;
|
||||
font-weight: bold;
|
||||
margin-top: 0.0em;
|
||||
margin-bottom: 0.5em;
|
||||
}
|
||||
|
||||
div.listingblock div.content {
|
||||
border: 1px solid silver;
|
||||
background: #f4f4f4;
|
||||
padding: 0.5em;
|
||||
}
|
||||
|
||||
div.quoteblock-content {
|
||||
padding-left: 2.0em;
|
||||
}
|
||||
|
||||
div.exampleblock-content {
|
||||
border-left: 2px solid silver;
|
||||
padding-left: 0.5em;
|
||||
}
|
||||
229
doc/tools/asciidoc/stylesheets/xhtml11.css
Normal file
229
doc/tools/asciidoc/stylesheets/xhtml11.css
Normal file
|
|
@ -0,0 +1,229 @@
|
|||
/* Debug borders */
|
||||
p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
|
||||
/*
|
||||
border: 1px solid red;
|
||||
*/
|
||||
}
|
||||
|
||||
body {
|
||||
margin: 1em 5% 1em 5%;
|
||||
}
|
||||
|
||||
a {
|
||||
color: blue;
|
||||
text-decoration: underline;
|
||||
}
|
||||
a:visited {
|
||||
color: fuchsia;
|
||||
}
|
||||
|
||||
em {
|
||||
font-style: italic;
|
||||
}
|
||||
|
||||
strong {
|
||||
font-weight: bold;
|
||||
}
|
||||
|
||||
tt {
|
||||
color: navy;
|
||||
}
|
||||
|
||||
h1, h2, h3, h4, h5, h6 {
|
||||
color: #527bbd;
|
||||
font-family: sans-serif;
|
||||
margin-top: 1.2em;
|
||||
margin-bottom: 0.5em;
|
||||
line-height: 1.3;
|
||||
}
|
||||
|
||||
h1 {
|
||||
border-bottom: 2px solid silver;
|
||||
}
|
||||
h2 {
|
||||
border-bottom: 2px solid silver;
|
||||
padding-top: 0.5em;
|
||||
}
|
||||
|
||||
div.sectionbody {
|
||||
font-family: serif;
|
||||
margin-left: 0;
|
||||
}
|
||||
|
||||
hr {
|
||||
border: 1px solid silver;
|
||||
}
|
||||
|
||||
p {
|
||||
margin-top: 0.5em;
|
||||
margin-bottom: 0.5em;
|
||||
}
|
||||
|
||||
pre {
|
||||
padding: 0;
|
||||
margin: 0;
|
||||
}
|
||||
|
||||
span#author {
|
||||
color: #527bbd;
|
||||
font-family: sans-serif;
|
||||
font-weight: bold;
|
||||
font-size: 1.2em;
|
||||
}
|
||||
span#email {
|
||||
}
|
||||
span#revision {
|
||||
font-family: sans-serif;
|
||||
}
|
||||
|
||||
div#footer {
|
||||
font-family: sans-serif;
|
||||
font-size: small;
|
||||
border-top: 2px solid silver;
|
||||
padding-top: 0.5em;
|
||||
margin-top: 4.0em;
|
||||
}
|
||||
div#footer-text {
|
||||
float: left;
|
||||
padding-bottom: 0.5em;
|
||||
}
|
||||
div#footer-badges {
|
||||
float: right;
|
||||
padding-bottom: 0.5em;
|
||||
}
|
||||
|
||||
div#preamble,
|
||||
div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
|
||||
div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
|
||||
div.admonitionblock {
|
||||
margin-right: 10%;
|
||||
margin-top: 1.5em;
|
||||
margin-bottom: 1.5em;
|
||||
}
|
||||
div.admonitionblock {
|
||||
margin-top: 2.5em;
|
||||
margin-bottom: 2.5em;
|
||||
}
|
||||
|
||||
div.content { /* Block element content. */
|
||||
padding: 0;
|
||||
}
|
||||
|
||||
/* Block element titles. */
|
||||
div.title, caption.title {
|
||||
font-family: sans-serif;
|
||||
font-weight: bold;
|
||||
text-align: left;
|
||||
margin-top: 1.0em;
|
||||
margin-bottom: 0.5em;
|
||||
}
|
||||
div.title + * {
|
||||
margin-top: 0;
|
||||
}
|
||||
|
||||
td div.title:first-child {
|
||||
margin-top: 0.0em;
|
||||
}
|
||||
div.content div.title:first-child {
|
||||
margin-top: 0.0em;
|
||||
}
|
||||
div.content + div.title {
|
||||
margin-top: 0.0em;
|
||||
}
|
||||
|
||||
div.sidebarblock > div.content {
|
||||
background: #ffffee;
|
||||
border: 1px solid silver;
|
||||
padding: 0.5em;
|
||||
}
|
||||
|
||||
div.listingblock > div.content {
|
||||
border: 1px solid silver;
|
||||
background: #f4f4f4;
|
||||
padding: 0.5em;
|
||||
}
|
||||
|
||||
div.quoteblock > div.content {
|
||||
padding-left: 2.0em;
|
||||
}
|
||||
|
||||
div.attribution {
|
||||
text-align: right;
|
||||
}
|
||||
div.verseblock + div.attribution {
|
||||
text-align: left;
|
||||
}
|
||||
|
||||
div.admonitionblock .icon {
|
||||
vertical-align: top;
|
||||
font-size: 1.1em;
|
||||
font-weight: bold;
|
||||
text-decoration: underline;
|
||||
color: #527bbd;
|
||||
padding-right: 0.5em;
|
||||
}
|
||||
div.admonitionblock td.content {
|
||||
padding-left: 0.5em;
|
||||
border-left: 2px solid silver;
|
||||
}
|
||||
|
||||
div.exampleblock > div.content {
|
||||
border-left: 2px solid silver;
|
||||
padding: 0.5em;
|
||||
}
|
||||
|
||||
div.verseblock div.content {
|
||||
white-space: pre;
|
||||
}
|
||||
|
||||
div.imageblock div.content { padding-left: 0; }
|
||||
div.imageblock img { border: 1px solid silver; }
|
||||
span.image img { border-style: none; }
|
||||
|
||||
dl {
|
||||
margin-top: 0.8em;
|
||||
margin-bottom: 0.8em;
|
||||
}
|
||||
dt {
|
||||
margin-top: 0.5em;
|
||||
margin-bottom: 0;
|
||||
font-style: italic;
|
||||
}
|
||||
dd > *:first-child {
|
||||
margin-top: 0;
|
||||
}
|
||||
|
||||
ul, ol {
|
||||
list-style-position: outside;
|
||||
}
|
||||
ol.olist2 {
|
||||
list-style-type: lower-alpha;
|
||||
}
|
||||
|
||||
div.tableblock > table {
|
||||
border: 3px solid #527bbd;
|
||||
}
|
||||
thead {
|
||||
font-family: sans-serif;
|
||||
font-weight: bold;
|
||||
}
|
||||
tfoot {
|
||||
font-weight: bold;
|
||||
}
|
||||
|
||||
div.hlist {
|
||||
margin-top: 0.8em;
|
||||
margin-bottom: 0.8em;
|
||||
}
|
||||
td.hlist1 {
|
||||
vertical-align: top;
|
||||
font-style: italic;
|
||||
padding-right: 0.8em;
|
||||
}
|
||||
td.hlist2 {
|
||||
vertical-align: top;
|
||||
}
|
||||
|
||||
@media print {
|
||||
div#footer-badges { display: none; }
|
||||
}
|
||||
43
doc/tools/asciidoc/xhtml11-quirks.conf
Normal file
43
doc/tools/asciidoc/xhtml11-quirks.conf
Normal file
|
|
@ -0,0 +1,43 @@
|
|||
#
|
||||
# xhtml11-quirks.conf
|
||||
#
|
||||
# Workarounds for IE6's broken # and incomplete CSS2.
|
||||
#
|
||||
|
||||
[image-blockmacro]
|
||||
<div class="imageblock">
|
||||
<a id="{id}"></a>
|
||||
<div class="content">
|
||||
<a class="image" href="{link}">
|
||||
<img src="{target}" alt="{1={target}}"{1? title="{1}"}{width? width="{width}"}{height? height="{height}"}/>
|
||||
{link#}</a>
|
||||
</div>
|
||||
<div class="image-title">{caption=Figure: }{title}</div>
|
||||
</div>
|
||||
|
||||
[sidebarblock]
|
||||
<div class="sidebarblock">
|
||||
<a id="{id}"></a>
|
||||
<div class="sidebar-content">
|
||||
<div class="sidebar-title">{title}</div>
|
||||
|
|
||||
</div></div>
|
||||
|
||||
[quoteblock]
|
||||
<div class="quoteblock">
|
||||
<a id="{id}"></a>
|
||||
<div class="title">{title}</div>
|
||||
<div class="quoteblock-content">
|
||||
|
|
||||
<div class="attribution">
|
||||
<span class="emphasis">{citetitle}</span><br />
|
||||
— {attribution}
|
||||
</div></div></div>
|
||||
|
||||
[exampleblock]
|
||||
<div class="exampleblock">
|
||||
<a id="{id}"></a>
|
||||
<div class="title">{caption=Example: }{title}</div>
|
||||
<div class="exampleblock-content">
|
||||
|
|
||||
</div></div>
|
||||
426
doc/tools/asciidoc/xhtml11.conf
Normal file
426
doc/tools/asciidoc/xhtml11.conf
Normal file
|
|
@ -0,0 +1,426 @@
|
|||
#
|
||||
# xhtml11.conf
|
||||
#
|
||||
# Asciidoc configuration file.
|
||||
# xhtml11 backend, generates XHTML 1.1 conformant markup.
|
||||
#
|
||||
[miscellaneous]
|
||||
outfilesuffix=.html
|
||||
# Screen width in pixels.
|
||||
pagewidth=800
|
||||
pageunits=
|
||||
|
||||
[attributes]
|
||||
basebackend=html
|
||||
basebackend-html=
|
||||
|
||||
[replacements]
|
||||
# Line break.
|
||||
(?m)^(.*)\s\+$=\1<br />
|
||||
# Superscripts.
|
||||
\^(.+?)\^=<sup>\1</sup>
|
||||
# Subscripts.
|
||||
~(.+?)~=<sub>\1</sub>
|
||||
# Escape ASCIIMathML delimiters.
|
||||
ifdef::asciimath[]
|
||||
\$=\$
|
||||
`=\`
|
||||
endif::asciimath[]
|
||||
|
||||
[ruler-blockmacro]
|
||||
<hr />
|
||||
|
||||
[image-inlinemacro]
|
||||
<span class="image">
|
||||
<a class="image" href="{link}">
|
||||
<img src="{target}" alt="{1={target}}"{1? title="{1}"}{width? width="{width}"}{height? height="{height}"}/>
|
||||
{link#}</a>
|
||||
</span>
|
||||
|
||||
[image-blockmacro]
|
||||
<div class="imageblock">
|
||||
<a id="{id}"></a>
|
||||
<div class="content">
|
||||
<a class="image" href="{link}">
|
||||
<img src="{target}" alt="{1={target}}"{1? title="{1}"}{width? width="{width}"}{height? height="{height}"}/>
|
||||
{link#}</a>
|
||||
</div>
|
||||
<div class="title">{caption=Figure: }{title}</div>
|
||||
</div>
|
||||
|
||||
[indexterm-inlinemacro]
|
||||
# Inline index term.
|
||||
{empty}
|
||||
|
||||
[indexterm2-inlinemacro]
|
||||
# Inline index term.
|
||||
# Single entry index term that is visible in the primary text flow.
|
||||
{1}
|
||||
|
||||
[footnote-inlinemacro]
|
||||
# Inline footnote.
|
||||
<br />[{0}]<br />
|
||||
|
||||
[callout-inlinemacro]
|
||||
# Inline callout.
|
||||
<b>({index})</b>
|
||||
|
||||
[tags]
|
||||
# Bulleted, numbered and labeled list tags.
|
||||
ilist={id?<a id="{id}"></a>}{title?<div class="title">{title}</div>}<ul>|</ul>
|
||||
ilistitem=<li>|</li>
|
||||
ilisttext=<p>|</p>
|
||||
olist={id?<a id="{id}"></a>}{title?<div class="title">{title}</div>}<ol>|</ol>
|
||||
olist2={id?<a id="{id}"></a>}<ol class="olist2">|</ol>
|
||||
olistitem=<li>|</li>
|
||||
olisttext=<p>|</p>
|
||||
vlist={id?<a id="{id}"></a>}{title?<div class="title">{title}</div>}<dl>|</dl>
|
||||
vlistentry=|
|
||||
vlistterm=<dt>|</dt>
|
||||
vlistitem=<dd>|</dd>
|
||||
vlisttext=<p>|</p>
|
||||
# Horizontal labeled list.
|
||||
hlist=<div class="hlist">{id?<a id="{id}"></a>}{title?<div class="title">{title}</div>}<table>{1?<col width="{1}%" />}{2?<col width="{2}%" />}|</table></div>
|
||||
hlistentry=<tr>|</tr>
|
||||
hlistterm=<td class="hlist1">|</td>
|
||||
hlistitem=<td class="hlist2">|</td>
|
||||
hlisttext=|
|
||||
# Question and Answer list.
|
||||
qlist={id?<a id="{id}"></a>}{title?<div class="title">{title}</div>}<ol>|</ol>
|
||||
qlistentry=<li>|</li>
|
||||
qlistterm=<p><strong>|</strong></p>
|
||||
qlistitem=|
|
||||
qlisttext=<p>|</p>
|
||||
# Callout list.
|
||||
colist={id?<a id="{id}"></a>}{title?<div class="title">{title}</div>}<ol>|</ol>
|
||||
colistitem=<li>|</li>
|
||||
colisttext=<p>|</p>
|
||||
|
||||
# Quoted text.
|
||||
emphasis=<em{0? style="}{1?color: {1};}{2?background-color: {2};}{3?font-size: {3}em;}{0?"}>|</em>
|
||||
strong=<strong{0? style="}{1?color: {1};}{2?background-color: {2};}{3?font-size: {3}em;}{0?"}>|</strong>
|
||||
monospaced=<tt{0? style="}{1?color: {1};}{2?background-color: {2};}{3?font-size: {3}em;}{0?"}>|</tt>
|
||||
quoted={0?<span style="}{1?color: {1};}{2?background-color: {2};}{3?font-size: {3}em;}{0?">}{amp}#8220;|{amp}#8221;{0?</span>}
|
||||
unquoted={0?<span style="}{1?color: {1};}{2?background-color: {2};}{3?font-size: {3}em;}{0?">}|{0?</span>}
|
||||
|
||||
# $$ inline passthrough.
|
||||
$$passthrough=<span{0? style="}{1?color: {1};}{2?background-color: {2};}{3?font-size: {3}em;}{0?"}>|</span>
|
||||
|
||||
# Inline macros
|
||||
[http-inlinemacro]
|
||||
<a href="{name}:{target}">{0={name}:{target}}</a>
|
||||
[https-inlinemacro]
|
||||
<a href="{name}:{target}">{0={name}:{target}}</a>
|
||||
[ftp-inlinemacro]
|
||||
<a href="{name}:{target}">{0={name}:{target}}</a>
|
||||
[file-inlinemacro]
|
||||
<a href="{name}:{target}">{0={name}:{target}}</a>
|
||||
[mailto-inlinemacro]
|
||||
<a href="{name}:{target}">{0={target}}</a>
|
||||
[link-inlinemacro]
|
||||
<a href="{target}">{0={target}}</a>
|
||||
# anchor:id[text]
|
||||
[anchor-inlinemacro]
|
||||
<a id="{target}"></a>
|
||||
# [[id,text]]
|
||||
[anchor2-inlinemacro]
|
||||
<a id="{1}"></a>
|
||||
# [[[id]]]
|
||||
[anchor3-inlinemacro]
|
||||
<a id="{1}">[{1}]</a>
|
||||
# xref:id[text]
|
||||
[xref-inlinemacro]
|
||||
<a href="#{target}">{0=[{target}]}</a>
|
||||
# <<id,text>>
|
||||
[xref2-inlinemacro]
|
||||
<a href="#{1}">{2=[{1}]}</a>
|
||||
|
||||
# Special word substitution.
|
||||
[emphasizedwords]
|
||||
<em>{words}</em>
|
||||
[monospacedwords]
|
||||
<tt>{words}</tt>
|
||||
[strongwords]
|
||||
<strong>{words}</strong>
|
||||
|
||||
# Paragraph substitution.
|
||||
[paragraph]
|
||||
<div class="title">{title}</div>
|
||||
<p>{id?<a id="{id}"></a>}
|
||||
|
|
||||
</p>
|
||||
|
||||
[literalparagraph]
|
||||
# The literal block employs the same markup.
|
||||
template::[literalblock]
|
||||
|
||||
[verseparagraph]
|
||||
# The verse block employs the same markup.
|
||||
template::[verseblock]
|
||||
|
||||
[admonitionparagraph]
|
||||
# The admonition block employs the same markup.
|
||||
template::[admonitionblock]
|
||||
|
||||
# Delimited blocks.
|
||||
[passthroughblock]
|
||||
|
|
||||
|
||||
[listingblock]
|
||||
<div class="listingblock">
|
||||
<a id="{id}"></a>
|
||||
<div class="title">{caption=Example: }{title}</div>
|
||||
<div class="content">
|
||||
<pre><tt>
|
||||
|
|
||||
</tt></pre>
|
||||
</div></div>
|
||||
|
||||
[literalblock]
|
||||
<div class="literalblock">
|
||||
<a id="{id}"></a>
|
||||
<div class="title">{title}</div>
|
||||
<div class="content">
|
||||
{style#}<pre class="{style}"><span>
|
||||
{style%}<pre><tt>
|
||||
|
|
||||
</tt></pre>
|
||||
</div></div>
|
||||
|
||||
[verseblock]
|
||||
<div class="verseblock">
|
||||
<a id="{id}"></a>
|
||||
<div class="title">{title}</div>
|
||||
<div class="content">
|
||||
|
|
||||
</div></div>
|
||||
|
||||
[sidebarblock]
|
||||
<div class="sidebarblock">
|
||||
<a id="{id}"></a>
|
||||
<div class="content">
|
||||
<div class="title">{title}</div>
|
||||
|
|
||||
</div></div>
|
||||
|
||||
[quoteblock]
|
||||
<div class="quoteblock">
|
||||
<a id="{id}"></a>
|
||||
<div class="title">{title}</div>
|
||||
<div class="content">
|
||||
|
|
||||
<div class="attribution">
|
||||
<em>{citetitle}</em><br />
|
||||
— {attribution}
|
||||
</div></div></div>
|
||||
|
||||
[exampleblock]
|
||||
<div class="exampleblock">
|
||||
<a id="{id}"></a>
|
||||
<div class="title">{caption=Example: }{title}</div>
|
||||
<div class="content">
|
||||
|
|
||||
</div></div>
|
||||
|
||||
[admonitionblock]
|
||||
<div class="admonitionblock">
|
||||
<a id="{id}"></a>
|
||||
<table><tr>
|
||||
<td class="icon">
|
||||
{icons#}<img src="{icon={iconsdir}/{name}.png}" alt="{caption}" />
|
||||
{icons%}<div class="title">{caption}</div>
|
||||
</td>
|
||||
<td class="content">
|
||||
<div class="title">{title}</div>
|
||||
|
|
||||
</td>
|
||||
</tr></table>
|
||||
</div>
|
||||
|
||||
# Bibliography list.
|
||||
# Same as numbered list.
|
||||
[listdef-bibliography]
|
||||
listtag=olist
|
||||
itemtag=olistitem
|
||||
texttag=olisttext
|
||||
|
||||
# Glossary list.
|
||||
# Same as labeled list.
|
||||
[listdef-glossary]
|
||||
listtag=vlist
|
||||
itemtag=vlistitem
|
||||
texttag=vlisttext
|
||||
entrytag=vlistentry
|
||||
labeltag=vlistterm
|
||||
|
||||
# Tables.
|
||||
[tabledef-default]
|
||||
template=table
|
||||
colspec=<col width="{colwidth}{pageunits}" />
|
||||
bodyrow=<tr>|</tr>
|
||||
headdata=<th align="{colalign}">|</th>
|
||||
footdata=<td align="{colalign}">|</td>
|
||||
bodydata=<td align="{colalign}">|</td>
|
||||
|
||||
[table]
|
||||
<div class="tableblock">
|
||||
<a id="{id}"></a>
|
||||
<table rules="{grid=none}"
|
||||
frame="{frame%hsides}"
|
||||
frame="{frame@topbot:hsides}{frame@all:border}{frame@none:void}{frame@sides:vsides}"
|
||||
cellspacing="0" cellpadding="4">
|
||||
<caption class="title">{caption=Table: }{title}</caption>
|
||||
{colspecs}
|
||||
{headrows#}<thead>
|
||||
{headrows}
|
||||
{headrows#}</thead>
|
||||
{footrows#}<tfoot>
|
||||
{footrows}
|
||||
{footrows#}</tfoot>
|
||||
<tbody valign="top">
|
||||
{bodyrows}
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
|
||||
[preamble]
|
||||
# Untitled elements between header and first section title.
|
||||
<div id="preamble">
|
||||
<a id="{id}"></a>
|
||||
<div class="sectionbody">
|
||||
|
|
||||
</div>
|
||||
</div>
|
||||
|
||||
# Document sections.
|
||||
[sect0]
|
||||
<h1>{id?<a id="{id}"></a>}{title}</h1>
|
||||
|
|
||||
|
||||
[sect1]
|
||||
<h2>{id?<a id="{id}"></a>}{numbered?{sectnum} }{title}</h2>
|
||||
<div class="sectionbody">
|
||||
|
|
||||
</div>
|
||||
|
||||
[sect2]
|
||||
<h3>{id?<a id="{id}"></a>}{numbered?{sectnum} }{title}</h3>
|
||||
|
|
||||
|
||||
[sect3]
|
||||
<h4>{id?<a id="{id}"></a>}{numbered?{sectnum} }{title}</h4>
|
||||
|
|
||||
|
||||
[sect4]
|
||||
<h5>{id?<a id="{id}"></a>}{title}</h5>
|
||||
|
|
||||
|
||||
[header]
|
||||
# IE6 enters quirks mode if the following XML directive is present.
|
||||
#<?xml version="1.0" encoding="UTF-8"?>
|
||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
|
||||
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset={encoding}" />
|
||||
<meta name="generator" content="AsciiDoc {asciidoc-version}" />
|
||||
ifdef::linkcss[]
|
||||
<link rel="stylesheet" href="{stylesdir=.}/{theme={backend}}.css" type="text/css" />
|
||||
{doctype-manpage}<link rel="stylesheet" href="{stylesdir=.}/{theme={backend}}-manpage.css" type="text/css" />
|
||||
ifdef::quirks[]
|
||||
<link rel="stylesheet" href="{stylesdir=.}/{theme={backend}}-quirks.css" type="text/css" />
|
||||
endif::quirks[]
|
||||
endif::linkcss[]
|
||||
ifndef::linkcss[]
|
||||
<style type="text/css">
|
||||
include1::{stylesdir=./stylesheets}/{theme={backend}}.css[]
|
||||
{doctype-manpage}include1::{stylesdir=./stylesheets}/{theme={backend}}-manpage.css[]
|
||||
ifdef::quirks[]
|
||||
include1::{stylesdir=./stylesheets}/{theme={backend}}-quirks.css[]
|
||||
endif::quirks[]
|
||||
</style>
|
||||
endif::linkcss[]
|
||||
ifdef::asciimath[]
|
||||
ifdef::linkcss[]
|
||||
<script type="text/javascript" src="{scriptsdir=.}/ASCIIMathML.js"></script>
|
||||
endif::linkcss[]
|
||||
ifndef::linkcss[]
|
||||
<script type="text/javascript">
|
||||
# Escape as CDATA to pass validators.
|
||||
/*<![CDATA[*/
|
||||
include1::{scriptsdir=./javascripts}/ASCIIMathML.js[]
|
||||
/*]]>*/
|
||||
</script>
|
||||
endif::linkcss[]
|
||||
endif::asciimath[]
|
||||
<title>{doctitle}</title>
|
||||
</head>
|
||||
<body>
|
||||
# Article, book header.
|
||||
ifndef::doctype-manpage[]
|
||||
<div id="header">
|
||||
<h1>{doctitle}</h1>
|
||||
<span id="author">{author}</span><br />
|
||||
<span id="email"><tt><<a href="mailto:{email}">{email}</a>></tt></span><br />
|
||||
<span id="revision">version {revision}{date?,}</span>
|
||||
{date}
|
||||
</div>
|
||||
endif::doctype-manpage[]
|
||||
# Man page header.
|
||||
ifdef::doctype-manpage[]
|
||||
<div id="header">
|
||||
<h1>
|
||||
{doctitle} Manual Page
|
||||
</h1>
|
||||
<h2>NAME</h2>
|
||||
<div class="sectionbody">
|
||||
<p>{manname} -
|
||||
{manpurpose}
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
endif::doctype-manpage[]
|
||||
|
||||
[footer]
|
||||
<div id="footer">
|
||||
<div id="footer-text">
|
||||
Version {revision}<br />
|
||||
Last updated {localdate} {localtime}
|
||||
</div>
|
||||
ifdef::badges[]
|
||||
<div id="footer-badges">
|
||||
ifndef::icons[]
|
||||
Valid <a href="http://validator.w3.org/check?uri=referer">XHTML</a>
|
||||
and <a href="http://jigsaw.w3.org/css-validator/check/referer">CSS</a>.
|
||||
endif::icons[]
|
||||
ifdef::icons[]
|
||||
<a href="http://validator.w3.org/check?uri=referer">
|
||||
<img style="border:none; width:88px; height:31px;"
|
||||
src="http://www.w3.org/Icons/valid-xhtml11"
|
||||
alt="Valid XHTML 1.1!" />
|
||||
</a>
|
||||
<a href="http://jigsaw.w3.org/css-validator/check/referer">
|
||||
<img style="border:none; width:88px; height:31px;"
|
||||
src="http://jigsaw.w3.org/css-validator/images/vcss"
|
||||
alt="Valid CSS!" />
|
||||
</a>
|
||||
<a href="http://www.mozilla.org/products/firefox/">
|
||||
<img style="border:none; width:110px; height:32px;"
|
||||
src="http://www.spreadfirefox.com/community/images/affiliates/Buttons/110x32/safer.gif"
|
||||
alt="Get Firefox!" />
|
||||
</a>
|
||||
endif::icons[]
|
||||
</div>
|
||||
endif::badges[]
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
|
||||
ifdef::doctype-manpage[]
|
||||
[sect-synopsis]
|
||||
template::[sect1]
|
||||
endif::doctype-manpage[]
|
||||
|
||||
ifdef::quirks[]
|
||||
include::{backend}-quirks.conf[]
|
||||
endif::quirks[]
|
||||
Loading…
Reference in New Issue
Block a user