Questions tagged [asciidoc]
AsciiDoc is a lightweight markup format similar to Markdown, but it was designed for technical writing with programmatic capabilities as well as semantic structure.
477
questions
0
votes
0
answers
31
views
Render a PlantUML diagram in an asciidoc readme in GitLab
I'm trying to put my diagrams in the readme and from looking at the gitlab docs it seems like it can be done by default. However, GitLab doesn't render my diagrams.
I used the same method as in the ...
0
votes
1
answer
23
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 ...
0
votes
0
answers
17
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
1
answer
30
views
I am getting `Error creating DOCX from AsciiDoc file` in IntelliJ Idea, How can this be resolved?
I am getting below error in IntelliJ Idea while trying to convert my .adoc file to docx using Official AsciiDoc Plugin. However, converting to pdf is working fine.
Error creating DOCX from AsciiDoc ...
0
votes
0
answers
24
views
What's the correct way to render Asciidoc HTML in Gatsby?
I'm following the Gatsby tutorial, but instead of using the MDX transformer, I'd like to use the officially-supported Asciidoc one (gatsby-transformer-asciidoc). In the part 6 of tutorial, a page ...
0
votes
2
answers
39
views
How to include partial with different attributes and without empty lines
I have the partial with name hello_world
Hello {lang} World!
I want to include the partial and change the attribute {lang}. I have manage to do it with
:lang: Java
include::partial$hello_world.adoc[]
...
0
votes
1
answer
49
views
How to use spring-asciidoctor-backends?
I want to use spring-asciidoctor-backends to build a documentation with Spring's look and feel. I added the recommended Maven plugin to the pom like this:
<plugin>
<groupId>org....
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
21
views
How to render asciidoc tables to text?
I have some asciidoc documentation with tables, and I would like to render them for output to a text console. I'm looking for a rendition something like markdown:
| Item | Price | # In ...
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
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
25
views
How to insert an image above :toc: left of asciidoc multipage?
I need to put an image above the toc at the left.
I'm using multidoctor-multipage to create a html multipage manual. I need to place a logo image above the Table of Content at the left, in order that ...
0
votes
1
answer
81
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
74
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 \
...
0
votes
2
answers
73
views
asciidoc: how to include only title from a .adoc file?
I'm creating my curriculum vitae in asciidoc.
curriculum-vitae/
- _includes/experiences.adoc
- curriculum-vitae.adoc
- resume.adoc
I'm trying to reuse the content of _includes/experiences.adoc ...
2
votes
1
answer
115
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
0
answers
82
views
AsciiDoc, how to have the Navigation bar expanded when opening the page?
AsciiDoc, how to have the Navigation bar expanded when opening the page?
The default Navigation bar on left side of an AsciiDoc page is collapsed when a user enters the page. This is good behavior for ...
0
votes
1
answer
45
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
56
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
407
views
Including markdown in asciidoc
I tried to import a markdown file into an asciidoc file. In first sight it looks good but then it recognized that the markdown is not properly rendered as it's not asciidoc. This is my example: ...
1
vote
1
answer
161
views
Pandoc ignoring html tags when converting from Markdown to Asciidoc
I'm trying to convert a document from Markdown to Asciidoc using Pandoc converter.
In my md documents there are some html pieces. After converting all the html tags (for example <a>...</a>)...
1
vote
1
answer
122
views
Converting adoc to markdown while preserving latex style math equations
I have a group of adoc documents that I'm converting to markdown. For most of them I've been able to convert them with:
asciidoc -b docbook -o temp.xml <infile>
pandoc -f docbook -t ...
0
votes
1
answer
145
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
211
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 ...
0
votes
1
answer
219
views
images in various locations in included Asciidoc files
I have an AsciiDoc structure like this:
Documentation.adoc
DeveloperDocumentation/DeveloperDocumentation.adoc
DeveloperDocumentation/DeveloperDocumentationPart1.adoc
UserDocumentation/...
0
votes
0
answers
45
views
Is it possible to create asciidoc from haddock?
I am currently building my Haskell project (and generating html documentation) with stack build --test --haddock.
Is there a way to get asciidoc as output format?
0
votes
0
answers
38
views
Locale::Po4a::AsciiDoc how to exclude cross-references ids, anchors ids and custom-ids from translation
from an asciidoc file containing:
[[ill-sketches-intro,Sketches]]
[NOTE,icon=texte-introduction.svg]
.Sketches
====
. <<img-Things-various>>
====
(...)
[[img-Things-various, Various ...
1
vote
1
answer
119
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
170
views
css or other antora / asciidoc options to display svg tooltips form html files
I was sort of shocked to learn that tooltips in svg images don't display when an image is part of an html page inside a <img > tag.
I found a reference with some options; https://stackoverflow....
0
votes
0
answers
22
views
Subscript with spaces and capital letters in a sourcecode block?
Example code:
[source,hs,subs="quotes"]
----
List~map~ id~a~ = id~List{sp}a~
----
Current rendering:
1
vote
1
answer
152
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
0
answers
47
views
How to put AsciiDoc block title under the block?
Referring to the AsciiDoc documentation, you can assign a title to a code block as follows:
.Specify GitLab CI stages
[source,yaml]
----
image: node:16-buster
stages: [ init, verify, deploy ]
----
...
2
votes
1
answer
148
views
Adding extra information in Spring Rest-Docs using Attributes failing
I'm generating documentation for APIs that are written in Python. I am using Spring Rest-Docs for this which works flawless.
Now I must add a list of roles that are authorized to call the API to each ...
0
votes
1
answer
201
views
How can I render HTML using Liquid in asciidoc in Jekyll?
In my current Jekyll setup I am writing all my posts using the asciidoc (.adoc) file format, specifically I'm using these plugins
plugins:
- jekyll-asciidoc
- jekyll-redirect-from
- jekyll-feed
...
0
votes
1
answer
31
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 ...
1
vote
1
answer
241
views
Automatically replace the PlantUML code in an .adoc file with the corresponding PNG images
I have a big .adoc file with plantUML Diagrams in it. The main goal is to convert the .adoc from asciidoc to markdown. For that it is necessary to replace the .puml diagrams to images (png). Its ...
0
votes
1
answer
315
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
58
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
17
views
Table parameters saved in a central document
I am using two attributes for table parameters
:table1: frame="none", grid = "none", stripes=none
:table2: frame="topbot", grid = "rows", options="header&...
0
votes
1
answer
593
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&...
0
votes
3
answers
343
views
How can I find always the same include file from within different sub folders
I want to include a adoc file from within different other adoc files. But the path to the include file depends from the deep of the directory structure. My Idea would be defining an environment ...
0
votes
1
answer
147
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
128
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
157
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
61
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
3
answers
189
views
Asciidoctor / RevealJS default CSS generated
I'm launching asciidoctor via a javascript API & gulp.
const options = {safe: 'unsafe', backend: 'revealjs', attributes: { 'stylesheet': 'custom.css' }};
asciidoctor.convertFile(file.path, options,...
0
votes
1
answer
130
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
161
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 ...