` heading.
-
-.Book doctype
-----
-= Document Title (Level 0)
-
-== Section Level 1
-
-=== Section Level 2
-
-==== Section Level 3
-
-===== Section Level 4
-
-====== Section Level 5
-
-= Section Level 0
-----
-
-[.result]
-====
-// float is required to create plain headers
-[float]
-= Document Title (Level 0)
-
-[float]
-== Section Level 1
-
-[float]
-=== Section Level 2
-
-[float]
-==== Section Level 3
-
-[float]
-===== Section Level 4
-
-[float]
-====== Section Level 5
-
-[float]
-= Section Level 0
-====
-
-////
-IMPORTANT: There are two other ways to define a section title.
-_Their omission is intentional_.
-They both require more markup and are therefore unnecessary.
-The http://en.wikipedia.org/wiki/Setext[setext] title syntax (underlined text) is especially wasteful, hard to remember, hard to maintain and error prone.
-The reader never sees the extra markup, so why type it?
-*Be frugal!*
-////
-
-.Explicit id
-----
-[[primitives-nulls]]
-== Primitive types and null values
-----
-
-.Section anchors and links (Asciidoctor only)
-
-`sectanchors`::
-When this document attribute is set, a section icon anchor appears in front of the section title.
-
-`sectlinks`::
-When this document attribute is set, the section titles become links.
-
-NOTE: Section title anchors depend on the default Asciidoctor stylesheet to render properly.
-
-== Include Files
-
-.Document parts
-----
-= Reference Documentation
-Lead Developer
-
-This is documentation for project X.
-
-\include::basics.adoc[]
-
-\include::installation.adoc[]
-
-\include::example.adoc[]
-----
-
-CAUTION: Asciidoctor does not insert blank lines between adjacent include statements to keep the content separated.
-Be sure to add a blank line in the source document to avoid unexpected results, such as a section title being swallowed.
-
-.Include content from a URI
-----
-:asciidoctor-source: https://raw.github.com/asciidoctor/asciidoctor/master
-
-\include::{asciidoctor-source}/README.adoc[]
-----
-
-NOTE: Including content from a URI is potentially dangerous, so it's disabled if the safe mode is SECURE or greater.
-Assuming the safe mode is less than SECURE, you must also set the `allow-uri-read` attribute to permit Asciidoctor to read content from a URI.
-
-== Horizontal Rules and Page Breaks
-
-.Horizontal rule
-----
-'''
-----
-
-[.result]
-====
-'''
-====
-
-.Page break
-----
-<<<
-----
-
-== Lists
-
-.Unordered, basic
-----
-* Edgar Allen Poe
-* Sheri S. Tepper
-* Bill Bryson
-
-//^
-
-* Kevin Spacey
-* Jeremy Piven
-----
-
-[.result]
-====
-* Edgar Allen Poe
-* Sheri S. Tepper
-* Bill Bryson
-
-//^
-
-* Kevin Spacey
-* Jeremy Piven
-====
-
-NOTE: Blank lines are required before and after a list.
-
-TIP: You can force two lists apart with a line comment, as the previous example demonstrates.
-The text in the comment, (`^`), is optional, but serves as a hint to other authors that this line serves as an "end of list" marker.
-//toc::[]
-
-.Unordered, max nesting
-----
-* level 1
-** level 2
-*** level 3
-**** level 4
-***** level 5
-* level 1
-----
-
-[.result]
-====
-* level 1
-** level 2
-*** level 3
-**** level 4
-***** level 5
-* level 1
-====
-
-TIP: The unordered list marker can be changed using {list-marker}[block styles].
-
-.Checklist
-----
-- [*] checked
-- [x] also checked
-- [ ] not checked
-- normal list item
-----
-
-[.result]
-====
-- [*] checked
-- [x] also checked
-- [ ] not checked
-- normal list item
-====
-
-TIP: Checklists can use {checklist-ref}[font-based icons and be interactive].
-
-.Ordered, basic
-----
-. Step 1
-. Step 2
-. Step 3
-----
-
-[.result]
-====
-. Step 1
-. Step 2
-. Step 3
-====
-
-.Ordered, nested
-----
-. Step 1
-. Step 2
-.. Step 2a
-.. Step 2b
-. Step 3
-----
-
-[.result]
-====
-. Step 1
-. Step 2
-.. Step 2a
-.. Step 2b
-. Step 3
-====
-
-.Ordered, max nesting
-----
-. level 1
-.. level 2
-... level 3
-.... level 4
-..... level 5
-. level 1
-----
-
-[.result]
-====
-. level 1
-.. level 2
-... level 3
-.... level 4
-..... level 5
-. level 1
-====
-
-TIP: For ordered lists, Asciidoctor supports {list-number}[numeration styles] such as `lowergreek` and `decimal-leading-zero`.
-
-.Labeled, single-line
-----
-first term:: definition of first term
-section term:: definition of second term
-----
-
-[.result]
-====
-first term:: definition of first term
-section term:: definition of second term
-====//toc::[]
-
-
-.Labeled, multi-line
-----
-first term::
-definition of first term
-section term::
-definition of second term
-----
-
-[.result]
-====
-first term::
-definition of first term
-section term::
-definition of second term
-====
-
-.Q&A
-----
-[qanda]
-What is Asciidoctor?::
- An implementation of the AsciiDoc processor in Ruby.
-What is the answer to the Ultimate Question?:: 42
-----
-
-[.result]
-====
-[qanda]
-What is Asciidoctor?::
- An implementation of the AsciiDoc processor in Ruby.
-What is the answer to the Ultimate Question?:: 42
-====
-
-.Mixed
-----
-Operating Systems::
- Linux:::
- . Fedora
- * Desktop
- . Ubuntu
- * Desktop
- * Server
- BSD:::
- . FreeBSD
- . NetBSD
-
-Cloud Providers::
- PaaS:::
- . OpenShift
- . CloudBees
- IaaS:::
- . Amazon EC2
- . Rackspace
-----
-
-[.result]
-====
-Operating Systems::
- Linux:::
- . Fedora
- * Desktop
- . Ubuntu
- * Desktop
- * Server
- BSD:::
- . FreeBSD
- . NetBSD
-
-Cloud Providers::
- PaaS:::
- . OpenShift
- . CloudBees
- IaaS:::
- . Amazon EC2
- . Rackspace
-====
-
-TIP: Lists can be indented.
-Leading whitespace is not significant.
-
-.Complex content in outline lists
-----
-* Every list item has at least one paragraph of content,
- which may be wrapped, even using a hanging indent.
-+
-Additional paragraphs or blocks are adjoined by putting
-a list continuation on a line adjacent to both blocks.
-+
-list continuation:: a plus sign (+) on a line by itself
-
-* A literal paragraph does not require a list continuation.
-
- $ gem install asciidoctor
-
-* AsciiDoc lists may contain any complex content.
-+
-[cols="2", options="header"]
-|===
-|Application
-|Language
-
-|AsciiDoc
-|Python
-
-|Asciidoctor
-|Ruby
-|===
-----
-
-[.result]
-====
-* Every list item has at least one paragraph of content,
- which may be wrapped, even using a hanging indent.
-+
-Additional paragraphs or blocks are adjoined by putting
-a list continuation on a line adjacent to both blocks.
-+
-list continuation:: a plus sign (+) on a line by itself
-
-* A literal paragraph does not require a list continuation.
-
- $ gem install asciidoctor
-
-* AsciiDoc lists may contain any complex content.
-+
-[cols="2", options="header"]
-|===
-|Application
-|Language
-
-|AsciiDoc
-|Python
-
-|Asciidoctor
-|Ruby
-|===
-====
-
-== Links
-
-.External
-----
-http://asciidoctor.org - automatic!
-
-http://asciidoctor.org[Asciidoctor]
-
-https://github.com/asciidoctor[Asciidoctor @ *GitHub*]
-----
-
-[.result]
-====
-http://asciidoctor.org - automatic!
-
-http://asciidoctor.org[Asciidoctor]
-
-https://github.com/asciidoctor[Asciidoctor @ *GitHub*]
-====
-
-.Relative
-----
-link:index.html[Docs]
-----
-
-[.result]
-====
-link:index.html[Docs]
-====
-
-.Email and IRC
-----
-devel@discuss.arquillian.org
-
-mailto:devel@discuss.arquillian.org[Discuss Arquillian]
-
-mailto:devel-join@discuss.arquillian.org[Subscribe, Subscribe me, I want to join!]
-
-irc://irc.freenode.org/#asciidoctor
-----
-
-[.result]
-====
-devel@discuss.arquillian.org
-
-mailto:devel@discuss.arquillian.org[Discuss Arquillian]
-
-mailto:devel-join@discuss.arquillian.org[Subscribe, Subscribe me, I want to join!]
-
-irc://irc.freenode.org/#asciidoctor
-====
-
-.Link with attributes (Asciidoctor only)
-----
-http://discuss.asciidoctor.org[Discuss Asciidoctor, role="external", window="_blank"]
-
-http://discuss.asciidoctor.org[Discuss Asciidoctor^]
-
-http://search.example.com["Google, Yahoo, Bing^", role="teal"]
-----
-
-[.result]
-====
-http://discuss.asciidoctor.org[Discuss Asciidoctor, role="external", window="_blank"]
-
-http://discuss.asciidoctor.org[Discuss Asciidoctor^]
-
-http://search.example.com["Google, Yahoo, Bing^", role="teal"]
-====
-
-NOTE: Links with attributes (including the subject and body segments on mailto links) are a feature unique to Asciidoctor.
-To enable them, you must set the `linkattrs` attribute on the document.
-When they are enabled, you must quote the link text if it contains a comma.
-
-.Inline anchors
-----
-[[bookmark-a]]Inline anchors make arbitrary content referenceable.
-
-anchor:bookmark-b[]Use a cross reference to link to this location.
-----
-
-[.result]
-====
-[[bookmark-a]]Inline anchors make arbitrary content referenceable.
-
-anchor:bookmark-b[]Use a cross reference to link to this location.
-====
-
-.Internal cross references
-----
-See <> to learn how to write paragraphs.
-
-Learn how to organize the document into <>.
-----
-
-[.result]
-====
-See <> to learn how to write paragraphs.
-
-Learn how to organize the document into <>.
-====
-
-.Inter-document cross references (Asciidoctor only)
-----
-Refer to <> for more information.
-
-See you when you get back from <>!
-----
-
-== Images
-
-.Block
-----
-image::sunset.jpg[]
-
-image::sunset.jpg[Sunset]
-
-[[img-sunset]]
-.A mountain sunset
-image::sunset.jpg[Sunset, 300, 200, link="http://www.flickr.com/photos/javh/5448336655"]
-
-image::http://asciidoctor.org/images/octocat.jpg[GitHub mascot]
-----
-
-[.result]
-====
-image::sunset.jpg[]
-
-image::sunset.jpg[Sunset]
-
-[[img-sunset]]
-.A mountain sunset
-image::sunset.jpg[Sunset, 300, 200, link="http://www.flickr.com/photos/javh/5448336655"]
-
-image::http://asciidoctor.org/images/octocat.jpg[GitHub mascot]
-====
-
-IMPORTANT: Images are resolved relative to the value of the {imagesdir-ref}[`imagesdir` document attribute], which defaults to an empty value.
-The `imagesdir` attribute can be an absolute path, relative path or base URL.
-If the image target is a URL or absolute path, the `imagesdir` prefix is _not_ added.
-
-TIP: You should use the `imagesdir` attribute to avoid hard coding the shared path to your images in every image macro.
-
-.Image macro using positioning role
-----
-image:sunset.jpg[Sunset,150,150,role="right"] What a beautiful sunset!
-----
-
-[.result]
-====
-image:sunset.jpg[Sunset,150,150,role="right"] What a beautiful sunset!
-====
-
-TIP: There are a variety of attributes available to {image-attributes}[position and frame images].
-
-.Inline
-----
-Click image:icons/play.png[Play, title="Play"] to get the party started.
-
-Click image:icons/pause.png[title="Pause"] when you need a break.
-----
-
-[.result]
-====
-Click image:icons/play.png[Play, title="Play"] to get the party started.
-
-Click image:icons/pause.png[title="Pause"] when you need a break.
-====
-
-.Embedded
-----
-= Document Title
-:data-uri:
-----
-
-NOTE: When the `data-uri` attribute is set, all images in the document--including admonition icons--are embedded into the document as https://developer.mozilla.org/en-US/docs/data_URIs[data URIs].
-
-TIP: Instead of declaring the `data-uri` attribute in the document, you can pass it as a command-line argument using `-a data-uri`.
-
-== Videos
-
-.Block
-----
-video::video_file.mp4[]
-
-video::video_file.mp4[width=640, start=60, options=autoplay]
-----
-
-.Embedded Youtube video
-----
-video::rPQoq7ThGAU[youtube]
-----
-
-.Embedded Vimeo video
-----
-video::67480300[vimeo]
-----
-
-TIP: You can control the video settings using {video-ref}[additional attributes and options] on the macro.
-
-== Source Code
-
-.Inline
-----
-Reference code like `types` or `methods` inline.
-----
-
-[.result]
-====
-Reference code like `types` or `methods` inline.
-====
-
-.Literal line
-----
- Indent the line one space to insert a code snippet
-----
-
-[.result]
-====
- Indent the line one space to insert a code snippet
-====
-
-.Literal block
-----
-....
-error: The requested operation returned error: 1954 Forbidden search for defensive operations manual
-absolutely fatal: operation initiation lost in the dodecahedron of doom
-would you like to die again? y/n
-....
-----
-
-[.result]
-====
-....
-error: The requested operation returned error: 1954 Forbidden search for defensive operations manual
-absolutely fatal: operation initiation lost in the dodecahedron of doom
-would you like to die again? y/n
-....
-====
-
-[listing]
-.Listing block with title, no syntax highlighting
-....
-.Gemfile.lock
-----
-GEM
- remote: https://rubygems.org/
- specs:
- asciidoctor (0.1.4)
-
-PLATFORMS
- ruby
-
-DEPENDENCIES
- asciidoctor (~> 0.1.4)
-----
-....
-
-[.result]
-====
-.Gemfile.lock
-----
-GEM
- remote: https://rubygems.org/
- specs:
- asciidoctor (0.1.4)
-
-PLATFORMS
- ruby
-
-DEPENDENCIES
- asciidoctor (~> 0.1.4)
-----
-====
-
-[listing]
-.Code block with title and syntax highlighting
-....
-[source,ruby]
-.app.rb
-----
-require 'sinatra'
-
-get '/hi' do
- "Hello World!"
-end
-----
-....
-
-[.result]
-====
-[source,ruby]
-.app.rb
-----
-require 'sinatra'
-
-get '/hi' do
- "Hello World!"
-end
-----
-====
-
-[listing, subs="specialcharacters"]
-.Code block with callouts
-....
-[source,ruby]
-----
-require 'sinatra' <1>
-
-get '/hi' do <2>
- "Hello World!" <3>
-end
-----
-<1> Library import
-<2> URL mapping
-<3> Content for response
-....
-
-[.result]
-====
-[source,ruby]
-----
-require 'sinatra' <1>
-
-get '/hi' do <2>
- "Hello World!" <3>
-end
-----
-<1> Library import
-<2> URL mapping
-<3> Content for response
-====
-
-[listing, subs="specialcharacters"]
-.Code block with non-selectable callouts
-....
-----
-line of code // <1>
-line of code # <2>
-line of code ;; <3>
-----
-<1> A callout behind a line comment for C-style languages.
-<2> A callout behind a line comment for Ruby, Python, Perl, etc.
-<3> A callout behind a line comment for Clojure.
-....
-
-[.result]
-====
-----
-line of code // <1>
-line of code # <2>
-line of code ;; <3>
-----
-<1> A callout behind a line comment for C-style languages.
-<2> A callout behind a line comment for Ruby, Python, Perl, etc.
-<3> A callout behind a line comment for Clojure.
-====
-
-[listing, subs="specialcharacters"]
-.XML code block with a non-selectable callout
-....
-[source,xml]
-----
-
- Section Title
-
-----
-<1> The section title is required.
-....
-
-[.result]
-====
-[source,xml]
-----
-
- Section Title
-
-----
-<1> The section title is required.
-====
-
-[listing]
-.Code block sourced from file
-....
-[source,ruby]
-----
-\include::app.rb[]
-----
-....
-
-[listing]
-.Code block sourced from file relative to source directory
-....
-:sourcedir: src/main/java
-
-[source,java]
-----
-\include::{sourcedir}/org/asciidoctor/Asciidoctor.java[]
-----
-....
-
-[listing]
-.Strip leading indentation from source
-....
-[source,ruby,indent=0]
-----
-\include::lib/document.rb[lines=5..10]
-----
-....
-
-[NOTE]
-====
-* When `indent` is 0, the leading block indent is stripped (tabs are replaced with 4 spaces).
-* When `indent` is > 0, the leading block indent is first stripped (tabs are replaced with 4 spaces), then a block is indented by the number of columns equal to this value.
-====
-
-.Code block without delimiters (no blank lines)
-----
-[source,xml]
-
-----
-
-[.result]
-====
-[source,xml]
-
-====
-
-[IMPORTANT]
-.Enabling the syntax highlighter
-====
-Syntax highlighting is enabled by setting the `source-highlighter` attribute in the document header or passed as an argument.
-
- :source-highlighter: pygments
-
-The valid options for are `coderay`, `highlight.js`, `prettify`, and `pygments`.
-====
-
-== More Delimited Blocks
-
-.Sidebar
-----
-.AsciiDoc history
-****
-AsciiDoc was first released in Nov 2002 by Stuart Rackham.
-It was designed from the start to be a shorthand syntax
-for producing professional documents like DocBook and LaTeX.
-****
-----
-
-[.result]
-====
-.AsciiDoc history
-****
-AsciiDoc was first released in Nov 2002 by Stuart Rackham.
-It was designed from the start to be a shorthand syntax
-for producing professional documents like DocBook and LaTeX.
-****
-====
-
-NOTE: Any block can have a title, positioned above the block.
-A block title is a line of text that starts with a dot.
-The dot cannot be followed by a space.
-
-.Example
-----
-.Sample document
-====
-Here's a sample AsciiDoc document:
-
-[listing]
-....
-= Title of Document
-Doc Writer
-:toc:
-
-This guide provides...
-....
-
-The document header is useful, but not required.
-====
-----
-
-[example.result]
---
-.Sample document
-====
-Here's a sample AsciiDoc document:
-
-[listing]
-....
-= Title of Document
-Doc Writer
-:toc:
-
-This guide provides...
-....
-
-The document header is useful, but not required.
-====
---
-
-[[admon-bl]]
-.Admonition
-----
-[NOTE]
-====
-An admonition block may contain complex content.
-
-.A list
-- one
-- two
-- three
-
-Another paragraph.
-====
-----
-
-[.result]
-=====
-[NOTE]
-====
-An admonition block may contain complex content.
-
-.A list
-- one
-- two
-- three
-
-Another paragraph.
-====
-=====
-
-[TIP]
-.Admonition and callout icons
-====
-Asciidoctor can "draw" icons using {fontawesome-ref}[Font Awesome^] and CSS.
-
-To use this feature, set the value of the `icons` document attribute to `font`.
-Asciidoctor will then emit HTML markup that selects an appropriate font character from the Font Awesome font for each admonition block.
-
-Icons can also be used {icon-inline}[inline] and {icon-attribute}[styled].
-====
-
-.Blockquote
-----
-[quote, Abraham Lincoln, Soldiers' National Cemetery Dedication]
-____
-Four score and seven years ago our fathers brought forth
-on this continent a new nation...
-____
-
-[quote, Albert Einstein]
-A person who never made a mistake never tried anything new.
-
-____
-A person who never made a mistake never tried anything new.
-____
-----
-
-[.result]
-====
-[quote, Abraham Lincoln, Soldiers' National Cemetery Dedication]
-____
-Four score and seven years ago our fathers brought forth
-on this continent a new nation...
-____
-
-[quote, Albert Einstein]
-A person who never made a mistake never tried anything new.
-
-____
-A person who never made a mistake never tried anything new.
-____
-====
-
-.Abbreviated blockquote (Asciidoctor only)
-----
-"I hold it that a little rebellion now and then is a good thing,
-and as necessary in the political world as storms in the physical."
--- Thomas Jefferson, Papers of Thomas Jefferson: Volume 11
-----
-
-[.result]
-====
-"I hold it that a little rebellion now and then is a good thing,
-and as necessary in the political world as storms in the physical."
--- Thomas Jefferson, Papers of Thomas Jefferson: Volume 11
-====
-
-.Air quotes (Asciidoctor only)
-
-As a tip of the hat to Dick, Asciidoctor recognizes text between "air quotes" as a quote block.
-Air quotes are the best thing since fenced code blocks.
-
-----
-[, Richard M. Nixon]
-""
-When the President does it, that means that it's not illegal.
-""
-----
-
-[.result]
-====
-[, Richard M. Nixon]
-""
-When the President does it, that means that it's not illegal.
-""
-====
-
-.Passthrough
-----
-++++
-
-Content in a passthrough block is passed to the output unprocessed.
-That means you can include raw HTML, like this embedded Gist:
-
-
-
-++++
-----
-
-[.result]
-====
-++++
-
-Content in a passthrough block is passed to the output unprocessed.
-That means you can include raw HTML, like this embedded Gist:
-
-
-
-++++
-====
-
-.Open
-----
---
-An open block can be an anonymous container,
-or it can masquerade as any other block.
---
-
-[source]
---
-puts "I'm a source block!"
---
-----
-
-[.result]
-====
---
-An open block can be an anonymous container,
-or it can masquerade as any other block.
---
-
-[source]
---
-puts "I'm a source block!"
---
-====
-
-[listing]
-.Custom substitutions
-....
-:version: 0.1.4
-
-[source,xml]
-[subs="verbatim,attributes"]
-----
-
- org.asciidoctor
- asciidoctor-java-integration
- {version}
-
-----
-....
-
-[.result]
-====
-// the attribute value is hard-coded in this result since the example depends
-// on a hypothetical document attribute
-[source,xml]
-----
-
- org.asciidoctor
- asciidoctor-java-integration
- 0.1.4
-
-----
-====
-
-== Block Id, Role and Options
-
-.Traditional markup method for assigning block `id` and `role`
-----
-[[goals]]
-[role="incremental"]
-* Goal 1
-* Goal 2
-----
-
-.Shorthand markup method for assigning block `id` and `role` (Asciidoctor only)
-----
-[#goals.incremental]
-* Goal 1
-* Goal 2
-----
-
-[TIP]
-====
-* To specify multiple roles using the shorthand syntax, separate them by dots.
-* The order of `id` and `role` values in the shorthand syntax does not matter.
-====
-
-.Traditional markup method for assigning quoted text anchor (`id`) and `role`
-----
-[[free_the_world]][big goal]_free the world_
-----
-
-.Shorthand markup method for assigning quoted text anchor (`id`) and `role` (Asciidoctor only)
-----
-[#free_the_world.big.goal]_free the world_
-----
-
-.Role assigned to text enclosed in backticks
-----
-[rolename]`escaped monospace text`
-----
-
-.Traditional markup method for assigning block `options`
-----
-[options="header,footer,autowidth"]
-|===
-|Cell A |Cell B
-|===
-----
-
-.Shorthand markup method for assigning block `options` (Asciidoctor only)
-----
-[%header%footer%autowidth]
-|===
-|Cell A |Cell B
-|===
-----
-
-== Comments
-
-.Line
-----
-// A single-line comment.
-----
-
-TIP: Single-line comments can be used to divide elements, such as two adjacent lists.
-
-.Block
-----
-////
-A multi-line comment.
-
-Notice it's a delimited block.
-////
-----
-
-== Tables
-
-.Table with a title, three columns, a header, and two rows of content
-----
-.Table Title
-|===
-|Name of Column 1 |Name of Column 2 |Name of Column 3 <1>
-<2>
-|Cell in column 1, row 1
-|Cell in column 2, row 1
-|Cell in column 3, row 1
-
-|Cell in column 1, row 2
-|Cell in column 2, row 2
-|Cell in column 3, row 2
-|===
-----
-<1> Unless the `cols` attribute is specified, the number of columns is equal to the number of vertical bars on the first non-blank line inside the block delimiters.
-<2> When a blank line follows a single line of column titles, the column titles row will be styled as a header row by default.
-
-[.result]
-====
-.Table Title
-|===
-|Name of Column 1 |Name of Column 2 |Name of Column 3
-
-|Cell in column 1, row 1
-|Cell in column 2, row 1
-|Cell in column 3, row 1
-
-|Cell in column 1, row 2
-|Cell in column 2, row 2
-|Cell in column 3, row 2
-|===
-====
-
-.Table with two columns, a header, and two rows of content
-----
-[cols="2*", options="header"] <1>
-|===
-|Name of Column 1
-|Name of Column 2
-
-|Cell in column 1, row 1
-|Cell in column 2, row 1
-
-|Cell in column 1, row 2
-|Cell in column 2, row 2
-|===
-----
-<1> The `*` in the `cols` attribute is the repeat operator. It means repeat the column specification for the remainder of columns. In this case, it means to repeat the default formatting across 4 columns. When the header row is not defined on a single line, you must use the `cols` attribute to set the number of columns and `options` attributes to make the first row a header.
-
-[.result]
-====
-[cols="2*", options="header"]
-|===
-|Name of Column 1
-|Name of Column 2
-
-|Cell in column 1, row 1
-|Cell in column 2, row 1
-
-|Cell in column 1, row 2
-|Cell in column 2, row 2
-|===
-====
-
-.Table with three columns, a header, and two rows of content
-----
-[cols="1,1,2", options="header"] <1>
-.Applications
-|===
-|Name
-|Category
-|Description
-
-|Firefox
-|Browser
-|Mozilla Firefox is an open-source web browser.
-It's designed for standards compliance,
-performance, portability.
-
-|Arquillian
-|Testing
-|An innovative and highly extensible testing platform.
-Empowers developers to easily create real, automated tests.
-|===
-----
-<1> In this example, the `cols` attribute has two functions. It specifies that this table has three columns, and it sets their relative widths.
-
-[.result]
-====
-[cols="1,1,2", options="header"]
-.Applications
-|===
-|Name
-|Category
-|Description
-
-|Firefox
-|Browser
-|Mozilla Firefox is an open-source web browser.
-It's designed for standards compliance,
-performance, portability.
-
-|Arquillian
-|Testing
-|An innovative and highly extensible testing platform.
-Empowers developers to easily create real, automated tests.
-|===
-====
-
-.Table with column containing AsciiDoc content
-----
-[cols="2,2,5a"]
-|===
-|Firefox
-|Browser
-|Mozilla Firefox is an open-source web browser.
-
-It's designed for:
-
-* standards compliance
-* performance
-* portability
-
-http://getfirefox.com[Get Firefox]!
-|===
-----
-
-[.result]
-====
-[cols="2,2,5a"]
-|===
-|Firefox
-|Browser
-|Mozilla Firefox is an open-source web browser.
-
-It's designed for:
-
-* standards compliance
-* performance
-* portability
-
-http://getfirefox.com[Get Firefox]!
-|===
-====
-
-.Table from CSV data
-----
-[format="csv", options="header"]
-|===
-Artist,Track,Genre
-Baauer,Harlem Shake,Hip Hop
-The Lumineers,Ho Hey,Folk Rock
-|===
-----
-
-[.result]
-====
-[format="csv", options="header"]
-|===
-Artist,Track,Genre
-Baauer,Harlem Shake,Hip Hop
-The Lumineers,Ho Hey,Folk Rock
-|===
-====
-
-.Table from CSV data using shorthand (Asciidoctor only)
-----
-,===
-Artist,Track,Genre
-
-Baauer,Harlem Shake,Hip Hop
-,===
-----
-
-[.result]
-====
-,===
-Artist,Track,Genre
-
-Baauer,Harlem Shake,Hip Hop
-,===
-====
-
-.Table from DSV data using shorthand (Asciidoctor only)
-----
-:===
-Artist:Track:Genre
-
-Robyn:Indestructable:Dance
-:===
-----
-
-[.result]
-====
-:===
-Artist:Track:Genre
-
-Robyn:Indestructable:Dance
-:===
-====
-
-.Table with formatted, aligned and merged cells
-----
-[cols="e,m,^,>s", width="25%"]
-|===
-|1 >s|2 |3 |4
-^|5 2.2+^.^|6 .3+<.>m|7
-^|8
-|9 2+>|10
-|===
-----
-
-[.result]
-====
-[cols="e,m,^,>s", width="25%"]
-|===
-|1 >s|2 |3 |4
-^|5 2.2+^.^|6 .3+<.>m|7
-^|8
-|9 2+>|10
-|===
-====
-
-== UI Macros
-
-IMPORTANT: You *must* set the `experimental` attribute in the document header to enable these macros.
-
-.Keyboard shortcuts (inline `kbd` macro)
-----
-|===
-|Shortcut |Purpose
-
-|kbd:[F11]
-|Toggle fullscreen
-
-|kbd:[Ctrl+T]
-|Open a new tab
-
-|kbd:[Ctrl+Shift+N]
-|New incognito window
-
-|kbd:[Ctrl + +]
-|Increase zoom
-|===
-----
-
-[.result]
-====
-|===
-|Shortcut |Purpose
-
-|kbd:[F11]
-|Toggle fullscreen
-
-|kbd:[Ctrl+T]
-|Open a new tab
-
-|kbd:[Ctrl+Shift+N]
-|New incognito window
-
-|kbd:[Ctrl + +]
-|Increase zoom
-|===
-====
-
-.Menu selections (inline `menu` macro)
-----
-To save the file, select menu:File[Save].
-
-Select menu:View[Zoom > Reset] to reset the zoom level to the default setting.
-----
-
-[.result]
-====
-To save the file, select menu:File[Save].
-
-Select menu:View[Zoom > Reset] to reset the zoom level to the default setting.
-====
-
-.Buttons (inline `btn` macro)
-----
-Press the btn:[OK] button when you are finished.
-
-Select a file in the file navigator and click btn:[Open].
-----
-
-[.result]
-====
-Press the btn:[OK] button when you are finished.
-
-Select a file in the file navigator and click btn:[Open].
-====
-
-== Attributes and Substitutions
-
-.Attribute declaration and usage
-----
-:homepage: http://asciidoctor.org
-:docslink: http://asciidoctor.org/docs[Asciidoctor's Docs]
-:desc: Asciidoctor is a mature, plain-text document format for +
- writing notes, articles, documentation, books, and more. +
- It's also a text processor & toolchain for translating +
- documents into various output formats (i.e., backends), +
- including HTML, DocBook, PDF and ePub.
-:checkedbox: pass:normal[`[✔]`]
-
-Check out {homepage}[Asciidoctor]!
-
-{desc}
-
-Check out {docslink} too!
-
-{checkedbox} That's done!
-----
-
-[.result]
-====
-// I have to use a nested doc hack here, otherwise the attributes won't resolve
-[.unstyled]
-|===
-a|
-:homepage: http://asciidoctor.org
-:docslink: http://asciidoctor.org/docs[Asciidoctor's Docs]
-:desc: Asciidoctor is a mature, plain-text document format for +
- writing notes, articles, documentation, books, and more. +
- It's also a text processor & toolchain for translating +
- documents into various output formats (i.e., backends), +
- including HTML, DocBook, PDF and ePub.
-:checkedbox: pass:normal[`[✔]`]
-
-Check out {homepage}[Asciidoctor]!
-
-{desc}
-
-Check out {docslink} too!
-
-{checkedbox} That's done!
-|===
-====
-
-.Attribute assignment precedence (highest to lowest)
-- Attribute passed to the API or CLI that does not end in `@`
-- Attribute defined in the document
-- Attribute passed to the API or CLI that ends in `@`
-- Intrinsic attribute value (default values)
-
-TIP: To make an attribute value that is passed to the API or CLI have a lower precedence than an assignment in the document, add an `@` symbol to the end of the attribute value.
-
-// Table of literal character attributes
-.Built-in literal attributes
-[width="70%", cols="^1l,^1l,^1"]
-|===
-|Attribute reference |Replacement |Rendered
-
-|\{lt}
-|<
-|<
-
-|\{gt}
-|>
-|>
-
-|\{amp}
-|&
-|&
-
-|\{startsb}
-|[
-|[
-
-|\{endsb}
-|]
-|]
-
-|\{vbar}
-|\|
-|\|
-
-|\{caret}
-|^
-|^
-
-|\{asterisk}
-|*
-|*
-
-|\{tilde}
-|~
-|~
-
-|\{apostrophe}
-|'
-|'
-
-|\{backslash}
-|\
-|\
-
-|\{backtick}
-|`
-|`
-
-|\{two-colons}
-|::
-|::
-
-|\{two-semicolons}
-|;;
-|;;
-
-|===
-
-// Table of character reference attributes
-.Built-in entity attributes
-[width="70%", cols="^1l,^1l,^1"]
-|===
-|Attribute reference |Replacement |Rendered
-
-|\{empty}
-|_nothing_
-|{empty}
-
-|\{sp}, \{space}
-|_single space_
-|{sp}
-
-|\{nbsp}
-|\
-|{nbsp}
-
-|\{zwsp}
-|\
-|{zwsp}
-
-|\{wj}
-|\
-|{wj}
-
-|\{apos}
-|\'
-|{apos}
-
-|\{quot}
-|\"
-|{quot}
-
-|\{lsquo}
-|\‘
-|{lsquo}
-
-|\{rsquo}
-|\’
-|{rsquo}
-
-|\{ldquo}
-|\“
-|{ldquo}
-
-|\{rdquo}
-|\”
-|{rdquo}
-
-|\{deg}
-|\°
-|{deg}
-
-|\{plus}
-|\+
-|{plus}
-
-|\{brvbar}
-|\¦
-|{brvbar}
-|===
-
-// Table of built-in data attributes
-.Built-in data attributes
-[width="70%",cols="1m,3"]
-|===
-|Attribute |Description
-
-|asciidoctor
-|Calls the processor
-
-|asciidoctor-version
-|Version of the processor
-
-|backend
-|Backend used to render document
-
-|docdate
-|Last modified date
-
-|docdatetime
-|Last modified date and time
-
-|docdir
-|Name of document directory
-
-|docfile
-|Name of document file
-
-|doctime
-|Last modified time
-
-|doctitle
-|The title of the document
-
-|doctype
-|Document's doctype (e.g., article)
-
-|localdate
-|Local date when rendered
-
-|localdatetime
-|Local date and time when rendered
-
-|localtime
-|Local time when rendered
-|===
-
-.Named substitutions
-[horizontal]
-`none`:: Disables substitutions
-
-`normal`:: Performs all substitutions except for callouts
-
-`verbatim`:: Replaces special characters and processes callouts
-
-`specialcharacters`:: Replaces `<`, `>`, and `&` with their corresponding entities
-
-`quotes`:: Applies text formatting
-
-`attributes`:: Replaces attribute references
-
-`replacements`:: Substitutes textual and character reference replacements
-
-`macros`:: Processes macros
-
-`post_replacements`:: Replaces the line break character (`{plus}`)
-
-.Counter attributes
-----
-[caption=""]
-.Parts{counter2:index:0}
-|===
-|Part Id |Description
-
-|PX-{counter:index}
-|Description of PX-{index}
-
-|PX-{counter:index}
-|Description of PX-{index}
-|===
-----
-
-[.result]
-====
-[caption=""]
-.Parts{counter2:index:0}
-|===
-|Part Id |Description
-
-|PX-{counter:index}
-|Description of PX-{index}
-
-|PX-{counter:index}
-|Description of PX-{index}
-|===
-====
-
-== Text Replacement
-
-// Table of text replacements performed during replacements substitution
-////
-Included in:
-
-- user-manual: Text Substitutions: Replacements
-- quick-ref
-////
-
-[cols="2,^1l,^1l,^1,2"]
-.Textual symbol replacements
-|===
-|Name |Syntax |Unicode Replacement |Rendered |Notes
-
-|Copyright
-|\(C)
-|\©
-|(C)
-|
-
-|Registered
-|\(R)
-|\®
-|(R)
-|
-
-|Trademark
-|\(TM)
-|\™
-|(TM)
-|
-
-|Em dash
-|\--
-|\—
-|{empty}--{empty}
-|When space is detected on either side of the em dash, the thin space numeric character entity (`\ `) is also substituted into the document.
-
-|ellipses
-|\...
-|\…
-|...
-|
-
-|right single arrow
-|\->
-|\→
-|->
-|
-
-|right double arrow
-|\=>
-|\⇒
-|=>
-|
-
-|left single arrow
-|\<-
-|\←
-|<-
-|
-
-|left double arrow
-|\<=
-|\⇐
-|<=
-|
-
-|apostrophe
-|Sam\'s
-|Sam\’s
-|Sam's
-|The vertical form apostrophe is replaced with the curved form apostrophe.
-|===
-
-TIP: Any named, numeric or hex http://en.wikipedia.org/wiki/List_of_XML_and_HTML_character_entity_references[XML entity reference] is supported.
-
-== Escaping Text
-
-.Backslash
-----
-\*Stars* is not rendered as bold text.
-The asterisks around the word are preserved.
-
-\{author} is not resolved to the author name.
-The curly brackets around the word are preserved.
-
-The backslash character is automatically removed.
-----
-
-[.result]
-====
-\*Stars* is not rendered as bold text.
-The asterisks around the word are preserved.
-
-\{author} is not resolved to the author name.
-The curly brackets around the word are preserved.
-
-The backslash character is automatically removed.
-====
-
-.Double dollar
-----
-$$*Stars*$$ is not rendered as bold text.
-The asterisks around the word are preserved.
-
-$$&$$ renders as an XML entity instead of &.
-----
-
-[.result]
-====
-$$*Stars*$$ is not rendered as bold text.
-The asterisks around the word are preserved.
-
-$$&$$ renders as an XML entity instead of &.
-====
-
-.Triple plus and inline passthrough macro
-----
-+++underline me+++ renders as underlined text.
-
-pass:[underline me] also renders as underlined text.
-----
-
-[.result]
-====
-+++underline me+++ renders as underlined text.
-
-pass:[underline me] also renders as underlined text.
-====
-
-.Backticks
-----
-`Text in {backticks}` renders exactly as entered, in `monospace`.
-The attribute reference is not resolved.
-----
-
-[.result]
-====
-`Text in {backticks}` renders exactly as entered, in `monospace`.
-The attribute reference is not resolved.
-====
-
-== Table of Contents (ToC)
-
-.Document with ToC
-----
-= AsciiDoc Writer's Guide
-Doc Writer
-v1.0, 2013-01-01
-:toc:
-----
-
-.Document with ToC positioned on the right
-----
-= AsciiDoc Writer's Guide
-Doc Writer
-v1.0, 2013-01-01
-:toc: right
-----
-
-TIP: The ToC {toc-ref}["title, levels, and positioning"] can be customized.
-
-== Bibliography
-
-.References
-----
-'The Pragmatic Programmer' <> should be required reading for
-all developers.
-
-[bibliography]
-- [[[prag]]] Andy Hunt & Dave Thomas. 'The Pragmatic Programmer:
- From Journeyman to Master'. Addison-Wesley. 1999.
-- [[[seam]]] Dan Allen. 'Seam in Action'. Manning Publications.
- 2008.
-----
-
-[.result]
-====
-'The Pragmatic Programmer' <> should be required reading for
-all developers.
-
-[bibliography]
-- [[[prag]]] Andy Hunt & Dave Thomas. 'The Pragmatic Programmer:
- From Journeyman to Master'. Addison-Wesley. 1999.
-- [[[seam]]] Dan Allen. 'Seam in Action'. Manning Publications.
- 2008.
-====
-
-[[section-footnotes]]
-== Footnotes
-
-.Normal and reusable footnotes
-----
-A statement.footnote:[Clarification about this statement.]
-
-A bold statement.footnoteref:[disclaimer,These opinions are my own.]
-
-Another bold statement.footenoteref:[disclaimer]
-----
-
-[.result]
-====
-[.unstyled]
-|===
-a|
-A statement.footnote:[Clarification about this statement.]
-
-A bold statement.footnoteref:[disclaimer,These opinions are my own.]
-
-Another bold statement.footenoteref:[disclaimer]
-|===
-====
-
-== Markdown Compatibility
-
-IMPORTANT: Markdown compatibility is only available by default in Asciidoctor.
-You can configure AsciiDoc (Python) to recognize this syntax by putting https://github.com/asciidoctor/asciidoctor/blob/master/compat/asciidoc.conf[the AsciiDoc compatibility file] from Asciidoctor in the same directory as the document being processed.
-
-.Markdown-style headings
-----
-# Document Title (Level 0)
-
-## Section Level 1
-
-### Section Level 2
-
-#### Section Level 3
-
-##### Section Level 4
-
-###### Section Level 5
-----
-
-[.result]
-====
-[float]
-# Document Title (Level 0)
-
-[float]
-## Section Level 1
-
-[float]
-### Section Level 2
-
-[float]
-#### Section Level 3
-
-[float]
-##### Section Level 4
-
-[float]
-###### Section Level 5
-====
-
-.Fenced code block with syntax highlighting
-----
-```ruby
-require 'sinatra'
-
-get '/hi' do
- "Hello World!"
-end
-```
-----
-
-[.result]
-====
-```ruby
-require 'sinatra'
-
-get '/hi' do
- "Hello World!"
-end
-```
-====
-
-.Markdown-style blockquote
-----
-> I hold it that a little rebellion now and then is a good thing,
-> and as necessary in the political world as storms in the physical.
-> -- Thomas Jefferson, Papers of Thomas Jefferson: Volume 11
-----
-
-[.result]
-====
-> I hold it that a little rebellion now and then is a good thing,
-> and as necessary in the political world as storms in the physical.
-> -- Thomas Jefferson, Papers of Thomas Jefferson: Volume 11
-====
-
-.Markdown-style blockquote with block content
-----
-> > What's new?
->
-> I've got Markdown in my AsciiDoc!
->
-> > Like what?
->
-> * Blockquotes
-> * Headings
-> * Fenced code blocks
->
-> > Is there more?
->
-> Yep. AsciiDoc and Markdown share a lot of common syntax already.
-----
-
-[.result]
-====
-> > What's new?
->
-> I've got Markdown in my AsciiDoc!
->
-> > Like what?
->
-> * Blockquotes
-> * Headings
-> * Fenced code blocks
->
-> > Is there more?
->
-> Yep. AsciiDoc and Markdown share a lot of common syntax already.
-====
-
-.Markdown-style horizontal rules
-----
----
-
-- - -
-
-***
-
-* * *
-----
-
-[.result]
-====
----
-
-- - -
-
-***
-
-* * *
-====
-
-== User Manual and Help
-
-To learn more about Asciidoctor and its capabilities, check out the other {docref}[Asciidoctor guides] and its {user-ref}[User Manual].
-Also, don't forget to join the {mailinglist}[Asciidoctor mailing list], where you can ask questions and leave comments.
-
diff --git a/help/html.html b/help/html.html
deleted file mode 100644
index 2456d1f..0000000
--- a/help/html.html
+++ /dev/null
@@ -1,128 +0,0 @@
-
-This page is having a quick review of all the HTML tags discussed in this tutorial. If you need to know in detail about any tag then refer to HTML Tag List chapter.
-HTML Basic Syntax:
-
-HTML Element names and attribute names are not case sensitive.
HTML Documents start with a <!doctype...> statement, followed by a header and a text body all enclosed in <html>...</html>.
HTML Header is enclosed in <head>....</head> tags.
HTML Body is enclosed in <body>....</body> tags.
HTML Comments are written as <!-- A comment -->.
-HTML Basic Document:
-
-<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4.0//EN">
-<html>
-<head>
-<title>Document Title like HTML Tutorial</title>
-</head>
-
-<body>
- Document Text with other tags will come here.
-</body>
-
-</html>
-
-Header elements:
-
-<head> - Opening tag for the head of the document. The following optional tags can be placed inside the head.
<title>...</title> -Document title (not part of the text), recommended maximum length 64 characters.
<link ...> - Relationships for the document as a whole: common attributes are rel, rev, href.
<base href="url"> - Specifies the base URL of the document. This is used when dereferencing relative URLs in the page.
<base href="url" target="..."> - Specifies the base URL of the document. This is used when dereferencing relative URLs in the page. Also specifies the base target frame that all links will default to.
<meta ...> - Embed meta-information as if given by the server: attributes http-equiv, name, content.
-<meta http-equiv="refresh" content="N" > - Same page will be reloaded automatically after N seconds.
-<meta http-equiv="refresh" content="N" url="http://www.example.com> - Same other page will refresh automatically after N seconds.
-<meta http-equiv="expires" content="Wed, 08 Aug 2007 01:21:00 GMT" > - Specifies an expiration date for the page so that it will be reloaded after a certain date.
-<meta http-equiv="keywords" content="keyword1, keyword2,..." > - Specifies various keywords available on the page and to be used by the search engine.
-<meta http-equiv="description" content="A short description of the site" > - Specifies small description of the page and to be used by the search engine.
-
<style type="text/css" href="URL" /> - Specifies a CSS file to be used for the web page.
<script type="text/scripttype" href="URL" /> - Specifies a Javascript of VBscript file to be used for the web page.
<noscript> ... </noscript> - Encloses anything you want displayed by browsers that do not support inline scripts. This goes inside the <script> tags.
</head> - Closing tag for the head of the document.
-Body Elements:
-
-<body>...</body> - Encloses the main body of the document.
<hn>...</hn> - Makes the enclosed text a heading of various sizes where n is any number ranging from 1 to 6, and 1 creates the biggest heading while 6 creates the smallest.
<basefont size="n"> - Sets the default font properties for the entire page.
<isindex attributes> - Displays a text box indicating the presence of a searchable index. Simply adding this tag will not create a searchable page. The server must be set up to support it.
<img src="URL" attributes> - Places an inline image into the document.
<map attributes>...</map> - Specifies a collection of hot spots that define a client-side image map. The <area> tag can be used inside to define the hot spots.
<area attributes>...</area> - Specifies the shape and size of a hot spot to be used in the definition of a client-side image map. Used inside the <map> tag.
<marquee attributes>...</marquee> - Places a scrolling text marquee into the document.
<applet attributes>...</applet> - Inserts a Java applet in the HTML document. Any text placed between the opening and closing <applet> tags will be displayed by browsers that do not support JAVA.
<embed attributes>...</embed> - Inserts an embedded multimedia object, such as a sound file or video, into the page.
<a href="...">...</a> - When used with the HREF attribute, the enclosed text and/or graphic becomes a link to another document or anchor. When used with the NAME attribute, the enclosed text and/or graphic becomes an anchor.
<ol attributes>...</ol> - Puts the enclosed items marked with <li>, in a numbered list.
<ul attributes>...</ul> - Puts the enclosed items marked with <li>, in a bulleted list.
<dl>...</dl> - Creates a definition list. Within this container, <dt> specifies a definition term and <dd> specifies the definition.
-Frame Elements:
-
-<frameset attributes>...</frameset> - Defines a set of frames that will make up the page. The <frame>, and <noframes> tags go inside this. The <frameset> tag is used instead of the <body> tag. You can, however, include a <body> tag inside the <noframes> tags for browsers that do not support frames.
<frame attributes /> - Defines a single frame within a frameset.
<iframe attributes>...</iframe> - Defines a floating frame. Does not need to be placed within a frameset.
<noframes>...</noframes> - Placed inside the <frameset>, anything between the beginning and ending of this tag is viewable only by browsers that do not support frames. This tag is used to create pages that are compatible with older browsers that do not support frames.
-Table Elements:
-
-<table attributes>...</table> -Creates a table that can include any number of rows.
<caption attributes>...</caption> -Specifies the caption of the table.
<tr attributes>...</tr> - Specifies a table row. It can enclose the table heading and table data.
<th attributes>...</th> - Specifies a table heading.
<td attributes>...</td> - Specifies a table data cell.
<colgroup attributes /> - Specifies the properties of one or more columns. This tag generally goes right after the opening <table> tag.
<col attributes /> - Used with the <colgroup> tag, this specifies the properties of one column. This tag overrides any attributes specified in the <colgroup> tag that comes right before it.
<tbody>...</tbody> - Encloses the body of your table. This tag is optional unless you are using the <thead> or <tfoot> tags. It used to separate the rows in the table from those in the header or footer.
<tfoot>...</tfoot> - Encloses the table rows that are to be used as a footer. It is an optional tag and comes right after the ending <tbody> element.
<thead>...</thead> - Encloses the table rows that are to be used as a header. It is an optional tag and comes before the opening <tbody> element.
-Form Elements:
-
-<from attributes>...</from> - Specifies a form. Forms can be used to send user input to the server in the form of NAME/VALUE pairs.
<input attributes /> - Specifies a control or input area for a form, from which a NAME/VALUE pair will be returned to the server. It could be Checkbox, Raidobox, password, text, reset, submit, hidden and image.
<select attributes>...</select> - Creates a drop-down list of items. The list items are defined by the <option> tags placed inside the opening and closing <select> tag.
<option value="..." /> - Specifies an item in the drop down list. Placed within the opening and closing <select> tags. Any text following the <option> tag is what the user will see in the list.
<textarea attributes>...</textarea> - Creates a multi-lined text entry box. Any text placed in between the tags is used as the default text string that is displayed when the page is loaded.
<button attributes>...</button> - allows you to have push buttons on forms that more closely resemble push buttons available in Windows and other applications.
-Text Formatting Elements:
-
-<address>.....< /address> - Encloses the signature file of the author of the page. Text is displayed in italics.
<acronym>.....< /acronym> - indicates an acronym in the text.
<b>...< /b> - Boldfaces the enclosed text.
<big>...< /big> - Makes the enclosed text one size larger.
<blink>.....< /blink> - Makes the enclosed text blink continually.
<blockquote>.....< /blockquote> - Encloses a long quote. Both the left and right margins are indented.
<br> - Inserts a line break.
<center>.....< /center> - Centers the enclosed elements.
<cite>.....< /cite> - Encloses a citation such as the title of a book or paper.
<code>.....< /code> - Encloses a sample of code. The text is rendered in small font.
<comment>.....< /comment> - Encloses a comment. Text inside the tags is ignored unless it contains HTML code.
<del>.....< /del> - To mark the document text that has been deleted since a previous version.
<dfn>.....< /dfn> - Encloses a definition. Text inside the tags is formatted to look like a definition.
<div>...< /div> - Specifies the alignment of the enclosed elements. Can be used to divide a document into sections that are aligned differently.
<em>...< /em> - Emphasis on the enclosed text (Italics).
<font attributes>...< /font> - Sets the font properties for the enclosed text.
<fieldset attributes>...< /fieldset> - Allows you can group related form fields, making your form easier to read and use.
<hr attributes /> - Inserts a horizontal line.
<i>...< /i> - The enclosed text is italics.
<ins>...< /ins> - To mark parts of a document that have been added since the document's last version.
<label>...< /label> - Allows you to lable a tag.
<kbd>...< /kbd> - Specifies text to be entered at the keyboard. Text is rendered as bold and fixed-width.
<p attributes>...< /p> - Designates the enclosed text as a plain paragraph.
<q>...</q> - acts much the same as the <blockquote> tag, but applies to shorter quoted sections, ones that don't need paragraph breaks.
<pre>.....< /pre> - Displays text in fixed-width type without collapsing spaces.
<s>.....< /s> - Displays text with a line through it. The <strike> tag does exactly the same.
<samp>...< /samp> - Indicates sample output from a form or program. Text is rendered in small font.
<small>...< /small> - Makes the enclosed text one size smaller.
<spacer attributes>...< /spacer> - Inserts blocks of spaces into HTML documents.
<strong>...< /strong> - Stronger emphasis on the enclosed text.
<sub>...< /sub> - Renders the enclosed text in subscript.
<sup>...< /sup> - Renders the enclosed text in superscript.
<tt>...< /tt> - The enclosed text is typewriter font.
<u>...< /u> - The enclosed text in underlined.
<var>...< /var> - Specifies a variable. Text is rendered in small fixed-width type.
<wbr> - Causes text enclosed by the NOBR tags to wrap only if necessary.
diff --git a/help/markdown.md b/help/markdown.md
deleted file mode 100644
index 6913cb0..0000000
--- a/help/markdown.md
+++ /dev/null
@@ -1,307 +0,0 @@
-Markdown: Basics
-================
-
-
-
-
-Getting the Gist of Markdown's Formatting Syntax
-------------------------------------------------
-
-This page offers a brief overview of what it's like to use Markdown.
-The [syntax page] [s] provides complete, detailed documentation for
-every feature, but Markdown should be very easy to pick up simply by
-looking at a few examples of it in action. The examples on this page
-are written in a before/after style, showing example syntax and the
-HTML output produced by Markdown.
-
-It's also helpful to simply try Markdown out; the [Dingus] [d] is a
-web application that allows you type your own Markdown-formatted text
-and translate it to XHTML.
-
-**Note:** This document is itself written using Markdown; you
-can [see the source for it by adding '.text' to the URL] [src].
-
- [s]: /projects/markdown/syntax "Markdown Syntax"
- [d]: /projects/markdown/dingus "Markdown Dingus"
- [src]: /projects/markdown/basics.text
-
-
-## Paragraphs, Headers, Blockquotes ##
-
-A paragraph is simply one or more consecutive lines of text, separated
-by one or more blank lines. (A blank line is any line that looks like
-a blank line -- a line containing nothing but spaces or tabs is
-considered blank.) Normal paragraphs should not be indented with
-spaces or tabs.
-
-Markdown offers two styles of headers: *Setext* and *atx*.
-Setext-style headers for `` and `` are created by
-"underlining" with equal signs (`=`) and hyphens (`-`), respectively.
-To create an atx-style header, you put 1-6 hash marks (`#`) at the
-beginning of the line -- the number of hashes equals the resulting
-HTML header level.
-
-Blockquotes are indicated using email-style '`>`' angle brackets.
-
-Markdown:
-
- A First Level Header
- ====================
-
- A Second Level Header
- ---------------------
-
- Now is the time for all good men to come to
- the aid of their country. This is just a
- regular paragraph.
-
- The quick brown fox jumped over the lazy
- dog's back.
-
- ### Header 3
-
- > This is a blockquote.
- >
- > This is the second paragraph in the blockquote.
- >
- > ## This is an H2 in a blockquote
-
-
-Output:
-
- A First Level Header
-
- A Second Level Header
-
-
Now is the time for all good men to come to
- the aid of their country. This is just a
- regular paragraph.
-
- The quick brown fox jumped over the lazy
- dog's back.
-
- Header 3
-
-
- This is a blockquote.
-
- This is the second paragraph in the blockquote.
-
- This is an H2 in a blockquote
-
-
-
-
-### Phrase Emphasis ###
-
-Markdown uses asterisks and underscores to indicate spans of emphasis.
-
-Markdown:
-
- Some of these words *are emphasized*.
- Some of these words _are emphasized also_.
-
- Use two asterisks for **strong emphasis**.
- Or, if you prefer, __use two underscores instead__.
-
-Output:
-
- Some of these words are emphasized.
- Some of these words are emphasized also.
-
- Use two asterisks for strong emphasis.
- Or, if you prefer, use two underscores instead.
-
-
-
-## Lists ##
-
-Unordered (bulleted) lists use asterisks, pluses, and hyphens (`*`,
-`+`, and `-`) as list markers. These three markers are
-interchangable; this:
-
- * Candy.
- * Gum.
- * Booze.
-
-this:
-
- + Candy.
- + Gum.
- + Booze.
-
-and this:
-
- - Candy.
- - Gum.
- - Booze.
-
-all produce the same output:
-
-
- - Candy.
- - Gum.
- - Booze.
-
-
-Ordered (numbered) lists use regular numbers, followed by periods, as
-list markers:
-
- 1. Red
- 2. Green
- 3. Blue
-
-Output:
-
-
- - Red
- - Green
- - Blue
-
-
-If you put blank lines between items, you'll get `` tags for the
-list item text. You can create multi-paragraph list items by indenting
-the paragraphs by 4 spaces or 1 tab:
-
- * A list item.
-
- With multiple paragraphs.
-
- * Another item in the list.
-
-Output:
-
-
- A list item.
- With multiple paragraphs.
Another item in the list.
-
-
-
-### Links ###
-
-Markdown supports two styles for creating links: *inline* and
-*reference*. With both styles, you use square brackets to delimit the
-text you want to turn into a link.
-
-Inline-style links use parentheses immediately after the link text.
-For example:
-
- This is an [example link](http://example.com/).
-
-Output:
-
- This is an
- example link.
-
-Optionally, you may include a title attribute in the parentheses:
-
- This is an [example link](http://example.com/ "With a Title").
-
-Output:
-
- This is an
- example link.
-
-Reference-style links allow you to refer to your links by names, which
-you define elsewhere in your document:
-
- I get 10 times more traffic from [Google][1] than from
- [Yahoo][2] or [MSN][3].
-
- [1]: http://google.com/ "Google"
- [2]: http://search.yahoo.com/ "Yahoo Search"
- [3]: http://search.msn.com/ "MSN Search"
-
-Output:
-
- I get 10 times more traffic from Google than from Yahoo or MSN.
-
-The title attribute is optional. Link names may contain letters,
-numbers and spaces, but are *not* case sensitive:
-
- I start my morning with a cup of coffee and
- [The New York Times][NY Times].
-
- [ny times]: http://www.nytimes.com/
-
-Output:
-
- I start my morning with a cup of coffee and
- The New York Times.
-
-
-### Images ###
-
-Image syntax is very much like link syntax.
-
-Inline (titles are optional):
-
- 
-
-Reference-style:
-
- ![alt text][id]
-
- [id]: /path/to/img.jpg "Title"
-
-Both of the above examples produce the same output:
-
- 
-
-
-
-### Code ###
-
-In a regular paragraph, you can create code span by wrapping text in
-backtick quotes. Any ampersands (`&`) and angle brackets (`<` or
-`>`) will automatically be translated into HTML entities. This makes
-it easy to use Markdown to write about HTML example code:
-
- I strongly recommend against using any `
-Content in a passthrough block is passed to the output unprocessed. -That means you can include raw HTML, like this embedded Gist: -
- - -++++ ----- - -[.result] -==== -++++ --Content in a passthrough block is passed to the output unprocessed. -That means you can include raw HTML, like this embedded Gist: -
- - -++++ -==== - -.Open ----- --- -An open block can be an anonymous container, -or it can masquerade as any other block. --- - -[source] --- -puts "I'm a source block!" --- ----- - -[.result] -==== --- -An open block can be an anonymous container, -or it can masquerade as any other block. --- - -[source] --- -puts "I'm a source block!" --- -==== - -[listing] -.Custom substitutions -.... -:version: 0.1.4 - -[source,xml] -[subs="verbatim,attributes"] ----- -This page is having a quick review of all the HTML tags discussed in this tutorial. If you need to know in detail about any tag then refer to HTML Tag List chapter.
-HTML Basic Syntax:
--
-
HTML Element names and attribute names are not case sensitive.
-HTML Documents start with a <!doctype...> statement, followed by a header and a text body all enclosed in <html>...</html>.
-HTML Header is enclosed in <head>....</head> tags.
-HTML Body is enclosed in <body>....</body> tags.
-HTML Comments are written as <!-- A comment -->.
-
HTML Basic Document:
--<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4.0//EN"> -<html> -<head> -<title>Document Title like HTML Tutorial</title> -</head> - -<body> - Document Text with other tags will come here. -</body> - -</html> - |
Header elements:
--
-
<head> - Opening tag for the head of the document. The following optional tags can be placed inside the head.
-<title>...</title> -Document title (not part of the text), recommended maximum length 64 characters.
-<link ...> - Relationships for the document as a whole: common attributes are rel, rev, href.
-<base href="url"> - Specifies the base URL of the document. This is used when dereferencing relative URLs in the page.
-<base href="url" target="..."> - Specifies the base URL of the document. This is used when dereferencing relative URLs in the page. Also specifies the base target frame that all links will default to.
-<meta ...> - Embed meta-information as if given by the server: attributes http-equiv, name, content.
-<meta http-equiv="refresh" content="N" > - Same page will be reloaded automatically after N seconds.
-<meta http-equiv="refresh" content="N" url="http://www.example.com> - Same other page will refresh automatically after N seconds.
-<meta http-equiv="expires" content="Wed, 08 Aug 2007 01:21:00 GMT" > - Specifies an expiration date for the page so that it will be reloaded after a certain date.
-<meta http-equiv="keywords" content="keyword1, keyword2,..." > - Specifies various keywords available on the page and to be used by the search engine.
-<meta http-equiv="description" content="A short description of the site" > - Specifies small description of the page and to be used by the search engine.
-
-<style type="text/css" href="URL" /> - Specifies a CSS file to be used for the web page.
-<script type="text/scripttype" href="URL" /> - Specifies a Javascript of VBscript file to be used for the web page.
-<noscript> ... </noscript> - Encloses anything you want displayed by browsers that do not support inline scripts. This goes inside the <script> tags.
-</head> - Closing tag for the head of the document.
-
Body Elements:
--
-
<body>...</body> - Encloses the main body of the document.
-<hn>...</hn> - Makes the enclosed text a heading of various sizes where n is any number ranging from 1 to 6, and 1 creates the biggest heading while 6 creates the smallest.
-<basefont size="n"> - Sets the default font properties for the entire page.
-<isindex attributes> - Displays a text box indicating the presence of a searchable index. Simply adding this tag will not create a searchable page. The server must be set up to support it.
-<img src="URL" attributes> - Places an inline image into the document.
-<map attributes>...</map> - Specifies a collection of hot spots that define a client-side image map. The <area> tag can be used inside to define the hot spots.
-<area attributes>...</area> - Specifies the shape and size of a hot spot to be used in the definition of a client-side image map. Used inside the <map> tag.
-<marquee attributes>...</marquee> - Places a scrolling text marquee into the document.
-<applet attributes>...</applet> - Inserts a Java applet in the HTML document. Any text placed between the opening and closing <applet> tags will be displayed by browsers that do not support JAVA.
-<embed attributes>...</embed> - Inserts an embedded multimedia object, such as a sound file or video, into the page.
-<a href="...">...</a> - When used with the HREF attribute, the enclosed text and/or graphic becomes a link to another document or anchor. When used with the NAME attribute, the enclosed text and/or graphic becomes an anchor.
-<ol attributes>...</ol> - Puts the enclosed items marked with <li>, in a numbered list.
-<ul attributes>...</ul> - Puts the enclosed items marked with <li>, in a bulleted list.
-<dl>...</dl> - Creates a definition list. Within this container, <dt> specifies a definition term and <dd> specifies the definition.
-
Frame Elements:
--
-
<frameset attributes>...</frameset> - Defines a set of frames that will make up the page. The <frame>, and <noframes> tags go inside this. The <frameset> tag is used instead of the <body> tag. You can, however, include a <body> tag inside the <noframes> tags for browsers that do not support frames.
-<frame attributes /> - Defines a single frame within a frameset.
-<iframe attributes>...</iframe> - Defines a floating frame. Does not need to be placed within a frameset.
-<noframes>...</noframes> - Placed inside the <frameset>, anything between the beginning and ending of this tag is viewable only by browsers that do not support frames. This tag is used to create pages that are compatible with older browsers that do not support frames.
-
Table Elements:
--
-
<table attributes>...</table> -Creates a table that can include any number of rows.
-<caption attributes>...</caption> -Specifies the caption of the table.
-<tr attributes>...</tr> - Specifies a table row. It can enclose the table heading and table data.
-<th attributes>...</th> - Specifies a table heading.
-<td attributes>...</td> - Specifies a table data cell.
-<colgroup attributes /> - Specifies the properties of one or more columns. This tag generally goes right after the opening <table> tag.
-<col attributes /> - Used with the <colgroup> tag, this specifies the properties of one column. This tag overrides any attributes specified in the <colgroup> tag that comes right before it.
-<tbody>...</tbody> - Encloses the body of your table. This tag is optional unless you are using the <thead> or <tfoot> tags. It used to separate the rows in the table from those in the header or footer.
-<tfoot>...</tfoot> - Encloses the table rows that are to be used as a footer. It is an optional tag and comes right after the ending <tbody> element.
-<thead>...</thead> - Encloses the table rows that are to be used as a header. It is an optional tag and comes before the opening <tbody> element.
-
Form Elements:
--
-
<from attributes>...</from> - Specifies a form. Forms can be used to send user input to the server in the form of NAME/VALUE pairs.
-<input attributes /> - Specifies a control or input area for a form, from which a NAME/VALUE pair will be returned to the server. It could be Checkbox, Raidobox, password, text, reset, submit, hidden and image.
-<select attributes>...</select> - Creates a drop-down list of items. The list items are defined by the <option> tags placed inside the opening and closing <select> tag.
-<option value="..." /> - Specifies an item in the drop down list. Placed within the opening and closing <select> tags. Any text following the <option> tag is what the user will see in the list.
-<textarea attributes>...</textarea> - Creates a multi-lined text entry box. Any text placed in between the tags is used as the default text string that is displayed when the page is loaded.
-<button attributes>...</button> - allows you to have push buttons on forms that more closely resemble push buttons available in Windows and other applications.
-
Text Formatting Elements:
--
-
<address>.....< /address> - Encloses the signature file of the author of the page. Text is displayed in italics.
-<acronym>.....< /acronym> - indicates an acronym in the text.
-<b>...< /b> - Boldfaces the enclosed text.
-<big>...< /big> - Makes the enclosed text one size larger.
-<blink>.....< /blink> - Makes the enclosed text blink continually.
-<blockquote>.....< /blockquote> - Encloses a long quote. Both the left and right margins are indented.
-<br> - Inserts a line break.
-<center>.....< /center> - Centers the enclosed elements.
-<cite>.....< /cite> - Encloses a citation such as the title of a book or paper.
-<code>.....< /code> - Encloses a sample of code. The text is rendered in small font.
-<comment>.....< /comment> - Encloses a comment. Text inside the tags is ignored unless it contains HTML code.
-<del>.....< /del> - To mark the document text that has been deleted since a previous version.
-<dfn>.....< /dfn> - Encloses a definition. Text inside the tags is formatted to look like a definition.
-<div>...< /div> - Specifies the alignment of the enclosed elements. Can be used to divide a document into sections that are aligned differently.
-<em>...< /em> - Emphasis on the enclosed text (Italics).
-<font attributes>...< /font> - Sets the font properties for the enclosed text.
-<fieldset attributes>...< /fieldset> - Allows you can group related form fields, making your form easier to read and use.
-<hr attributes /> - Inserts a horizontal line.
-<i>...< /i> - The enclosed text is italics.
-<ins>...< /ins> - To mark parts of a document that have been added since the document's last version.
-<label>...< /label> - Allows you to lable a tag.
-<kbd>...< /kbd> - Specifies text to be entered at the keyboard. Text is rendered as bold and fixed-width.
-<p attributes>...< /p> - Designates the enclosed text as a plain paragraph.
-<q>...</q> - acts much the same as the <blockquote> tag, but applies to shorter quoted sections, ones that don't need paragraph breaks.
-<pre>.....< /pre> - Displays text in fixed-width type without collapsing spaces.
-<s>.....< /s> - Displays text with a line through it. The <strike> tag does exactly the same.
-<samp>...< /samp> - Indicates sample output from a form or program. Text is rendered in small font.
-<small>...< /small> - Makes the enclosed text one size smaller.
-<spacer attributes>...< /spacer> - Inserts blocks of spaces into HTML documents.
-<strong>...< /strong> - Stronger emphasis on the enclosed text.
-<sub>...< /sub> - Renders the enclosed text in subscript.
-<sup>...< /sup> - Renders the enclosed text in superscript.
-<tt>...< /tt> - The enclosed text is typewriter font.
-<u>...< /u> - The enclosed text in underlined.
-<var>...< /var> - Specifies a variable. Text is rendered in small fixed-width type.
-<wbr> - Causes text enclosed by the NOBR tags to wrap only if necessary.
-
` and `` are created by
-"underlining" with equal signs (`=`) and hyphens (`-`), respectively.
-To create an atx-style header, you put 1-6 hash marks (`#`) at the
-beginning of the line -- the number of hashes equals the resulting
-HTML header level.
-
-Blockquotes are indicated using email-style '`>`' angle brackets.
-
-Markdown:
-
- A First Level Header
- ====================
-
- A Second Level Header
- ---------------------
-
- Now is the time for all good men to come to
- the aid of their country. This is just a
- regular paragraph.
-
- The quick brown fox jumped over the lazy
- dog's back.
-
- ### Header 3
-
- > This is a blockquote.
- >
- > This is the second paragraph in the blockquote.
- >
- > ## This is an H2 in a blockquote
-
-
-Output:
-
- A First Level Header
-
- A Second Level Header
-
-
A First Level Header
- -A Second Level Header
- -Now is the time for all good men to come to - the aid of their country. This is just a - regular paragraph.
- -The quick brown fox jumped over the lazy - dog's back.
- -Header 3
- --- - - -### Phrase Emphasis ### - -Markdown uses asterisks and underscores to indicate spans of emphasis. - -Markdown: - - Some of these words *are emphasized*. - Some of these words _are emphasized also_. - - Use two asterisks for **strong emphasis**. - Or, if you prefer, __use two underscores instead__. - -Output: - -This is a blockquote.
- -This is the second paragraph in the blockquote.
- -This is an H2 in a blockquote
-
Some of these words are emphasized. - Some of these words are emphasized also.
- -Use two asterisks for strong emphasis. - Or, if you prefer, use two underscores instead.
- - - -## Lists ## - -Unordered (bulleted) lists use asterisks, pluses, and hyphens (`*`, -`+`, and `-`) as list markers. These three markers are -interchangable; this: - - * Candy. - * Gum. - * Booze. - -this: - - + Candy. - + Gum. - + Booze. - -and this: - - - Candy. - - Gum. - - Booze. - -all produce the same output: - --
-
- Candy. -
- Gum. -
- Booze. -
-
-
- Red -
- Green -
- Blue -
` tags for the -list item text. You can create multi-paragraph list items by indenting -the paragraphs by 4 spaces or 1 tab: - - * A list item. - - With multiple paragraphs. - - * Another item in the list. - -Output: - -
-
-
A list item.
-With multiple paragraphs.
- Another item in the list.
-
This is an - example link.
- -Optionally, you may include a title attribute in the parentheses: - - This is an [example link](http://example.com/ "With a Title"). - -Output: - -This is an - example link.
- -Reference-style links allow you to refer to your links by names, which -you define elsewhere in your document: - - I get 10 times more traffic from [Google][1] than from - [Yahoo][2] or [MSN][3]. - - [1]: http://google.com/ "Google" - [2]: http://search.yahoo.com/ "Yahoo Search" - [3]: http://search.msn.com/ "MSN Search" - -Output: - -I get 10 times more traffic from Google than from Yahoo or MSN.
- -The title attribute is optional. Link names may contain letters, -numbers and spaces, but are *not* case sensitive: - - I start my morning with a cup of coffee and - [The New York Times][NY Times]. - - [ny times]: http://www.nytimes.com/ - -Output: - -I start my morning with a cup of coffee and - The New York Times.
- - -### Images ### - -Image syntax is very much like link syntax. - -Inline (titles are optional): - -  - -Reference-style: - - ![alt text][id] - - [id]: /path/to/img.jpg "Title" - -Both of the above examples produce the same output: - -
-
-
-
-### Code ###
-
-In a regular paragraph, you can create code span by wrapping text in
-backtick quotes. Any ampersands (`&`) and angle brackets (`<` or
-`>`) will automatically be translated into HTML entities. This makes
-it easy to use Markdown to write about HTML example code:
-
- I strongly recommend against using any `