The official chat room for Asciidoctor, a modern text processor and publishing toolchain for the AsciiDoc markup language.
Yea it's unfortunate. @mojavelinux makes a great point with PDFs being intended for printing, thus the white background and minimal coloring. The html looks so professional though. I especially like the header with my name, email, and date. I anticipate this would be a struggle for me to reproduce in the pdf theme
I run a test on a simple file and except for the footer is not bad
I was thinking to simply print to file from the browser, but that adds ugly metadata to the document
I tried
wkhtmltopdf and htmldoc. wkhtml preserved the styling well, but in code blocks puts the language top right very blurry. It breaks pages but doesn't number them. htmldoc does not preserve styling, but numbers pages well. My best bet might be to tweak the pdf theme, but I'm not sure how I would duplicate the document header
I understand then, you mean using asciidoctor-pdf with a theme? https://github.com/asciidoctor/asciidoctor-pdf/blob/master/docs/theming-guide.adoc
@djencks right I didn't look further into this because it seems it replaces the
asciidoctor-pdf command. I will check it out again though
@djencks let me know if I'm missing something, but the Document theme is pretty close to the default
asciidoctor-pdf. What would I be gaining with asciidoctor-web-pdf?
asciidoctor-web-pdf offers much more options in terms of layout ans is based on web technologies. If you are doing some brochure like document, could help, the repo has visual examples https://github.com/Mogztter/asciidoctor-web-pdf. asciidoctor-pdf is custom (yaml configuration) is oriented for printed docs
Yes I don't think that's my solution. After digesting the fact that PDFs are intended for print, I pared down my needs to the following: change headers to sans serif, add the author title. Headers in serif is easily achieved by extending the default theme. The author title I don't know where to begin. Is there any way to include this in the pdf? If I can check these boxes I'm satisfied.
If a front cover image is specified, the title page comes after the front cover. -source
I haven't been able to find documentation on setting a front cover image
Here is an example that sets an image https://github.com/asciidoctor/asciidoctor-maven-examples/tree/master/asciidoctor-pdf-with-theme-example/src/theme
you either set the doctype to book or set the title-page attribute in the header
I wasn't implying that PDF is intended for print. it's just as applicable to screen. what I was saying is that the default theme is optimized for print since people will want to print it. so the colors need to have good contrast by default
(we accomplish this with print styles in the HTML)
Is there a way to get a company logo on the title page of a pdf
Yes, title-page-logo in theme https://github.com/asciidoctor/asciidoctor-pdf/blob/master/docs/theming-guide.adoc#key-prefix-title-page-logo or title-logo-image in AsciiDoc header
Is there anything I can specify in asciidoc to have them start as is and be cut on the page break?
not until Asciidoctor PDF 2
If someone wants to contribute additional built-in themes, I'm happy to review and consider them.
What tools and languages would I become familiar with in order to contribute?
https://github.com/asciidoctor/asciidoctor-pdf/blob/master/CONTRIBUTING-CODE.adoc
you should know that I don't treat developers as language specific. I treat all developers as developers. Because the skill of development is with programming logic, not with knowing syntax. though I do recognize that you do need to become familiar with a toolchain in order to put that skill to use.
but that's why we are here, to help each other out over those hurdles.
Awesome! Is there a way to specify an absolute path for the image? It seems
:imagesdir:, :title-logo-image:, and image:: all take relative paths. Further, :title-logo-image: puts the logo on it's own page. This makes sense for a book, but is there a way to put the image on the title page, so there's only one cover page?
Good to hear!
I was mistaken on the
:title-logo-image:! It does show on the title page with a valid path.
yes, the path can be absolute
it's either absolute or relatvie to imagesdir
the path should still be encased in an image macro, as in
image:relative-path.png[] or image:/absolute/path.png[]
that ensures it gets resolved like an image normally does and lets you specify dimensions