tag:discuss.asciidoctor.org,2006:forum-1Nabble - Asciidoctor :: Discussion2024-03-28T09:04:34Z<b>General discussion for Asciidoctor, an open source Ruby implementation of the AsciiDoc markup language.</b><br/><br/>You can post messages via email or through this forum interface.
<br/>Click <b>Options > Post by email</b> to get the personalized e-mail address you must use to post to the list via email.tag:discuss.asciidoctor.org,2006:post-2835Golang implementation2015-03-15T07:26:18Z2015-03-15T07:26:18Zgour
Hello,
<br/><br/>atm I'm using <a href="http://gohugo.io/" target="_top" rel="nofollow" link="external">Hugo</a> static site generator which is written in Go language and it's <b>very</b> fast and <b>very easy</b> to deploy being single binary executable.
<br/><br/>In the next version it's supposed to get support for writing content using Asciidoc(tor) markup.
<br/><br/>There is some attempt of implementing Asciidoctor in Go like <a href="https://github.com/VonC/asciidocgo" target="_top" rel="nofollow" link="external">this</a> one, but I thought that, maybe, having official implementation of Asciidoctor re-written in Go might help to make it even more popular considering the speed of the (static compiled) language and deployability.
<br/><br/>There is even <a href="https://github.com/gopherjs/gopherjs" target="_top" rel="nofollow" link="external"> A compiler from Go (golang.org) to JavaScript for running Go code in a browser </a> available.
<br/><br/>What do you think <img class='smiley' src='/images/smiley/anim_confused.gif' /><br/>
tag:discuss.asciidoctor.org,2006:post-7443Asciidoctor-diagram on Windows2019-12-20T04:32:26Z2019-12-20T04:32:26ZNanook
Hi folks,
<br/>I've been struggling to get asciidoctor-diagram to work for a couple of days now and have made pretty much no progress. I am trying to get the plantuml, blockdiag and ditaa rendering implemented. I have the asciidoctor and asciidoctor-diagram gems installed, but running <i>asciidoctor -r asciidoctor-diagram test.adoc </i> results in no output and no diagnostics. Including --trace produces nothing, it is as if the command is hanging up somewhere but I can't find out where. Cancelling the command simply asks me if I want to terminate the batch job. I am completely stuck... My minimal knowledge of ruby is of course of little help... Any assistance would be immensely appreciated! Here the sample I am trying to run:
<br/><br/><br/>= diagram tst
<br/><br/>== header
<br/><br/>[ditaa, "dita_file", "svg"]
<br/>....
<br/> +-------------+
<br/> | Asciidoctor |-------+
<br/> | diagram | |
<br/> +-------------+ | PNG out
<br/> ^ |
<br/> | ditaa in |
<br/> | v
<br/> +--------+ +--------+----+ /---------------\
<br/> | | --+ Asciidoctor +--> | |
<br/> | Text | +-------------+ | Beautiful |
<br/> |Document| | !magic! | | Output |
<br/> | {d}| | | | |
<br/> +---+----+ +-------------+ \---------------/
<br/> : ^
<br/> | Lots of work |
<br/> +-----------------------------------+
<br/>....
<br/><br/>[[main-classes]]
<br/>.The PlantUML block extension class
<br/>[plantuml, sample-plantuml-diagram, alt="Class diagram", width=135, height=118]
<br/>----
<br/>class BlockProcessor
<br/>class PlantUmlBlock
<br/>BlockProcessor <|-- PlantUmlBlock
<br/>----
<br/><br/>Source code:
<br/><br/>[source, java]
<br/>----
<br/>class Test {
<br/><br/>}
<br/>----
tag:discuss.asciidoctor.org,2006:post-6030How to include bar chart ?2017-11-21T01:50:11Z2017-11-21T01:50:11ZJan
I'm new to the AsciiDoc stuff, so this might be a very dumb question. <img class='smiley' src='/images/smiley/smiley_beam.gif' /><br/><br/>Is it possible with AsciidoctorJ to put a bar chart into a pdf document ? That is, not by including the image of a bar chart. But rather have AsciidoctorJ render it based on data and style.
<br/><br/>THX !
<br/><br/>Jan
<br/><br/>
tag:discuss.asciidoctor.org,2006:post-652Image in table2013-09-24T10:44:15Z2013-09-24T10:44:15ZTrebor
I'm trying to embed an image in an html table, but the image is just showing the markup in the final . Can someone please tell me what I'm doing wrong?
<br/><br/>|===
<br/>|image::<a href="http://www.example.com/myimage.jpg" target="_top" rel="nofollow" link="external">http://www.example.com/myimage.jpg</a>[My Image, 600,160]
<br/>|<a href="http://www.example.com/quiz/choice=a" target="_top" rel="nofollow" link="external">http://www.example.com/quiz/choice=a</a>[The Lion Needs courage]
<br/>|<a href="http://www.example.com/quiz/choice=b" target="_top" rel="nofollow" link="external">http://www.example.com/quiz/choice=b</a>[The Scarecrow needs a brain]
<br/>|<a href="http://www.example.com/quiz/choice=c" target="_top" rel="nofollow" link="external">http://www.example.com/quiz/choice=c</a>[The Tinman Needs a heart]
<br/>|===
<br/><br/>Thank you,
<br/><br/>Trebor
tag:discuss.asciidoctor.org,2006:post-8710The discussion list has moved to the Zulip-powered project chat2022-03-27T19:54:46Z2022-03-27T19:54:46Zmojavelinux
As of today, I've switched this discussion list to read only. While you can still view the archives at <a href="https://discuss.asciidoctor.org" target="_top" rel="nofollow" link="external">https://discuss.asciidoctor.org</a>, all new discussions and follow-ups should be directed to the Zulip-powered project chat at <a href="https://asciidoctor.zulipchat.com" target="_top" rel="nofollow" link="external">https://asciidoctor.zulipchat.com</a>.
<br/><br/>The archives of the project chat are public, so you can view the conversations without needing an account or having to sign in. Click the "Access without an account (Beta)" button on <a href="https://asciidoctor.zulipchat.com" target="_top" rel="nofollow" link="external">https://asciidoctor.zulipchat.com</a> to enter the chat as a guest. If you wish to post, you will need to create an account and sign in.
<br/><br/>There are various reasons why we're making this switch. First and foremost, Zulip (<a href="https://zulip.com" target="_top" rel="nofollow" link="external">https://zulip.com</a>) has proven to be a very effective communication tool for this community. Zulip combines the immediacy of real-time chat with an email threading model. We've been using it for over and year now. In that time, Zulip has been able to accommodate all the discussions we've had without any trouble. The discussions can be partitioned into streams, and the moderators have the ability to move topics and posts around, all of which helps keep the information more organized. The majority of members seem to be happy with it, and that exceeds our expectations.
<br/><br/>In contrast, managing this list continues to be more and more of a burden for me. To ward off spam and abuse, I've had to switch to approving every new member, which is a tedious process and task. And, for some reason, even my own replies are rejected. I'm just fed up with it.
<br/><br/>Having this list in use also splits the conversation across yet another channel, making it hard for people to find the information they need. We want to route these conversations to the chat and also keep such conversations out of the issue tracker. That leaves only the documentation and the project chat where users have to look to find information about how to use the software. It's a much more manageable situation.
<br/><br/>I look forward to conversing with you in the project chat! <a href="https://asciidoctor.zulipchat.com" target="_top" rel="nofollow" link="external">https://asciidoctor.zulipchat.com</a>
tag:discuss.asciidoctor.org,2006:post-5098How to add page number for a pdf bookmark/cross reference2016-11-12T12:59:36Z2016-11-12T12:59:36Zfluentcoder@gmail.com
<b>CONTENTS DELETED</b>
<div class="weak-color">The author has deleted this message.</div>
tag:discuss.asciidoctor.org,2006:post-8708Asciidoctor and Compiler-Explorer2022-01-12T01:16:01Z2022-01-12T01:16:01Zwimalopaan
Hi all,
<br/><br/>compiler-explorer exposes a REST-api to send/display/compile/execute code snippets.
<br/><br/>I would like to use this also in some asciidoctor documentation.
<br/><br/>Is there an easy way to
<br/><br/>* send a source block via REST to compiler-explorer, and
<br/>* generate a link in the document?
<br/><br/>Thanks for all hints,
<br/> Wilhelm
tag:discuss.asciidoctor.org,2006:post-8706Can Asciidoctor-pdf suppress creation of the text layer?2022-01-08T10:46:42Z2022-01-08T10:46:42Zkev
Often also called the "ocr layer", I want to generate PDFs where the text cannot be casually selected. The text is stored in a separate layer than I want to prevent from being generated.
tag:discuss.asciidoctor.org,2006:post-8705swagger2markup looks like it needs support, plus :-)2021-12-14T17:49:02Z2021-12-14T17:49:02ZElisa
Hello,
<br/><br/>Years ago I worked with a team to create documentation that made use of Swagger2markup, as seen in <a href="https://github.com/Swagger2Markup/spring-swagger2markup-demo" target="_top" rel="nofollow" link="external">https://github.com/Swagger2Markup/spring-swagger2markup-demo</a>, to integrate output from Swagger into a document that integrated a developer guide with API reference documentation. It was a large project (printed out to around 1500 pages). There were numerous reasons that making use of the SwaggerUI for API reference documentation was not feasible.
<br/><br/>In the intervening years I have worked on numerous projects and now I am again working on documenting RESTful APIs. There are quite a lot of new hosting solutions and also some new tools that look interesting, however I am surprised to find that swagger2markup looks like is lacks the support that it needs right now.
<br/><br/>While SwaggerUI has its merits, there are situations in which a standalone document is required. I don't know how participants might be attracted to open source projects. I've seen a tendency for developers to think in terms of working on new lightweight markup languages and then abandon the effort when they start to understand how complex the requirements are.
<br/><br/>Perhaps brainstorming how to capture the above energy might result in useful strategies to attract attention to projects in the Asciidoctor toolchain that could use additional support, Swagger2markup being one. Since participation in some open source projects give developers substantial cred, and I've observed the impulse of some developer to create new lightweight markup languages only for them to fail when they realize the complexities, perhaps there is some way that opportunities to add to documentation tooling for lightweight markup languages might become a cool thing.
<br/><br/>What do you think?
tag:discuss.asciidoctor.org,2006:post-8703IDE Previews with sylesheet2021-12-13T14:04:12Z2021-12-13T14:04:12Zbkalbfus
I am not seeing the stylesheet attribute being utilized in previews of Eclipse and Atom IDE's. Node and Ruby platforms are handling it correctly. Since the IDE utilities use asciidoctor-js and Node works, I wonder where it breaks. Does anyone else see this, or is there a configuration I'm missing?
tag:discuss.asciidoctor.org,2006:post-8702Scrollbar of code block not shown when embeded in admonition block2021-12-08T10:01:51Z2021-12-09T06:06:18Zphgiraud
Hi,
<br/>In HTML ouput, using source code highlighter <i>highlightjs</i>, this kind of code block:
<br/><br/><pre>.example.properties
[source,properties,options=nowrap]
a_property_with_some_very_long_line_content=abcdef|abcdef|abcdef|abcdef|abcdef|abcdef|abcdef|abcdef|abcdef|abcdef|abcdef|abcdef|abcdef|abcdef|abcdef|abcdef|abcdef|abcdef|abcdef|abcdef|abcdef</pre><br/>is nicely displayed with a scroll bar:
<br/><br/><img src="https://discuss.asciidoctor.org/file/n8702/scroll_ok.png" border="0"/><br/><br/>But when embeded within an admonition block:
<br/><br/><pre>[NOTE]
--
.example.properties
[source,properties,options=nowrap]
a_property_with_some_very_long_line_content=abcdef|abcdef|abcdef|abcdef|abcdef|abcdef|abcdef|abcdef|abcdef|abcdef|abcdef|abcdef|abcdef|abcdef|abcdef|abcdef|abcdef|abcdef|abcdef|abcdef|abcdef
--</pre><br/>it doesn't work:
<br/><br/><img src="https://discuss.asciidoctor.org/file/n8702/scroll_ko.png" border="0"/><br/><br/>Any idea?
<br/>thanks
<br/>
tag:discuss.asciidoctor.org,2006:post-8701Include section number in order lists's number?2021-12-07T10:29:09Z2021-12-07T10:29:09Zholyjak
Hello!
<br/><br/>I have in my document numbered sections that include numbered lists. Is there some way to include the section's number in the list item's number?
<br/><br/>i.e. having
<br/><br/>```
<br/>#### 6. Loading data from the server
<br/><br/>Some text
<br/><br/>1. item one
<br/>```
<br/><br/>I want the result to include "6.1 item one". I am OK with doing this manually, if there is some way, e.g. if it worked via something like
<br/>`[start="6.1"]` or something. But looking at the docs, I do not see any solution. (Other then nesting the list in a single-item order list with `[start=<section num>]` and using CSS to hide the outer list and its indentation.)
<br/><br/>thank you!
tag:discuss.asciidoctor.org,2006:post-8699Mathml and Jeuclid2021-11-19T23:35:44Z2021-11-19T23:35:44Zmetro
Is anyone able to successfully use Mathml in the fopub flow with a recent Apache FOP (2.5/2.6)?
<br/><br/>I am getting java.lang.NullPointerException with jeuclid-core-3.1.9.jar/jeuclid-fop-3.1.9.jar when using [stem] in Asciidoctor.
<br/><br/>MT
<br/>--
tag:discuss.asciidoctor.org,2006:post-8696graphviz dpi2021-11-16T00:55:38Z2021-11-16T00:55:38Zmetro
Hi,
<br/><br/>As graphviz has an issue in SVG generation (it generates an illegal "transparent" stroke type), I am currently stuck using PNG for graphviz.
<br/><br/>Unfortunately, the PNG output is very lowres.
<br/><br/>Is there a way in Asciidoctor-diagram to pass the -Gdpi option to graphviz?
<br/><br/>Thanks,
<br/><br/>MT
<br/>--
tag:discuss.asciidoctor.org,2006:post-8697Rendering Admonitions and Callouts in Docx2021-11-16T09:30:46Z2021-11-16T09:30:46Zfbalmeida
I'm a tech writer for a software company that uses asciidoctor for the entire product portfolio's offline documentation. Our adoc files are typically exported to and delivered in pdf/html format, but for a specific sub-set of projects, some documents will have to be delivered in docx format.
<br/><br/>So I've cobbled together a method of converting adoc files to docx format, via docbook + pandoc + some nifty macros to adjust tables, numbering, images, etc. It's looking real good, but two details remain problematic:
<br/><br/>1. Rendering callouts in docx.
<br/>2. Rendering adoc admonitions in docx.
<br/><br/>I've been scurrying the interwebs for different approaches, but apparently there are none to be found.
<br/><br/>I figured it would make a good discussion here.
<br/><br/>Any ideas?
tag:discuss.asciidoctor.org,2006:post-8695Inconsistency in formatted inline elements - space before role name2021-11-03T04:12:03Z2021-11-03T04:12:03Zjoswr1ght
I'm experimenting with Asciidoctor for several use cases, one of which where I require the ability to redact content. This is intended to convey output for the reader where sensitive information has been removed. A dark highlight and matching text color suits this need (also removing the sensitive content and replacing it with AAAAAAA or similar so that it is not copied and pasted).
Asciidoctor-pdf's support for inline element formatting seems to support this:
<pre>
// theme.yml
role:
redact:
font-color: #000000
background-color: #000000
</pre>
When the inline element is applied using <code> [.redact]#redacted text#</code> it works OK, except when there is no space immediately before <code>[.redact]</code>:
<pre>
// sample.adoc
:markup-in-source: verbatim,quotes
= Sample Document for Redacting Text
Jimmy Hoffa is buried at [.redact]#this is redacted for secrecy#. Please don't share this information.
It would be dis[.redact]#astrous# for all concerned.
.MySQL Login
[[figure-mysql-login]]
[source,subs="{markup-in-source}"]
----
$ mysql -u root -p [.redact]#P@ssw0rd# wordpress
Incorrect password.
$ mysql -u root -p[.redact]#P@ssw0rd# wordpress
mysql>
----
</pre>
<img src="https://discuss.asciidoctor.org/file/n8695/Screen_Shot_2021-11-03_at_7.png" border="0" alt="Rendered PDF Output for Sample"/>
<br />
Is it possible to get the inline element role formatting to work when there is no space in front of the role name, or am I misunderstanding/misusing this feature?
<br /><br />
Thank you!
<br /><br />
-Josh
tag:discuss.asciidoctor.org,2006:post-6732Two icon sets (Font Awesome and Material Design) in one document?2019-02-14T02:41:16Z2021-10-19T02:50:20ZTobi
I have to write a manual for a software that uses Font Awesome 5.5 icons and Google Material Design icons. Is it possible to use icons from both sets inline in one document? How do I set up the document for this?
<br/>Thank you!
tag:discuss.asciidoctor.org,2006:post-7712Problem with ::toc[] and custom HTML template2020-03-01T11:08:33Z2020-03-01T11:08:33ZDrAscii
<b>test.adoc</b><br/><br/><pre>= Test
:toc: macro
abc
toc::[]
abc</pre><br/><b>Command</b><br/><br/>asciidoctor --trace -T asciidoctor-backends/erb/html5 test.adoc
<br/><br/>or
<br/><br/>asciidoctor --trace -T asciidoctor-backends/haml/html5 test.adoc
<br/><br/>or
<br/><br/>asciidoctor --trace -T asciidoctor-backends/slim/html5 test.adoc
<br/><br/><b>Result (asciidoctor --trace -T asciidoctor-backends/erb/html5 test.adoc)</b><br/><br/>Traceback (most recent call last):
<br/> 27: from /usr/local/bin/asciidoctor:23:in `<main>'
<br/> 26: from /usr/local/bin/asciidoctor:23:in `load'
<br/> 25: from /var/lib/gems/2.5.0/gems/asciidoctor-2.0.10/bin/asciidoctor:15:in `<top (required)>'
<br/> 24: from /var/lib/gems/2.5.0/gems/asciidoctor-2.0.10/lib/asciidoctor/cli/invoker.rb:111:in `invoke!'
<br/> 23: from /var/lib/gems/2.5.0/gems/asciidoctor-2.0.10/lib/asciidoctor/cli/invoker.rb:111:in `each'
<br/> 22: from /var/lib/gems/2.5.0/gems/asciidoctor-2.0.10/lib/asciidoctor/cli/invoker.rb:128:in `block in invoke!'
<br/> 21: from /var/lib/gems/2.5.0/gems/asciidoctor-2.0.10/lib/asciidoctor/convert.rb:183:in `convert_file'
<br/> 20: from /var/lib/gems/2.5.0/gems/asciidoctor-2.0.10/lib/asciidoctor/convert.rb:183:in `open'
<br/> 19: from /var/lib/gems/2.5.0/gems/asciidoctor-2.0.10/lib/asciidoctor/convert.rb:183:in `block in convert_file'
<br/> 18: from /var/lib/gems/2.5.0/gems/asciidoctor-2.0.10/lib/asciidoctor/convert.rb:118:in `convert'
<br/> 17: from /var/lib/gems/2.5.0/gems/asciidoctor-2.0.10/lib/asciidoctor/document.rb:951:in `convert'
<br/> 16: from /var/lib/gems/2.5.0/gems/asciidoctor-2.0.10/lib/asciidoctor/converter/composite.rb:28:in `convert'
<br/> 15: from /var/lib/gems/2.5.0/gems/asciidoctor-2.0.10/lib/asciidoctor/converter/template.rb:107:in `convert'
<br/> 14: from /var/lib/gems/2.5.0/gems/tilt-2.0.10/lib/tilt/template.rb:109:in `render'
<br/> 13: from /var/lib/gems/2.5.0/gems/tilt-2.0.10/lib/tilt/template.rb:170:in `evaluate'
<br/> 12: from /var/lib/gems/2.5.0/gems/tilt-2.0.10/lib/tilt/template.rb:170:in `call'
<br/> 11: from asciidoctor-backends/erb/html5/document.html.erb:144:in `__tilt_46916425557440'
<br/> 10: from /var/lib/gems/2.5.0/gems/asciidoctor-2.0.10/lib/asciidoctor/document.rb:1020:in `content'
<br/> 9: from /var/lib/gems/2.5.0/gems/asciidoctor-2.0.10/lib/asciidoctor/abstract_block.rb:84:in `content'
<br/> 8: from /var/lib/gems/2.5.0/gems/asciidoctor-2.0.10/lib/asciidoctor/abstract_block.rb:84:in `map'
<br/> 7: from /var/lib/gems/2.5.0/gems/asciidoctor-2.0.10/lib/asciidoctor/abstract_block.rb:84:in `block in content'
<br/> 6: from /var/lib/gems/2.5.0/gems/asciidoctor-2.0.10/lib/asciidoctor/abstract_block.rb:75:in `convert'
<br/> 5: from /var/lib/gems/2.5.0/gems/asciidoctor-2.0.10/lib/asciidoctor/converter/composite.rb:28:in `convert'
<br/> 4: from /var/lib/gems/2.5.0/gems/asciidoctor-2.0.10/lib/asciidoctor/converter/template.rb:109:in `convert'
<br/> 3: from /var/lib/gems/2.5.0/gems/tilt-2.0.10/lib/tilt/template.rb:109:in `render'
<br/> 2: from /var/lib/gems/2.5.0/gems/tilt-2.0.10/lib/tilt/template.rb:170:in `evaluate'
<br/> 1: from /var/lib/gems/2.5.0/gems/tilt-2.0.10/lib/tilt/template.rb:170:in `call'
<br/>/asciidoctor-backends/erb/html5/block_toc.html.erb:16:in `__tilt_46916425557440': undefined method `convert_with_options' for #<Asciidoctor::Converter::CompositeConverter:0x000055572a698968> (NoMethodError)
<br/><br/><b>Additional information</b><br/><br/>I've just downloaded the directory
<br/><pre>asciidoctor-backends</pre>from GitHub without modifying anything.
<br/>
tag:discuss.asciidoctor.org,2006:post-7509Color for Text2020-01-20T08:46:13Z2020-01-20T08:46:13ZConrad
Hello,
<br/><br/>I refer to <a href="https://discuss.asciidoctor.org/Asciidoctor-pdf-color-question-td4313.html#a5825" target="_top" rel="nofollow" link="external">https://discuss.asciidoctor.org/Asciidoctor-pdf-color-question-td4313.html#a5825</a>.
<br/><br/>How can I colorize text? If I understand the thread correctly there will be maybe a solution. The thread is from 2016.
<br/><br/>I am using the downloadable version of AsciidoctorJ and I did not finde a stylesheet for pdf.
<br/><br/>I tried "[red]#this is printed in red#" and it works with AsciidocFX, but not with AsciidoctorJ. Unfortunately the solution with AsciidocFX causes other problems (e.g. lack of TOC).
<br/><br/>Conrad
tag:discuss.asciidoctor.org,2006:post-8685Announcement: AsciiDoc cheat sheet for Dash for macOS2021-09-25T04:22:36Z2021-09-25T04:22:36Zholyjak
Hello! I have created a AsciiDoctor cheat sheet as a docset for the offline documentation browser Dash for macOS. I would appreciate feedback!
<br/><br/>You can view the source of it here <a href="https://github.com/holyjak/dash-asciidoc-cheatsheet/blob/main/web-cheatsheet.adoc" target="_top" rel="nofollow" link="external">https://github.com/holyjak/dash-asciidoc-cheatsheet/blob/main/web-cheatsheet.adoc</a> and download the Dash docset from the releases page <a href="https://github.com/holyjak/dash-asciidoc-cheatsheet/releases/tag/2.0.16%2Falpha" target="_top" rel="nofollow" link="external">https://github.com/holyjak/dash-asciidoc-cheatsheet/releases/tag/2.0.16%2Falpha</a> (download and unzip, then, in Dash: Manage docsets - + to Add Local Docset)
<br/><br/>I plan to contribute it to the official docsets once it has been used for a while.
<br/><br/>Thank you!
tag:discuss.asciidoctor.org,2006:post-8683Cells and CSS role2021-09-16T02:44:38Z2021-09-16T02:44:38Zchristophe
Hello,
<br/>I have seen may posts on that but no final status.
<br/>Is there a way to assign a role to a cell ?
<br/>I would like to change BGColor depending on values using css properties.
<br/>Thx
tag:discuss.asciidoctor.org,2006:post-8674Nested tables: stripes and separator2021-07-04T17:50:16Z2021-07-04T17:50:16Zveselov
Greetings!
<br/><br/>Point 1: I think the documentation around table separator is a bit confusing. The separator only controls the column data delimiter, but not the table delimiter. For nested tables, the default column data delimiter changes to `!`, and can be controlled, but the table delimiter changes to `!===` and can not be controlled. What would be the table delimiter for 3rd level nested table?
<br/><br/>Also, using multi-character separator seems to have issues. Using separator `YYY` requires that `YYY` separates the data, but the first column renders all but first separator character into the data.
<br/><br/>Point 2: If the parent table is striped, the nested tables are also striped. That was totally unexpected, and it's unclear how to "fix" the striping of the nested table to `none` or `all`. I don't believe that's a correct behavior. I wonder if a counter can be used to rectify this.
<br/><br/>Sample doc:
<br/><br/>= Bundle
<br/>// testing with Asciidoctor 2.0.15
<br/><br/>[cols="a",stripes=even,separator=%,grid=none]
<br/>|===
<br/>%
<br/>[cols="1,5",separator=YYY]
<br/>!===
<br/>YYY*Property* YYY potato
<br/>YYY*Default Value* YYYRusset
<br/>YYY*Explanation* YYY the type of potato to bake
<br/>!===
<br/>%
<br/>[cols="1,5",separator=|]
<br/>!===
<br/>|*Property* |flour
<br/>|*Default Value* |buckwheat
<br/>|*Explanation* | what you want your cake to be made out of
<br/>!===
<br/>|===
<br/>
tag:discuss.asciidoctor.org,2006:post-8667Counters and ifeval2021-06-30T09:32:54Z2021-06-30T12:41:11Zhalol
Hello,
<br/><br/>I am having an issue with counters and using them in ifeval directives:
<br/><br/>Given the file:
<br/><br/><pre>
{counter2:test}
The value of my counter is now {test}
// ifeval::[{test} > 1]
// The value of my counter is now {test}
// endif::[]
// => Leads to error Failed to load AsciiDoc document - undefined method `>' for nil:NilClass
ifeval::[{counter:newtest} == 1]
The value of my new counter is now {newtest}
endif::[]</pre><br/>The output produced is:
<br/><pre>The value of my counter is now 1
The value of my new counter is now {newtest}</pre><br/>1. The first ifeval (commented out) causes an error and cannot be used at all (presumably because the counter defined beforehand is null in ifeval).
<br/>2. In the second case, the counter defined in the ifeval directive cannot be used elsewhere.
<br/><br/>Am I doing something wrong?
<br/><br/>Using:
<br/>asciidoctor -version
<br/>Asciidoctor 2.0.15 [<a href="https://asciidoctor.org" target="_top" rel="nofollow" link="external">https://asciidoctor.org</a>]
<br/>On Fedora 34.
tag:discuss.asciidoctor.org,2006:post-8677Adding css class resp. role to a horizontal ruler and table rows2021-07-19T03:11:48Z2021-07-19T03:11:48Zgrandmasterg
Hi @all,
<br/><br/>we are using asciidoctor to create a documentation dynamically out of very a high number of ruby scripts (thousands of ruby scripts). These ruby scripts are test scripts and the result is a generated test specification in html.
<br/><br/>To handle the prose parts which should be rendered into the test specficiation we've created seperate ruby classes that can be used inside those ruby scripts where the content can be retrieved back during a kind of "dry-run" (without a running test environment). These classes also know specific conditions which can evaluate to true resp. false. To evaluate such conditions a seperate xml file exists which contain these conditions with their according values true/false. For different customers the values of these conditions are adjusted differently in the xml. Based on the evaluation result of the conditions we are assigning specific css classes to the different supported elements, e.g. lists, headlines, table cells, etc. (i.e. css classes ".valid" resp. ".invalid"). This way we can generate i nice html for all customers at the same time (by using erb templates that write the according adoc). In the end we use an own css and add a bit of javascript to be able to hide/show also the invalid content in the html (via javscript property 'style.display').
<br/><br/>For most of the things we are using there is built-in support by Asciidoctor. But in wonder if there is really no possibility to add a css class to
<br/><br/>- a horizontal ruler (workaround with adding html directly)
<br/>- to a table and all children elements and if this is not possible to each table row directly (workaround with adding class/role to each table cell separately and via javascript later on to the 'closest' tr-element)
<br/><br/>BR
<br/>gg
tag:discuss.asciidoctor.org,2006:post-8670PNGs were recognized....now they're not2021-07-02T05:29:19Z2021-07-02T05:29:19ZKLynn2021
We're working in Windows 10, with 24-color PNGs, using Asciidoctor 2.0.10. Never had a problem with Asciidoctor-PDF and PNGs until yesterday when one of my co-workers reported that the images weren't showing up in the PDF.
<br/><br/>Once we established that it wasn't a problem with the image path, I attempted to duplicate the issue on different files. I got the same message each time: "image file is an unrecognised format"
<br/><br/>Again, this used to work just fine. Did something change?
<br/><br/>
tag:discuss.asciidoctor.org,2006:post-8671Customizing link output in PDF2021-07-02T13:14:25Z2021-07-02T13:14:25ZPatrick Ben Koetter
Greetings,
<br/><br/>can I configure asciidoctor-pdf to output links showing the link text only
<br/>without printing the URI after the link text?
<br/><br/>What'd like to have is this
<br/><br/> Follow RFC 8482 and
<br/><br/>whereas "RFC 8482" represents the link text.
<br/><br/>At the moment asciidoctor-pdf rendering gives me this:
<br/><br/> Follow RFC 8482 [<a href="https://www.rfc-editor.org/rfc/rfc8482.txt" target="_top" rel="nofollow" link="external">https://www.rfc-editor.org/rfc/rfc8482.txt</a>] and
<br/><br/>I've had a look at the asciidoctor-pdf theming guide and regular asciidoctor
<br/>docs and wasn't able to identify anything that gives me what I want.
<br/><br/>Regards,
<br/><br/>p@rick
tag:discuss.asciidoctor.org,2006:post-8668Generating a PDF using AsciiDoctor2021-06-30T14:59:10Z2021-06-30T14:59:10ZCarl
I am trying out how to generate a PDF from my asciiDoc files. I ran "<b>gem install asciidoctor-pdf</b>" and it appeared to complete successfully (no error messages; ended with "21 gems installed"). However when I run "<b>asciidoctor -r asciidoctor-pdf *.adoc</b>", it completes with no messages, but there are no *.pdf files in the directory.
<br/><br/>Am I doing something wrong, or are the PDFs written to another directory?
tag:discuss.asciidoctor.org,2006:post-8666PDF Table Formatting Issue with AsciiDoc Style Column2021-06-28T13:41:36Z2021-06-28T13:41:36Zweezair
Hey Gang, looking for help trouble-shooting an issue I am having with PDF output of a table in which I have a column with a AsciiDoc style operator.
<br/><br/>Here is the table:
<br/><br/>[%header, cols="<,<,<a,<a"]
<br/>.Critical Software
<br/>,===
<br/>include::tables/critical-software.csv[]
<br/>,===
<br/><br/>I'm using the AsciiDoc "a" operator on the last two columns to render the unordered lists correctly in each cell.
<br/><br/>Here is the .csv file, a header and two rows of content
<br/><br/>"Category of Software","Description","Types of Products","Rationale for Inclusion"
<br/>"Identity, credential, and access management (ICAM)","Software that centrally identifies, authenticates, manages access rights for, or enforces access decisions for organizational users, systems, and devices","* Identity management systems
<br/>* Identity provider and federation services
<br/>* Certificate issuers
<br/>* Access brokers
<br/>* Privileged access management software
<br/>* Public key infrastructure","* Foundational for ensuring that only authorized users, systems, and devices can obtain access to sensitive information and functions"
<br/>"Operating systems, hypervisors, container environments","Software that establishes or manages access and control of hardware resources (bare metal or virtualized/ containerized) and provides common services such as access control, memory management, and runtime execution environments to software applications and/or interactive users","* Operating systems for servers, desktops, and mobile devices
<br/>* Hypervisors and container runtime systems that support virtualized execution of operating systems and similar environments","* Highly privileged software with direct access and control of underlying hardware resources and that provides the most basic and critical trust and security functions"
<br/><br/>The .csv file comes in fine. The first two columns render with the correct styling from the .yml file as expected. The last two columns are brought in well, but the styling is off. The font is bigger and it looks as if the cells are justified. See the image:
<br/><br/><nabble_a href="AsciiDoctor-PDF_Table_Styling_issue.png">AsciiDoctor-PDF_Table_Styling_issue.png</a><br/><br/><img src="https://discuss.asciidoctor.org/file/n8666/AsciiDoctor-PDF_Table_Styling_issue.png" border="0"/><br/><br/>The pdf stylesheet .yml table section is a modification of the standard Asciidoctor.pdf style:
<br/><br/>table:
<br/> background-color: $page_background_color
<br/> border-color: 002F92
<br/> border-style: solid
<br/> border-width: $base_border_width
<br/> caption:
<br/> align: center
<br/> text-align: center
<br/> side: bottom
<br/> max-width: none
<br/> font-size: 8
<br/> grid-color: 002F92
<br/> grid-style: solid
<br/> head:
<br/> background-color: 002F92
<br/> font-color: ffffff
<br/> font-size: 9
<br/> font_style: bold
<br/> border_bottom_width: $base_border_width * 2.5
<br/> body:
<br/> stripe-background-color: edecff
<br/> foot:
<br/> background_color: F0F0F0
<br/> cell:
<br/> cell_padding: 2
<br/><br/>I tried fixing using a bunch of setting to include table-cell settings and table-asciidoc-cell. I couldn't find much on table-asciidoc-cell in the theming guide and online.
<br/><br/>Any help is appreciated.
<br/><br/>Thanks.
<br/>
tag:discuss.asciidoctor.org,2006:post-8659How to define variables globally?2021-06-18T10:39:27Z2021-06-18T10:39:27ZCarl
Hi, I am new to AsciiDoc.
<br/><br/>I have defined this variable (attribute) in the document header of each help topic:
<br/><br/><b>:prodName: Our Product Name</b><br/><br/>This way I can reference our product name using {prodName}. However, each help topic is in its own *.adoc file. Thus, I will have hundreds of adoc files when I'm done. This method of defining in each document header is not sustainable! Is there a place where I can define these global variables just once, then reference them in each topic?
tag:discuss.asciidoctor.org,2006:post-8661[FIXED] How to compile just the source content? (No document, head, styles, etc.)2021-06-20T21:46:39Z2021-06-21T06:44:10Ztoastal
I've been happier with the feature set of writing AsciiDoc over Markdown and its many limitations. I wanted to use AsciiDoc on SourceHut, but only Markdown is supported out of the box. However, using their GraphQL API, one can POST any arbitrary HTML to the README. SourceHut will do some post-processing--mostly remove some unsupported attributes and turning unsupported elements into <div>s. Where this comes up as in issue is the <style> and <title> elements have content that just gets rendered as plaintext. The `--argument stylesheet!` flag removes the styles but leave me with the <title>. I can't set the doctitle to empty either it seems (and I want to keep the `<h1>`). You can see the issue <a href="https://git.sr.ht/~toastal/dhall-contribute-json" target="_top" rel="nofollow" link="external">here</a> and how the title element's contents caused a duplication.
<br/><br/>Effectively what I want is *only* the <body> element (but probably in an <article> or no container). I would have expected this is what either `embedded` or `--doctype inline` flags would have meant. This way I could "embed" this markup produced from my AsciiDoc document inside a different, larger HTML-based system.
<br/><br/>Unless GitHub and GitLab are using Ruby library to do something the tool doesn't out of the box (which I'm not using Ruby), they must be doing something similar with the CLI tools, but I can't figure it out from the manpages or docs. I also have my next project where I want to do something similar and need just the content to be compatible with a static site build tool, Soupault, but again I just need the content, not a full document. Form what I see though, AsciiDoctor is built to be the end tool and not integrated as a renderer for other tools.
tag:discuss.asciidoctor.org,2006:post-8658asciidoctor-pdf: Unicode characters โโ๐ญ๐๐๐โฐ work, but โนโโง don't2021-06-18T06:39:32Z2021-06-18T06:39:32ZCarsten
Dear group,
<br/><br/>for this problem, I've already checked, among others:
<br/><a href="https://github.com/asciidoctor/asciidoctor-pdf/issues/1129" target="_top" rel="nofollow" link="external">https://github.com/asciidoctor/asciidoctor-pdf/issues/1129</a><br/><a href="https://github.com/asciidoctor/asciidoctor-pdf/blob/v1.5.x/docs/theming-guide.adoc" target="_top" rel="nofollow" link="external">https://github.com/asciidoctor/asciidoctor-pdf/blob/v1.5.x/docs/theming-guide.adoc</a><br/><a href="https://discuss.asciidoctor.org/Troubleshoot-missing-glyphs-pdf-from-TOC-generation-td8585.html" target="_top" rel="nofollow" link="external">https://discuss.asciidoctor.org/Troubleshoot-missing-glyphs-pdf-from-TOC-generation-td8585.html</a><br/><br/>but could not make any progress.
<br/>Using asciidoctor-pdf 1.6.0 on Ubuntu 20.04 LTS with this test file:
<br/><br/><pre>
= Test
:experimental: // for kbd:[F11] etc
[cols="1,12", frame=none, grid=rows]
|===
| โ | watch
| โ | checkmark
| ๐ญ | think bubble
| ๐ | memo
| ๐ | lock
| ๐ | key
| โฐ | alarm clock
| kbd:[โน] | โน
| kbd:[โ] | โ
| kbd:[โง] | โง
|===
</pre><br/>and this command line:
<br/><br/><pre>
asciidoctor-pdf --verbose -a pdf-theme=default-with-fallback-font test.adoc --out-file test.pdf
</pre><br/>the output is:
<br/><br/><pre>
asciidoctor: WARNING: Could not locate the character `โน' in the following fonts: M+ 1mn, M+ 1p Fallback, Noto Emoji
asciidoctor: WARNING: Could not locate the character `โ' in the following fonts: M+ 1mn, M+ 1p Fallback, Noto Emoji
asciidoctor: WARNING: Could not locate the character `โง' in the following fonts: M+ 1mn, M+ 1p Fallback, Noto Emoji
</pre><br/>And the resulting PDF has all symbols except the three ones mentioned in the warning messages.
<br/><br/>Are these characters not included in any of the considered fonts?
<br/>How can I proceed to get โนโโง into the pdf file?
tag:discuss.asciidoctor.org,2006:post-8656callouts for Erlang code2021-06-17T22:55:36Z2021-06-17T22:55:36ZLeHoff
Hi,
<br/><br/>I would like to use callouts for Erlang code, but I cannot figure out how to remove the Erlang comment character (%) from the output.
<br/><br/>-module(testing). % <1>
<br/><br/>It turns the <1> into a nice circle, but it leaves the % in there. I would like it to do the same as is done for other languages where the comment is removed from the rendered HTML.
<br/><br/>I have searched quite a bit without finding anything.
<br/><br/>Thanks in advance,
<br/>Torben
tag:discuss.asciidoctor.org,2006:post-8655Printing table cell from CSV completely verbatim2021-06-17T02:02:07Z2021-06-17T02:02:07ZPascal
I have a CSV table that contains some fields with regular expressions and I would like to display this table in the documentation.
<br/><br/>I'm currently using:
<br/><br/>[%header,format=csv,]
<br/>|===
<br/>include::data.csv[]
<br/>|===
<br/><br/>To include the data.
<br/><br/>The problem is that I have regular expressions in the form: "^(RIGHT\.[A-Z0-9]+-1|LEFT\.[A-Z0-9]+)$"
<br/><br/>Because of the two plus signs in the expression the content gets rendered as: "^(RIGHT\.-1|LEFT\.[A-Z0-9])$"
<br/><br/>Now is there a way to force asciidoctor to render this column, (or all cells) completely verbatim without any processing?
<br/>I would like to avoid changing the content of the CSV itself as it is also consumed by other tooling.
<br/><br/>I already tried to declare the column as as literal via cols="l" and while this renders the column as literal formatting it still removes the +.
<br/><br/>Thank you for your help.
<br/><br/>Pascal
tag:discuss.asciidoctor.org,2006:post-8653How to use border for specific and inline images in pdf?2021-06-11T13:39:52Z2021-06-11T13:39:52Zcwempe
I found out I can add a border by adding some definitions in my theme.
<br/><a href="https://github.com/asciidoctor/asciidoctor-pdf/blob/main/docs/theming-guide.adoc#image" target="_top" rel="nofollow" link="external">https://github.com/asciidoctor/asciidoctor-pdf/blob/main/docs/theming-guide.adoc#image</a><br/><br/>Like :
<br/><pre>image:
border-color: cccccc
border-width: 3</pre><br/>But this creates borders to all block images, I think.
<br/><br/>So how can I apply borders to only specific images?
<br/>How can I add the same border to inline images?
<br/>Is this even possible?
<br/><br/>Thanks
tag:discuss.asciidoctor.org,2006:post-8647problem installing asciidoctor-mathematical gem2021-06-10T15:42:33Z2021-06-10T16:33:38ZElisa
I am hoping to get asciidoctor-mathematical to work for on my Mac, specifically for generating pdfs using the ruby build (we need the running headers and footers, etc).
<br/><br/>I can see some discussion about asciidcotor-mathematical not working on Mac but I also saw that someone did get it working and think that perhaps there is a dependency that is not documented.
<br/><br/>It looks like I might just need to know the correct location to place `glib2.0`
<br/><br/>I'm looking at Mathoid and it looks like it's not intended for use with the Ruby asciidoctor-pdf. So if I can get the right dependencies and document them that will be great.
<br/><br/>I have followed directions in <a href="https://github.com/asciidoctor/asciidoctor-mathematical" target="_top" rel="nofollow" link="external">https://github.com/asciidoctor/asciidoctor-mathematical</a>, by installing prerequisites and fonts.
<br/><br/>When I try to run gem install asciidoctor-mathematical, the install fails partway through.
<br/><br/>The install instructions are a bit terse and I might have missed something. Please let me know what I need to do.
<br/><br/>Here is what appears to be pertinent messaging from Terminal output:
<br/><br/>...
<br/>-- Detecting CXX compile features - done
<br/>CMake Deprecation Warning at CMakeLists.txt:8 (cmake_minimum_required):
<br/> Compatibility with CMake < 2.8.12 will be removed from a future version of
<br/> CMake.
<br/><br/> Update the VERSION argument <min> value or use a ...<max> suffix to tell
<br/> CMake that the project does not need compatibility with older versions.
<br/><br/><br/>-- Found PkgConfig: /opt/local/bin/pkg-config (found version "0.29.1")
<br/>-- Checking for module 'glib-2.0'
<br/>-- No package 'glib-2.0' found
<br/>CMake Error at /usr/local/Cellar/cmake/3.20.3/share/cmake/Modules/FindPkgConfig.cmake:556 (message):
<br/> A required package was not found
<br/>Call Stack (most recent call first):
<br/> /usr/local/Cellar/cmake/3.20.3/share/cmake/Modules/FindPkgConfig.cmake:778 (_pkg_check_modules_internal)
<br/> CMakeLists.txt:41 (pkg_check_modules)
<br/><br/><br/><br/>