summaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
authorAndre Polykanine A.K.A. Menelion ElensĂșlĂ« <andre@oire.org>2017-09-12 02:05:19 +0300
committerGitHub <noreply@github.com>2017-09-12 02:05:19 +0300
commita148661c74b8bd5e9189d8fcb43dbb42c4ab10ec (patch)
tree684982c822cb28517a4fd33811a395a563f6e971
parent177db388313bfc4aa538ee4bfa54d5b72a09537a (diff)
parentca4b1b70dae58b3a484432646da5eaedb2f549db (diff)
Merge pull request #2855 from abelsromero/feat/added_further_reading_section_to_AsciiDoc
[asciidoc/en] fixes #2644. Add `Further Reading` section to AsciiDoc
-rw-r--r--asciidoc.html.markdown14
1 files changed, 14 insertions, 0 deletions
diff --git a/asciidoc.html.markdown b/asciidoc.html.markdown
index 8326c581..1261fcea 100644
--- a/asciidoc.html.markdown
+++ b/asciidoc.html.markdown
@@ -2,6 +2,7 @@
language: asciidoc
contributors:
- ["Ryan Mavilia", "http://unoriginality.rocks/"]
+ - ["Abel Salgado Romero", "https://twitter.com/abelsromero"]
filename: asciidoc.md
---
@@ -120,3 +121,16 @@ You can nest lists by adding extra asterisks or periods up to five times.
.... foo 4
..... foo 5
```
+
+## Further Reading
+
+There are two tools to process AsciiDoc documents:
+
+1. [AsciiDoc](http://asciidoc.org/): original Python implementation available in the main Linux distributions. Stable and currently in maintenance mode.
+2. [Asciidoctor](http://asciidoctor.org/): alternative Ruby implementation, usable also from Java and JavaScript. Under active development, it aims to extend the AsciiDoc syntax with new features and output formats.
+
+Following links are related to `Asciidoctor` implementation:
+
+* [Markdown - AsciiDoc syntax comparison](http://asciidoctor.org/docs/user-manual/#comparison-by-example): side-by-side comparison of common Markdown and AsciiDoc elements.
+* [Getting started](http://asciidoctor.org/docs/#get-started-with-asciidoctor): installation and quick start guides to render simple documents.
+* [Asciidoctor User Manual](http://asciidoctor.org/docs/user-manual/): complete single-document manual with syntax reference, examples, rendering tools, amongst others.