Questions tagged [asciidoctor]

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

Filter by
Sorted by
Tagged with
0 votes
0 answers
14 views

auto-generating list of figures and list of tables in asciidoctor

The Asciidoctor official page says to gem-install asciidoctor-lists but it goes error as below: gem install asciidoctor-lists ERROR: While executing gem ... (Gem::FilePermissionError) You don't have ...
sos's user avatar
  • 1
0 votes
0 answers
19 views

Asciidoctor tables in docx no style

I create a asciidoc documentation with asciidocFx and rendering looks ok. When i convert the asciidoc to xml and xml to docx, i see in my docx that tables are no borders and i would like to know what ?...
Vincedrome's user avatar
0 votes
0 answers
26 views

Get list of includes in a parsed document

I'm parsing an asciidoc document using asciidoctor.js library. The document has doctype of book. I need to get list of all the included documents (asciidoc) in this book doc. Although, the library ...
rmalviya's user avatar
  • 2,177
0 votes
0 answers
52 views

How to add RGB or CMYK output intent profile to a PDF

With asciidoctor-pdf -a optimize=PDF/A-1 mytext.adoc which is a simple testfile :author: Maxim Kim :subject: pdfa Test :keywords: Keyw1, Keyw2 :doctype: article some text Now a PDF is created ...
Namal's user avatar
  • 281
0 votes
0 answers
56 views

- In plugin 'org.asciidoctor.convert' type 'org.asciidoctor.gradle.AsciidoctorTask' property 'logDocuments' is annotated with @Optional

I am using Gradle 9.0. what is the ascii version that is compatible to run and facing below error In plugin 'org.asciidoctor.convert' type 'org.asciidoctor.gradle.AsciidoctorTask' property '...
DIVYA's user avatar
  • 15
0 votes
1 answer
50 views

How to show Table and Image Side by Side in AsciiDoc

Unable to place the image and table side by side. Table creates the nextline automatically, I have even tried nested tables, but didn't worked well. I would like to place those side by side. Do we ...
Sivarajan Sivanesan's user avatar
0 votes
1 answer
82 views

Execute Java code, and capture output, to be included in a book written in AsciiDoc

I am writing a technical book for Java programming in AsciiDoc format, using the AsciiDoctor plugin for the IntelliJ IDE. I have seen how to include snippets of code from a Java source code file. I ...
Basil Bourque's user avatar
0 votes
1 answer
80 views

How to convert AsciiDoc to Odt without anchors and metadata

I'm trying to convert AsciiDoc files to Odt using the following commands in sequence: /usr/bin/asciidoctor \ --destination-dir=/tmp \ --backend=docbook5 \ --attribute=leveloffset=+1 \ ...
Eduardo Fernandes's user avatar
2 votes
1 answer
117 views

How can I insert an unordered list inside a note in Asciidoc without losing the note?

How to add an unordered list inside a note in Asciidoc? I tried the following syntax but the Note disappears and the unordered list appears without being enclosed in a note. Is there a workaround to ...
Induja's user avatar
  • 19
0 votes
1 answer
50 views

How to define globaly just once that all the paragraphs must be justified?

In the main .adoc file where it includes other .adoc files, it is possible to declare globally just once the following sentence: :imagesdir: ./figures/ How to accomplish the same goal, to declare ...
Manuel Jordan's user avatar
0 votes
1 answer
59 views

Auto-width columns (or TeX-like tabular) in AsciiDoc?

I want to document linguistic data using AsciiDoc, converting the document into HTML. For that I need to have a word-by-word translation that pretty much looks like a table but with columns of unequal ...
Lukas's user avatar
  • 198
0 votes
0 answers
85 views

Asciidoctor callouts are not being styled properly

I am trying to build documentation pages for a project using asciidoctor and have a main index.adoc which includes sections from a yaml source file which has line comments meant for callouts. The file ...
murrag's user avatar
  • 1
0 votes
1 answer
62 views

