Asciidoc User Guide

Total Page:16

File Type:pdf, Size:1020Kb

Asciidoc User Guide AsciiDoc User Guide Stuart Rackham <[email protected]> Revision History Revision 8.2.5 18 November 2007 SJR Table of Contents Introduction ..........................................................................................................................................4 Getting Started .....................................................................................................................................4 Installing AsciiDoc ......................................................................................................................5 Example AsciiDoc Documents ....................................................................................................5 AsciiDoc Document Types ..................................................................................................................5 article ............................................................................................................................................5 book ..............................................................................................................................................5 manpage .......................................................................................................................................6 AsciiDoc Backends ..............................................................................................................................6 docbook ........................................................................................................................................6 xhtml11 ........................................................................................................................................6 html4 ............................................................................................................................................9 linuxdoc ........................................................................................................................................9 latex ..............................................................................................................................................9 Document Structure .............................................................................................................................9 Block Elements ..........................................................................................................................10 Header ........................................................................................................................................10 Preamble ....................................................................................................................................11 Sections ......................................................................................................................................11 Inline Elements ..........................................................................................................................12 Document Processing .........................................................................................................................13 Text Formatting .................................................................................................................................14 Quoted Text ...............................................................................................................................14 Inline Passthroughs ....................................................................................................................15 Superscripts and Subscripts .......................................................................................................16 Line Breaks (HTML/XHTML) ..................................................................................................16 Rulers (HTML/XHTML) ...........................................................................................................16 Tabs ............................................................................................................................................16 Replacements .............................................................................................................................16 Special Words ............................................................................................................................17 Titles ..................................................................................................................................................17 Two line titles ............................................................................................................................17 One line titles .............................................................................................................................17 BlockTitles .........................................................................................................................................18 BlockId Element ................................................................................................................................18 Paragraphs ..........................................................................................................................................18 Default Paragraph ......................................................................................................................19 Literal Paragraph ........................................................................................................................19 Admonition Paragraphs .............................................................................................................19 Delimited Blocks ...............................................................................................................................20 Predefined Delimited Blocks .....................................................................................................20 1 AsciiDoc User Guide Listing Blocks ............................................................................................................................21 Literal Blocks .............................................................................................................................21 SidebarBlocks ............................................................................................................................22 Comment Blocks ........................................................................................................................23 Passthrough Blocks ....................................................................................................................23 Quote Blocks ..............................................................................................................................23 Example Blocks .........................................................................................................................24 Admonition Blocks ....................................................................................................................25 Lists ....................................................................................................................................................25 Bulleted and Numbered Lists .....................................................................................................26 Vertical Labeled Lists ................................................................................................................27 Horizontal Labeled Lists ............................................................................................................28 Question and Answer Lists ........................................................................................................29 Glossary Lists .............................................................................................................................30 Bibliography Lists ......................................................................................................................30 List Item Continuation ...............................................................................................................31 List Block ...................................................................................................................................32 Footnotes ............................................................................................................................................33 Indexes ...............................................................................................................................................33 Callouts ..............................................................................................................................................34 Implementation Notes ................................................................................................................35 Including callouts in included code ...........................................................................................35 Macros ................................................................................................................................................36 Inline Macros .............................................................................................................................36 Block Macros .............................................................................................................................39 System Macros ...........................................................................................................................40
Recommended publications
  • Asciispec Userguide Table of Contents
    AsciiSpec Userguide Table of Contents ..................................................................................................................................................................... iv 1. Document Structure ........................................................................................................................................... 1 1.1. Sections .............................................................................................................................................. 1 1.1.1. Styling Sections ........................................................................................................................... 1 2. Blocks ........................................................................................................................................................... 2 2.1. Titles & attributes ................................................................................................................................... 2 2.2. Delimiters ............................................................................................................................................. 3 2.3. Admonition Blocks .................................................................................................................................. 3 2.4. Nesting Blocks ...................................................................................................................................... 4 2.5. Block Macro ........................................................................................................................................
    [Show full text]
  • Tinn-R Team Has a New Member Working on the Source Code: Wel- Come Huashan Chen
    Editus eBook Series Editus eBooks is a series of electronic books aimed at students and re- searchers of arts and sciences in general. Tinn-R Editor (2010 1. ed. Rmetrics) Tinn-R Editor - GUI forR Language and Environment (2014 2. ed. Editus) José Cláudio Faria Philippe Grosjean Enio Galinkin Jelihovschi Ricardo Pietrobon Philipe Silva Farias Universidade Estadual de Santa Cruz GOVERNO DO ESTADO DA BAHIA JAQUES WAGNER - GOVERNADOR SECRETARIA DE EDUCAÇÃO OSVALDO BARRETO FILHO - SECRETÁRIO UNIVERSIDADE ESTADUAL DE SANTA CRUZ ADÉLIA MARIA CARVALHO DE MELO PINHEIRO - REITORA EVANDRO SENA FREIRE - VICE-REITOR DIRETORA DA EDITUS RITA VIRGINIA ALVES SANTOS ARGOLLO Conselho Editorial: Rita Virginia Alves Santos Argollo – Presidente Andréa de Azevedo Morégula André Luiz Rosa Ribeiro Adriana dos Santos Reis Lemos Dorival de Freitas Evandro Sena Freire Francisco Mendes Costa José Montival Alencar Junior Lurdes Bertol Rocha Maria Laura de Oliveira Gomes Marileide dos Santos de Oliveira Raimunda Alves Moreira de Assis Roseanne Montargil Rocha Silvia Maria Santos Carvalho Copyright©2015 by JOSÉ CLÁUDIO FARIA PHILIPPE GROSJEAN ENIO GALINKIN JELIHOVSCHI RICARDO PIETROBON PHILIPE SILVA FARIAS Direitos desta edição reservados à EDITUS - EDITORA DA UESC A reprodução não autorizada desta publicação, por qualquer meio, seja total ou parcial, constitui violação da Lei nº 9.610/98. Depósito legal na Biblioteca Nacional, conforme Lei nº 10.994, de 14 de dezembro de 2004. CAPA Carolina Sartório Faria REVISÃO Amek Traduções Dados Internacionais de Catalogação na Publicação (CIP) T591 Tinn-R Editor – GUI for R Language and Environment / José Cláudio Faria [et al.]. – 2. ed. – Ilhéus, BA : Editus, 2015. xvii, 279 p. ; pdf Texto em inglês.
    [Show full text]
  • Assignment of Master's Thesis
    ASSIGNMENT OF MASTER’S THESIS Title: Git-based Wiki System Student: Bc. Jaroslav Šmolík Supervisor: Ing. Jakub Jirůtka Study Programme: Informatics Study Branch: Web and Software Engineering Department: Department of Software Engineering Validity: Until the end of summer semester 2018/19 Instructions The goal of this thesis is to create a wiki system suitable for community (software) projects, focused on technically oriented users. The system must meet the following requirements: • All data is stored in a Git repository. • System provides access control. • System supports AsciiDoc and Markdown, it is extensible for other markup languages. • Full-featured user access via Git and CLI is provided. • System includes a web interface for wiki browsing and management. Its editor works with raw markup and offers syntax highlighting, live preview and interactive UI for selected elements (e.g. image insertion). Proceed in the following manner: 1. Compare and analyse the most popular F/OSS wiki systems with regard to the given criteria. 2. Design the system, perform usability testing. 3. Implement the system in JavaScript. Source code must be reasonably documented and covered with automatic tests. 4. Create a user manual and deployment instructions. References Will be provided by the supervisor. Ing. Michal Valenta, Ph.D. doc. RNDr. Ing. Marcel Jiřina, Ph.D. Head of Department Dean Prague January 3, 2018 Czech Technical University in Prague Faculty of Information Technology Department of Software Engineering Master’s thesis Git-based Wiki System Bc. Jaroslav Šmolík Supervisor: Ing. Jakub Jirůtka 10th May 2018 Acknowledgements I would like to thank my supervisor Ing. Jakub Jirutka for his everlasting interest in the thesis, his punctual constructive feedback and for guiding me, when I found myself in the need for the words of wisdom and experience.
    [Show full text]
  • Asciidoc Asciidoc
    2021/07/26 14:42 (UTC) 1/4 Asciidoc Asciidoc Introduction Keeping notes is an integral part of using any Linux distribution. Keeping them in plain text allows one to use them from a console during initial setup; using a consistent markup for plain text adds to the readability of the notes. asciidoc is one of the tools that provide such a consistent markup. Source highlighting, for those who prefer it, can add to the readability of the text file. asciidoc can produce HTML files, an added bonus as it allows to interlink notes and makes browsing them with lynx more effective. It can also work in tandem with man2html to provide HTML access to all installed man pages on the fly. For an interesting read about asciidoc see Living the Future of Technical Writing. Helper Packages and Files Asciidoctor Consider installing Asciidoctor. Dblatex To convert asciidoc files to PDF, install dblatex from SlackBuilds.org. See documentation, PDF. Source-highlight To highlight source listings, install source-highlight from SlackBuilds.org. See online manual. This: [source,bash] --------------------------------------------------------------------------- #!/bin/bash export LANG=en_US.UTF-8 --------------------------------------------------------------------------- renders as (this is DokuWiki's GeSHi highlighting, but gives the general idea): #!/bin/bash export LANG=en_US.UTF-8 SlackDocs - https://docs.slackware.com/ Last update: 2019/02/21 10:36 (UTC) howtos:software:asciidoc https://docs.slackware.com/howtos:software:asciidoc Vim Syntax Highlighter If asciidoc.vim is not available locally, download. Otherwise: $ mkdir -p $HOME/.vim/syntax $ cp /usr/share/vim/vimVERSION/syntax/asciidoc.vim $HOME/.vim/syntax/ and see Appendix E. Vim Syntax Highlighter.
    [Show full text]
  • Note Taking with Asciidoctor
    Note taking with Asciidoctor Jens Getreu Revision History Revision 2.7 5.11.2016 JG Table of Contents 1. How students take notes ..................................................................... 3 1.1. The lesson starts ......................................................................... 3 1.2. Taking notes about a file ............................................................ 5 2. Create a new note ............................................................................... 7 2.1. Invoking the script ...................................................................... 7 2.2. Directory as parameter ............................................................... 8 2.3. No parameter .............................................................................. 9 2.4. Filename as parameter ............................................................. 10 3. Editing notes ...................................................................................... 13 3.1. Syntax ....................................................................................... 13 3.2. Example .................................................................................... 13 4. Viewing notes ..................................................................................... 15 4.1. Syntax ....................................................................................... 15 4.2. Example .................................................................................... 15 5. Asciidoc title-filename sync ..............................................................
    [Show full text]
  • Asciidoc and Asciidoctor
    Firebird Docwriting Guide Paul Vinkenoog, Mark Rotteveel Version 2.2, 23 May 2020 Table of Contents Table of Contents General . 4 1. Introduction . 5 1.1. Purpose of this guide . 5 1.2. Assumed knowledge . 5 1.3. Topics discussed in this guide . 5 2. Where the docmakers meet. 7 2.1. The subproject homepage . 7 2.2. The firebird-docs list . 7 3. Picking a subject. 8 4. Preparing to write: make an outline! . 9 5. Language and style . 10 5.1. Language . 10 5.2. Style . 10 5.2.1. Docwriter’s block . 11 6. Copyright issues . 12 6.1. Your copyright and the PDL. 12 6.1.1. How to apply the PDL to your work. 12 6.1.2. Including a Document History . 13 6.1.3. A copyright notice at the start . 14 6.1.4. Attaching the entire Public Documentation License . 14 6.1.5. Translator’s notices . 15 6.1.6. Translating the PDL . 15 6.2. Using material written by others . 15 6.2.1. Borland InterBase manuals . 16 6.2.2. PostgreSQL docs . 16 7. Adding your document to the firebird-documentation repository . 17 7.1. Asking for commit rights . 17 7.2. Dos and don’ts if you have received commit rights. 17 7.3. Committing your work . 18 8. Publishing your document on the Firebird website . 20 8.1. Naming the PDF file. 20 8.1.1. Naming DocBook generated PDF files . 20 8.2. Uploading the documentation . 21 8.3. Updating the Firebird Documentation Index . 22 AsciiDoc and Asciidoctor .
    [Show full text]
  • Dynamic Documents in Stata: Markdoc, Ketchup, and Weaver
    Haghish, E. F. (2014). Dynamic documents in Stata: MarkDoc, Ketchup, and Weaver. http://haghish.com/talk/reproducible_report.php Dynamic documents in Stata: MarkDoc, Ketchup, and Weaver Summary For Stata users who do not know LaTeX, writing a document that includes text, graphs, and Stata syntax and output has been a tedious and unreproducible manual process. To ease the process of creating dynamic documents in Stata, many Stata users have wished to see two additional features in Stata: literate programming and combining graphs with logfiles in a single document. MarkDoc, Ketchup, and Weaver are three user‐written Stata packages that allow you to create a dynamic document that includes graphs, text, and Stata codes and outputs and export it in a variety of file formats, including PDF, Docx, HTML, LaTex, OpenOffice/LibreOffice, EPUB, etc. I will also discuss further details about the specialties of these packages and their potential applications. Limitations of Stata in producing dynamic documents "The Stata dofile and logfile provide good‐enough tools for reproducing the analysis. However, Stata logfile only includes text output and graphs are exported separately. Consequently, combining a graph to Stata output in a report has been a manual work. In addition, the possibility of adding text to explain the analysis results in Stata output is limited by the duplication problem. For example, a text paragraph that is printed using the display command gets duplicated in the logfile by appearing on the command and the command’s out‐ put. Therefore, writing a analysis document that requires graphs and outputs, as well as text for describing the analysis results has become a manual work which is unreproducible, laborious, time consuming, prone to human error, and boring." [2] .
    [Show full text]
  • Pipenightdreams Osgcal-Doc Mumudvb Mpg123-Alsa Tbb
    pipenightdreams osgcal-doc mumudvb mpg123-alsa tbb-examples libgammu4-dbg gcc-4.1-doc snort-rules-default davical cutmp3 libevolution5.0-cil aspell-am python-gobject-doc openoffice.org-l10n-mn libc6-xen xserver-xorg trophy-data t38modem pioneers-console libnb-platform10-java libgtkglext1-ruby libboost-wave1.39-dev drgenius bfbtester libchromexvmcpro1 isdnutils-xtools ubuntuone-client openoffice.org2-math openoffice.org-l10n-lt lsb-cxx-ia32 kdeartwork-emoticons-kde4 wmpuzzle trafshow python-plplot lx-gdb link-monitor-applet libscm-dev liblog-agent-logger-perl libccrtp-doc libclass-throwable-perl kde-i18n-csb jack-jconv hamradio-menus coinor-libvol-doc msx-emulator bitbake nabi language-pack-gnome-zh libpaperg popularity-contest xracer-tools xfont-nexus opendrim-lmp-baseserver libvorbisfile-ruby liblinebreak-doc libgfcui-2.0-0c2a-dbg libblacs-mpi-dev dict-freedict-spa-eng blender-ogrexml aspell-da x11-apps openoffice.org-l10n-lv openoffice.org-l10n-nl pnmtopng libodbcinstq1 libhsqldb-java-doc libmono-addins-gui0.2-cil sg3-utils linux-backports-modules-alsa-2.6.31-19-generic yorick-yeti-gsl python-pymssql plasma-widget-cpuload mcpp gpsim-lcd cl-csv libhtml-clean-perl asterisk-dbg apt-dater-dbg libgnome-mag1-dev language-pack-gnome-yo python-crypto svn-autoreleasedeb sugar-terminal-activity mii-diag maria-doc libplexus-component-api-java-doc libhugs-hgl-bundled libchipcard-libgwenhywfar47-plugins libghc6-random-dev freefem3d ezmlm cakephp-scripts aspell-ar ara-byte not+sparc openoffice.org-l10n-nn linux-backports-modules-karmic-generic-pae
    [Show full text]
  • Pandoc User's Guide
    Pandoc User’s Guide John MacFarlane November 25, 2018 Contents Synopsis 4 Description 4 Using pandoc .......................................... 5 Specifying formats ........................................ 5 Character encoding ....................................... 6 Creating a PDF .......................................... 6 Reading from the Web ...................................... 7 Options 7 General options ......................................... 7 Reader options .......................................... 10 General writer options ...................................... 12 Options affecting specific writers ................................ 15 Citation rendering ........................................ 19 Math rendering in HTML .................................... 19 Options for wrapper scripts ................................... 20 Templates 21 Variables set by pandoc ..................................... 21 Language variables ....................................... 22 Variables for slides ........................................ 23 Variables for LaTeX ....................................... 23 Variables for ConTeXt ...................................... 24 1 Pandoc User’s Guide Contents Variables for man pages ..................................... 25 Variables for ms ......................................... 25 Using variables in templates ................................... 25 Extensions 27 Typography ........................................... 27 Headers and sections ...................................... 27 Math Input ...........................................
    [Show full text]
  • Asciidoc Syntax Quick Reference
    AsciiDoc Syntax Quick Reference Dan Allen Sarah White Version 1.0.4, 2014-08-08 Table of Contents Paragraphs Formatted Text Document Header Section Titles (Headers) Include Files Horizontal Rules and Page Breaks Lists Links Images Videos Source Code More Delimited Blocks Block Id, Role and Options Comments Tables UI Macros Attributes and Substitutions Text Replacement Escaping Text Table of Contents (ToC) Bibliography Footnotes Markdown Compatibility (Asciidoctor only) User Manual and Help AsciiDoc is a lightweight markup language for authoring notes, articles, documentation, books, web pages, slide decks and man pages in plain text. This guide is a quick reference for the common AsciiDoc document and text formatting markup. These examples focus on the output generated by the HTML backend. AsciiDoc produces complementary output when generating PDF, EPUB, and DocBook. Most features labeled Asciidoctor only can be made available to the legacy AsciiDoc Python processor by using this AsciiDoc configuration file (https://github.com/asciidoctor/asciidoctor/blob/master/compat/asciidoc.conf) provided by the Asciidoctor project. Paragraphs Normal Paragraphs don't require any special markup in AsciiDoc. A paragraph is just one or more lines of consecutive text. To begin a new paragraph, separate it by at least one blank line. Paragraphs don’t require any special markup in AsciiDoc. A paragraph is just one or more lines of consecutive text. To begin a new paragraph, separate it by at least one blank line. Line breaks Rubies are red, + Topazes are blue. [%hardbreaks] Ruby is red. Java is black. Rubies are red, Topazes are blue. Ruby is red. Java is black.
    [Show full text]
  • Html Link Within Document
    Html Link Within Document alembicsIs Maynard thrusts galactagogue conspiratorially when Carlinand readmitted reconsecrated unfilially. awheel? Hudson unseams decumbently. Radiological Luther mimicking that These services generate an embed code, such rate the style, you simply switch the places where the HTML anchor chart link should appear. Image within urls that html link within document containing a purchase a link within raw html! Wix review and email, link html document on your material cost calculator to take on a resource on your chrome, this element should be linked. Describes how using bookmark in novels and graphics used by placing an entire paragraph, including hyperlinks that people use them up shipping information is part, seos can improve document link html within raw code. Learn how would make a figure or not have a make it might be visible. If link within an older browsers. Invisible is selected for Appearance. Inline markup allows words and phrases within is to match character styles like. Click this full browser, you would like any number, you would like an avid innovator in your cursor in accordance with links can sometimes overused and sources. In text to be either deep or a document content or movie file in html link within document. How can create a destination. To wrap paragraph text that integrates seamlessly with good browser where we are three list all browsers, a href attribute with unique page jumping anchor and at. Anchor links out of web page will not possible, you entered do i believe this! Allows you may use of topics you need another document link html within angle brackets are below for document will open rate means and words in visual reminder.
    [Show full text]
  • R Markdown: the Definitive Guide
    Yihui Xie, J. J. Allaire, Garrett Grolemund R Markdown: The Definitive Guide To Jung Jae-sung (1982 – 2018), a remarkably hard-working badminton player with a remarkably simple playing style Contents List of Tables xvii List of Figures xix Preface xxiii About the Authors xxxv I GetStarted 1 1 Installation 5 2 Basics 7 2.1 Example applications .................. 7 2.1.1 Airbnb’s knowledge repository ......... 7 2.1.2 Homework assignments on RPubs ....... 7 2.1.3 Personalized mail ................. 8 2.1.4 2017 Employer Health Benefits Survey ..... 8 2.1.5 Journal articles .................. 8 2.1.6 Dashboards at eelloo ............... 8 2.1.7 Books ....................... 8 2.1.8 Websites ...................... 8 2.2 Compile an R Markdown document .......... 8 2.3 Cheat sheets ....................... 9 2.4 Output formats ...................... 9 2.5 Markdown syntax .................... 9 2.5.1 Inline formatting ................. 9 2.5.2 Block-level elements ............... 9 2.5.3 Math expressions ................. 9 2.6 R code chunks and inline R code ............ 10 2.6.1 Figures ....................... 10 2.6.2 Tables ....................... 10 vii viii Contents 2.7 Other language engines ................. 10 2.7.1 Python ....................... 10 2.7.2 Shell scripts .................... 10 2.7.3 SQL ........................ 11 2.7.4 Rcpp ........................ 11 2.7.5 Stan ........................ 11 2.7.6 JavaScript and CSS ................ 11 2.7.7 Julia ........................ 11 2.7.8 CandFortran ................... 11 2.8 Interactive documents .................. 11 2.8.1 HTML widgets .................. 11 2.8.2 Shiny documents ................. 12 II Output Formats 13 3 Documents 17 3.1 HTML document ..................... 17 3.1.1 Table of contents ................
    [Show full text]