438 questions
1
vote
1
answer
36
views
Emphasizing asciidoctor literal parts
I'd like to to highlight a part of a literal/listing/source block "manually" in AsciiDoctor. Is there any way to do so?
E.g. I'd like to add a class or just a single "strong/b" to ...
3
votes
2
answers
322
views
Error generating Mermaid diagrams with Asciidoctor-pdf and asciidoctor-diagrams
I have the following step definition in my GitHub workflow
- name: Convert AsciiDoc to PDF
run: |
set -o pipefail
OUTPUT=$(asciidoctor-pdf -r asciidoctor-diagram -a ...
0
votes
1
answer
42
views
Asciidoctor - remove comments from included file
I'm using AsciiDoctor, and I include source files from another location, like so:
[source,java]
----
include::some/path/Source.java[tags=one,two,three]
----
I'd like to remove some comments from the ...
0
votes
0
answers
118
views
Issue with Table and Figure Captions Disappearing when Converting AsciiDoc to DOCX using Asciidoctor
I'm encountering an issue when creating captions for tables and figures in AsciiDoc. I’m using :table-caption: and :figure-caption: to automatically generate numbered captions for tables and images in ...
-1
votes
2
answers
346
views
How to include custom attributes in asciidoc book
I have an asciidoc book that consists of several .adoc files, and I want to use a custom attribute in each file.
I've created .attribute.adoc and included it in each file like this:
include::....
0
votes
1
answer
118
views
How to add a cover image to an asciidoc document
Here is my asciidoc document header:
= My App: Software Design Document
Giuseppe Greco <[email protected]>
v.0.1, 2024-09-18: First draft
:doctype: book
:sectnums:
:toc:
:toclevels: 4
:...
-1
votes
2
answers
376
views
Define color using local variable
Using this post, I created a variable in my file. Now I want to use it to define a background color in my array :
:first-color: #C0FFEE
[%noheader]
|===
h|{set:cellbgcolor:{first-color}} My Title
|{...
-1
votes
1
answer
62
views
Is there a tool to not only display, but also edit included file content in markdown, AsciiDoc or similar? [closed]
In some markdown flavours/ tools you can use {include someFile.md} to display content, which is not in the displayed file, but in a referenced one.
In AsciiDoc it even is possible by default via ...
0
votes
2
answers
107
views
How do I define a substitution on Asciidoctor.convert
I want to specify a string value for the Ruby API of Asciidoctor, and want to have Asciidoctor substitute that value into the output.
I pieces the following together from the documentation, but it ...
-1
votes
1
answer
55
views
How do I set an OG image for a docs page to render on socials (twitter, linkedin, etc)?
We use Antora for our docs, but when I look at the OG image metadata for one of our guides it doesn't show up:
https://metatags.io/?url=https%3A%2F%2Fdocs.timefold.ai%2Ffield-service-routing%2Flatest%...
1
vote
1
answer
64
views
Facing issue where i am unable to load the child.html in the index html with asciidoctor.jvm.convert 2.4.0
I am using spring docs 2.0.5 release version
I am using gradle 8.6, and i refer to this example to configure asciidoctor -i refered below link
https://github.com/spring-projects/spring-...
0
votes
1
answer
635
views
How to resolve 'section title out of sequence: expected level 1, got level 2' error in Asciidoctor VS Code extension?
I use the Asciidoctor VS Code Extension to edit my AsciiDoc project. My codebase has a structure with several layers of nested folders, and I use include::./folder/file.adoc[] to include lower-level ...
1
vote
2
answers
96
views
Remove multi-line pattern with sed
I have an AsciiDoc file and want to remove all collapsible blocks before rendering it as PDF using asciidoctor-pdf.
.Click to reveal the answer
[%collapsible]
====
This is the answer.
====
The text ...
0
votes
2
answers
114
views
Is there a way to combine curly quotes and em dash in AsciiDoc?
I'm writing prose in AsciiDoc and I've run into a bit of a puzzle: on occasion, I find myself writing interrupted dialog, and so want to end that bit of dialog with an em dash. I'm using curly quotes ...
1
vote
1
answer
152
views
Doctoolchain Docker Container fails to pull in dependencies
I'm trying to get the doctoolchain running within our company, first goal is to publish to Confluence.
I'm using the docker image that includes pandoc as a base and add some certificates we need. This ...
2
votes
1
answer
2k
views
How can I render mermaid diagrams of type C4 in asciidoctor?
I am currently trying to render mermaid C4 diagrams using asciidoctor. Mermaid itself can be rendered using asciidoctor. The following example is working as expected.
[mermaid,test]
....
timeline
...
0
votes
1
answer
324
views
How to get Asciidoctor to render source tags with color
I have installed (ver 2.2.6)
npm i asciidoctor
and run
asciidoctor -b xhtml5 -a source-highlighter=rouge .\README.adoc
I do get the web page , but the source code is generated flat ..
this is how ...
4
votes
1
answer
332
views
How do I enable tabs in Asciidoc and Maven with asciidoctor-tabs and asciidoctor-maven-plugin?
In the asciidoctor-maven-plugin, I can add extensions, but I need to specify a GAV and classname.
How do I add the asciidoctor-tabs extension to enable tabs in adoc files?
As far as I can tell, the ...
0
votes
1
answer
207
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 ...
2
votes
1
answer
827
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 ...
1
vote
1
answer
704
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
1
answer
622
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 ...
1
vote
1
answer
565
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 ...
0
votes
1
answer
218
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
2k
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&...