Where communities thrive

  • Join over 1.5M+ people
  • Join over 100K+ communities
  • Free without limits
  • Create your own community
Repo info
  • 11:04
    Mogztter opened #3508
  • 08:10
    mojavelinux milestoned #3494
  • 08:02
    mojavelinux labeled #3503
  • 08:02
    mojavelinux milestoned #3503
  • 08:01
    mojavelinux milestoned #2337
  • 07:59
    mojavelinux closed #3507
  • 07:59
    mojavelinux assigned #3507
  • 07:59
    mojavelinux milestoned #3507
  • 07:54
    mojavelinux closed #3506
  • Dec 13 20:50
    mojavelinux synchronize #3506
  • Dec 13 18:51
    mojavelinux synchronize #3506
  • Dec 13 16:50
    znerd edited #3507
  • Dec 13 16:50
    znerd edited #3507
  • Dec 13 16:47
    znerd opened #3507
  • Dec 13 08:28
    mojavelinux synchronize #3506
  • Dec 13 08:08
    mojavelinux synchronize #3506
  • Dec 13 08:03
    mojavelinux opened #3506
  • Dec 12 21:04
    mojavelinux transferred #3505
  • Dec 12 20:51
    sabatmonk opened #3505
  • Dec 11 20:05
    mojavelinux labeled #3504
