From 136d443b5c38bee96f5d995dfea3629ef07564c3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lo=C3=AFc=20Hoguin?= Date: Thu, 18 Jul 2019 09:59:28 +0200 Subject: Announce Ranch 2.0.0-rc.1 Adds Ranch 2.0 documentation and removes documentation for very old Cowboy and Ranch, along with Erlang.mk documentation which is available on its own website. --- docs/en/erlang.mk/1/guide/asciidoc/index.html | 223 -------------------------- 1 file changed, 223 deletions(-) delete mode 100644 docs/en/erlang.mk/1/guide/asciidoc/index.html (limited to 'docs/en/erlang.mk/1/guide/asciidoc/index.html') diff --git a/docs/en/erlang.mk/1/guide/asciidoc/index.html b/docs/en/erlang.mk/1/guide/asciidoc/index.html deleted file mode 100644 index a695b257..00000000 --- a/docs/en/erlang.mk/1/guide/asciidoc/index.html +++ /dev/null @@ -1,223 +0,0 @@ - - - - - - - - - - Nine Nines: AsciiDoc documentation - - - - - - - - - - - - - - -

- - - -

- -

AsciiDoc documentation

- -

Erlang.mk provides rules for generating documentation from AsciiDoc files. It can automatically build a user guide PDF, chunked HTML documentation and Unix manual pages.

Requirements

It is necessary to have AsciiDoc, xsltproc and dblatex installed on your system for Erlang.mk to generate documentation from AsciiDoc sources.

Writing AsciiDoc documentation

AsciiDoc is a text document format for writing notes, documentation, articles, books, ebooks, slideshows, web pages, man pages and blogs. AsciiDoc files can be translated to many formats including HTML, PDF, EPUB, man page.

The AsciiDoc user guide describes the AsciiDoc syntax.

The Erlang.mk user guide is written in AsciiDoc and can be used as an example. The entry file is book.asciidoc.

Erlang.mk expects you to put your documentation in a specific location. This is doc/src/guide/ for the user guide, and doc/src/manual/ for the function reference. In the case of the user guide, the entry point is always doc/src/guide/book.asciidoc.

For manual pages, it is good practice to use section 3 for modules, and section 7 for the application itself.

Configuration

All of the AsciiDoc related configuration can be done directly inside the files themselves.

Usage

To build all documentation:

$ make docs

To build only the AsciiDoc documentation:

$ make asciidoc

To build only the user guide:

$ make asciidoc-guide

To build only the manual:

$ make asciidoc-manual

To install man pages on Unix:

$ make install-docs

Erlang.mk allows customizing the installation path and sections of the man pages to be installed. The MAN_INSTALL_PATH variable defines where man pages will be installed. It defaults to /usr/local/share/man. The MAN_SECTIONS variable defines which manual sections are to be installed. It defaults to 3 7.

To install man pages to a custom location:

$ make install-docs MAN_INSTALL_PATH=/opt/share/man

Note that you may need to run the install commands using sudo or equivalent if the location is not writeable by your user.

- - - - - - - - - - - - - - - - -

- -

- - -

- Erlang.mk - 1 - - User Guide -

- -

- - - - - -

Navigation

- -

Version select

- -

Like my work? Donate!

Donate to Loïc Hoguin because his work on Cowboy, Ranch, Gun and Erlang.mk is fantastic:

Recurring payment options are also available via BountySource. These funds are used to cover the recurring expenses like dedicated servers or domain names.

- - - -

- - - - - - - - - -- cgit v1.2.3