509 questions
5
votes
1
answer
334
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 ...
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 ...
- 175
0
votes
1
answer
111
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 ...
- 163
0
votes
1
answer
112
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,822
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
:...
- 9,822
0
votes
1
answer
51
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,822
0
votes
1
answer
277
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,325
-1
votes
1
answer
62
views
Floating (with scroll) text in AsciiDoc?
New to AsciiDoc. I'm wondering if there is a way to have text "float" with scroll (similar to a floating header row in Excel). I have a single word that I've entered between separator lines ...
- 1
-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
163
views
How to avoid a space being added for a newline after an include
Our docs are written in Asciidoc and published with Antora.
I am using an include for some repeated snippets (e.g. contact us). Per asciidoc rules, each include has to be on its own line. However, a ...
- 32.4k
0
votes
1
answer
520
views
Why do asciidoc attributes docdatetime and localdatetime always display the same value?
Make an .adoc file with this content:
Last modified: {docdatetime} +
Last converted: {localdatetime}
Both lines display the same value (time of conversion) in preview (Ctrl+K, V) and in HTML output ...
- 103
0
votes
1
answer
244
views
Asciidoc define variable local to file
I'm using the arc42 template to create my documentation. It has a structure with a main file that includes files that contain the various chapters. I'd like to redefine a variable that is local to one ...
- 2,566
1
vote
1
answer
30
views
Facing issue with asciidoctor.jvm.convert 2.4.0 and spring docs 2.0.5 release Which is unable to load the child.html in the index html
test {
useJUnitPlatform()
outputs.dir snippetsDir
}
asciidoctor {
configurations "asciidoctorExtensions"
inputs.dir snippetsDir
dependsOn test
doLast {
copy{
from ("${asciidoctor....
- 37
0
votes
1
answer
41
views
issue while creating war using gradle 8.6 the public/docs folder is not getting created
spring boot 2.7.6 having issue while creating war using
asciidoctor.jvm.convert 2.4.0 and spring docs 2.0.5
test {
useJUnitPlatform()
outputs.dir snippetsDir
}
asciidoctor {
configurations "...
- 37
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 ...
- 14.4k
0
votes
2
answers
122
views
How to set scope for document attributes in AsciiDoc
I want to set the keywords attribute based on the hierarchy of sections.
For example, suppose you have the following AsciiDoc document:
= Article
:keywords: keyword0
== Section1
:keywords: keyword1
=...
2
votes
1
answer
53
views
Automating Frontmatter Removal: Streamlining Hugo and AsciiDoctor PDF Integration
Hugo removes the frontmatter from an Asciidoc file before passing the document to the Asciidoc processor. For example
---
title:
subtitle:
...
__
But how can I hide the frontmatter for Hugo for ...
- 53
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 ...
- 23
0
votes
2
answers
417
views
How to bulk edit large asciidoc tables in VSCode, or do so with a table editor UI?
I have a large table in .adoc ASCIIDoctor format:
|===
|Col A|ColB
|One
|Foo
|Two
|Bar
//... Many fields ...
|===
That renders like:
Col A
Col B
One
Foo
Two
Bar
...many
fields...
I have AsciiDoc ...
- 180
0
votes
1
answer
91
views
Converting mathematical formulas from html to Asciidoc
I need to convert formulas from html to Asciidoc. Pandoc is not doing it right because I suppose I need to preprocess them somehow.
The source of the formula is like this:
<div id="d126e133489&...
0
votes
1
answer
149
views
How do I include visible spaces in code listing in table
I am writing an asciidoc document to be rendered in html that includes a table in which several cells include code listings. I mark those cells as "a|" and include the listing between ---- ...
- 17.9k
0
votes
1
answer
54
views
Ascii doc syntaxes not provide consistent output & not working as expected
I have a .adoc file and it has a table with 3 columns. The table simply represents some HTTP codes with their status code, meanings, and methods.
This is the code I used to generate the above table.
[...
- 113
1
vote
1
answer
172
views
Table in pdf, generated from Asciidoctor have word wrapping but the word becomes unsearchable
I have the following table in Adoc which is generated by swagger annotation of java APIs.
[options="header", cols=".^5a,.^5a,.^5a"]
|===
|Name|Description|Schema
|**...
- 153
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 ...
- 27.5k
0
votes
1
answer
84
views
How to modify the html template used by Jekyll AsciiDoc HTML generator
I'm using AsciiDoc and Jekyll to generate a static site, based on a single HTML template. In this template, I would like to inject a variable defined in the properties of the project.
I have this part ...
- 6,827