5
0
mirror of git://git.proxmox.com/git/pve-docs.git synced 2025-01-18 06:03:46 +03:00

remove attributes.txt (use asciidoc/asciidoc-pve.conf instead)

This commit is contained in:
Dietmar Maurer 2016-11-08 06:46:43 +01:00
parent ae0ad291e1
commit a69bfc83f6
54 changed files with 8 additions and 97 deletions

View File

@ -1,6 +1,5 @@
Proxmox VE Documentation
========================
include::attributes.txt[]
We try to generate high quality documentation for
{website}[{pve}], and choose to use
@ -42,8 +41,8 @@ those Debian packages using:
make deb
Common Macro definition in link:attributes.txt[]
------------------------------------------------
Common Macro definition in link:asciidoc/asciidoc-pve.conf[]
------------------------------------------------------------
'asciidoc' allows us to define common macros, which can then be
referred to using `{macro}`. We try to use this mechanism to improve
@ -59,13 +58,12 @@ description
For example, the macro `{forum-url}` expands to {forum-url}, and the macro
`{forum}` expands to {forum}.
The plan is to add more such definitions for terms which are used more than once.
The plan is to add more such definitions for terms which are used more
than once.
WARNING: When asciidoc encounters a misspelled macro name, it will silently drop
the containing line!
WARNING: When asciidoc encounters a misspelled macro name, it will
silently drop the containing line!
WARNING: Never use macros in document titles or the ``NAME'' section of man pages,
as these get parsed before the `attributes.txt` file gets included.
Autogenerated CLI Command Synopsis
----------------------------------

View File

@ -1,14 +0,0 @@
:proxmoxGmbh: Proxmox Server Solutions Gmbh
:copyright: {proxmoxGmbh}
:pve: Proxmox VE
:website: http://www.proxmox.com/
:forum-url: https://forum.proxmox.com/
:forum: https://forum.proxmox.com/[{pve} Community Forum]
:webwiki-url: https://pve.proxmox.com/wiki/
:webwiki: https://pve.proxmox.com/wiki/[{pve} Wiki]
:manmanual: {pve} Documentation
:max-width: 55em
ifndef::docinfo1[]
:author: {proxmoxGmbh}
:email: support@proxmox.com
endif::docinfo1[]

View File

@ -2,7 +2,6 @@
ifdef::manvolnum[]
datacenter.cfg(5)
=================
include::attributes.txt[]
:pve-toplevel:
NAME
@ -23,7 +22,6 @@ endif::manvolnum[]
ifndef::manvolnum[]
Datacenter Configuration
========================
include::attributes.txt[]
endif::manvolnum[]
ifdef::wiki[]
:title: Manual: datacenter.cfg

View File

@ -1,7 +1,6 @@
[[getting_help]]
Getting Help
------------
include::attributes.txt[]
ifdef::wiki[]
:pve-toplevel:
endif::wiki[]

View File

@ -2,7 +2,6 @@
ifdef::manvolnum[]
ha-manager(1)
=============
include::attributes.txt[]
:pve-toplevel:
NAME
@ -21,7 +20,6 @@ endif::manvolnum[]
ifndef::manvolnum[]
High Availability
=================
include::attributes.txt[]
:pve-toplevel:
endif::manvolnum[]

View File

@ -1,7 +1,6 @@
[[howto_improve_pve_docs]]
Improving the Proxmox VE Documentation
--------------------------------------
include::attributes.txt[]
ifdef::wiki[]
:pve-toplevel:
endif::wiki[]

View File

@ -1,6 +1,5 @@
image:./images/proxmox-logo.svg[] pass:[<br>] {pve} Documentation Index
========================================================================
include::attributes.txt[]
:data-uri:
:icons:
:title: {pve} Documentation Index

View File

@ -1,6 +1,5 @@
Logical Volume Manager (LVM)
----------------------------
include::attributes.txt[]
ifdef::wiki[]
:pve-toplevel:
endif::wiki[]

View File

@ -1,6 +1,5 @@
ZFS on Linux
------------
include::attributes.txt[]
ifdef::wiki[]
:pve-toplevel:
endif::wiki[]

View File

@ -2,7 +2,6 @@
ifdef::manvolnum[]
pct(1)
======
include::attributes.txt[]
:pve-toplevel:
NAME
@ -23,7 +22,6 @@ endif::manvolnum[]
ifndef::manvolnum[]
Proxmox Container Toolkit
=========================
include::attributes.txt[]
:pve-toplevel:
endif::manvolnum[]
ifdef::wiki[]

View File

