From b253b8e4cba10dc28023e613498473f78e3a17ad Mon Sep 17 00:00:00 2001 From: Ryan Mavilia Date: Sun, 17 Jan 2016 04:04:41 -0500 Subject: Rename asciidoc.markdown to asciidoc.html.markdown --- asciidoc.html.markdown | 66 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 66 insertions(+) create mode 100644 asciidoc.html.markdown (limited to 'asciidoc.html.markdown') diff --git a/asciidoc.html.markdown b/asciidoc.html.markdown new file mode 100644 index 00000000..b98d0fa9 --- /dev/null +++ b/asciidoc.html.markdown @@ -0,0 +1,66 @@ +--- +language: asciidoc +contributors: + - ["Ryan Mavilia", "http://unoriginality.rocks/:] +filename: asciidoc.md +--- + +AsciiDoc is a markup language similar to Markdown and it can be used for anything from books to blogs. Created in 2002 by Stuart Rackham the language is simple but it allows for a great amount of customization. + +Document Header + +Headers are optional and can't contain blank lines. It must be offset from content by at least one blank line. + +Title Only + +```asciidoc += Document Title + +First sentence of document. +``` + +Title and Author + +```asciidoc += Document Title +First Last + +Start of this document. +``` + +Multiple Authors +```asciidoc += Document Title +John Doe ; Jane Doe; Black Beard + +Start of a doc with multiple authors. +``` + +Revision Line (requires an author line) +```asciidoc += Doc Title V1 +Potato Man +v1.0, 2016-01-13 + +This article about chips is going to be fun. +``` + +Section Titles + +```asciidoc += Level 0 (may only be used in document's header) + +== Same as

+ +=== Same as

+ +==== Same as

+ +===== Same as

+ +====== Same as
+ +======= Same as + +``` + -- cgit v1.2.3 From f60cb8316e21197e369311df91a1f9576878785d Mon Sep 17 00:00:00 2001 From: Ryan Mavilia Date: Tue, 26 Jan 2016 03:27:17 -0500 Subject: Added paragraphs, lists, and formatted text. --- asciidoc.html.markdown | 66 +++++++++++++++++++++++++++++++++++++++++++++----- 1 file changed, 60 insertions(+), 6 deletions(-) (limited to 'asciidoc.html.markdown') diff --git a/asciidoc.html.markdown b/asciidoc.html.markdown index b98d0fa9..4196e424 100644 --- a/asciidoc.html.markdown +++ b/asciidoc.html.markdown @@ -44,23 +44,77 @@ v1.0, 2016-01-13 This article about chips is going to be fun. ``` +Paragraphs + +```asciidoc +You don't need anything special for paragraphs. + +Add a blank line between paragraphs to seperate them. + +To create a line blank add a + +and you will recieve a line break! +``` + +Formatting Text + +```asciidoc +_underscore creates italics_ +*asterisks for bold* +*_combine for extra fun_* +`use ticks to signify monospace` +`*bolded monospace*` +``` Section Titles ```asciidoc = Level 0 (may only be used in document's header) -== Same as

+== Level 1

-=== Same as

+=== Level 2

-==== Same as

+==== Level 3

-===== Same as

+===== Level 4
-====== Same as
+====== Level 5
-======= Same as +======= Level 6 ``` +Lists + +To create a bulleted list use asterisks. +```asciidoc +* foo +* bar +* baz +``` + +To create a numbered list use periods. +```asciidoc +. item 1 +. item 2 +. item 3 +``` + +You can nest lists by adding extra asterisks or periods up to five times. +```asciidoc +* foo 1 +** foo 2 +*** foo 3 +**** foo 4 +***** foo 5 +``` +```asciidoc +. foo 1 +.. foo 2 +... foo 3 +.... foo 4 +..... foo 5 +``` + + + -- cgit v1.2.3 From 083aa4fa4c462cbd9b5f9b3c671969d7d3d6976c Mon Sep 17 00:00:00 2001 From: Ryan Mavilia Date: Tue, 26 Jan 2016 03:32:28 -0500 Subject: Edit my website! --- asciidoc.html.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'asciidoc.html.markdown') diff --git a/asciidoc.html.markdown b/asciidoc.html.markdown index 4196e424..f9ca8e21 100644 --- a/asciidoc.html.markdown +++ b/asciidoc.html.markdown @@ -1,7 +1,7 @@ --- language: asciidoc contributors: - - ["Ryan Mavilia", "http://unoriginality.rocks/:] + - ["Ryan Mavilia", "http://unoriginality.rocks/"] filename: asciidoc.md --- -- cgit v1.2.3 From 0c020f4da8563cbc9e509a63a1f03c1f53162c1c Mon Sep 17 00:00:00 2001 From: Adam Date: Sun, 14 Feb 2016 22:47:19 -0800 Subject: Fix up asciidoc --- asciidoc.html.markdown | 32 +++++++++++++++++--------------- 1 file changed, 17 insertions(+), 15 deletions(-) (limited to 'asciidoc.html.markdown') diff --git a/asciidoc.html.markdown b/asciidoc.html.markdown index f9ca8e21..7f2a4374 100644 --- a/asciidoc.html.markdown +++ b/asciidoc.html.markdown @@ -13,7 +13,7 @@ Headers are optional and can't contain blank lines. It must be offset from conte Title Only -```asciidoc +``` = Document Title First sentence of document. @@ -21,7 +21,7 @@ First sentence of document. Title and Author -```asciidoc +``` = Document Title First Last @@ -29,7 +29,8 @@ Start of this document. ``` Multiple Authors -```asciidoc + +``` = Document Title John Doe ; Jane Doe; Black Beard @@ -37,16 +38,18 @@ Start of a doc with multiple authors. ``` Revision Line (requires an author line) -```asciidoc + +``` = Doc Title V1 Potato Man v1.0, 2016-01-13 This article about chips is going to be fun. ``` + Paragraphs -```asciidoc +``` You don't need anything special for paragraphs. Add a blank line between paragraphs to seperate them. @@ -57,7 +60,7 @@ and you will recieve a line break! Formatting Text -```asciidoc +``` _underscore creates italics_ *asterisks for bold* *_combine for extra fun_* @@ -67,7 +70,7 @@ _underscore creates italics_ Section Titles -```asciidoc +``` = Level 0 (may only be used in document's header) == Level 1

@@ -87,34 +90,33 @@ Section Titles Lists To create a bulleted list use asterisks. -```asciidoc + +``` * foo * bar * baz ``` To create a numbered list use periods. -```asciidoc + +``` . item 1 . item 2 . item 3 ``` You can nest lists by adding extra asterisks or periods up to five times. -```asciidoc + +``` * foo 1 ** foo 2 *** foo 3 **** foo 4 ***** foo 5 -``` -```asciidoc + . foo 1 .. foo 2 ... foo 3 .... foo 4 ..... foo 5 ``` - - - -- cgit v1.2.3 From cfa79905912803e34a6a9f98d95f40fd013b4acd Mon Sep 17 00:00:00 2001 From: Jacob Ward Date: Wed, 17 Feb 2016 06:36:47 -0700 Subject: [asciidoc/en] fixed a couple of typos --- asciidoc.html.markdown | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) (limited to 'asciidoc.html.markdown') diff --git a/asciidoc.html.markdown b/asciidoc.html.markdown index 7f2a4374..8326c581 100644 --- a/asciidoc.html.markdown +++ b/asciidoc.html.markdown @@ -52,10 +52,10 @@ Paragraphs ``` You don't need anything special for paragraphs. -Add a blank line between paragraphs to seperate them. +Add a blank line between paragraphs to separate them. To create a line blank add a + -and you will recieve a line break! +and you will receive a line break! ``` Formatting Text @@ -68,7 +68,7 @@ _underscore creates italics_ `*bolded monospace*` ``` -Section Titles +Section Titles ``` = Level 0 (may only be used in document's header) -- cgit v1.2.3 From 0e32ded9a4dbb74a0c814aae2770045ed0b00a2d Mon Sep 17 00:00:00 2001 From: Abel Salgado Romero Date: Mon, 11 Sep 2017 19:16:13 +0200 Subject: fixes #2644 add `Further Reading` section to AsciiDoc --- asciidoc.html.markdown | 14 ++++++++++++++ 1 file changed, 14 insertions(+) (limited to 'asciidoc.html.markdown') diff --git a/asciidoc.html.markdown b/asciidoc.html.markdown index 8326c581..8b526586 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 JavasScript. 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 comparision](http://asciidoctor.org/docs/user-manual/#comparison-by-example): side-by-side comparision 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. -- cgit v1.2.3 From ca4b1b70dae58b3a484432646da5eaedb2f549db Mon Sep 17 00:00:00 2001 From: Abel Salgado Romero Date: Tue, 12 Sep 2017 00:10:57 +0200 Subject: Update asciidoc.html.markdown fixed review --- asciidoc.html.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'asciidoc.html.markdown') diff --git a/asciidoc.html.markdown b/asciidoc.html.markdown index 8b526586..1261fcea 100644 --- a/asciidoc.html.markdown +++ b/asciidoc.html.markdown @@ -127,10 +127,10 @@ You can nest lists by adding extra asterisks or periods up to five times. 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 JavasScript. Under active development, it aims to extend the AsciiDoc syntax with new features and output formats. +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 comparision](http://asciidoctor.org/docs/user-manual/#comparison-by-example): side-by-side comparision of common Markdown and AsciiDoc elements. +* [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. -- cgit v1.2.3 From 3c38bb8197a281f2ea5967e3f807736ba5bb5c50 Mon Sep 17 00:00:00 2001 From: Abel Salgado Romero Date: Thu, 21 Sep 2017 18:51:50 +0200 Subject: [asciidoc/en][asciidoc/de][asciidoc/is][asciidoc/pt] fixed wrong AsciiDoc section levels --- asciidoc.html.markdown | 4 ---- 1 file changed, 4 deletions(-) (limited to 'asciidoc.html.markdown') diff --git a/asciidoc.html.markdown b/asciidoc.html.markdown index 1261fcea..51d0d7c9 100644 --- a/asciidoc.html.markdown +++ b/asciidoc.html.markdown @@ -82,10 +82,6 @@ Section Titles ===== Level 4
-====== Level 5
- -======= Level 6 - ``` Lists -- cgit v1.2.3