stephan/cdist
1
0
Fork 0
forked from ungleich-public/cdist
Code Issues Pull requests Projects Releases Wiki Activity

Merge pull request #453 from darko-poljak/improve-docs-build

Browse source 
Improve docs build
This commit is contained in:
Nico Schottelius 2016-07-07 21:49:38 +09:00 committed by GitHub
commit 9b2800b614
90 changed files with 163 additions and 242 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

13
.gitignore vendored
View file

@ -2,14 +2,11 @@
.*.swp .*.swp
# Ignore generated manpages # Ignore generated manpages
docs/man/.marker docs/src/.marker
docs/man/man1/*.1 docs/src/man1/*.1
docs/man/man7/*.7 docs/src/man7/*.7
docs/man/man*/*.html docs/src/man7/cdist-type__*.rst
docs/man/man*/*.xml docs/src/cdist-reference.rst
docs/man/man*/docbook-xsl.css
docs/man/man7/cdist-type__*.rst
docs/man/cdist-reference.rst
# Ignore cdist cache for version control # Ignore cdist cache for version control
/cache/ /cache/

43
Makefile
View file

@ -20,7 +20,7 @@
helper=./bin/build-helper helper=./bin/build-helper
MANDIR=docs/man DOCS_SRC_DIR=docs/src
SPEECHDIR=docs/speeches SPEECHDIR=docs/speeches
TYPEDIR=cdist/conf/type TYPEDIR=cdist/conf/type
@ -36,13 +36,13 @@ CHANGELOG_FILE=docs/changelog
PYTHON_VERSION=cdist/version.py PYTHON_VERSION=cdist/version.py
SPHINXM=make -C $(MANDIR) man SPHINXM=make -C $(DOCS_SRC_DIR) man
SPHINXH=make -C $(MANDIR) html SPHINXH=make -C $(DOCS_SRC_DIR) html
################################################################################ ################################################################################
# Manpages # Manpages
# #
MAN1DSTDIR=$(MANDIR)/man1 MAN1DSTDIR=$(DOCS_SRC_DIR)/man1
MAN7DSTDIR=$(MANDIR)/man7 MAN7DSTDIR=$(DOCS_SRC_DIR)/man7
# Manpages #1: Types # Manpages #1: Types
# Use shell / ls to get complete list - $(TYPEDIR)/*/man.rst does not work # Use shell / ls to get complete list - $(TYPEDIR)/*/man.rst does not work
@ -56,32 +56,32 @@ $(MAN7DSTDIR)/cdist-type%.rst: $(TYPEDIR)/%/man.rst
ln -sf "../../../$^" $@ ln -sf "../../../$^" $@
# Manpages #2: reference # Manpages #2: reference
MANREF=$(MAN7DSTDIR)/cdist-reference.rst DOCSREF=$(MAN7DSTDIR)/cdist-reference.rst
MANREFSH=$(MANDIR)/cdist-reference.rst.sh DOCSREFSH=$(DOCS_SRC_DIR)/cdist-reference.rst.sh
$(MANREF): $(MANREFSH) $(DOCSREF): $(DOCSREFSH)
$(MANREFSH) $(DOCSREFSH)
# Manpages #3: generic part # Manpages #3: generic part
mansphinxman: $(MANTYPES) $(MANREF) $(PYTHON_VERSION) man: $(MANTYPES) $(DOCSREF) $(PYTHON_VERSION)
$(SPHINXM) $(SPHINXM)
mansphinxhtml: $(MANTYPES) $(MANREF) $(PYTHON_VERSION) html: $(MANTYPES) $(DOCSREF) $(PYTHON_VERSION)
$(SPHINXH) $(SPHINXH)
man: mansphinxman mansphinxhtml docs: man html
# Manpages #5: release part # Manpages #5: release part
MANWEBDIR=$(WEBBASE)/man/$(CHANGELOG_VERSION) MANWEBDIR=$(WEBBASE)/man/$(CHANGELOG_VERSION)
MANBUILDDIR=docs/dist/html HTMLBUILDDIR=docs/dist/html
man-dist: man docs-dist: html
rm -rf "${MANWEBDIR}" rm -rf "${MANWEBDIR}"
mkdir -p "${MANWEBDIR}" mkdir -p "${MANWEBDIR}"
# mkdir -p "${MANWEBDIR}/man1" "${MANWEBDIR}/man7" # mkdir -p "${MANWEBDIR}/man1" "${MANWEBDIR}/man7"
# cp ${MAN1DSTDIR}/*.html ${MAN1DSTDIR}/*.css ${MANWEBDIR}/man1 # cp ${MAN1DSTDIR}/*.html ${MAN1DSTDIR}/*.css ${MANWEBDIR}/man1
# cp ${MAN7DSTDIR}/*.html ${MAN7DSTDIR}/*.css ${MANWEBDIR}/man7 # cp ${MAN7DSTDIR}/*.html ${MAN7DSTDIR}/*.css ${MANWEBDIR}/man7
cp -R ${MANBUILDDIR}/* ${MANWEBDIR} cp -R ${HTMLBUILDDIR}/* ${MANWEBDIR}
cd ${MANWEBDIR} && git add . && git commit -m "cdist manpages update: $(CHANGELOG_VERSION)" || true cd ${MANWEBDIR} && git add . && git commit -m "cdist manpages update: $(CHANGELOG_VERSION)" || true
man-latest-link: web-pub man-latest-link: web-pub
@ -102,12 +102,9 @@ $(DOTMAN7DSTDIR)/cdist-type%.rst: $(DOTTYPEDIR)/%/man.rst
ln -sf "$^" $@ ln -sf "$^" $@
# Manpages #3: generic part # Manpages #3: generic part
dotmansphinxman: $(DOTMANTYPES) dotman: $(DOTMANTYPES)
$(SPHINXM) $(SPHINXM)
dotman: dotmansphinxman
################################################################################ ################################################################################
# Speeches # Speeches
# #
@ -147,7 +144,7 @@ web-doc:
web-dist: web-blog web-doc web-dist: web-blog web-doc
web-pub: web-dist man-dist speeches-dist web-pub: web-dist docs-dist speeches-dist
cd "${WEBDIR}" && make pub cd "${WEBDIR}" && make pub
web-release-all: man-latest-link web-release-all: man-latest-link
@ -212,12 +209,12 @@ release:
# #
clean: clean:
rm -f $(MANDIR)/cdist-reference.rst rm -f $(DOCS_SRC_DIR)/cdist-reference.rst
find "$(MANDIR)" -mindepth 2 -type l \ find "$(DOCS_SRC_DIR)" -mindepth 2 -type l \
| xargs rm -f | xargs rm -f
make -C $(MANDIR) clean make -C $(DOCS_SRC_DIR) clean
find * -name __pycache__ | xargs rm -rf find * -name __pycache__ | xargs rm -rf

4
bin/build-helper
View file

@ -206,8 +206,8 @@ eof
"$0" check-date "$0" check-date
"$0" check-unittest "$0" check-unittest
# Generate man pages (indirect check if they build) # Generate documentation (man and html)
make man make docs
# Generate speeches (indirect check if they build) # Generate speeches (indirect check if they build)
make speeches make speeches

4
bin/build-helper.freebsd
View file

@ -241,8 +241,8 @@ eof
"$0" check-date "$0" check-date
"$0" check-unittest "$0" check-unittest
# Generate man pages (indirect check if they build) # Generate documentation (man and html)
make helper=${helper} WEBDIR=${WEBDIR} man make helper=${helper} WEBDIR=${WEBDIR} docs
# Generate speeches (indirect check if they build) # Generate speeches (indirect check if they build)
make helper=${helper} WEBDIR=${WEBDIR} speeches make helper=${helper} WEBDIR=${WEBDIR} speeches

2
cdist/conf/type/__ccollect_source/man.rst
View file

@ -53,7 +53,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`ccollect`\ (1) :strong:`ccollect`\ (1)
AUTHORS AUTHORS

2
cdist/conf/type/__config_file/man.rst
View file

@ -48,7 +48,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__file`\ (7) :strong:`cdist-type__file`\ (7)
AUTHORS AUTHORS

2
cdist/conf/type/__consul_check/man.rst
View file

@ -62,7 +62,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__consul_agent`\ (7) :strong:`cdist-type__consul_agent`\ (7)
AUTHORS AUTHORS

2
cdist/conf/type/__consul_service/man.rst
View file

@ -66,7 +66,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__consul_agent`\ (7) :strong:`cdist-type__consul_agent`\ (7)
AUTHORS AUTHORS

2
cdist/conf/type/__consul_template_template/man.rst
View file

@ -59,7 +59,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__consul_template`\ (7), :manpage:`cdist-type__consul_template_config`\ (7) :strong:`cdist-type__consul_template`\ (7), :strong:`cdist-type__consul_template_config`\ (7)
AUTHORS AUTHORS

2
cdist/conf/type/__consul_watch_checks/man.rst
View file

@ -55,7 +55,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__consul_agent`\ (7) :strong:`cdist-type__consul_agent`\ (7)
consul documentation at: <http://www.consul.io/docs/agent/watches.html>. consul documentation at: <http://www.consul.io/docs/agent/watches.html>.

2
cdist/conf/type/__consul_watch_event/man.rst
View file

@ -48,7 +48,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__consul_agent`\ (7) :strong:`cdist-type__consul_agent`\ (7)
consul documentation at: <http://www.consul.io/docs/agent/watches.html>. consul documentation at: <http://www.consul.io/docs/agent/watches.html>.

2
cdist/conf/type/__consul_watch_key/man.rst
View file

@ -45,7 +45,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__consul_agent`\ (7) :strong:`cdist-type__consul_agent`\ (7)
consul documentation at: <http://www.consul.io/docs/agent/watches.html>. consul documentation at: <http://www.consul.io/docs/agent/watches.html>.

2
cdist/conf/type/__consul_watch_keyprefix/man.rst
View file

@ -45,7 +45,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__consul_agent`\ (7) :strong:`cdist-type__consul_agent`\ (7)
consul documentation at: <http://www.consul.io/docs/agent/watches.html>. consul documentation at: <http://www.consul.io/docs/agent/watches.html>.

2
cdist/conf/type/__consul_watch_nodes/man.rst
View file

@ -41,7 +41,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__consul_agent`\ (7) :strong:`cdist-type__consul_agent`\ (7)
consul documentation at: <http://www.consul.io/docs/agent/watches.html>. consul documentation at: <http://www.consul.io/docs/agent/watches.html>.

2
cdist/conf/type/__consul_watch_service/man.rst
View file

@ -65,7 +65,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__consul_agent`\ (7) :strong:`cdist-type__consul_agent`\ (7)
consul documentation at: <http://www.consul.io/docs/agent/watches.html>. consul documentation at: <http://www.consul.io/docs/agent/watches.html>.

2
cdist/conf/type/__consul_watch_services/man.rst
View file

@ -41,7 +41,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__consul_agent`\ (7) :strong:`cdist-type__consul_agent`\ (7)
consul documentation at: <http://www.consul.io/docs/agent/watches.html>. consul documentation at: <http://www.consul.io/docs/agent/watches.html>.

2
cdist/conf/type/__cron/man.rst
View file

@ -68,7 +68,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`crontab`\ (5) :strong:`crontab`\ (5)
AUTHORS AUTHORS

2
cdist/conf/type/__debconf_set_selections/man.rst
View file

@ -37,7 +37,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`debconf-set-selections`\ (1), :manpage:`cdist-type__update_alternatives`\ (7) :strong:`debconf-set-selections`\ (1), :strong:`cdist-type__update_alternatives`\ (7)
AUTHORS AUTHORS

2
cdist/conf/type/__dog_vdi/man.rst
View file

@ -43,7 +43,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`qemu`\ (1), :manpage:`dog`\ (8) :strong:`qemu`\ (1), :strong:`dog`\ (8)
AUTHORS AUTHORS

2
cdist/conf/type/__firewalld_rule/man.rst
View file

@ -65,7 +65,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__iptables_rule`\ (7), :manpage:`firewalld`\ (8) :strong:`cdist-type__iptables_rule`\ (7), :strong:`firewalld`\ (8)
AUTHORS AUTHORS

2
cdist/conf/type/__iptables_apply/man.rst
View file

@ -29,7 +29,7 @@ None (__iptables_apply is used by __iptables_rule)
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__iptables_rule`\ (7), :manpage:`iptables`\ (8) :strong:`cdist-type__iptables_rule`\ (7), :strong:`iptables`\ (8)
AUTHORS AUTHORS

2
cdist/conf/type/__iptables_rule/man.rst
View file

@ -50,7 +50,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__iptables_apply`\ (7), :manpage:`iptables`\ (8) :strong:`cdist-type__iptables_apply`\ (7), :strong:`iptables`\ (8)
AUTHORS AUTHORS

2
cdist/conf/type/__jail/man.rst
View file

@ -108,7 +108,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`jail`\ (8) :strong:`jail`\ (8)
AUTHORS AUTHORS

2
cdist/conf/type/__jail_freebsd10/man.rst
View file

@ -107,7 +107,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`jail`\ (8) :strong:`jail`\ (8)
AUTHORS AUTHORS

2
cdist/conf/type/__jail_freebsd9/man.rst
View file

@ -108,7 +108,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`jail`\ (8) :strong:`jail`\ (8)
AUTHORS AUTHORS

2
cdist/conf/type/__line/man.rst
View file

@ -61,7 +61,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`grep`\ (1) :strong:`grep`\ (1)
AUTHORS AUTHORS

2
cdist/conf/type/__locale/man.rst
View file

@ -34,7 +34,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`locale`\ (1), :manpage:`localedef`\ (1) :strong:`locale`\ (1), :strong:`localedef`\ (1)
AUTHORS AUTHORS

2
cdist/conf/type/__package_apt/man.rst
View file

@ -46,7 +46,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__package`\ (7) :strong:`cdist-type__package`\ (7)
AUTHORS AUTHORS

2
cdist/conf/type/__package_emerge/man.rst
View file

@ -47,7 +47,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__package`\ (7), :manpage:`cdist-type__package_emerge_dependencies`\ (7) :strong:`cdist-type__package`\ (7), :strong:`cdist-type__package_emerge_dependencies`\ (7)
AUTHORS AUTHORS

2
cdist/conf/type/__package_emerge_dependencies/man.rst
View file

@ -36,7 +36,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__package`\ (7), :manpage:`cdist-type__package_emerge`\ (7) :strong:`cdist-type__package`\ (7), :strong:`cdist-type__package_emerge`\ (7)
AUTHORS AUTHORS

2
cdist/conf/type/__package_luarocks/man.rst
View file

@ -39,7 +39,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__package`\ (7) :strong:`cdist-type__package`\ (7)
AUTHORS AUTHORS

2
cdist/conf/type/__package_opkg/man.rst
View file

@ -39,7 +39,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__package`\ (7) :strong:`cdist-type__package`\ (7)
AUTHORS AUTHORS

2
cdist/conf/type/__package_pacman/man.rst
View file

@ -42,7 +42,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__package`\ (7) :strong:`cdist-type__package`\ (7)
AUTHORS AUTHORS

2
cdist/conf/type/__package_pip/man.rst
View file

@ -49,7 +49,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__package`\ (7) :strong:`cdist-type__package`\ (7)
AUTHORS AUTHORS

2
cdist/conf/type/__package_pkg_freebsd/man.rst
View file

@ -54,7 +54,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__package`\ (7) :strong:`cdist-type__package`\ (7)
AUTHORS AUTHORS

2
cdist/conf/type/__package_pkg_openbsd/man.rst
View file

@ -54,7 +54,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__package`\ (7) :strong:`cdist-type__package`\ (7)
AUTHORS AUTHORS

2
cdist/conf/type/__package_pkgng_freebsd/man.rst
View file

@ -85,7 +85,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__package`\ (7) :strong:`cdist-type__package`\ (7)
AUTHORS AUTHORS

2
cdist/conf/type/__package_rubygem/man.rst
View file

@ -39,7 +39,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__package`\ (7) :strong:`cdist-type__package`\ (7)
AUTHORS AUTHORS

2
cdist/conf/type/__package_yum/man.rst
View file

@ -49,7 +49,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__package`\ (7) :strong:`cdist-type__package`\ (7)
AUTHORS AUTHORS

2
cdist/conf/type/__package_zypper/man.rst
View file

@ -56,7 +56,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__package`\ (7) :strong:`cdist-type__package`\ (7)
AUTHORS AUTHORS

2
cdist/conf/type/__pacman_conf/man.rst
View file

@ -59,7 +59,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`grep`\ (1) :strong:`grep`\ (1)
AUTHORS AUTHORS

2
cdist/conf/type/__pacman_conf_integrate/man.rst
View file

@ -35,7 +35,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`grep`\ (1) :strong:`grep`\ (1)
AUTHORS AUTHORS

2
cdist/conf/type/__pf_apply/man.rst
View file

@ -39,7 +39,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`pf`\ (4), :manpage:`cdist-type__pf_ruleset`\ (7) :strong:`pf`\ (4), :strong:`cdist-type__pf_ruleset`\ (7)
AUTHORS AUTHORS

2
cdist/conf/type/__pf_ruleset/man.rst
View file

@ -39,7 +39,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`pf`\ (4) :strong:`pf`\ (4)
AUTHORS AUTHORS

2
cdist/conf/type/__postfix_master/man.rst
View file

@ -68,7 +68,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`master`\ (5) :strong:`master`\ (5)
AUTHORS AUTHORS

2
cdist/conf/type/__postfix_postconf/man.rst
View file

@ -38,7 +38,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`postconf`\ (5) :strong:`postconf`\ (5)
AUTHORS AUTHORS

2
cdist/conf/type/__postgres_database/man.rst
View file

@ -30,7 +30,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__postgres_role`\ (7) :strong:`cdist-type__postgres_role`\ (7)
AUTHORS AUTHORS

2
cdist/conf/type/__postgres_role/man.rst
View file

@ -48,7 +48,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__postgres_database`\ (7) :strong:`cdist-type__postgres_database`\ (7)
postgresql documentation at: postgresql documentation at:
<http://www.postgresql.org/docs/current/static/sql-createrole.html>. <http://www.postgresql.org/docs/current/static/sql-createrole.html>.

2
cdist/conf/type/__process/man.rst
View file

@ -58,7 +58,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__start_on_boot`\ (7) :strong:`cdist-type__start_on_boot`\ (7)
AUTHORS AUTHORS

2
cdist/conf/type/__qemu_img/man.rst
View file

@ -37,7 +37,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`qemu-img`\ (1) :strong:`qemu-img`\ (1)
AUTHORS AUTHORS

2
cdist/conf/type/__rsync/man.rst
View file

@ -98,7 +98,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`rsync`\ (1) :strong:`rsync`\ (1)
AUTHORS AUTHORS

4
cdist/conf/type/__rvm/man.rst
View file

@ -31,8 +31,8 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__rvm_gem`\ (7), :manpage:`cdist-type__rvm_gemset`\ (7), :strong:`cdist-type__rvm_gem`\ (7), :strong:`cdist-type__rvm_gemset`\ (7),
:manpage:`cdist-type__rvm_ruby`\ (7) :strong:`cdist-type__rvm_ruby`\ (7)
AUTHORS AUTHORS

4
cdist/conf/type/__rvm_gem/man.rst
View file

@ -43,8 +43,8 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__rvm`\ (7), :manpage:`cdist-type__rvm_gemset`\ (7), :strong:`cdist-type__rvm`\ (7), :strong:`cdist-type__rvm_gemset`\ (7),
:manpage:`cdist-type__rvm_ruby`\ (7) :strong:`cdist-type__rvm_ruby`\ (7)
AUTHORS AUTHORS

4
cdist/conf/type/__rvm_gemset/man.rst
View file

@ -41,8 +41,8 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__rvm`\ (7), :manpage:`cdist-type__rvm_gem`\ (7), :strong:`cdist-type__rvm`\ (7), :strong:`cdist-type__rvm_gem`\ (7),
:manpage:`cdist-type__rvm_ruby`\ (7) :strong:`cdist-type__rvm_ruby`\ (7)
AUTHORS AUTHORS

4
cdist/conf/type/__rvm_ruby/man.rst
View file

@ -42,8 +42,8 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__rvm`\ (7), :manpage:`cdist-type__rvm_gem`\ (7), :strong:`cdist-type__rvm`\ (7), :strong:`cdist-type__rvm_gem`\ (7),
:manpage:`cdist-type__rvm_gemset`\ (7) :strong:`cdist-type__rvm_gemset`\ (7)
AUTHORS AUTHORS

2
cdist/conf/type/__ssh_authorized_key/man.rst
View file

@ -55,7 +55,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist__ssh_authorized_keys`\ (7), :manpage:`sshd`\ (8) :strong:`cdist__ssh_authorized_keys`\ (7), :strong:`sshd`\ (8)
AUTHORS AUTHORS

2
cdist/conf/type/__ssh_authorized_keys/man.rst
View file

@ -105,7 +105,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`sshd`\ (8) :strong:`sshd`\ (8)
AUTHORS AUTHORS

2
cdist/conf/type/__ssh_dot_ssh/man.rst
View file

@ -33,7 +33,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__ssh_authorized_keys`\ (7) :strong:`cdist-type__ssh_authorized_keys`\ (7)
AUTHORS AUTHORS

2
cdist/conf/type/__staged_file/man.rst
View file

@ -99,7 +99,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__file`\ (7) :strong:`cdist-type__file`\ (7)
AUTHORS AUTHORS

2
cdist/conf/type/__start_on_boot/man.rst
View file

@ -45,7 +45,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__process`\ (7) :strong:`cdist-type__process`\ (7)
AUTHORS AUTHORS

2
cdist/conf/type/__update_alternatives/man.rst
View file

@ -30,7 +30,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`cdist-type__debconf_set_selections`\ (7), :manpage:`update-alternatives`\ (8) :strong:`cdist-type__debconf_set_selections`\ (7), :strong:`update-alternatives`\ (8)
AUTHORS AUTHORS

2
cdist/conf/type/__user/man.rst
View file

@ -84,7 +84,7 @@ EXAMPLES
SEE ALSO SEE ALSO
-------- --------
:manpage:`pw`\ (8), :manpage:`usermod`\ (8) :strong:`pw`\ (8), :strong:`usermod`\ (8)
AUTHORS AUTHORS

0
docs/man/Makefile → docs/src/Makefile
View file

0
docs/man/cdist-best-practice.rst → docs/src/cdist-best-practice.rst
View file

0
docs/man/cdist-bootstrap.rst → docs/src/cdist-bootstrap.rst
View file

0
docs/man/cdist-explorer.rst → docs/src/cdist-explorer.rst
View file

0
docs/man/cdist-features.rst → docs/src/cdist-features.rst
View file

0
docs/man/cdist-hacker.rst → docs/src/cdist-hacker.rst
View file

44
docs/man/cdist-install.rst → docs/src/cdist-install.rst
View file

@ -68,19 +68,44 @@ If the main site is down, you can acquire cdist from one of the following sites:
* git://github.com/telmich/cdist.git `github <https://github.com/telmich/cdist>`_ * git://github.com/telmich/cdist.git `github <https://github.com/telmich/cdist>`_
* git://git.code.sf.net/p/cdist/code `sourceforge <https://sourceforge.net/p/cdist/code>`_ * git://git.code.sf.net/p/cdist/code `sourceforge <https://sourceforge.net/p/cdist/code>`_
Building and using manpages Building and using documentation (man and html)
^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
If you want to build and use the manpages, run: If you want to build and use the documentation, run:
.. code-block:: sh
make docs
Documentation comes in two formats, man pages and full HTML
documentation. Documentation is built into distribution's
docs/dist directory. man pages are in docs/dist/man and
HTML documentation in docs/dist/html.
If you want to use man pages, run:
.. code-block:: sh .. code-block:: sh
make man
export MANPATH=$MANPATH:$(pwd -P)/docs/dist/man export MANPATH=$MANPATH:$(pwd -P)/docs/dist/man
Or you can move man pages from docs/dist/man directory to some Or you can move man pages from docs/dist/man directory to some
other directory and add it to MANPATH. other directory and add it to MANPATH.
Full HTML documentation can be accessed at docs/dist/html/index.html.
You can also build only man pages or only html documentation, for
only man pages run:
.. code-block:: sh
make man
for only html documentation run:
.. code-block:: sh
make html
You can also build man pages for types in your ~/.cdist directory: You can also build man pages for types in your ~/.cdist directory:
.. code-block:: sh .. code-block:: sh
@ -94,17 +119,6 @@ some other custom .cdist directory, e.g. /opt/cdist then use:
DOT_CDIST_PATH=/opt/cdist make dotman DOT_CDIST_PATH=/opt/cdist make dotman
Building and using HTML documentation
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
If you want to build and use HTML documentation, run:
.. code-block:: sh
make html
Now you can access docs/dist/html/index.html.
Python package Python package
~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~

0
docs/man/cdist-intro.rst → docs/src/cdist-intro.rst
View file

0
docs/man/cdist-logo.png → docs/src/cdist-logo.png
View file

Side by side Swipe Overlay

Before

Width:  |  Height:  |  Size: 1.5 KiB

After

Width:  |  Height:  |  Size: 1.5 KiB

0
docs/man/cdist-manifest.rst → docs/src/cdist-manifest.rst
View file

0
docs/man/cdist-messaging.rst → docs/src/cdist-messaging.rst
View file

0
docs/man/cdist-os.rst → docs/src/cdist-os.rst
View file

0
docs/man/cdist-quickstart.rst → docs/src/cdist-quickstart.rst
View file

0
docs/man/cdist-reference.rst.sh → docs/src/cdist-reference.rst.sh
View file

0
docs/man/cdist-remote-exec-copy.rst → docs/src/cdist-remote-exec-copy.rst
View file

0
docs/man/cdist-stages.rst → docs/src/cdist-stages.rst
View file

0
docs/man/cdist-support.rst → docs/src/cdist-support.rst
View file

0
docs/man/cdist-troubleshooting.rst → docs/src/cdist-troubleshooting.rst
View file

0
docs/man/cdist-type.rst → docs/src/cdist-type.rst
View file

0
docs/man/cdist-types.rst → docs/src/cdist-types.rst
View file

0
docs/man/cdist-update.rst → docs/src/cdist-update.rst
View file

0
docs/man/cdist-why.rst → docs/src/cdist-why.rst
View file

0
docs/man/conf.py → docs/src/conf.py
View file

0
docs/man/index.rst → docs/src/index.rst
View file

4
docs/man/man1/cdist.rst → docs/src/man1/cdist.rst
View file

@ -56,10 +56,6 @@ CONFIG
------ ------
Configure one or more hosts Configure one or more hosts
.. option:: -h, --help
Show the help screen
.. option:: -c CONF_DIR, --conf-dir CONF_DIR .. option:: -c CONF_DIR, --conf-dir CONF_DIR
Add a configuration directory. Can be specified multiple times. Add a configuration directory. Can be specified multiple times.

0
docs/man/man7/.gitignore → docs/src/man7/.gitignore vendored
View file

4
docs/web/cdist/documentation.mdwn
View file

@ -1,7 +1,7 @@
[[!meta title="Documentation"]] [[!meta title="Documentation"]]
You can browse the latest You can browse the
[latest version of the manpages](/software/cdist/man/latest) or [latest version of the documentation](/software/cdist/man/latest) or
have a look at [all versions](/software/cdist/man). have a look at [all versions](/software/cdist/man).
You can also view [speeches about cdist](/software/cdist/speeches). You can also view [speeches about cdist](/software/cdist/speeches).

143
docs/web/cdist/install.mdwn
View file

@ -17,114 +17,6 @@ This is the machine you use to configure the target hosts.
* /bin/sh: A posix like shell (for instance bash, dash, zsh) * /bin/sh: A posix like shell (for instance bash, dash, zsh)
* SSH server * SSH server
## Requirement Installation: Python >= 3.2
Ensure you have at least Python 3.2 or newer installed on
the **source host**.
You can check this by running **python -V**:
% python -V
Python 3.3.0
### Archlinux
Archlinux includes a recent python in the extra repository.
You can install it using
pacman -S python
### CentOS
See the "From source" section
### Debian
For Debian **wheezy** or newer:
aptitude install python3
On **squeeze** you can add following line in **/etc/apt/sources.list**
deb http://ftp.debian.org/debian wheezy main
And add pinning entry in **/etc/apt/preferences.d/wheezy**:
Package: *
Pin: release n=wheezy
Pin-Priority: 1
Please be aware that both **openssh-server** and **openssh-client** might be
removed on **python3.2** installation. You surely want to reinstall them:
apt-get install -t wheezy openssh-server openssh-client
For older Debian versions, installing python 3.2 from source is required.
If you want to build the cdist manpages:
aptitude install --without-recommends asciidoc xsltproc
### Fedora
Fedora 15 and newer includes a recent python.
You can install it using
yum install python3
### FreeBSD
For the port:
cd /usr/ports/lang/python32/ && make install clean
For the package:
pkg_add -r python32
You can also use any newer version, but at least python 3.2 is required.
### Gentoo
Gentoo only provides python 3.2 in testing packages (http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=3&chap=3).
If you want to ensure nothing breaks you must set back the python version to what was default before.
emerge -av =python-3.2.2 --autounmask-write
emerge -av =python-3.2.2
eselect python list
eselect python list set python3.2
### Max OS X
You can choose between Homebrew and Macports, either way works:
[Homebrew](http://mxcl.github.com/homebrew/) variant:
brew install python3
[Macports](http://www.macports.org/install.php) variant:
port install python32
ln -s /opt/local/bin/python3.2 /opt/local/bin/python3
### Redhat
See the "From source" section
### From Source
For those operating systems not yet supporting Python 3.2:
pyversion=3.2.3
wget http://www.python.org/ftp/python/$pyversion/Python-${pyversion}.tar.bz2
tar xvfj Python-${pyversion}.tar.bz2
cd Python-${pyversion}
./configure
make
sudo make install
This installs python 3.2 to /usr/local/bin.
Ensure this directory is in your PATH environment variable.
## Install cdist ## Install cdist
You can install cdist either from git or as a python package. You can install cdist either from git or as a python package.
@ -141,11 +33,6 @@ To install cdist, execute the following commands:
cd cdist cd cdist
export PATH=$PATH:$(pwd -P)/bin export PATH=$PATH:$(pwd -P)/bin
If you want to build and use the manpages, run:
make man
export MANPATH=$MANPATH:$(pwd -P)/doc/man
#### Available versions in git #### Available versions in git
* The active development takes place in the **master** branch * The active development takes place in the **master** branch
@ -169,6 +56,36 @@ If the main site is down, you can acquire cdist from one of the following sites:
* git://github.com/telmich/cdist.git ([github](https://github.com/telmich/cdist)) * git://github.com/telmich/cdist.git ([github](https://github.com/telmich/cdist))
* git://git.code.sf.net/p/cdist/code ([sourceforge](https://sourceforge.net/p/cdist/code)) * git://git.code.sf.net/p/cdist/code ([sourceforge](https://sourceforge.net/p/cdist/code))
#### Building and using documentation (man and html)
If you want to build and use the documentation, run:
make docs
Documentation comes in two formats, man pages and full HTML
documentation. Documentation is built into distribution's
docs/dist directory. man pages are in docs/dist/man and
HTML documentation in docs/dist/html.
If you want to use man pages, run:
export MANPATH=$MANPATH:$(pwd -P)/docs/dist/man
Or you can move manpages from docs/dist/man directory to some
other directory and add it to MANPATH.
Full HTML documentation can be accessed at docs/dist/html/index.html.
You can also build manpages for types in your ~/.cdist directory:
make dotman
Built manpages are now in docs/dist/man directory. If you have
some other custom .cdist directory, e.g. /opt/cdist then use:
DOT_CDIST_PATH=/opt/cdist make dotman
### Python Package ### Python Package
Cdist is available as a python package at Cdist is available as a python package at