511 questions
-2
votes
1
answer
61
views
Common AsciiDoc attributes in an include file [closed]
The Asciidoctor documentation says that an include directive can be used to:
Define a common set of attributes across multiple documents (typically included into the document header).
I can't seem to ...
- 8,152
0
votes
1
answer
85
views
How to show footnotes per page instead of endnotes
I am using Asciidoctor (asciidoctor-pdf 2.3.19) to generate my documentation. Currently, when I use the footnote syntax footnote:[Content], the notes are collected and displayed at the very end of the ...
5
votes
1
answer
394
views
How can I center a preface title?
How can I center the preface title?
I tried:
[.text-center]
== PREFACE TITLE
[.text-center]
[.lead]
SOME TEXT +
AND SOME MORE.
Lorem ipsum dolor sit amet, consectetur ...
But this centers the whole ...
0
votes
1
answer
109
views
Is it possible to place visual content above the document title in AsciiDoc without breaking document structure?
I am using Antora+AsciiDoc to create technical documentation. I am facing the problem of needing to visually add content before the document header in the .adoc file to make it display correctly in ...
- 13
3
votes
2
answers
507
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 ...
- 175
0
votes
1
answer
68
views
how to include roles into link text in ASCIIdoc?
I would like to use roles in the text that's displayed for a link. I've tried a lot of different ways, but have not found one that does what I want. Say, I have
https://example.com[Group 1: C1, E1]
...
- 140
0
votes
1
answer
136
views
Pandoc is ignoring/loosing custom styles when exporting to MS word
I have the following asciidoc document.
= Test
== Introduction
lorem ipsum
[.custom]
This text should use the CustomStyle from Word.
I am converting this document to MS word (via DocBook) as ...
- 173
0
votes
0
answers
128
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 ...
0
votes
1
answer
129
views
Text to the right of an embedded image in AsciiDoc
In my asciidoc document I've an embedded image like this:
[[login-page]]
[salt, id="login-page", format="svg", align="left"]
----
{
Login | "MyName "
...
- 9,852
-1
votes
2
answers
444
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::....
- 9,852
0
votes
1
answer
158
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
:...
- 9,852
0
votes
1
answer
156
views
How do you render code in two columns in ASCIIDOC?
In the ASCIDOC, I'd like to render the [source] code block in one row of two-column table. How can I do it?
- 14k
0
votes
1
answer
133
views
How to add an external link to a bibliography item in AsciiDoc
Here below is my bibliography section:
[bibliography]
- [[[ref1, 1]]] Philippe Kruchten. link:https://www.cs.ubc.ca/~gregor/teaching/papers/4+1view-architecture.pdf[The “4+1” View Model of Software ...
- 9,852
-1
votes
2
answers
463
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
|{...
- 3,335
0
votes
1
answer
355
views
Add break line in bulleted list
I want to add an empty line in a bulleted list with asciidoc. What I want:
I've try with + but the empty line does not appear :
* item 1
** item 1-1
** item 1-2 +
+
* item 2
** item 2-1
** item 2-2
...
- 3,335