Академический Документы
Профессиональный Документы
Культура Документы
=====================
Prerequisites
-------------
See the link:README.html[README] page.
$ hg --version
[subs="attributes"]
$ cd ~/bin
$ hg clone -r {revnumber} https://asciidoc.googlecode.com/hg/ asciidoc-
{revnumber}
You now have two choices: you can run asciidoc locally from your
repository or you can use 'autoconf(1)' and 'make(1)' to perform a
system-wide install.
[subs="attributes"]
$ ln -s ~/bin/asciidoc-{revnumber}/asciidoc.py ~/bin/asciidoc
$ ln -s ~/bin/asciidoc-{revnumber}/a2x.py ~/bin/a2x
Use the Mercurial `pull` command to update your local AsciiDoc repository.
---------------------------------------------
$ autoconf
$ ./configure
$ make
$ sudo make install
---------------------------------------------
To uninstall:
---------------------------------------------
$ sudo make uninstall
---------------------------------------------
[[X1]]
Distribution tarball installation
---------------------------------
The distribution source tarballs can be downloaded from the
SourceForge http://sourceforge.net/projects/asciidoc/.
[subs="attributes"]
$ tar -xzf asciidoc-{revnumber}.tar.gz
$ cd asciidoc-{revnumber}
$ ./configure
$ sudo make install
To uninstall AsciiDoc:
[[X3]]
Microsoft Windows installation
------------------------------
AsciiDoc is developed and tested on Linux but there seem to be quite a
few people using it on Windows. To install AsciiDoc on Windows unzip
the distribution Zip file contents:
[subs="attributes"]
$ unzip asciidoc-{revnumber}.zip
This will create the folder +asciidoc-{revnumber}+ containing the
`asciidoc.py` and `a2x.py` executables along with configuration files
and documentation.
To generate DocBook based outputs (e.g. PDFs) you will also need a
working DocBook toolchain. Installing and configuring a DocBook
toolchain on Windows can be a challenge -- this blog post explains
http://blog.rainwebs.net/2010/02/25/how-to-create-handsome-pdf-documents-without-
frustration/[How
to Create Handsome PDF Documents Without Frustration] using
http://www.cygwin.com/[Cygwin],
http://dblatex.sourceforge.net/[dblatex] and AsciiDoc.
A full battery of tests can be run from the `main.aap` script in the
distribution root directory:
$ aap test
$ aap
[[X2]]
Prepackaged AsciiDoc installation
---------------------------------
The following platform specific AsciiDoc packages are available:
*Debian GNU/Linux*::
If you use Debian or a Debian based distribution there's an
http://packages.debian.org/asciidoc[AsciiDoc Debian package]
available. Thanks to mailto:stone@debian.org[Fredrik Steen] who
built and maintains the Debian AsciiDoc package.
*Gentoo Linux*::
If you use Gentoo Linux there's a
http://packages.gentoo.org/package/app-text/asciidoc[Gentoo AsciiDoc
package] available. Thanks to mailto:brandon@ifup.org[Brandon
Philips] for writing the ebuild.
*Fedora Linux*::
With help from Terje Rsten, Chris Wright added asciidoc to Fedora
Extras which is available in the default installation. To install
asciidoc execute the following command:
*Slackware Linux*::
John Calixto has created a Slackware package for AsciiDoc which can
be downloaded from http://linuxpackages.net/.
*Ark Linux*::
mailto:bero@arklinux.org[Bernhard Rosenkraenzer] added AsciiDoc to
Ark Linux -- the package is available from the Ark Linux repository
at http://arklinux.osuosl.org/dockyard-devel/, so Ark Linux users
should just run `apt-get install asciidoc`.
*T2 Linux*::
mailto:cw@ixplanet.de[Christian Wiese] added AsciiDoc to the
http://www.t2-project.org/[T2 Linux] repository at
http://svn.exactcode.de/t2/trunk/package/textproc/asciidoc/. To
build and install the package on a T2 system, run
`./scripts/Emerge-Pkg asciidoc` from within your T2 source directory
(default: `/usr/src/t2-src`).