Stack Overflow
Stack Overflow

Questions tagged [asciidoctor]

An open source Ruby processor for converting AsciiDoc markup into HTML 5, DocBook 4.5 and other formats.

An open source Ruby processor for converting AsciiDoc markup into HTML 5, DocBook 4.5 and other formats.

See also:

Requirements

Asciidoctor works on Linux, OS X (aka Mac OS X) and Windows and requires one of the following implementations of Ruby:

MRI (Ruby 1.8.7, 1.9.3, 2.0, 2.1, 2.2 & 2.3)

JRuby (1.7 in Ruby 1.8 and 1.9 modes, 9000)

Rubinius 2.2.x

Opal (JavaScript)

413 questions
36
votes
4 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
  • 26,223
  • 11
  • 73
  • 120
20
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
  • 507
  • 2
  • 12
16
votes
1 answer

Cannot locate a Guava Jar in the gradle distribution?

I have the following error while performing the gradle build command. What went wrong: Execution failed for task ':asciidoctor'. > Cannot locate a Guava JAR in the Gradle distribution I'm using macOS Big Sur.
Apelli
  • 163
  • 5
15
votes
2 answers

Links to sections of same page in asciidoc

I'm writing some text that will be converted to HTML, as a long single page. Can't figure out how to make links to sections as in HTML using #some-id, so that a user when clicking it will go up or down the web page to

Section…

Luis
  • 1,236
  • 5
  • 22
  • 31
12
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
  • 147
  • 1
  • 1
  • 8
12
votes
1 answer

Hide header from ToC in Asciidoc / Asciidoctor

I'd like to find a way to hide certain headers from the Table of Contents in my Asciidoc document, which I am processing with Asciidoctor to HTML and PDF. I have increased the headerlevel value to include some other sub-headers, but a side-effect of…
grw
  • 1,279
  • 1
  • 11
  • 19
12
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
  • 1,024
  • 1
  • 14
  • 30
12
votes
1 answer

Using an Image as a Link in AsciiDoc

I'm trying to create a "clickable" image in AsciiDoc lightweight markup language with Asciidoctor. I tried the following (not working): image::[[]] For…
CouchDeveloper
  • 18,174
  • 3
  • 45
  • 67
11
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,959
  • 1
  • 17
  • 27
10
votes
2 answers

How to create external link references in AsciiDoc without repeating the URL multiple times?

In markdown I can write: [example1][myid] [example2][myid] [myid]: http://example.com so I don't have to retype the full external link multiple times. Is there an analogous feature in AsciiDoc? Specially interested in the Asciidoctor…
Ciro Santilli OurBigBook.com
  • 347,512
  • 102
  • 1,199
  • 985
10
votes
1 answer

How to use AsciiDoc with Python?

The original AsciiDoc processor was written in python, but AsciiDoc evolved in the form of Asciidoctor written in Ruby. On my search for how to process modern AsciiDoc (the Asciidoctor dialect), I only came across a post that there is an older…
rdmueller
  • 10,742
  • 10
  • 69
  • 126
9
votes
0 answers

How to bundle AsciiDoctor gems in a Cocoa app

My app I have a Mac app that uses AsciiDoctor under the hood to generate PDF and ePUB files. I use the Process class (formerly NSTask) to run the AsciiDoctor commands. What I want I want people to be able to use my app without having to manually…
Swift Dev Journal
  • 19,282
  • 4
  • 56
  • 66
9
votes
2 answers

Antora top navigation bar customization

My question is quite simple though I cannot find anything that points to it in the documentation. I am generating documentation for a project with the default generator in Antora but I cannot figure out how to customize the top navigation bar, items…
Germán Diago
  • 7,473
  • 1
  • 36
  • 59
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
  • 2
  • 6
8
votes
1 answer

How to pass Maven variable to asciidoctor-maven-plugin?

I have user-guide which uses AsciiDoc it is very beautiful despite that I did not spend much time for it. AsciiDoc plugins are awesome. So I want to pass my Maven final name in the user guide. Question: How to do…
Xelian
  • 16,680
  • 25
  • 99
  • 152
1
2 3
…
27 28