Documentation/asciidoc.conf.in

   1 ## linkgit: macro
   2 #
   3 # Usage: linkgit: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 [macros]
  11 (?su)[\\]?(?P<name>linkgit):(?P<target>\S*?)\[(?P<attrlist>.*?)\]=
  12
  13 [attributes]
  14 asterisk=&#42;
  15 plus=&#43;
  16 caret=&#94;
  17 startsb=&#91;
  18 endsb=&#93;
  19 backslash=&#92;
  20 tilde=&#126;
  21 apostrophe=&#39;
  22 backtick=&#96;
  23 litdd=&#45;&#45;
  24 manmanual=Git Manual
  25 mansource=Git @GIT_VERSION@
  26 revdate=@GIT_DATE@
  27
  28 ifdef::doctype-book[]
  29 [titles]
  30         underlines="__","==","--","~~","^^"
  31 endif::doctype-book[]
  32
  33 ifdef::backend-docbook[]
  34 [linkgit-inlinemacro]
  35 ifndef::doctype-book[]
  36 {0%{target}}
  37 {0#<citerefentry>}
  38 {0#<refentrytitle>{target}</refentrytitle><manvolnum>{0}</manvolnum>}
  39 {0#</citerefentry>}
  40 endif::doctype-book[]
  41 ifdef::doctype-book[]
  42 <ulink url="{target}.html">{target}{0?({0})}</ulink>
  43 endif::doctype-book[]
  44
  45 [literal-inlinemacro]
  46 {eval:re.sub(r'(&lt;[-a-zA-Z0-9.]+&gt;)', r'<emphasis>\1</emphasis>', re.sub(r'([\[\s|()>]|^|\]|&gt;)(\.?([-a-zA-Z0-9:+=~@,\/_^\$]+\.?)+)',r'\1<literal>\2</literal>', re.sub(r'(\.\.\.?)([^\]$.])', r'<literal>\1</literal>\2', macros.passthroughs[int(attrs['passtext'][1:-1])] if attrs['passtext'][1:-1].isnumeric() else attrs['passtext'][1:-1])))}
  47
  48 endif::backend-docbook[]
  49
  50 ifdef::backend-docbook[]
  51 ifdef::doctype-manpage[]
  52 # The following two small workarounds insert a simple paragraph after screen
  53 [listingblock]
  54 <example><title>{title}</title>
  55 <literallayout class="monospaced">
  56 |
  57 </literallayout><simpara></simpara>
  58 {title#}</example>
  59
  60 [verseblock]
  61 <formalpara{id? id="{id}"}><title>{title}</title><para>
  62 {title%}<literallayout{id? id="{id}"}>
  63 {title#}<literallayout>
  64 |
  65 </literallayout>
  66 {title#}</para></formalpara>
  67 {title%}<simpara></simpara>
  68 endif::doctype-manpage[]
  69 endif::backend-docbook[]
  70
  71 ifdef::backend-xhtml11[]
  72 [attributes]
  73 git-relative-html-prefix=
  74 [linkgit-inlinemacro]
  75 <a href="{git-relative-html-prefix}{target}.html">{target}{0?({0})}</a>
  76
  77 [literal-inlinemacro]
  78 {eval:re.sub(r'(&lt;[-a-zA-Z0-9.]+&gt;)', r'<em>\1</em>', re.sub(r'([\[\s|()>]|^|\]|&gt;)(\.?([-a-zA-Z0-9:+=~@,\/_^\$]+\.?)+)',r'\1<code>\2</code>', re.sub(r'(\.\.\.?)([^\]$.])', r'<code>\1</code>\2', macros.passthroughs[int(attrs['passtext'][1:-1])] if attrs['passtext'][1:-1].isnumeric() else attrs['passtext'][1:-1])))}
  79
  80 endif::backend-xhtml11[]
  81
  82 ifdef::backend-docbook[]
  83 ifdef::doctype-manpage[]
  84 [paradef-default]
  85 synopsis-style=template="verseparagraph",filter="sed 's!&#8230;\\(\\]\\|$\\)!<phrase>\\0</phrase>!g;s!\\([\\[ |()]\\|^\\|\\]\\|&gt;\\)\\([-=a-zA-Z0-9:+@,\\/_^\\$.]\\+\\|&#8230;\\)!\\1<literal>\\2</literal>!g;s!&lt;[-a-zA-Z0-9.]\\+&gt;!<emphasis>\\0</emphasis>!g'"
  86 endif::doctype-manpage[]
  87 endif::backend-docbook[]
  88
  89 ifdef::backend-xhtml11[]
  90 [paradef-default]
  91 synopsis-style=template="verseparagraph",filter="sed 's!&#8230;\\(\\]\\|$\\)!<span>\\0</span>!g;s!\\([\\[ |()]\\|^\\|\\]\\|&gt;\\)\\([-=a-zA-Z0-9:+@,\\/_^\\$.]\\+\\|&#8230;\\)!\\1<code>\\2</code>!g;s!&lt;[-a-zA-Z0-9.]\\+&gt;!<em>\\0</em>!g'"
  92 endif::backend-xhtml11[]