Where communities thrive


  • Join over 1.5M+ people
  • Join over 100K+ communities
  • Free without limits
  • Create your own community
People
Repo info
Activity
  • Mar 17 2021 20:22
    @mojavelinux banned @asciidoctor-docbot
  • Mar 07 2021 12:13
    shlomif opened #3965
  • Mar 07 2021 11:09
    mojavelinux labeled #3961
  • Mar 07 2021 11:09
    mojavelinux milestoned #3961
  • Mar 07 2021 11:07
    mojavelinux milestoned #3962
  • Mar 07 2021 11:07
    mojavelinux assigned #3962
  • Mar 07 2021 11:07
    mojavelinux closed #3962
  • Mar 07 2021 10:37
    mojavelinux closed #3964
  • Mar 07 2021 10:24
    slonopotamus opened #3964
  • Mar 07 2021 09:57
    mojavelinux closed #3963
  • Mar 06 2021 11:30
    withshubh opened #3963
  • Mar 06 2021 08:35
    reosablo opened #3962
  • Mar 05 2021 20:17
    mojavelinux labeled #3960
  • Mar 05 2021 20:17
    mojavelinux closed #3960
  • Mar 05 2021 15:52
    HarshKapadia2 edited #3961
  • Mar 05 2021 15:50
    HarshKapadia2 opened #3961
  • Mar 05 2021 12:59
    slowGetter opened #3960
  • Mar 05 2021 09:32
    mojavelinux labeled #3959
  • Mar 05 2021 09:32
    mojavelinux closed #3959
  • Mar 05 2021 07:06
    wimdeblauwe opened #3959
djencks
@djencks
I suspect the maven plugin sets imagedir, so probably you need to supply it in your doc for intellij to know. Yes, zulip is the up-to-date place for chat.
Simone Bordet
@sbordet
Hey David! Long time!
djencks
@djencks
Hi Simone!! BTW, I think Jetty is a complicated enough project that it might be worth looking into whether using Antora will be worthwhile. IMO the maven asciidoctor plugin doesn't allow for very sophisticated results.
Simone Bordet
@sbordet
Had the same feeling... I definitely need to look into that, but we also need to integrate with Eclipse's look and feel
Although, it's not that the documentation needs to be particularly complicated... we have 2 guides (for ops and for devs) and that's it.
djencks
@djencks
Doesn't Jetty have several versions live at once? Antora will easily let you have several versions of the docs.
As far as eclipse look and feel, Eclipse che is using Antora: https://www.eclipse.org/che/docs/che-7/overview/introduction-to-eclipse-che/
Simone Bordet
@sbordet
we have developed an Asciidoctor extension in Java to run Jetty and capture output that we include in documentation
not sure we can port it to Node :)
djencks
@djencks
An alternative would be to run the generator and check in the results. There are arguments for and against this approach, but I tend to like it. For one thing, it provides a commit record when the output from Jetty changes.
Guillaume Grossetie
@Mogztter
@sbordet taking screenshots with Puppeteer and a local HTTP is also relatively easy with Node.js. You might even find "ready to use" JavaScript library that does just that. But of course you will some JavaScript/Node.js knowledge. If you don't want to port your extension then @djencks solution is the way to go.
(if you need to run Jetty you might need to execute command: https://nodejs.org/api/child_process.html#child_process_child_process_execsync_command_options)
Simone Bordet
@sbordet
@Mogztter no thanks... If I find some time I may report a bug to the Maven Plugin, as it seems it does not cd into child directories like other plugins do.
Guillaume Grossetie
@Mogztter
đź‘Ť
Wursti
@WorldWideWursti_twitter
Good Evening
lertsenem
@lertsenem:matrix.org
[m]
Good Evening
RB Whitaker
@rbwhitaker
Does anybody have a link to any examples of what the asciidoctor pdf is capable of? I have a very specific idea of what I want to achieve, and I want to make sure it's achievable before I invest too heavily in an AsciiDoc-based toolchain.
djencks
@djencks
You should ask on the asciidoctor Zulip channel, the Gitter channel is really only for history now. Also check out asciidoctor-web-pdf where you have the full power of css available.
RB Whitaker
@rbwhitaker
Sounds good! I followed a link here from something that seemed pretty official. But I can see at the top of this page that it suggests going to the zulip channel. Thanks for the help.
Wursti
@WorldWideWursti_twitter
Hello Everyone
@rbwhitaker which feature do you search? I currently fighting with my themes :)
Dan Allen
@mojavelinux
@rbwhitaker Could you tell me where you found that link? Perhaps there's a place that needs updating that I missed.
mcp292
@mcp292
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.
djencks
@djencks
Please ask on https://asciidoctor.zulipchat.com.... gitter is mostly here for history now.
mcp292
@mcp292
Will do once I fix the highlighting lol
Thanks for the heads up
djencks
@djencks
:-) Highlighting always catches me....
mcp292
@mcp292
@lertsenem:matrix.org @eskwayrd @slonopotamus Thanks for the diagram syntax suggestions! First time back since! asciidoctor-diagram sounds legit!
Aaron Hoffer
@ahoffer

I'd like to refer to the current section title as an attribute.
For example:

== Leo

This section is aobut {sectiontitle}.

I looked through the list of intrinsic attributes and didn't see anything for that.

James Elliott
@brunchboy
Please ask on https://asciidoctor.zulipchat.com (gitter is mostly here for history now).
HĂ©ctor Fabio Cadavid Rengifo
@hcadavid
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?
Romain Manni-Bucau
@rmannibucau
Hi all,
I'm using asciidoctor-pdf (java flavor) and I have a hard time getting callouts working, it renders as [] - so I assume it is identified but something is wrong in the custom theme but not sure how to identify it, no log/warn
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
Romain Manni-Bucau
@rmannibucau
hmm, i changed code font family so conum inheritance does not work (font_family: $literal_font_family)
guess less references cross "block" in the base theme can have helped?
was it :)
Jin Kwon
@onacit
How can I disable 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
John Ericksen
@johncarl81
Hey everyone - I'm currently using jbake and freemarker to build a static website with a few pages built using the asciidoctor integration.
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?
Daniel Hinojosa
@dhinojosa
Get back to Java mister. @johncarl81 :smile:
John Ericksen
@johncarl81
LOL, Hi Dan!
djencks
@djencks
First of all, the community has moved to Zulip, Gitter is here only for historical purposes. Second, you might investigate Antora… IMO it’s amazing.
John Ericksen
@johncarl81
oh snap... I didnt know. And thanks @djencks , ill check it out.
Daniel Hinojosa
@dhinojosa
I dig Antora, I think I have one issue with it. But I haven’t used it enough to consider it worthwhile to mention. I am going to use it some more though. That one thing I may have an issue with might be the best thing for me and what I do.
djencks
@djencks
Out of curiosity, what is your issue?
Daniel Hinojosa
@dhinojosa
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.
djencks
@djencks
Actually, what I’ve found most amazing about it is that the organization forces me to think more clearly about my content. I use it for even very small sites for that reason.
Daniel Hinojosa
@dhinojosa
Yeah, I can see that for sure.
djencks
@djencks
Reorganizing an existing site to use antora can be a lot of work however. Some of the new features in antora 3 can help, such as symlinks .