]> git.ipfire.org Git - thirdparty/git.git/blame - Documentation/asciidoc.conf
asciidoc: add minor workaround to add an empty line after code blocks
[thirdparty/git.git] / Documentation / asciidoc.conf
CommitLineData
5162e697 1## linkgit: macro
d1c2e113 2#
5162e697 3# Usage: linkgit:command[manpage-section]
d1c2e113
SV
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
babfaba2 10[attributes]
c0a5e2d4 11asterisk=&#42;
4c7100a9
JH
12plus=&#43;
13caret=&#94;
a3e65d74
JF
14startsb=&#91;
15endsb=&#93;
54bd2558 16tilde=&#126;
babfaba2 17
d1c2e113 18ifdef::backend-docbook[]
5162e697 19[linkgit-inlinemacro]
d1c2e113
SV
20{0%{target}}
21{0#<citerefentry>}
22{0#<refentrytitle>{target}</refentrytitle><manvolnum>{0}</manvolnum>}
23{0#</citerefentry>}
24endif::backend-docbook[]
25
e920b565 26ifdef::backend-docbook[]
7f55cf45 27ifndef::docbook-xsl-172[]
e920b565 28# "unbreak" docbook-xsl v1.68 for manpages. v1.69 works with or without this.
7f55cf45 29# v1.72 breaks with this because it replaces dots not in roff requests.
e920b565
FD
30[listingblock]
31<example><title>{title}</title>
32<literallayout>
281a53bb
JP
33ifdef::doctype-manpage[]
34&#10;.ft C&#10;
35endif::doctype-manpage[]
e920b565 36|
281a53bb
JP
37ifdef::doctype-manpage[]
38&#10;.ft&#10;
39endif::doctype-manpage[]
e920b565
FD
40</literallayout>
41{title#}</example>
7f55cf45 42endif::docbook-xsl-172[]
9b6f84d2
JF
43
44ifdef::docbook-xsl-172[]
45ifdef::doctype-manpage[]
46# The following two small workarounds insert a simple paragraph after screen
47[listingblock]
48<example><title>{title}</title>
49<screen>
50|
51</screen><simpara></simpara>
52{title#}</example>
53
54[verseblock]
55<formalpara{id? id="{id}"}><title>{title}</title><para>
56{title%}<literallayout{id? id="{id}"}>
57{title#}<literallayout>
58|
59</literallayout><simpara></simpara>
60{title#}</para></formalpara>
61endif::doctype-manpage[]
62endif::docbook-xsl-172[]
e920b565
FD
63endif::backend-docbook[]
64
d3d4fa86 65ifdef::doctype-manpage[]
7ef195ba
FL
66ifdef::backend-docbook[]
67[header]
68template::[header-declarations]
69<refentry>
70<refmeta>
71<refentrytitle>{mantitle}</refentrytitle>
72<manvolnum>{manvolnum}</manvolnum>
73<refmiscinfo class="source">Git</refmiscinfo>
4159c578 74<refmiscinfo class="version">{git_version}</refmiscinfo>
7ef195ba
FL
75<refmiscinfo class="manual">Git Manual</refmiscinfo>
76</refmeta>
77<refnamediv>
78 <refname>{manname}</refname>
79 <refpurpose>{manpurpose}</refpurpose>
80</refnamediv>
81endif::backend-docbook[]
d3d4fa86 82endif::doctype-manpage[]
7ef195ba 83
d1c2e113 84ifdef::backend-xhtml11[]
5162e697 85[linkgit-inlinemacro]
d1c2e113
SV
86<a href="{target}.html">{target}{0?({0})}</a>
87endif::backend-xhtml11[]