Questions tagged [asciidoctor]
An open source Ruby processor for converting AsciiDoc markup into HTML 5, DocBook 4.5 and other formats.
414
questions
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 ...
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 ?...
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 ...
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 ...
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 '...
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 ...
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 ...
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 \
...
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 ...
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 ...
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 ...
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 ...
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 ...
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 ...
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 ...
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 ...
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 ...
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
...
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 ...
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 $...
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 ...
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 ...
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&...
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 ...
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&...
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 ...
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]
...
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]
----
...
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>
@...
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....
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 ...
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 (...
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[]
...
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-...
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 ...
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
...
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 ...
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 ...
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 ...
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 ...
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 ...
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?
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 ...
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 ...
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[...
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 {...
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.
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 ...
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=...
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 ...