Andrew's git - gitweb.git/blob - Documentation/asciidoc.conf

   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]
  14asterisk=&#42;
  15plus=&#43;
  16caret=&#94;
  17startsb=&#91;
  18endsb=&#93;
  19backslash=&#92;
  20tilde=&#126;
  21apostrophe=&#39;
  22backtick=&#96;
  23
  24ifdef::backend-docbook[]
  25[linkgit-inlinemacro]
  26{0%{target}}
  27{0#<citerefentry>}
  28{0#<refentrytitle>{target}</refentrytitle><manvolnum>{0}</manvolnum>}
  29{0#</citerefentry>}
  30endif::backend-docbook[]
  31
  32ifdef::backend-docbook[]
  33ifndef::git-asciidoc-no-roff[]
  34# "unbreak" docbook-xsl v1.68 for manpages. v1.69 works with or without this.
  35# v1.72 breaks with this because it replaces dots not in roff requests.
  36[listingblock]
  37<example><title>{title}</title>
  38<literallayout>
  39ifdef::doctype-manpage[]
  40&#10;.ft C&#10;
  41endif::doctype-manpage[]
  42|
  43ifdef::doctype-manpage[]
  44&#10;.ft&#10;
  45endif::doctype-manpage[]
  46</literallayout>
  47{title#}</example>
  48endif::git-asciidoc-no-roff[]
  49
  50ifdef::git-asciidoc-no-roff[]
  51ifdef::doctype-manpage[]
  52# The following two small workarounds insert a simple paragraph after screen
  53[listingblock]
  54<example><title>{title}</title>
  55<literallayout>
  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>
  68endif::doctype-manpage[]
  69endif::git-asciidoc-no-roff[]
  70endif::backend-docbook[]
  71
  72ifdef::doctype-manpage[]
  73ifdef::backend-docbook[]
  74[header]
  75template::[header-declarations]
  76<refentry>
  77<refmeta>
  78<refentrytitle>{mantitle}</refentrytitle>
  79<manvolnum>{manvolnum}</manvolnum>
  80<refmiscinfo class="source">Git</refmiscinfo>
  81<refmiscinfo class="version">{git_version}</refmiscinfo>
  82<refmiscinfo class="manual">Git Manual</refmiscinfo>
  83</refmeta>
  84<refnamediv>
  85  <refname>{manname}</refname>
  86  <refpurpose>{manpurpose}</refpurpose>
  87</refnamediv>
  88endif::backend-docbook[]
  89endif::doctype-manpage[]
  90
  91ifdef::backend-xhtml11[]
  92[linkgit-inlinemacro]
  93<a href="{target}.html">{target}{0?({0})}</a>
  94endif::backend-xhtml11[]