Stephan Vedder
Also opened an issue now: asciidoctor/asciidoctor-pdf#1418
Guillaume Grossetie
Perfect we can now track this issue
and hopefully fix it :wink:
Stephan Vedder
@Mogztter how can i make asciidoctor-pdf include the the subtitle?
Stephan Vedder
Ah i was missing :title-page:
Guillaume Grossetie
or you can use :doctype: book
Stephan Vedder
Yeah, but that would change my HTML output aswell wouldn't it?
Guillaume Grossetie
yes it will use the "book" style by default
the most noticeable change is that each section will be on a new page
Stephan Vedder
What's a page in HTML though?
Guillaume Grossetie
you meant with asciidoctor-pdf (Ruby)?
I was talking about Asciidoctor web PDF where we use Paged.js to paginate the HTML page
Stephan Vedder
I meant the normal asciidoctor tool
I use both asciidoctor and asciidoctor-pdf with the same input
Guillaume Grossetie
got i :)
is there anyway to remove the Figure x. prefix in image captions with asciidoctor-pdf?
Andreas Schilling
Hi all! Am I right that the Java artifacts of the current gradle plugin are not available anywhere else than the gradle plugin portal? I'd like to build a custom plugin that uses the asciidoctor gradle plugin and thus need a compile time dependency. I know I can add a repository definition for the gradle plugin portal as well, but any consumer then would have to do the same.
Joseph Cayouette
Is there a way to output the asciidoctor build errors when building with CI? For example if an include is not found, or PNG is not interlaced?
I would love to catch these in a way that allows us to check for these simple fixes.
Guillaume Grossetie
(not sure about the "PNG is not interlaced" but it should work when an include is not found)
@styx_hcr_twitter I think you should ask in the asciidoctorj channel -> https://gitter.im/asciidoctor/asciidoctorj#
Guillaume Grossetie
@slmjkdbtl not sure if it's a good idea but you can do the following
@Mogztter Thanks! but for some reason the actual caption rendered is {caption}{title} and the caption won't even show if the title is not set, so I have to set title="" to actually set the caption that I wanted
experts: I recently finished a book with asciidoc (https://github.com/pinggit/kubernetes-contrail-day-one/blob/master/kubernetes-contrail.adoc), and some reader is asking for a "kindle" version. I don't have one but I think that is doable. and I found https://asciidoctor.org/docs/asciidoctor-epub3/ , reading through it is confusing though. my question: is there a concrete step-by-step example for me to follow? e.g. are these steps the right ones? http://theantway.com/2017/06/how-to-convert-asciidoc-book-to-epubmobi-formats/
Guillaume Grossetie
You should be able to use the asciidoctor-epub3 gem to convert your AsciiDoc book directly to EPUB3
But you will need to follow the instructions to structure your AsciIDoc book accordingly
Otherwise the docbook -> pandoc -> epub -> mobi might work
thanks! I'll read it again and see.

$ sudo NOKOGIRI_USE_SYSTEM_LIBRARIES=1 gem install asciidoctor-epub3 --pre
[sudo] password for ping:
Building native extensions. This could take a while...
ERROR: Error installing asciidoctor-epub3:
ERROR: Failed to build gem native extension.

current directory: /var/lib/gems/2.5.0/gems/nokogiri-1.10.7/ext/nokogiri

/usr/bin/ruby2.5 -r ./siteconf20191213-1929-166h1b3.rb extconf.rb
checking if the C compiler accepts ... yes
Building nokogiri using system libraries.
Using pkg-config gem version 1.4.0
checking for libxml-2.0... no
checking for libxslt... no
checking for libexslt... no
ERROR: cannot discover where libxml2 is located on your system. please make sure pkg-config is installed.
extconf.rb failed
Could not create Makefile due to some reason, probably lack of necessary
libraries and/or headers. Check the mkmf.log file for more details. You may
need configuration options.

Provided configuration options:

To see why this extension failed to compile, please check the mkmf.log which can be found here:


extconf failed, exit code 1

Gem files will remain installed in /var/lib/gems/2.5.0/gems/nokogiri-1.10.7 for inspection.
Results logged to /var/lib/gems/2.5.0/extensions/x86_64-linux/2.5.0/nokogiri-1.10.7/gem_make.out

run into issues when trying to install this gem...
I have libxml2 and pkg-config though
I'm on ubuntu 1804 (wsl)
$ sudo gem install asciidoctor-epub3
[sudo] password for ping:
ERROR: Could not find a valid gem 'asciidoctor-epub3' (>= 0) in any repository
ERROR: Possible alternatives: asciidoctor-gb, asciidoctor-rouge, asciidoctor, asciidoctor-csand, asciidoctor-csd
just tried a few machines and none of them works...
Guillaume Grossetie
you shouldn't use sudo
I recommend using rvm to install gems in the user space
but that's not the issue
nokogiri requires a few system libraries
I believe the root cause is ERROR: cannot discover where libxml2 is located on your system. please make sure pkg-config is installed.
Install Nokogiri on a brand new Ubuntu system with these commands:
sudo apt-get install build-essential patch ruby-dev zlib1g-dev liblzma-dev
(please note that the following might be enough: sudo apt-get install libxslt-dev libxml2-dev)
thanks! I'll give it a shot
the gem installation went through now, but then I got this when trying to generate the mobi file:
$ asciidoctor-epub3 -D output -a ebook-format=kf8 kubernetes-contrail.adoc --trace
Traceback (most recent call last):
        32: from /usr/local/bin/asciidoctor-epub3:23:in `<main>'
        31: from /usr/local/bin/asciidoctor-epub3:23:in `load'
        30: from /var/lib/gems/2.5.0/gems/asciidoctor-epub3-1.5.0.alpha.9/bin/asciidoctor-epub3:32:in `<top (required)>'
        29: from /var/lib/gems/2.5.0/gems/asciidoctor-2.0.10/lib/asciidoctor/cli/invoker.rb:111:in `invoke!'
        28: from /var/lib/gems/2.5.0/gems/asciidoctor-2.0.10/lib/asciidoctor/cli/invoker.rb:111:in `each'
        27: from /var/lib/gems/2.5.0/gems/asciidoctor-2.0.10/lib/asciidoctor/cli/invoker.rb:128:in `block in invoke!'
        26: from /var/lib/gems/2.5.0/gems/asciidoctor-2.0.10/lib/asciidoctor/convert.rb:183:in `convert_file'
        25: from /var/lib/gems/2.5.0/gems/asciidoctor-2.0.10/lib/asciidoctor/convert.rb:183:in `open'
        24: from /var/lib/gems/2.5.0/gems/asciidoctor-2.0.10/lib/asciidoctor/convert.rb:183:in `block in convert_file'
        23: from /var/lib/gems/2.5.0/gems/asciidoctor-2.0.10/lib/asciidoctor/convert.rb:124:in `convert'
        22: from /var/lib/gems/2.5.0/gems/asciidoctor-2.0.10/lib/asciidoctor/document.rb:978:in `write'
        21: from /var/lib/gems/2.5.0/gems/asciidoctor-epub3-1.5.0.alpha.9/lib/asciidoctor-epub3/converter.rb:41:in `write'
        20: from /var/lib/gems/2.5.0/gems/asciidoctor-epub3-1.5.0.alpha.9/lib/asciidoctor-epub3/packager.rb:508:in `package'
        19: from /var/lib/gems/2.5.0/gems/asciidoctor-epub3-1.5.0.alpha.9/lib/asciidoctor-epub3/packager.rb:508:in `new'
        18: from /var/lib/gems/2.5.0/gems/gepub-1.0.6/lib/gepub/builder.rb:187:in `initialize'
        17: from /var/lib/gems/2.5.0/gems/gepub-1.0.6/lib/gepub/builder.rb:187:in `instance_eval'
        16: from /var/lib/gems/2.5.0/gems/asciidoctor-epub3-1.5.0.alpha.9/lib/asciidoctor-epub3/packager.rb:592:in `block in package'
        15: from /var/lib/gems/2.5.0/gems/asciidoctor-epub3-1.5.0.alpha.9/lib/asciidoctor-epub3/packager.rb:280:in `add_content'
        14: from /var/lib/gems/2.5.0/gems/gepub-1.0.6/lib/gepub/builder.rb:303:in `resources'
        13: from /var/lib/gems/2.5.0/gems/gepub-1.0.6/lib/gepub/builder.rb:303:in `new'
        12: from /var/lib/gems/2.5.0/gems/gepub-1.0.6/lib/gepub/resource_builder.rb:33:in `initialize'
        11: from /var/lib/gems/2.5.0/gems/gepub-1.0.6/lib/gepub/resource_builder.rb:33:in `instance_eval'
        10: from /var/lib/gems/2.5.0/gems/asciidoctor-epub3-1.5.0.alpha.9/lib/asciidoctor-epub3/packager.rb:285:in `block in add_content'
         9: from /var/lib/gems/2.5.0/gems/gepub-1.0.6/lib/gepub/resource_builder.rb:39:in `ordered'
         8: from /var/lib/gems/2.5.0/gems/gepub-1.0.6/lib/gepub/book.rb:174:in `ordered'
         7: from /var/lib/gems/2.5.0/gems/gepub-1.0.6/lib/gepub/package.rb:182:in `ordered'
         6: from /var/lib/gems/2.5.0/gems/gepub-1.0.6/lib/gepub/resource_builder.rb:40:in `block in ordered'
         5: from /var/lib/gems/2.5.0/gems/gepub-1.0.6/lib/gepub/resource_builder.rb:40:in `instance_eval'
         4: from /var/lib/gems/2.5.0/gems/asciidoctor-epub3-1.5.0.alpha.9/lib/asciidoctor-epub3/packager.rb:288:in `block (2 levels) in add_content'
         3: from /var/lib/gems/2.5.0/gems/asciidoctor-epub3-1.5.0.alpha.9/lib/asciidoctor-epub3/packager.rb:288:in `each_with_index'
         2: from /var/lib/gems/2.5.0/gems/asciidoctor-epub3-1.5.0.alpha.9/lib/asciidoctor-epub3/packager.rb:288:in `each'
         1: from /var/lib/gems/2.5.0/gems/asciidoctor-epub3-1.5.0.alpha.9/lib/asciidoctor-epub3/packager.rb:292:in `block (3 levels) in add_content'
/var/lib/gems/2.5.0/gems/asciidoctor-epub3-1.5.0.alpha.9/lib/asciidoctor-epub3/packager.rb:463:in `postprocess_xhtml': undefined method `gsub' for #<Asciidoctor::Epub3::Packager:0x00007ffff282e3b8> (NoMethodError)
any clues?
Guillaume Grossetie
no I'm not familiar with the EPUB3 converter, did you follow the "Structuring your Manuscript" section? https://github.com/asciidoctor/asciidoctor-epub3#structuring-your-manuscript
you should open an issue at https://github.com/asciidoctor/asciidoctor-epub3 with an, as small as possible, sample document