@ -1,7 +1,6 @@
ifdef::manvolnum[]
pct.conf(5)
===========
include::attributes.txt[]
:pve-toplevel:
NAME
@ -23,7 +22,6 @@ endif::manvolnum[]
ifndef::manvolnum[]
Container Configuration
=======================
include::attributes.txt[]
endif::manvolnum[]
ifdef::wiki[]
:pve-toplevel:

View File

@ -1,7 +1,6 @@
ifdef::manvolnum[]
pmxcfs(8)
=========
include::attributes.txt[]
:pve-toplevel:
NAME
@ -21,7 +20,6 @@ endif::manvolnum[]
ifndef::manvolnum[]
Proxmox Cluster File System (pmxcfs)
====================================
include::attributes.txt[]
:pve-toplevel:
endif::manvolnum[]

View File

@ -6,7 +6,6 @@ ifndef::pvelogo[]
Proxmox VE Administration Guide
===============================
endif::pvelogo[]
include::attributes.txt[]
:doctype: book
:title: Proxmox VE Administration Guide
:toc:

View File

@ -1,7 +1,6 @@
[bibliography]
Bibliography
============
include::attributes.txt[]
ifndef::manvolnum[]
:pve-toplevel:
endif::manvolnum[]

View File

@ -1,6 +1,5 @@
Disk Health Monitoring
----------------------
include::attributes.txt[]
ifdef::wiki[]
:pve-toplevel:
endif::wiki[]

View File

@ -7,7 +7,6 @@ ASCIIDOC_PVE?=/usr/bin/asciidoc-pve
PVE_COMMON_DOC_SOURCES= \
${ASCIIDOC_PVE} \
attributes.txt \
pve-copyright.adoc \
docinfo.xml
@ -76,4 +75,4 @@ chapter-%.html: %.adoc ${PVE_COMMON_DOC_SOURCES}
.PHONY: cleanup-docgen
cleanup-docgen:
rm -f *.xml.tmp *.1 *.5 *.8 *.adoc attributes.txt docinfo.xml
rm -f *.xml.tmp *.1 *.5 *.8 *.adoc docinfo.xml

View File

@ -1,6 +1,5 @@
External Metric Server
----------------------
include::attributes.txt[]
ifdef::wiki[]
:pve-toplevel:
endif::wiki[]

View File

@ -1,6 +1,5 @@
Frequently Asked Questions
==========================
include::attributes.txt[]
ifndef::manvolnum[]
:pve-toplevel:
endif::manvolnum[]

View File

@ -2,7 +2,6 @@
ifdef::manvolnum[]
pve-firewall(8)
===============
include::attributes.txt[]
:pve-toplevel:
NAME
@ -23,7 +22,6 @@ endif::manvolnum[]
ifndef::manvolnum[]
{pve} Firewall
==============
include::attributes.txt[]
:pve-toplevel:
endif::manvolnum[]
ifdef::wiki[]

View File

@ -1,7 +1,6 @@
ifdef::manvolnum[]
pve-ha-crm(8)
=============
include::attributes.txt[]
:pve-toplevel:
NAME
@ -22,7 +21,6 @@ endif::manvolnum[]
ifndef::manvolnum[]
Cluster Resource Manager Daemon
================================
include::attributes.txt[]
endif::manvolnum[]
This is the Cluster Resource Manager Daemon.

View File

@ -1,7 +1,6 @@
ifdef::manvolnum[]
pve-ha-lrm(8)
=============
include::attributes.txt[]
:pve-toplevel:
NAME
@ -22,7 +21,6 @@ endif::manvolnum[]
ifndef::manvolnum[]
Local Resource Manager Daemon
==============================
include::attributes.txt[]
endif::manvolnum[]
This is the Local Resource Manager Daemon.

View File

@ -1,6 +1,5 @@
Installing Proxmox VE
=====================
include::attributes.txt[]
ifndef::manvolnum[]
:pve-toplevel:
endif::manvolnum[]

View File

@ -1,7 +1,6 @@
[[sysadmin_network_configuration]]
Network Configuration
---------------------
include::attributes.txt[]
ifdef::wiki[]
:pve-toplevel:
endif::wiki[]

View File

@ -1,7 +1,6 @@
[[sysadmin_package_repositories]]
Package Repositories
--------------------
include::attributes.txt[]
ifdef::wiki[]
:pve-toplevel:
endif::wiki[]

View File

@ -1,6 +1,5 @@
Directory Backend
-----------------
include::attributes.txt[]
ifdef::wiki[]
:pve-toplevel:
:title: Storage: Directory

View File