Asciidoctor : How to add nested list across rows in a table

I have a requirement to develop table in adoc format with nested lists across rows in first column Expected output table: with nested bullets expected output table Any suggestions? intent to have ...
Johnjoe's user avatar
0 votes
1 answer
149 views

How to add borders to headings in AsciiDoctor-pdf PDF output

How to add borders to headings in AsciiDoctor-pdf PDF output. (I am not an English speaker. Ask me if any expressions are difficult to understand). I am a high school student and I am using ...
YasAko's user avatar
  • 1
0 votes
0 answers
88 views

Terminating due to java.lang.OutOfMemoryError: Metaspace (AsciiDoctorj-pdf)

I am currently attempting to deploy a JAR file that converts an Asciidoc file to a PDF file. However, when attempting to convert an Asciidoc file larger than 10kb, I am encountering an out of memory ...
Vamshi Kasarla's user avatar
1 vote
1 answer
218 views

Custom css with supplemental-ui in Antora does not work

According to UI-supplemental-files and Stackoverflow antora-top-navigation-bar-customization I replaced my top navigation (supplemental-ui/partials/header-content.hbs), but the same thing for CSS ...
theuema's user avatar
  • 107
1 vote
1 answer
121 views

Antora - Keep navigation menu expanded while clicking any of the items in the menu

I've set the left navigation menu like this * link:page1.adoc[Item 1] ** link:item2.adoc[Item 2] *** link:item3.adoc[Item 3] * link:item4.adoc[Item 4] But when I open any page in browser, the ...
Noor Muhammed's user avatar
1 vote
1 answer
158 views

Common TOC in all pages of ASCIIDOC collection

I have a collection of ASCIIDOC files. I want to have a common TOC that lists all pages. For example, if I have the following files file1.adoc file11.adoc file111.adoc file12.adoc file121.adoc ...
Noor Muhammed's user avatar
0 votes
1 answer
32 views

Asciidoctor: Is it possible to activate section numbering in themes yml

I know that I can use :sectnums: all after the title to enable section and subsection numbering. But is it possible to define this in the theme yml? I have a lot documents which use the same theme ...
Namal's user avatar
  • 281
0 votes
1 answer
320 views

asciidoctor: FAILED: 'asciidoctor-plantuml' could not be loaded

In my docker container, running asciidoctor -r asciidoctor-plantuml my_doc.adoc gets me asciidoctor: FAILED: 'asciidoctor-plantuml' could not be loaded. To reproduce the issue: $ docker run -it -v $...
dboy's user avatar
  • 1,002
0 votes
0 answers
46 views

How to customize Asciidoctor's DocBook converter?

For example, when the goal is to represent several lines of a program's source code, then the AsciiDoc block markup choices are using a literal block (....), which is converted to the literallayout ...
toraritte's user avatar
  • 6,592
0 votes
1 answer
59 views

With AsciiDoc counters: is it possible to change step size?

We can have counter starts with 100 and continue with 101, 102, ...: * {counter:num:100} * {counter:num:100} We can also use letters: * {counter:alpha:X} * {counter:alpha:X} But is it possible to ...
Tar's user avatar
  • 8,679
0 votes
1 answer
602 views

Text with background color and rounded borders in asciidoctor-pdf

I am trying to create some badge-like texts for my documentation, to highlight the status of some issues. Here are some examples (jira issues embedded in a confluence wiki) Example for a "closed&...
aZr4el's user avatar
  • 3
3 votes
2 answers
204 views

Asciidoctor maven plugin is generating index.html with no read permissions

Im creating an index.htm file with the asciidoctor-maven-plugin:2.2.2 and I get a build error, because the created file has no read permissions. mvn clean install mvn clean install works on other ...
Glup3's user avatar
  • 144
0 votes
1 answer
151 views

Asciidoc: Is there any way to access current section number

I would like to add the current section number in front of the table numbering in the caption of my tables. Example: Tables under heading 1.1 should have the caption "Table 1.1-1: Any Caption&...
alex_c137's user avatar
  • 1,824
