Commit | Line | Data |
---|---|---|
168e428f PH |
1 | # $Cambridge: exim/doc/doc-docbook/MyAsciidoc.conf,v 1.1 2005/06/16 10:32:31 ph10 Exp $ |
2 | ||
3 | # Asciidoc configuration customization for creating the DocBook XML sources | |
4 | # of the Exim specification and the filter document. | |
5 | ||
6 | [miscellaneous] | |
7 | newline=\n | |
8 | ||
9 | [quotes] | |
10 | _=filename | |
11 | $=varname | |
12 | %=option | |
13 | ^=command | |
14 | ^^=function | |
15 | ^%|%^=parameter | |
16 | ``|''=quoted | |
17 | ||
18 | [tags] | |
19 | strong=<emphasis role="bold">|</emphasis> | |
20 | ||
21 | filename=<filename>|</filename> | |
22 | varname=<varname>$|</varname> | |
23 | option=<option>|</option> | |
24 | command=<command>|</command> | |
25 | function=<function>|</function> | |
26 | parameter=<parameter>|</parameter> | |
27 | quoted=<quote>|</quote> | |
28 | ||
29 | ||
30 | [replacements] | |
31 | # Nothing - this is for disambiguating markup | |
32 | "##"= | |
33 | ||
34 | # -- En dash | |
35 | (^|[^-])--($|[^-])=\1–\2 | |
36 | ||
37 | # --- Em dash | |
38 | (^|\s+)---($|\s+)=\1舒\2 | |
39 | ||
40 | # -- Hard space | |
41 | ~=  | |
42 | ||
43 | # ' automatic apostrophe | |
44 | ([A-Za-z0-9])'([A-Za-z\s])=\1’\2 | |
45 | ||
46 | # daggers | |
47 | !!=† | |
48 | !\?=‡ | |
49 | ||
50 | # The default markup recognizes subscripts and superscripts using tilde and | |
51 | # circumflex. We don't want this. These settings manage to turn off the | |
52 | # effect, while still allowing tilde to be recognized as a hard space. | |
53 | \^(.+?)\^=^\1^ | |
54 | ~(.+?)~=~\1~ | |
55 | ||
56 | ||
57 | [attributes] | |
58 | # Manual apostrophe: needed for an apostrophe after something quoted, because | |
59 | # I can't get the automatic one to work in that situation | |
60 | ap=’ | |
61 | ||
62 | # Manual tilde: tilde is defined as a hard space, and it doesn't seem possible | |
63 | # to quote is using a backslash. | |
64 | tl=~ | |
65 | ||
66 | # Two hyphens, to stop them being treated as an en dash | |
67 | hh=-- | |
68 | ||
69 | # Percent: causes confusion with the quote otherwise | |
70 | pc=% | |
71 | ||
72 | # Colon: there's a case where this causes trouble | |
73 | co=: | |
74 | ||
75 | # The sequence "[]" for use in index terms | |
76 | bk=[] | |
77 | ||
78 | ||
79 | # We need to add extra stuff to the <bookinfo> element | |
80 | ||
81 | [header] | |
82 | <?xml {xmldecl}?> | |
83 | <!DOCTYPE book {dtddecl}> | |
84 | ||
85 | <book lang="en"> | |
86 | {doctitle#}<bookinfo> | |
87 | <title>{doctitle}</title> | |
88 | <titleabbrev>{doctitleabbrev}</titleabbrev> | |
89 | <date>{date}</date> | |
90 | {authored#}<author> | |
91 | <firstname>{firstname}</firstname> | |
92 | <othername>{middlename}</othername> | |
93 | <surname>{lastname}</surname> | |
94 | {authored#}</author> | |
95 | <authorinitials>{authorinitials}</authorinitials> | |
96 | {revisionhistory%}<revhistory><revision><revnumber>{revision}</revnumber><date>{date}</date>{authorinitials?<authorinitials>{authorinitials}</authorinitials>}{revremark?<revremark>{revremark}</revremark>}</revision></revhistory> | |
97 | <corpname>{companyname}</corpname> | |
98 | <othercredit><contrib>{othercredit},</contrib></othercredit> | |
99 | {copyright#}<copyright><year>{cpyear}</year><holder>{copyright}</holder></copyright> | |
100 | <abstract><para>{abstract}</para></abstract> | |
101 | {doctitle#}</bookinfo> | |
102 | ||
103 | ||
104 | # Define a new kind of block that maps to <literallayout> so as not to | |
105 | # insist on a monospaced font. Delimiter is &&&. | |
106 | ||
107 | [blockdef-literallayout] | |
108 | delimiter=^&{3,}(\[(?P<args>.*)\])?=*$ | |
109 | template=literallayoutblock | |
110 | presubs=specialcharacters,quotes,replacements,macros,callouts | |
111 | ||
112 | # The template for my non-monospaced literal layout block | |
113 | ||
114 | [literallayoutblock] | |
115 | <literallayout{revisionflag? revisionflag="{revisionflag}"}> | |
116 | | | |
117 | </literallayout> | |
118 | ||
119 | ||
120 | # Paragraph substitution - use <para> rather than <simplepara> | |
121 | ||
122 | [paragraph] | |
123 | {title#}<formalpara{id? id="{id}"{revisionflag? revisionflag="{revisionflag}"}}><title>{title}</title><para> | |
124 | {title%}<para{id? id="{id}"}{revisionflag? revisionflag="{revisionflag}"}> | |
125 | | | |
126 | {title%}</para> | |
127 | {title#}</para></formalpara> | |
128 | {empty} | |
129 | ||
130 | ||
131 | # Define a special table for left-centre-right lines, filling the whole page | |
132 | # width, with a border but no separators, for Exim configuration options. It | |
133 | # would be nice if this could call the default [table] template, forcing the | |
134 | # appropriate attributes, but I have not found a way of doing this. | |
135 | ||
136 | [tabledef-conf] | |
137 | fillchar== | |
138 | format=csv | |
139 | template=conf-table | |
140 | colspec=<colspec align="{colalign}"/> | |
141 | bodyrow=<row>|</row> | |
142 | bodydata=<entry>|</entry> | |
143 | ||
144 | [conf-table] | |
145 | <{title?table}{title!informaltable}{id? id="{id}"} pgwide="1" frame="all" colsep="0" rowsep="0"> | |
146 | <title>{title}</title> | |
147 | <tgroup cols="{cols}"> | |
148 | <colspec align="left" colwidth="8*"/> | |
149 | <colspec align="center" colwidth = "5*"/> | |
150 | <colspec align="center" colwidth = "5*"/> | |
151 | <colspec align="right" colwidth = "6*"/> | |
152 | {headrows#}<thead> | |
153 | {headrows} | |
154 | {headrows#}</thead> | |
155 | {footrows#}<tfoot> | |
156 | {footrows} | |
157 | {footrows#}</tfoot> | |
158 | <tbody> | |
159 | {bodyrows} | |
160 | </tbody> | |
161 | </tgroup> | |
162 | </{title?table}{title!informaltable}> | |
163 | ||
164 | # The default indexterm macro generates primary index entries for the | |
165 | # secondary and tertiary terms as well, which does not make sense | |
166 | # in the context of the way I write indexes. As well as a replacement | |
167 | # that does the simple, straightforward thing, we actually want to have | |
168 | # two different macros: one for concepts and one for options. | |
169 | ||
170 | [cindex-inlinemacro] | |
171 | # Inline index term for concepts. | |
172 | <indexterm role="concept"> | |
173 | <primary>{1}</primary> | |
174 | <secondary>{2}</secondary> | |
175 | <tertiary>{3}</tertiary> | |
176 | </indexterm> | |
177 | ||
178 | [oindex-inlinemacro] | |
179 | # Inline index term for options. | |
180 | <indexterm role="option"> | |
181 | <primary>{1}</primary> | |
182 | <secondary>{2}</secondary> | |
183 | <tertiary>{3}</tertiary> | |
184 | </indexterm> | |
185 | ||
186 | # Allow for the "role" attribute for an index. | |
187 | ||
188 | [sect-index] | |
189 | <index{id? id="{id}"}{role? role="{role}"}> | |
190 | <title>{title}</title> | |
191 | | | |
192 | </index> | |
193 | ||
194 | ||
195 | # Allow for the "titleabbrev" attribute for chapters. | |
196 | ||
197 | [sect1] | |
198 | <chapter{id? id="{id}"}> | |
199 | <title>{title}</title> | |
200 | <titleabbrev>{titleabbrev}</titleabbrev> | |
201 | | | |
202 | </chapter> | |
203 | ||
204 | ||
205 | #### End #### |