@ -1,6 +1,5 @@
GlusterFS Backend
-----------------
include::attributes.txt[]
ifdef::wiki[]
:pve-toplevel:
:title: Storage: GlusterFS

View File

@ -1,6 +1,5 @@
http://www.open-iscsi.org/[Open-iSCSI] initiator
------------------------------------------------
include::attributes.txt[]
ifdef::wiki[]
:pve-toplevel:
:title: Storage: iSCSI

View File

@ -1,6 +1,5 @@
User Mode iSCSI Backend
-----------------------
include::attributes.txt[]
ifdef::wiki[]
:pve-toplevel:
:title: Storage: User Mode iSCSI

View File

@ -1,6 +1,5 @@
LVM Backend
-----------
include::attributes.txt[]
ifdef::wiki[]
:pve-toplevel:
:title: Storage: LVM

View File

@ -1,6 +1,5 @@
LVM thin Backend
----------------
include::attributes.txt[]
ifdef::wiki[]
:pve-toplevel:
:title: Storage: LVM Thin

View File

@ -1,6 +1,5 @@
NFS Backend
-----------
include::attributes.txt[]
ifdef::wiki[]
:pve-toplevel:
:title: Storage: NFS

View File

@ -1,6 +1,5 @@
Ceph RADOS Block Devices (RBD)
------------------------------
include::attributes.txt[]
ifdef::wiki[]
:pve-toplevel:
:title: Storage: RBD

View File

@ -1,6 +1,5 @@
Local ZFS Pool Backend
----------------------
include::attributes.txt[]
ifdef::wiki[]
:pve-toplevel:
:title: Storage: ZFS

View File

@ -1,6 +1,5 @@
System Requirements
-------------------
include::attributes.txt[]
ifdef::wiki[]
:pve-toplevel:
endif::wiki[]

View File

@ -1,6 +1,5 @@
Install from USB Stick
----------------------
include::attributes.txt[]
ifdef::wiki[]
:pve-toplevel:
endif::wiki[]

View File

@ -1,7 +1,6 @@
ifdef::manvolnum[]
pveam(1)
========
include::attributes.txt[]
:pve-toplevel:
NAME
@ -22,7 +21,6 @@ endif::manvolnum[]
ifndef::manvolnum[]
Container Images
================
include::attributes.txt[]
endif::manvolnum[]
Command line tool to manage container images. See `man pct` for usage

View File

@ -2,7 +2,6 @@
ifdef::manvolnum[]
pveceph(1)
==========
include::attributes.txt[]
:pve-toplevel:
NAME
@ -21,7 +20,6 @@ endif::manvolnum[]
ifndef::manvolnum[]
pveceph - Manage CEPH Services on Proxmox VE Nodes
==================================================
include::attributes.txt[]
endif::manvolnum[]
Tool to manage http://ceph.com[CEPH] services on {pve} nodes.

View File

@ -1,7 +1,6 @@
ifdef::manvolnum[]
pvecm(1)
========
include::attributes.txt[]
:pve-toplevel:
NAME
@ -21,7 +20,6 @@ endif::manvolnum[]
ifndef::manvolnum[]
Cluster Manager
===============
include::attributes.txt[]
:pve-toplevel:
endif::manvolnum[]

View File

@ -1,7 +1,6 @@
ifdef::manvolnum[]
pvedaemon(8)
============
include::attributes.txt[]
:pve-toplevel:
NAME
@ -22,7 +21,6 @@ endif::manvolnum[]
ifndef::manvolnum[]
pvedaemon - Proxmox VE API Daemon
=================================
include::attributes.txt[]
endif::manvolnum[]
This daemon exposes the whole {pve} API on `127.0.0.1:85`. It runs as

View File

@ -1,7 +1,6 @@
ifdef::manvolnum[]
pveperf(1)
==========
include::attributes.txt[]
:pve-toplevel:
NAME
@ -22,7 +21,6 @@ endif::manvolnum[]
ifndef::manvolnum[]
pveperf - Proxmox VE Benchmark Script
=====================================
include::attributes.txt[]
endif::manvolnum[]
Tries to gather some CPU/hard disk performance data on the hard disk

View File

@ -1,7 +1,6 @@
ifdef::manvolnum[]
pveproxy(8)
===========
include::attributes.txt[]
:pve-toplevel:
NAME
@ -22,7 +21,6 @@ endif::manvolnum[]
ifndef::manvolnum[]
pveproxy - Proxmox VE API Proxy Daemon
======================================
include::attributes.txt[]
endif::manvolnum[]
This daemon exposes the whole {pve} API on TCP port 8006 using

View File

