5
0
mirror of git://git.proxmox.com/git/pve-docs.git synced 2025-03-20 22:50:06 +03:00

README.adoc: add info about macro usage

This commit is contained in:
Dietmar Maurer 2016-01-06 17:58:58 +01:00
parent 98d7e09a20
commit 8e6e64116e

View File

@ -1,5 +1,6 @@
Proxmox VE Documentation
========================
include::attributes.txt[]
What is this?
-------------
@ -14,6 +15,17 @@ Administration Guide]. So we have one source, and generate several
documents from that. It is also possible to generate printable PDF
files, or ebook formats ('.ebup').
Common Macro definition in link:attributes.txt[]
------------------------------------------------
'asciidoc' allows us to define common macros, which can then be
referred to using `{macro}`. We try to use this mechanism to improve
consistency. For example, we defined a macro called `pve`, which
expands to "Proxmox VE". The plan is to add more such definitions for
terms which are used more than once.
NOTE: The github 'asciidoc' viewer does not expand those macros.
Autogenerated CLI Command Synopsis
----------------------------------