16

I'm using asciidoctor-maven-plugin to convert .adoc files to html file... Would want to include a link to javascript in the generated html file... Basically would like to see something like below in the html file that is generated from the .adoc file

<script src="custom.js"></script>

Tried setting attributes like linkcss scriptsdir etc..but of no luck...

Any help?

One way is like in http://mrhaki.blogspot.ie/2014/06/awesome-asciidoc-include-raw-html.html

But then have to add it in every .adoc file...is there a way to get it automatically added just like the CSS (using stylesheet)

Karthik
  • 1,383
  • 1
  • 10
  • 11

2 Answers2

13

You can use the passthrough block for that using ++++:

++++
<p>
Content in a passthrough block is passed to the output unprocessed.
That means you can include raw HTML, like this embedded Gist:
</p>

<script src="http://gist.github.com/mojavelinux/5333524.js">
</script>
++++

Source: http://asciidoctor.org/docs/asciidoc-syntax-quick-reference/#more-delimited-blocks

null
  • 3,959
  • 1
  • 21
  • 28
  • 1
    Though it works, there's a limitation that you can't pass any values inside this block. – Zon May 02 '20 at 10:59
12

Use docinfo files, see the documentation for more detail.

You create docinfo files by adding another file named <doc_file_name>-docinfo.html for HTML generation or <doc_file_name>-docinfo.xml for docbook generation. The contents of the docinfo file are copied into the generated output, in the head section for html. If you want to add things to the bottom of the document there are footer docinfo files for that. It follows the same as a normal docinfo but the file name is <doc_file_name>-docinfo-footer.html or <doc_file_name>-docinfo-footer.xml

Happy docing :) Let me, or preferably the list know of any other maven issues you find.

LightGuard
  • 5,298
  • 19
  • 19
  • 1
    And don't forget to set the :docinfo: attribute in your adoc, to the corresponding value! (also explained in the docs linked by @LightGuard) – seinecle Feb 04 '18 at 20:01