@ -2,7 +2,6 @@
ifdef::manvolnum[]
pvesm(1)
========
include::attributes.txt[]
:pve-toplevel:
NAME
@ -22,7 +21,6 @@ endif::manvolnum[]
ifndef::manvolnum[]
{pve} Storage
=============
include::attributes.txt[]
:pve-toplevel:
endif::manvolnum[]
ifdef::wiki[]

View File

@ -1,7 +1,6 @@
ifdef::manvolnum[]
pvestatd(8)
===========
include::attributes.txt[]
:pve-toplevel:
NAME
@ -21,7 +20,6 @@ endif::manvolnum[]
ifndef::manvolnum[]
pvestatd - Proxmox VE Status Daemon
===================================
include::attributes.txt[]
endif::manvolnum[]
This daemon queries the status of VMs, storages and containers at

View File

@ -1,7 +1,6 @@
ifdef::manvolnum[]
pvesubscription(1)
==================
include::attributes.txt[]
:pve-toplevel:
NAME
@ -21,7 +20,6 @@ endif::manvolnum[]
ifndef::manvolnum[]
pvesubscription - Subscription Management
=========================================
include::attributes.txt[]
endif::manvolnum[]
This tool is used to handle {pve} subscriptions.

View File

@ -2,7 +2,6 @@
ifdef::manvolnum[]
pveum(1)
========
include::attributes.txt[]
:pve-toplevel:
NAME
@ -23,7 +22,6 @@ endif::manvolnum[]
ifndef::manvolnum[]
User Management
===============
include::attributes.txt[]
:pve-toplevel:
endif::manvolnum[]

View File

@ -2,7 +2,6 @@
ifdef::manvolnum[]
qm(1)
=====
include::attributes.txt[]
:pve-toplevel:
NAME
@ -22,7 +21,6 @@ endif::manvolnum[]
ifndef::manvolnum[]
Qemu/KVM Virtual Machines
=========================
include::attributes.txt[]
:pve-toplevel:
endif::manvolnum[]

View File

@ -1,7 +1,6 @@
ifdef::manvolnum[]
qm.conf(5)
==========
include::attributes.txt[]
:pve-toplevel:
NAME
@ -23,7 +22,6 @@ endif::manvolnum[]
ifndef::manvolnum[]
Virtual Machine Configuration
=============================
include::attributes.txt[]
endif::manvolnum[]
ifdef::wiki[]
:pve-toplevel:

View File

@ -1,7 +1,6 @@
ifdef::manvolnum[]
qmrestore(1)
============
include::attributes.txt[]
:pve-toplevel:
NAME
@ -21,7 +20,6 @@ endif::manvolnum[]
ifndef::manvolnum[]
Restore Virtual Machines
========================
include::attributes.txt[]
endif::manvolnum[]

View File

@ -467,6 +467,7 @@ if ($generate_depends) {
my $filelist = $fileinfo->{outfile}->{$e};
foreach my $sourcefile (sort keys %$filelist) {
my $varname = $depend_varname_hash->{$sourcefile};
next if !defined($varname);
my $target = $filelist->{$sourcefile};
my $dep = "\$\{$varname\}";
$make_targets->{$target} = $dep;

View File

@ -1,7 +1,6 @@
ifdef::manvolnum[]
spiceproxy(8)
=============
include::attributes.txt[]
:pve-toplevel:
NAME
@ -22,7 +21,6 @@ endif::manvolnum[]
ifndef::manvolnum[]
spiceproxy - SPICE Proxy Service
================================
include::attributes.txt[]
endif::manvolnum[]
http://www.spice-space.org[SPICE] (the Simple Protocol for Independent

View File

@ -1,7 +1,6 @@
[[chapter_system_administration]]
Host System Administration
==========================
include::attributes.txt[]
ifndef::manvolnum[]
:pve-toplevel:
endif::manvolnum[]

View File

@ -1,6 +1,5 @@
System Software Updates
-----------------------
include::attributes.txt[]
ifdef::wiki[]
:pve-toplevel:
endif::wiki[]

View File

@ -1,6 +1,5 @@
Time Synchronization
--------------------
include::attributes.txt[]
ifdef::wiki[]
:pve-toplevel:
endif::wiki[]

View File

@ -2,7 +2,6 @@
ifdef::manvolnum[]
vzdump(1)
=========
include::attributes.txt[]
:pve-toplevel:
NAME
@ -23,7 +22,6 @@ endif::manvolnum[]
ifndef::manvolnum[]
Backup and Restore
==================
include::attributes.txt[]
:pve-toplevel:
endif::manvolnum[]