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.<\/p>\n\n\n\n
Any text editor can be used. Some websites, like Github, render AsciiDoc files directly into HTML.<\/p>\n\n\n\n
To get use on it, We can refer trough an IDE with the corresponding plugin, or we have to install it localy on the computer. <\/p><\/blockquote>\n\n\n\n
IntelliJ AsciiDoc Plugin<\/span><\/h4>\n\n\n\n
A plugin for the IntelliJ platform (IntelliJ IDEA, RubyMine, etc.) that provides support for the AsciiDoc<\/a> markup language. It also supports Antora<\/a>, the documentation CMS build with AsciiDoc.<\/p>\n\n\n\n
You can install the plugin (named \u201cAsciiDoc\u201d) from the plugins section inside your JetBrains IDE or download it from the JetBrains Plugin Repository<\/a>.<\/p>\n\n\n\n
Features<\/h5>\n\n\n\n
- Recognizes the AsciiDoc file extension (.adoc, .asciidoc, .ad)<\/li>
- Provides a two-pane AsciiDoc preview editor based on AsciidoctorJ<\/a> with live preview.<\/li>
- Toolbar and context menu for basic formatting and to create tables.<\/li>
- Refactor Markdown to AsciiDoc: Right click on a file, or use the Refactor menu, and the Markdown document will be replaced by the AsciiDoc equivalent. Also, supports undo if the user is not happy with the result!<\/li><\/ul>\n\n\n\n
AsciiDoc Installation<\/span><\/h4>\n\n\n\n
<\/p>\n\n\n\n
Installing from the GitHub repository<\/span><\/h5>\n\n\n\n
The AsciiDoc repository is hosted by GitHub<\/a>. To browse the repository go to https:\/\/github.com\/asciidoc\/asciidoc-py3<\/a>. You can install AsciiDoc from the repository if you don\u2019t have an up to date packaged version, or you want to get the latest version from the master branch:<\/p>\n\n\n\n
- Make sure you have Git<\/a> installed; you can check with:
$ git --version<\/code><\/li>- Go to the directory you want to install AsciiDoc into and download the repository. This example gets the 9.0.3 tagged release:
$ cd ~\/bin $ git clone https:\/\/github.com\/asciidoc\/asciidoc-py3 asciidoc-9.0.3 $ git checkout 9.0.3<\/code><\/li><\/ul>\n\n\n\nYou now have two choices: you can run asciidoc locally from your repository or you can use autoconf(1)<\/em> and make(1)<\/em> to perform a system-wide install.<\/p>\n\n\n\n
<\/p>\n\n\n\n
Running asciidoc from your local copy<\/span><\/h5>\n\n\n\n
Create a symlink to the AsciiDoc script in a search
PATH<\/code> directory so it\u2019s easy to executeasciidoc<\/code> from the command line, for example:<\/p>\n\n\n\n$ ln -s ~\/bin\/asciidoc-9.0.3\/asciidoc.py ~\/bin\/asciidoc\n$ ln -s ~\/bin\/asciidoc-9.0.3\/a2x.py ~\/bin\/a2x<\/code><\/pre>\n\n\n\nUse the git
pull<\/code> command to update your local AsciiDoc repository.<\/p>\n\n\n\n<\/p>\n\n\n\n
Installing asciidoc for all users<\/span><\/h5>\n\n\n\n
Create
configure<\/code> using autoconf(1)<\/em>; useconfigure<\/code> to create theMakefile<\/code>; run make(1)<\/em>; build the man pages; install:<\/p>\n\n\n\n$ autoconf\n$ .\/configure\n$ make\n$ sudo make install<\/code><\/pre>\n\n\n\nTo uninstall:<\/p>\n\n\n\n
$ sudo make uninstall<\/code><\/pre>\n\n\n\n<\/p>\n\n\n\n
Prepackaged AsciiDoc installation<\/span><\/h5>\n\n\n\n
The following platform-specific AsciiDoc packages are available:<\/p>\n\n\n\n
Fedora Linux<\/span><\/strong><\/p>\n\n\n\n
AsciiDoc is included in Fedora Extras, which is available in the default Fedora installation. To install asciidoc, execute the following command:<\/p>\n\n\n\n
$ yum install asciidoc<\/code><\/pre>\n\n\n\nUbuntu \/ Debian<\/span><\/strong><\/p>\n\n\n\n
AsciiDoc is included in Ubuntu \/ Debian package manager. To install, execute the following command:<\/p>\n\n\n\n
$ apt install asciidoc<\/code><\/pre>\n\n\n\nmacOS Homebrew<\/span><\/strong><\/p>\n\n\n\n
AsciiDoc has been packaged in homebrew and is installable using the following command:<\/p>\n\n\n\n
$ brew install asciidoc<\/code><\/pre>\n\n\n\nSee also Packager Notes<\/a> in the AsciiDoc User Guide<\/em>.<\/p>\n\n\n\n
Overview and Examples<\/span><\/h4>\n\n\n\n
You write an AsciiDoc document the same way you would write a normal text document, there are no markup tags or weird format notations. AsciiDoc files are designed to be viewed, edited and printed directly or translated to other presentation formats using the
asciidoc(1)<\/code> command.<\/p>\n\n\n\nThe
asciidoc(1)<\/code> command translates AsciiDoc files to HTML, XHTML and DocBook markups. DocBook can be post-processed to presentation formats such as HTML, PDF, EPUB, DVI, LaTeX, roff, and Postscript using readily available Open Source tools.<\/p>\n\n\n\n<\/p>\n\n\n\n
Example Articles<\/span><\/h3>\n\n\n\n
- This XHTML version of the AsciiDoc User Guide<\/a> was generated by AsciiDoc from this AsciiDoc file<\/a>.<\/li>
- Here\u2019s the same document<\/a> created by first generating DocBook markup using AsciiDoc and then converting the DocBook markup to HTML using DocBook XSL Stylesheets<\/em>.<\/li>
- The User Guide again, this time a chunked version<\/a>.<\/li>
- AsciiDoc generated this stand-alone HTML file<\/a> containing embedded CSS, JavaScript and images from this AsciiDoc article template<\/a> with this command:
asciidoc -a data-uri -a icons -a toc -a max-width=55em article.txt<\/code><\/li>- The same AsciiDoc article template<\/a> generated this HTML 5<\/a> (the toc2<\/em> attribute puts a table of contents in the left margin) from this command:
asciidoc -b html5 -a icons -a toc2 -a theme=flask article.txt<\/code><\/li>- The same AsciiDoc article template<\/a> produced this HTML file<\/a> and this PDF file<\/a> via DocBook markup generated by AsciiDoc.<\/li><\/ul>\n\n\n\n
Reference:<\/h5>\n\n\n\n
https:\/\/github.com\/asciidoctor<\/a><\/p>\n\n\n\n