Support asciidoc (asciidoctor)

[peaceiris]

Support asciidoc (asciidoctor)

[peaceiris]

I reopened this for updating the README.

@reitzig Could you review this pull-request? reitzig/today-i-learned#1

[peaceiris]

Did you try the following?

- run: sudo gem install asciidoctor

Also we can use the apt or bundle to install asciidoctor.

• asciidoctor/asciidoctor

[reitzig]

Heh, got it. For the benefit of googlers:

  - name: Setup asciidoctor
    run: |
      sudo gem update --system 3.0.6
      sudo gem install asciidoctor
      sudo .github/scripts/reroute_asciidoctor.sh
      ruby --version; gem --version; asciidoctor --version

With this as .github/scripts/reroute_asciidoctor.sh:

#!/bin/bash

set -eu

binary="$(which asciidoctor)"
binary_orig="${binary}"_orig

if [[ -L "${binary}" ]]; then
    echo "Can not handle links yet"
    exit 1
fi

mv "${binary}" "${binary_orig}"

cat > "${binary}" <<BASH
#!/bin/bash

"${binary_orig}" \
    --attribute=experimental=true \
    --attribute=icons=font \
    "\$@"
BASH
chmod +x "${binary}"

echo "Updated '${binary}' to call '${binary_orig}' with extra parameters."

I guess it's easy to pull out the extra parameters so they appear in the workflow YAML instead, but not tonight. :'D

[peaceiris]

We are going to add a new section under Tips - README.md like the section for autoprefixer and postcss-cli. If you will work on this, I'll gladly merge it.

      - name: Setup Hugo
        uses: peaceiris/actions-hugo@v2
        with:
          hugo-version: 'latest'

      - uses: ruby/setup-ruby@v1
        with:
          ruby-version: 2.7

      - run: gem install asciidoctor
      - run: |
          alias asciidoctor="asciidoctor --attribute=experimental=true --attribute=icons=font"
          hugo --minify

[reitzig]

Just to point out the alternative here: https://github.com/reitzig/actions-asciidoctor

[reitzig]

Ah, now I understand the difference between a Docker-based action and one like yours a little bit better, I think. Thank you!

That seems to work -- basically. asciidoctor in the 18.04 repos is ancient, so gem it is, with a twist:

- name: Setup asciidoctor
        run: |
          sudo gem update --system 3.0.6 # cf. https://github.com/rubygems/rubygems/issues/3068#issuecomment-574775885
          ruby --version
          gem --version
          sudo gem install asciidoctor

This runs for a full minute... T_T

Unfortunately, my workaround for Hugo's ... clumsy handling of external tools doesn't seem to work on Github Actions. 🤔 Tinker tinker...

Update: Ah, I was being an idiot, I think. As my own README reminds me 🤦‍♂️ you have to add the working directory to PATH for that workaround to work.

[reitzig]

Very cool, thanks for your efforts!

Which change of the README do you have an in mind? Do you need me to do something?

I feel like doing this -- adding asciidoctor to a hugo setup, specifically, with workarounds -- could be a dedicated action. I'd be happy to collaborate!

[github-actions]

This issue has been LOCKED because of it being resolved!

The issue has been fixed and is therefore considered resolved.
If you still encounter this or it has changed, open a new issue instead of responding to solved ones.

Log | Bot Usage