The official chat room for Asciidoctor is now located at https://asciidoctor.zulipchat.com. Please join us there!
@rbwhitaker which feature do you search? I currently fighting with my themes :)
Been a while since I've needed to do a writeup. Glad to be back. Was refreshing myself with the syntax for code and assumed it was '`' but always like to check, and it seems since I've been gone it's changed to '`++`'. I come here to ask, why the added verbosity?
Source: https://docs.asciidoctor.org/asciidoc/latest/syntax-quick-reference/#ex-inline-literal.
Source: https://docs.asciidoctor.org/asciidoc/latest/syntax-quick-reference/#ex-inline-literal.
Thanks for the heads up
Hi all. I'm exploring how to create custom extensions (in Java) for an asciidoctor docs-as-code pipeline (I have been working with Sphynx, but I decided to switch to a Java-based solution). However, so far I've found a wide variety of blogs from a few years ago. Could you give me an advice on good up-to-date references for asciidoctor/Java extensions development?
I think it misses the font with number chars ( ③ ), M +1m or something like that but it is defined in the theme so not sure where to look to find the cause
guess less references cross "block" in the base theme can have helped?
was it :)
How can I disable
I tried with this and it seems not work.
source-highlighter with my prepress pdf?I tried with this and it seems not work.
<execution>
<id>process-asciidoc-pdf-prepress</id>
<phase>generate-resources</phase>
<goals>
<goal>process-asciidoc</goal>
</goals>
<configuration>
<attributes>
<media>prepress</media>
<pdf-style>default-for-print</pdf-style>
<source-highlighter/> <!-- doesn't work either -->
<source-highlighter>none</source-highlighter>
</attributes>
<backend>pdf</backend>
<outputDirectory>${project.build.directory}/pdf-prepress</outputDirectory>
<skip>false</skip>
</configuration>
</execution>
1 reply
It's working very well, but I'm looking at moving to a more javascript heavy frontend so I'm investigating building the site using npm and a stack (maybe handlebars?) for templating and resource packing. Is there a similar or recommended framework that gives the same functionality that jbake / freemarker / asciidoctor in a node environment?
Just the organization it seems like too much work for some cases. The antora.yml, subcomponents, the playbooks. For some things it is tons of work for little gain. But if you have a ton of material and you would like the ability to pick a choose different content, a different playbook for different situations it seems that antora has a huge win. The versioning is a big win. Again, I haven’t used it that much yet, so I may have need to experience my aha moment with it
There aren’t many themes but that will come in time the more the community uses it.
And that’s where I need to be more open minded and I think there will be a huge payoff because I already have huge repos of training material broken up into chapters. If I can harness that org ability to pick and choose different material for different reasons and contexts I’d be set.
Certainly, it may not be for you. However… (1)you can use it to build part of your site. For instance Apache Camel uses Hugo to build the less docs oriented part of its site and Antora for the docs. (2) you can do some amazing customizations with Antora, for instance this blog: https://blog.yuzutech.fr. It’s also not too hard to develop arbitrarily complex page layouts using layouts in the ui bundle and an extension that provides nested open blocks.
@dhinojosa If you ask your question in https://antora.zulipchat.com, I'm happy to answer you there. We've thought about how to organize and manage documentation for almost 5 years and I can assure you that the organization we came up with it fitting for the problem space. The structure it provides is a key strength of Antora and has proven itself as being very effective. It's not just for ceremony and it is not too much work.
I've submitted an issue in May : asciidoctor/asciidoctor-pdf#1933
I would like to know if you could help me to try to implement it...
If you scroll up, or look at the description of this room, you will see that we have moved to https://asciidoctor.zulipchat.com. If you ask there, I will reply.
(link enabling
subs="normal")
issue with links for anchors is that the # prevents the link to be rendered, guess some subs can be needed again
fun thing is it happens in idea asciidoctor editor (js?) but not with asciidoctorj in programmatic mode, any known diff there?
@rmannibucau The conversation about all things Asciidoctor has moved to https://asciidoctor.zulipchat.com/. Please ask your questions there.