# Provide asciidoc/asciidoctor on the builder nodes

**URL:** <https://answers.netlify.com/t/provide-asciidoc-asciidoctor-on-the-builder-nodes/12133>\
**Category:** Features\
**Tags:** building, hugo\
**Created:** [April 10, 2020, 3:04pm UTC](https://answers.netlify.com/t/provide-asciidoc-asciidoctor-on-the-builder-nodes/12133 "2020-04-10T15:04:32Z")\
**Posts on this page:** 7\
**Page:** 1

<div class="post-metadata">

**Author:** ![siscia](https://sea1.discourse-cdn.com/netlify/user_avatar/answers.netlify.com/siscia/32/4592_2.png) [@siscia](https://answers.netlify.com/u/siscia)\
**Post date:** [April 10, 2020, 3:04pm UTC](https://answers.netlify.com/t/provide-asciidoc-asciidoctor-on-the-builder-nodes/12133/1 "2020-04-10T15:04:32Z")

</div>

Hugo support writing documents in asciidoc and not only in markdown.

However, in order to compile the asciidoc documents hugo requires either asciidoc or asciidoctor available in the path.

Would it be possible to install one of those packages in the build nodes?

Overall asciidoc is more popular when people are working on more extensive and coherent material (think about a book) that a serie of blog posts.

---

<div class="post-metadata">

**Author:** ![siscia](https://sea1.discourse-cdn.com/netlify/user_avatar/answers.netlify.com/siscia/32/4592_2.png) [@siscia](https://answers.netlify.com/u/siscia)\
**Post date:** [April 10, 2020, 3:17pm UTC](https://answers.netlify.com/t/provide-asciidoc-asciidoctor-on-the-builder-nodes/12133/2 "2020-04-10T15:17:38Z")

</div>

Provided a PR here: [add asciidoctor to the build node, useful for hugo by siscia · Pull Request #391 · netlify/build-image · GitHub](https://github.com/netlify/build-image/pull/391)

---

<div class="post-metadata">

**Author:** ![fool](https://sea1.discourse-cdn.com/netlify/user_avatar/answers.netlify.com/fool/32/37_2.png) [@fool](https://answers.netlify.com/u/fool)\
**Post date:** [April 14, 2020, 6:32pm UTC](https://answers.netlify.com/t/provide-asciidoc-asciidoctor-on-the-builder-nodes/12133/3 "2020-04-14T18:32:24Z")

</div>

Thanks for the PR, but I am curious as to why you don’t use the npm package to install it - you can do that with no changes:

> **[asciidoctor](https://www.npmjs.com/package/asciidoctor)**
>
> A JavaScript AsciiDoc processor, cross-compiled from the Ruby-based AsciiDoc implementation, Asciidoctor, using Opal. Latest version: 2.2.6, last published: a year ago. Start using asciidoctor in your project by running \`npm i asciidoctor\`. There are...

We try not to add tools to the image that are installable in other ways. LMK if that won’t work for you!

---

<div class="post-metadata">

**Author:** ![siscia](https://sea1.discourse-cdn.com/netlify/user_avatar/answers.netlify.com/siscia/32/4592_2.png) [@siscia](https://answers.netlify.com/u/siscia)\
**Post date:** [April 27, 2020, 6:35pm UTC](https://answers.netlify.com/t/provide-asciidoc-asciidoctor-on-the-builder-nodes/12133/4 "2020-04-27T18:35:12Z")

</div>

Hello there!

Thanks for your answer. That tool over there is not asciidoctor nor it seems to provide the same interface.

I just tried and the package does not work. It is a asciidoctor version transpilled from ruby to js to be used inside node.js

What it is needed by hugo is a correct executable in the system PATH

Cheers,

---

<div class="post-metadata">

**Author:** ![fool](https://sea1.discourse-cdn.com/netlify/user_avatar/answers.netlify.com/fool/32/37_2.png) [@fool](https://answers.netlify.com/u/fool)\
**Post date:** [April 27, 2020, 9:58pm UTC](https://answers.netlify.com/t/provide-asciidoc-asciidoctor-on-the-builder-nodes/12133/5 "2020-04-27T21:58:26Z")

</div>

OK, I’d suggest creating a feature request over here: [Issues · netlify/build-image · GitHub](https://github.com/netlify/build-image/issues)

We’ll need to see more than a few other folks who can’t use the node package echo that feature request, before we’ll be able to consider adding it to the build image, since we try very hard to keep it small and have only commonly needed tools “baked in” vs “installed”.

For a quicker-results workaround, you could compile or find a binary that works in ubuntu 16.04 x86\_64 and add it to your repo and run directly (./asciidoctor && …)

---

<div class="post-metadata">

**Author:** ![akbo](https://sea1.discourse-cdn.com/netlify/user_avatar/answers.netlify.com/akbo/32/10356_2.png) [@akbo](https://answers.netlify.com/u/akbo)\
**Post date:** [May 6, 2020, 8:26pm UTC](https://answers.netlify.com/t/provide-asciidoc-asciidoctor-on-the-builder-nodes/12133/6 "2020-05-06T20:26:24Z")

</div>

I had the same problem. However, since asciidoctor is simply a ruby gem and the Netlify build process installs gems before building, this is actually really easy to solve:

- Create a Gemfile at the root of your repo (a textfile with the name Gemfile)
- Put the following two lines in the file:

source ‘[https://rubygems.org](https://rubygems.org)’  
gem ‘asciidoctor’

That’s it. In the next build, asciidoctor should get installed automatically and hugo can use it.

---

<div class="post-metadata">

**Author:** ![fool](https://sea1.discourse-cdn.com/netlify/user_avatar/answers.netlify.com/fool/32/37_2.png) [@fool](https://answers.netlify.com/u/fool)\
**Post date:** [May 7, 2020, 6:19am UTC](https://answers.netlify.com/t/provide-asciidoc-asciidoctor-on-the-builder-nodes/12133/7 "2020-05-07T06:19:32Z")

</div>

Thanks so much for providing that solution! Really appreciate your help, @akbo
