Documentation/asciidoc.conf

   1 ## gitlink: macro
   2 #
   3 # Usage: gitlink:command[manpage-section]
   4 #
   5 # Note, {0} is the manpage section, while {target} is the command.
   6 #
   7 # Show GIT link as: <command>(<section>); if section is defined, else just show
   8 # the command.
   9
  10 [attributes]
  11 plus=&#43;
  12 caret=&#94;
  13 startsb=&#91;
  14 endsb=&#93;
  15 tilde=&#126;
  16
  17 ifdef::backend-docbook[]
  18 [gitlink-inlinemacro]
  19 {0%{target}}
  20 {0#<citerefentry>}
  21 {0#<refentrytitle>{target}</refentrytitle><manvolnum>{0}</manvolnum>}
  22 {0#</citerefentry>}
  23 endif::backend-docbook[]
  24
  25 ifdef::backend-docbook[]
  26 # "unbreak" docbook-xsl v1.68 for manpages. v1.69 works with or without this.
  27 [listingblock]
  28 <example><title>{title}</title>
  29 <literallayout>
  30 ifdef::doctype-manpage[]
  31 &#10;.ft C&#10;
  32 endif::doctype-manpage[]
  33 |
  34 ifdef::doctype-manpage[]
  35 &#10;.ft&#10;
  36 endif::doctype-manpage[]
  37 </literallayout>
  38 {title#}</example>
  39 endif::backend-docbook[]
  40
  41 ifdef::doctype-manpage[]
  42 ifdef::backend-docbook[]
  43 [header]
  44 template::[header-declarations]
  45 <refentry>
  46 <refmeta>
  47 <refentrytitle>{mantitle}</refentrytitle>
  48 <manvolnum>{manvolnum}</manvolnum>
  49 <refmiscinfo class="source">Git</refmiscinfo>
  50 <refmiscinfo class="version">{git_version}</refmiscinfo>
  51 <refmiscinfo class="manual">Git Manual</refmiscinfo>
  52 </refmeta>
  53 <refnamediv>
  54   <refname>{manname}</refname>
  55   <refpurpose>{manpurpose}</refpurpose>
  56 </refnamediv>
  57 endif::backend-docbook[]
  58 endif::doctype-manpage[]
  59
  60 ifdef::backend-xhtml11[]
  61 [gitlink-inlinemacro]
  62 <a href="{target}.html">{target}{0?({0})}</a>
  63 endif::backend-xhtml11[]