iskm/learnxinyminutes-docs
1
0
Fork 0
mirror of https://github.com/adambard/learnxinyminutes-docs.git synced 2024-12-24 18:11:38 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Merge pull request #2855 from abelsromero/feat/added_further_reading_section_to_AsciiDoc

Browse Source 
[asciidoc/en] fixes #2644. Add `Further Reading` section to AsciiDoc
This commit is contained in:
Andre Polykanine A.K.A. Menelion Elensúlë 2017-09-12 02:05:19 +03:00 committed by GitHub
commit a148661c74
1 changed files with 14 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
asciidoc.html.markdown
View File

@ -2,6 +2,7 @@
language: asciidoc language: asciidoc
contributors: contributors:
- ["Ryan Mavilia", "http://unoriginality.rocks/"] - ["Ryan Mavilia", "http://unoriginality.rocks/"]
- ["Abel Salgado Romero", "https://twitter.com/abelsromero"]
filename: asciidoc.md filename: asciidoc.md
--- ---
@ -120,3 +121,16 @@ You can nest lists by adding extra asterisks or periods up to five times.
.... foo 4 .... foo 4
..... foo 5 ..... 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.