With the new stylesheet example blocks (delimited with ====) are
rendered as rather intrusive boxes with large padding in yellow
and grey.
This patch replaces the example blocks with simple code blocks
(delimited with ----) that better match the overall style of the
documentation.
Change-Id: Id95387cdb153332c2066e2d5e378697647dbca52
Signed-off-by: Michael Ochmann <michael.ochmann@sap.com>
Most of the cmd-xxxx.txt pages were still using the legacy 'italics'
asciidoc [1], which caused the synopsis sections to render like this:
'ssh' -p <port> 'gerrit some-command'
Furthermore, the line breaks and indentations were not rendered.
Replaced the legacy 'italics" with _italics_ in all synopsis sections
and changed the block type to [verse]. Verse blocks preserve indents
and line breaks (like <pre> in HTML), but still allow text formatting.
Fixed also some other minor mistakes and formatting errors.
[1] http://asciidoctor.org/docs/migration/#migration-cheatsheet
Change-Id: I457c5e42e3758789f29541d38d6f6c2e25532897
Signed-off-by: Michael Ochmann <michael.ochmann@sap.com>
Update the Access section on documentation of the cmd-plugin
command to also include config to enable the command.
Change-Id: I815275009494db6ce3027a2705b0056146ba7a0f
We previous use the section title style like:
Section level 1
===============
Section level 2
---------------
Which have a problem in Asciidoctor that the number of "="s or "-"s must match
the number of characters in the header exactly, as a result it's easy to make
mistakes while changing the titles. Asciidoctor provides a better style like:
= Section level 1
== Section level 2
So we switched to this style.
Also fixed a bug in replace_macros.py, which will not cause any problem in the
old style.
Change-Id: I811dd7238735d98f662767c17086152cd69aea02
AsciiDoctor have different understanding of [verse] with asciidoc, causing some
rendering differences. To get similar result with asciidoc, we use something
else instead of [verse] now.
Screenshots:
before:
http://imgur.com/JKMdBiv
after:
http://imgur.com/yFVvVac
Change-Id: I14e84f0e998e1e87b633681e8028ad657bde07e4