0 votes
1 answer
130 views

How to use AsciiDoctorJ in Gradle to convert .adoc files to Markdown

I'm currently replacing my Markdown files of my Java project with .adoc to get a seamless documentation across all modules, and I want to build a README.md out of it, preferable with the Gradle plugin ...
Marian Klühspies's user avatar
0 votes
1 answer
161 views

AsciiDoc, How to set an attribute with javascript or similar

I want to dynamically display a certain server status in an asciidoc (rendered in gitlab) Something like :status-server-1: 1 ifeval::[{status-server-1} == 1] image::green_dot.png[green_dot,20,20] ...
Gecko42's user avatar
0 votes
0 answers
62 views

asciidoctor-maven-plugin - add generated resources to classpath?

I have the 'asciidoctor-maven-plugin' conifugured in a standard fashion to process an adoc file and include a puml diagram. My 'index.adoc' file contains == PlantUML Diagram [plantuml,Text,png] ---- ...
emeraldjava's user avatar
1 vote
1 answer
2k views

How to include PlantUML in Asciidoc with Antora?

I would like to inlcude a PlantUML file inside an Asciidoc file and build an Antora site. foo.adoc [plantuml, bar, svg] .... include::bar.puml[] .... bar.puml @startuml <... valid PlantUML> @...
Miracoly's user avatar
0 votes
1 answer
136 views

How to structure image paths in ascidoctor?

I have a book with the following directory structure book.adoc chapters/chapter1.adoc chapters/chapter2.adoc chapters/chapter3.adoc images/img1.jpg images/img2.jpg in book.adoc I include the chapters....
Jakobovski's user avatar
  • 3,233
0 votes
1 answer
164 views

How to integrate OKTA SSO with Antora generated pages?

I am trying to integrate OKTA (Single Page Application) with generated docs of Antora. Using ‘antora’ command it creates generated html files. How do I include OKTA integration across all pages? I ...
Charmee Lee's user avatar
0 votes
0 answers
234 views

Solution to generate API documentation based on static content (Javascript/VueJs)

I'm working on a Vue 2 project where one of the goals would be to be able to generate a standard API documentation front-end based on static content. The syntax of the content is yet to be defined (...
OptiZonion's user avatar
0 votes
1 answer
286 views

AsciiDoc: "Unresolved directive in ... include:: ..." when rendering .adoc file in Firefox with Asciidoctor.js Live Preview

Using the Firefox Add-on "Asciidoctor.js Live Preview" I get the output Unresolved directive in Summary.adoc - include::a.adoc[] Unresolved directive in Summary.adoc - include::b.adoc[] ...
Rudolf Starosta - Rudi's user avatar
0 votes
1 answer
187 views

Add logo to title page when backend is docbook

I am trying to customise the title page where the backend output is docbook. title, subtitle etc are all output correctly. But I cannot seem to get the title logo to output. I have tried: :title-logo-...
Ryan Carter's user avatar
  • 11.5k
1 vote
2 answers
207 views

Disable stripping of trailing newlines from code blocks

I'm creating an Asciidoctor document with some code blocks. I'm using pygments as syntax highlighter. In the output, trailing empty lines in a code block are removed. Normally that's fine, but in some ...
wovano's user avatar
  • 4,698
0 votes
1 answer
603 views

Using a custom icon font with asciidoctor-pdf

I have managed to use a custom icon font replacing FontAwesome in AsciiDoc by doing the following. I have placed my font files in my AsciiDoc root directory: icons.css fonts/icons.eot fonts/icons.svg ...
Genus's user avatar
  • 13
5 votes
1 answer
2k views

Unordered list in a table cell with Asciidoc

I am trying to have a (simple) unordered list in a table cell in an Asciidoc document. I use asciidoctor. I tried the following: |=== | One | Two | Foo | - Bar - Baz |=== But this results in the ...
Florent Georges's user avatar
0 votes
1 answer
383 views

