Skip to content

bzlparty/rules_pandoc

Repository files navigation

Bazel rules for pandoc

CI

Installation

From the release you wish to use: https://github.com/bzlparty/rules_pandoc/releases copy the WORKSPACE snippet into your WORKSPACE file.

From a specific commit

To use a commit rather than a release, you can point at any SHA of the repo.

For example to use commit abc123:

  1. Replace url = "https://github.com/bzlparty/rules_pandoc/releases/download/v0.1.0/rules_pandoc-v0.1.0.tar.gz" with a GitHub-provided source archive like url = "https://github.com/bzlparty/rules_pandoc/archive/abc123.tar.gz"
  2. Replace strip_prefix = "rules_pandoc-0.1.0" with strip_prefix = "rules_pandoc-abc123"
  3. Update the sha256. The easiest way to do this is to comment out the line, then Bazel will print a message with the correct value. Note that GitHub source archives don't have a strong guarantee on the sha256 stability, see https://github.blog/2023-02-21-update-on-the-future-stability-of-source-code-archives-and-hashes/

Usage

load("@rules_pandoc//pandoc:defs.bzl", "pandoc")

pandoc(
    name = "html",
    input = "index.md",
    out = "index.html",
    standalone = True,
    title = "Index",
)

See the rules documentation for more.