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 20:22
    @mojavelinux banned @asciidoctor-docbot
  • Mar 07 12:13
    shlomif opened #3965
  • Mar 07 11:09
    mojavelinux labeled #3961
  • Mar 07 11:09
    mojavelinux milestoned #3961
  • Mar 07 11:07
    mojavelinux milestoned #3962
  • Mar 07 11:07
    mojavelinux assigned #3962
  • Mar 07 11:07
    mojavelinux closed #3962
  • Mar 07 10:37
    mojavelinux closed #3964
  • Mar 07 10:24
    slonopotamus opened #3964
  • Mar 07 09:57
    mojavelinux closed #3963
  • Mar 06 11:30
    withshubh opened #3963
  • Mar 06 08:35
    reosablo opened #3962
  • Mar 05 20:17
    mojavelinux labeled #3960
  • Mar 05 20:17
    mojavelinux closed #3960
  • Mar 05 15:52
    HarshKapadia2 edited #3961
  • Mar 05 15:50
    HarshKapadia2 opened #3961
  • Mar 05 12:59
    slowGetter opened #3960
  • Mar 05 09:32
    mojavelinux labeled #3959
  • Mar 05 09:32
    mojavelinux closed #3959
  • Mar 05 07:06
    wimdeblauwe opened #3959
lertsenem
@lertsenem:matrix.org
[m]
(I know about Zulip, but I don't really want yet another messaging account on a private plateform :/)
Maxim Kim
@habamax
asciidoctor ruby
Vishal Kumar
@vishalkrsinha
Have an attribute defined in a file say myDoc.adoc like (:MhPath: ../../../../abc/out/install/xyz). This adoc file is getting included in text.adoc file. Now, any way of overriding ':MhPath:' value during adoc conversion step like...
cmd> asciidoctor text.adoc :MhPath: ../../abc/out/install/xyz
Any help is much appreciated...
Ewan Edwards
@eskwayrd
You can use the -a flag to define an attribute at runtime. See asciidoctor —h for details.
13 replies
Ewan Edwards
@eskwayrd
If you have further questions, I invite you to ask them here: https://asciidoctor.zulipchat.com/
The Asciidoctor community recently moved over to Zulip, and the Gitter community is still alive for posterity.
1 reply
modprog
@modprog:matrix.org
[m]
Good Day,
I'm not sure if this is the right place to ask, but do you know if it has been considered to "compile" reveal.js presentations to a single HTML file?
Atleast when only small or no images are used?
Ewan Edwards
@eskwayrd
Presentations are a single HTML file, but they depend on JavaScript and CSS that make the presentation work. According to SO, You can use webpack’s `html-webpack-plugin’ to accomplish that: https://stackoverflow.com/questions/46866228/how-to-bundle-html-js-and-css-in-one-html-file-with-webpack
3 replies
lertsenem
@lertsenem:matrix.org
[m]
Doing so would link asciidoctor with a specific version of reveal.js I think ?
So it's probably wiser to leave such a tool separate ?
Ewan Edwards
@eskwayrd
Indeed, using webpack to create a bundled HTML file including the required JS and CSS would tie that specific presentation to that specific JS+CSS. But, if Asciidoctor, reveal.js, or the CSS styling used is updated at any point, you can create a new bundle.
Vishal Kumar
@vishalkrsinha
How to override an attribute value defined in a referenced file to the working file? I used ':!copycss:' but it's kind of suppressing actual warning too. Any other option plz?
Also, if the attribute is locally defined but using relative paths (say path to a stylesheet) still see the warning (that actually shouldn't be). How to handle it?
lertsenem
@lertsenem:matrix.org
[m]
Marrant, on dirait la même ville que dans DQ XI
Mark Plummer
@mark-plummer
Hi. My company has built a site with Gatsby and are using asciidoc as the authoring format. Im familiar with the awesome ifdef directive that Ive used woth our Antora site for conditionilzing content. They would like to do the same thing with the asciidoc content on the Gatsby site. Do you think that wpuld be possible to do? And how would they do it?
James Elliott
@brunchboy
Hi, Mark, I see you already joined the Antora community over on Zulip. The Asciidoctor community has moved to Zulip as well, at https://asciidoctor.zulipchat.com/ so I would encourage you to sign up on that instance too.
(And I am not ignoring your question out of spite, I don’t know the answer or I would say something helpful beyond encouraging you to ask it on Zulip, where streams and topics are much more cohesive and supportive of deep discussion.) :smile:
Mark Plummer
@mark-plummer
Thanks James! I had thought it had migrated, but was having trouble finding it in Zulip. thanks so much for sharing the link!
James Elliott
@brunchboy
:+1:
Dan Allen
@mojavelinux
For reference, it's linked from the Community category in the topbar on the docs site (https://docs.antora.org/antora/2.3/).
Dan Allen
@mojavelinux
Oops, wrong community reference ;)
It's linked from this page: https://docs.asciidoctor.org/about/support/
But that does make me realize that perhaps it should be linked from the topbar too. :scream: I opened an issue to track this change: asciidoctor/asciidoctor-docs-ui#113
James Elliott
@brunchboy
It took me embarassingly long to realize I needed to do that in my own UI, Dan. :smile:
Dan Allen
@mojavelinux
I got so used it being in the Antora site that I totally forgot that it isn't there in the Asciidoctor site ;)
Wursti
@WorldWideWursti_twitter
Hi
lertsenem
@lertsenem:matrix.org
[m]
Hello
Andreas Weinzierl
@this-is-me:matrix.org
[m]
Hi
WorldWideWursti_twitter @WorldWideWursti_twitter try to get asciidoctor-web-pdf running on macos big sur :-( its cheating me :)
Simone Bordet
@sbordet

Hi! Writing the Jetty documentation with asciidoctor in intellij here :)
Given:

root
  subdir
    mydoc.adoc
    myimage.png

I noticed that in the asciidoctor intellij plugin the image is rendered with: image::myimage.png[] (from mydoc.adoc)
However, when running the asciidoctor maven plugin, it must be: image::subdir/myimage.png[]
If I see it rendered ok in the intellij plugin, then it's broken when using the maven plugin, and viceversa.
My imagesdir attribute is not defined.
Help? :pray:

lertsenem
@lertsenem:matrix.org
[m]
Testing with asciidoctor and asciidoctor-pdf, the expected syntax is, as I suspected, the first one (image::myimage.png[])
I don't know how the maven plugin works, but it's strange, especially since the line is basically compiled in html as <img src="myimage.png">
(and thus a line <img src="toto/myimage.png'> should not work in your browser?)
Simone Bordet
@sbordet
@lertsenem:matrix.org then I suspect the maven plugin does not cd into subdirectories so imagesdir is always resolved with respect to root and not subdir...
BTW I moved the discussion to Zulip, as I understood the chats were moved there?
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
👍