GitLab Pages CI hugo with asciidoctor (low maintenance)

What is the best low maintenance / future proof way to use GitLab Pages to build a hugo site with asciidoc pages (using asciidoctor). There are some images on DockerHub, but they don't have reliable ...
Bastiaan Quast's user avatar
1 vote
1 answer
368 views

Embeddable collapsible sections in asciidoctor

If there is a possibility to embed collapsible sections in another collapsible section in asciidoctor? I am trying to achieve something like (here Address is embedded in Customer): I tried typing ...
porterjr's user avatar
3 votes
1 answer
655 views

Configure AsciiDoctor Maven plugin to generate a single PDF file

Is there a way to configure AsciiDoctor Maven plugin to generate one PDF file out of many .adoc files? Currently, it simply translates the structure of asciidoc files into the same structure, but ...
Sout parl's user avatar
1 vote
1 answer
139 views

How to customize the asciidoctor menu macro?

In my document I want to render menu chains italic and with arrows between the entries, like this: File → Save As... Is there a way to do this with the menu macro? I couldn't find a way to customize ...
Paul Seibel's user avatar
0 votes
1 answer
52 views

Cypress integration with asciidoc (asciidoctor)

is thre any way to work integrate asciidoctor (asciidoc) into cypress and creating tests using both? If yes, could you please explane how to do it?
DMate's user avatar
  • 1
1 vote
1 answer
252 views

Which asciidoc editors support custom extensions?

I am building a documentation solution where I need to use some custom extensions. For a writer it is often important to see some preview of his work, therefore I am looking for an editor that would ...
Peter Mukhachev's user avatar
1 vote
2 answers
389 views

What is wrong with my MathJax square bracket syntax?

This mathjax expression (in an asciidoctor document in a VS Code preview using asciidoctor-vscode) fails to render correctly: stem:[ = x_l = x_( ([m]+1) /2) ] The ] after the m acts like a ) for ...
Richard's user avatar
  • 15.2k
2 votes
2 answers
849 views

MkDocs: using a variable to construct external URLs

Using AsciiDoc, I can define a base URL property and reference it to define links: :external-url: https://www.example.com/docs :Foo: {external-url}/foo[Foo,role=external-doc] :Bar: {external-url}/bar[...
armandino's user avatar
  • 17.9k
3 votes
1 answer
424 views

Asciidoc: How can I format text in a user defined attribute?

When writing H~2~O in the text of an asciidoc document, it is rendered "H subscript(2) O", However trying to define an attribute: :water: H~2~O and refer to the attribute in the text as {...
PolarBear2015's user avatar
1 vote
1 answer
403 views

Asciidoctor: how to layout two code blocks side by side?

Is it possible to have two code blocks side-by-side using Asciidoctor? I could not find any examples in the documentation or on SO.
armandino's user avatar
  • 17.9k
1 vote
1 answer
93 views

WARNING: conversion missing in backend epub3 for toc

I'm using asciidoctor-pdf to create a PDF, and it is working nicely. But when I use asciidoctor-epub3 to convert it to an epub it shows a warning message: asciidoctor: WARNING: conversion missing in ...
lifeisfoo's user avatar
  • 15.6k
0 votes
1 answer
66 views

A "sample' reference not showing up a table... but shows up in standard paragraph

Here is my code. It does not seem to be a malformed table entry. The ASCIIDOCTOR-PDF 'build' produces no error and does create a PDF file. It all works... but the table SAMPLE text is blank. [cols=...
Peter Willard's user avatar
1 vote
1 answer
188 views

asciidoc: Is there a way to get around the problem of lines beginning with [colour] attributes ending with ] not displaying in asciidoc?

My target asciidoc text is this: [red]#Some prompt[x]# Make sure the option is [checked] But it won't display in asciidoc On further investigation, I found that any line beginning with a [colour] in ...
rednectar's user avatar
  • 121

1
2 3 4 5
9