chiark - git - mdw - stgit/blob - Documentation/asciidoc.conf

   1 [attributes]
   2 asterisk=&#42;
   3 plus=&#43;
   4 caret=&#94;
   5 startsb=&#91;
   6 endsb=&#93;
   7 tilde=&#126;
   8
   9 ifdef::backend-docbook[]
  10 ifndef::docbook-xsl-172[]
  11 # "unbreak" docbook-xsl v1.68 for manpages. v1.69 works with or without this.
  12 # v1.72 breaks with this because it replaces dots not in roff requests.
  13 [listingblock]
  14 <example><title>{title}</title>
  15 <literallayout>
  16 ifdef::doctype-manpage[]
  17 &#10;.ft C&#10;
  18 endif::doctype-manpage[]
  19 |
  20 ifdef::doctype-manpage[]
  21 &#10;.ft&#10;
  22 endif::doctype-manpage[]
  23 </literallayout>
  24 {title#}</example>
  25 endif::docbook-xsl-172[]
  26 endif::backend-docbook[]
  27
  28 ifdef::doctype-manpage[]
  29 ifdef::backend-docbook[]
  30 [header]
  31 template::[header-declarations]
  32 <refentry>
  33 <refmeta>
  34 <refentrytitle>{mantitle}</refentrytitle>
  35 <manvolnum>{manvolnum}</manvolnum>
  36 <refmiscinfo class="source">StGit</refmiscinfo>
  37 <refmiscinfo class="version">{stgit_version}</refmiscinfo>
  38 <refmiscinfo class="manual">StGit Manual</refmiscinfo>
  39 </refmeta>
  40 <refnamediv>
  41   <refname>{manname}</refname>
  42   <refpurpose>{manpurpose}</refpurpose>
  43 </refnamediv>
  44 endif::backend-docbook[]
  45 endif::doctype-manpage[]
  46
  47 ## link: macro
  48 #
  49 # Usage: link:command[manpage-section]
  50 #
  51 # Note, {0} is the manpage section, while {target} is the command.
  52 #
  53 # Show link as: <command>(<section>); if section is defined, else just
  54 # show the command.
  55
  56 ifdef::backend-docbook[]
  57 [link-inlinemacro]
  58 {0%{target}}
  59 {0#<citerefentry>}
  60 {0#<refentrytitle>{target}</refentrytitle><manvolnum>{0}</manvolnum>}
  61 {0#</citerefentry>}
  62 endif::backend-docbook[]
  63
  64 ifdef::backend-xhtml11[]
  65 [link-inlinemacro]
  66 <a href="{target}.html">{target}{0?({0})}</a>
  67 endif::backend-xhtml11[]
  68
  69 ## stglink: macro
  70 #
  71 # Usage: stglink:command[]
  72 #
  73 # Show StGit link as: stg-<command>(1) in man pages, stg <command> in
  74 # html.
  75
  76 ifdef::backend-docbook[]
  77 [stglink-inlinemacro]
  78 <citerefentry>
  79   <refentrytitle>stg-{target}</refentrytitle><manvolnum>1</manvolnum>
  80 </citerefentry>
  81 endif::backend-docbook[]
  82
  83 ifdef::backend-xhtml11[]
  84 [stglink-inlinemacro]
  85 <a href="stg-{target}.html">stg {target}</a>
  86 endif::backend-xhtml11[]