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.

Filter by
Sorted by
Tagged with
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 ...
dave's user avatar
  • 1
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 ...
Frank's user avatar
  • 5,939
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 ?...
Vincedrome's user avatar
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 ...
Awatansa Vishwakarma's user avatar
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 ...
Charlie Halford's user avatar
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[] ...
Panos Bariamis's user avatar
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....
Slevin's user avatar
  • 147
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 ...
rmalviya's user avatar
  • 2,167
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 ...
Travis Well's user avatar
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 ...
Namal's user avatar
  • 281
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 ...
Sivarajan Sivanesan's user avatar
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 ...
Inti Garcés's user avatar
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 ...
Basil Bourque's user avatar
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 \ ...
Eduardo Fernandes's user avatar
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 ...
Jean-Charles's user avatar
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 ...
Induja's user avatar
  • 19
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 ...
and-bri's user avatar
  • 1,564
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 ...
Manuel Jordan's user avatar
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 ...
Lukas's user avatar
  • 198
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: ...
hilbert's user avatar
  • 266
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>)...
Alexey Bogdanov's user avatar
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 ...
1_Esk's user avatar
  • 56
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 ...
YasAko's user avatar
  • 1
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 ...
theuema's user avatar
  • 107
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/...
jasie's user avatar
  • 2,219
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?
Joe's user avatar
  • 289
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 ...
user1767316's user avatar
  • 3,342
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 ...
Noor Muhammed's user avatar
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....
jj2f1's user avatar
  • 300
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:
chtenb's user avatar
  • 15.1k
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 ...
Noor Muhammed's user avatar
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 ] ---- ...
Slevin's user avatar
  • 147
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 ...
Arc-E-Tect's user avatar
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 ...
Mattia Righetti's user avatar
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 ...
Namal's user avatar
  • 281
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 ...
emotionalDamage's user avatar
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 $...
dboy's user avatar
  • 1,002
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 ...
toraritte's user avatar
  • 6,583
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 ...
Tar's user avatar
  • 8,669
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&...
SchmiPi's user avatar
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&...
aZr4el's user avatar
  • 3
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 ...
Dietmar Zabel's user avatar
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&...
alex_c137's user avatar
  • 1,824
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 ...
Marian Klühspies's user avatar
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] ...
Gecko42's user avatar
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] ---- ...
emeraldjava's user avatar
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> @...
Miracoly's user avatar
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,...
Obby's user avatar
  • 31
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....
Jakobovski's user avatar
  • 3,233
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 ...
Charmee Lee's user avatar

1
2 3 4 5
10