asciidoctor/asciidoctor

The official chat room for Asciidoctor, a modern text processor and publishing toolchain for the AsciiDoc markup language.

Stephan Vedder

@feliwir

Also opened an issue now: asciidoctor/asciidoctor-pdf#1418

Guillaume Grossetie

@Mogztter

Perfect we can now track this issue

and hopefully fix it :wink:

Stephan Vedder

@feliwir

@Mogztter how can i make asciidoctor-pdf include the the subtitle?

Stephan Vedder

@feliwir

Ah i was missing :title-page:

Guillaume Grossetie

@Mogztter

or you can use :doctype: book

Stephan Vedder

@feliwir

Yeah, but that would change my HTML output aswell wouldn't it?

Guillaume Grossetie

@Mogztter

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

@feliwir

What's a page in HTML though?

Guillaume Grossetie

@Mogztter

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

@feliwir

I meant the normal asciidoctor tool

I use both asciidoctor and asciidoctor-pdf with the same input

Guillaume Grossetie

@Mogztter

got i :)

t嘎

@slmjkdbtl

is there anyway to remove the Figure x. prefix in image captions with asciidoctor-pdf?

Andreas Schilling

@styx_hcr_twitter

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

@jcayouette

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

@Mogztter

Using --failure-level? https://asciidoctor.org/docs/user-manual/#processing-information

(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

@Mogztter

@slmjkdbtl not sure if it's a good idea but you can do the following

.Sunset
image::sunset.png[caption=""]

t嘎

@slmjkdbtl

@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

pinggit

@pinggit

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

@Mogztter

You should be able to use the asciidoctor-epub3 gem to convert your AsciiDoc book directly to EPUB3

https://asciidoctor.org/docs/asciidoctor-epub3/#getting-started

But you will need to follow the instructions to structure your AsciIDoc book accordingly

Otherwise the docbook -> pandoc -> epub -> mobi might work

pinggit

@pinggit

thanks! I'll read it again and see.

pinggit

@pinggit

$ 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:
--with-opt-dir
--without-opt-dir
--with-opt-include
--without-opt-include=${opt-dir}/include
--with-opt-lib
--without-opt-lib=${opt-dir}/lib
--with-make-prog
--without-make-prog
--srcdir=.
--curdir
--ruby=/usr/bin/$(RUBY_BASE_NAME)2.5
--help
--clean
--use-system-libraries=true
--with-zlib-dir
--without-zlib-dir
--with-zlib-include
--without-zlib-include=${zlib-dir}/include
--with-zlib-lib
--without-zlib-lib=${zlib-dir}/lib
--with-xml2-dir
--without-xml2-dir
--with-xml2-include
--without-xml2-include=${xml2-dir}/include
--with-xml2-lib
--without-xml2-lib=${xml2-dir}/lib
--with-libxml-2.0-config
--without-libxml-2.0-config
--with-pkg-config
--without-pkg-config
--with-pkg-config
--without-pkg-config
--with-override-variables
--without-override-variables
--with-xslt-dir
--without-xslt-dir
--with-xslt-include
--without-xslt-include=${xslt-dir}/include
--with-xslt-lib
--without-xslt-lib=${xslt-dir}/lib
--with-libxslt-config
--without-libxslt-config
--with-exslt-dir
--without-exslt-dir
--with-exslt-include
--without-exslt-include=${exslt-dir}/include
--with-exslt-lib
--without-exslt-lib=${exslt-dir}/lib
--with-libexslt-config
--without-libexslt-config

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

/var/lib/gems/2.5.0/extensions/x86_64-linux/2.5.0/nokogiri-1.10.7/mkmf.log

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

pinggit

@pinggit

just tried a few machines and none of them works...

Guillaume Grossetie

@Mogztter

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.

https://nokogiri.org/tutorials/installing_nokogiri.html

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)

pinggit

@pinggit

thanks! I'll give it a shot

pinggit

@pinggit

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

@Mogztter

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

Where communities thrive

People

Repo info

Activity