Stack Overflow
Stack Overflow

Questions tagged [asciidoc]

AsciiDoc is a lightweight markup format similar to Markdown, but it was designed for technical writing with programmatic capabilities as well as semantic structure.

AsciiDoc is a document format for writing technical articles, books, ebooks, slideshows, web pages, man pages, and blogs. AsciiDoc files can be rendered in many formats including HTML, PDF, EPUB, and man page.

AsciiDoc is highly configurable: both the AsciiDoc source file syntax and the backend output markups (handled by templates) can be customized and extended by the user. The format is very similar to the popular Markdown markup, but AsciiDoc additionally incorporates programmatic capabilities and semantic structure. Functionality such as variable substitution, conditional flow, and file inclusion make AsciiDoc dynamic, more like coding. Semantic elements like admonitions, examples, definition lists, and sidebars enable structured writing like a mature technical-writing format.

Originally designed as a lighter, writer-friendlier version of the XML-based DocBook format, AsciiDoc is supported by two distinct toolchain families: the original, Python-sourced variant, as well as newer, Ruby-based tools from an organization called Asciidoctor. The newer suite honors the original syntax almost completely but remains active extending the language and its tooling.

AsciiDoc is free software. The Python-sourced edition is licensed under the terms of the GNU General Public License version 2 (GPLv2). The Ruby-sourced edition is licensed under The MIT License.

357 questions
29
votes
3 answers

How do I do strikethrough (line-through) in asciidoc?

How do I render a strikethrough (or line-through) in an adoc file? Let's presume I want to write "That technology is -c-r-a-p- not perfect."
Geoffrey De Smet
  • 22,431
  • 8
  • 59
  • 106
20
votes
5 answers

Is there any way to convert markdown to asciidoc (or be able to produce the same HTML output)?

Here is my problem, normally I convert asciidoc documents to HTML (or more precisely asciidoc --> docbook --> html) but here I've been given a markdown document. I would like to be able to produce an HTML document from that markdown document that…
Laurent T
  • 970
  • 2
  • 12
  • 25
18
votes
2 answers

How to resolve keybinding-conflicts in atom.io

I installed the atom.io plugins git-plus and asciidoc-preview. Unfortunately both claim the keybinding Ctrl + Shift + A. There is no warning shown in the keybinding-settings. How to solve this Problem? Should I manually add the *.cson files and add…
Edward
  • 3,883
  • 7
  • 32
  • 76
17
votes
4 answers

Is it possible to have modular AsciiDoc book (that consists of few files)?

Considering that a book in DocBook format can be done in a "modular" fashion, I hoped I can do similar with AsciiDoc and split chapters and first-level sections in separate files. Unfortunately documentation does not say anything about this. The…
DejanLekic
  • 15,785
  • 3
  • 38
  • 69
16
votes
1 answer

How to prevent images from resetting ordered list numbering in asciidoctor

I am using asciidoctor to generate html. I have the following list: . one . two . three image::mypic.png[] . four And when converted to html, it looks like this: 1. one 2. two 3. three 1. four In html, I would like to see: 1.…
mkfin
  • 467
  • 2
  • 12
14
votes
2 answers

How to include a javascript in Asciidoc?

I'm using asciidoctor-maven-plugin to convert .adoc files to html file... Would want to include a link to javascript in the generated html file... Basically would like to see something like below in the html file that is generated from the .adoc…
Karthik
  • 965
  • 8
  • 10
12
votes
5 answers

How to add an image to asciidoc book cover page?

I would like to create a pdf book using asciidoc. The title page should include the title, subtitle and an image. So far I could not find any documentation on how to achive this. Intuivly I would do something like My book…
Isaac
  • 750
  • 2
  • 10
  • 27
11
votes
1 answer

asciidoc macros

I use asciidoc for rendering text. I have difficulties to understand macros. My goal is to have a simple macro processing (like in LaTeX). I would like to write two Macros: FOO should be replaced by "bar" MYTEXT(xyz) should be replaced by: "This is…
user1165430
  • 121
  • 4
10
votes
8 answers

How to convert asciidoc to pdf?

I attempted to convert my mybook.adoc to mybook.pdf using pandoc, and got the following error. $ pandoc -s mybook.adoc -t asciidoc -o mybook.pdf pandoc: cannot produce pdf output with asciidoc writer Is there another tool that I should use instead…
mherzl
  • 4,119
  • 3
  • 25
  • 51
9
votes
4 answers

Is there any way to change the text size (font size) of specific blocks when you using asciidoc?

I need your help. Now I am using AsciiDoc and AsciiDoctor to create some manuals. I want texts smaller on some specific blocks, for example wide table, wide list, and so on, but not want main texts smaller. Especially I need to make texts of wide…
macoril
  • 117
  • 1
  • 7
9
votes
2 answers

How can I make custom class HTML divisions using AsciiDoctor?

I am beginning with AsciiDoctor and I want to output HTML. I've been trying to figure out how to create custom class in divisions, I searched google, manuals etc. and couldn't find a solution. What I want to do is simply write something like…
trabant
  • 105
  • 1
  • 5
9
votes
3 answers

Are there any online demo's of AsciiDoc editors demonstrating live preview?

I have come across many demo's of Markdown editors demonstrating live preview eg: http://daringfireball.net/projects/markdown/dingus http://dillinger.io/ http://www.markitdown.net/markdown http://epiceditor.com/ http://hallojs.org/demo/markdown/ But…
user1063287
  • 8,524
  • 19
  • 95
  • 183
8
votes
1 answer

how to define own asciidoc macro

How do I define a macro in asciidoc/asciidoctor? I will use a repeating pattern in many parts of my document so I would like to make a parametrized substitution to avoid entering the same stuff many times. In particular, I have the following…
igagis
  • 1,599
  • 1
  • 13
  • 24
8
votes
3 answers

How to dynamically hide asciidoc element

I use org.asciidoctor.convert plugin for gradle to generate API documentation for my team. I include files: include::{snippets}/index/curl-request.adoc[] and want to place it's content into spoiler or anything like that. Is there any way to…
cynepnaxa
  • 964
  • 1
  • 12
  • 25
8
votes
2 answers

Can I display asciidoc document in github?

Am I able to display an asciidoc file on github in the same way that I can currently view a markdown file? According to this blog entry, I should be able to do this: If you’re interested in using AsciiDoc, head over to GitHub and create a new file…
krishnab
  • 7,198
  • 9
  • 45
  • 102
1
2 3
…
23 24