Repository Rules

Build Rules

Usage

Add rules_hugo to your WORKSPACE and add a theme from github

# Update these to latestRULES_HUGO_COMMIT="..."RULES_HUGO_SHA256="..."http_archive(name="build_stack_rules_hugo",url="https://github.com/stackb/rules_hugo/archive/%s.zip"%RULES_HUGO_COMMIT,sha256=RULES_HUGO_SHA256,strip_prefix="rules_hugo-%s"%RULES_HUGO_COMMIT)load("@build_stack_rules_hugo//hugo:rules.bzl","hugo_repository","github_hugo_theme")## Load hugo binary itself## Optionally, load a specific version of Hugo, with the 'version' argumenthugo_repository(name="hugo",)## This makes a filegroup target "@com_github_yihui_hugo_xmin//:files"# available to your build files#github_hugo_theme(name="com_github_yihui_hugo_xmin",owner="yihui",repo="hugo-xmin",commit="c14ca049d0dd60386264ea68c91d8495809cc4c6",)## This creates a filegroup target from a released archive from GitHub# this is useful when a theme uses compiled / aggregated sources NOT found# in a source root.#http_archive(name="com_github_thegeeklab_hugo_geekdoc",url="https://github.com/thegeeklab/hugo-geekdoc/releases/download/v0.34.2/hugo-geekdoc.tar.gz",sha256="7fdd57f7d4450325a778629021c0fff5531dc8475de6c4ec70ab07e9484d400e",build_file_content="""filegroup(    name = "files",    srcs = glob(["**"]),    visibility = ["//visibility:public"])    """)

Declare a hugo_site with a GitHub repository theme in your BUILD file

load("@build_stack_rules_hugo//hugo:rules.bzl","hugo_site","hugo_theme","hugo_serve")# Declare a theme 'xmin'.  In this case the `name` and# `theme_name` are identical, so the `theme_name` could be omitted in this case.hugo_theme(name="xmin",theme_name="xmin",srcs= ["@com_github_yihui_hugo_xmin//:files",    ],)# Declare a site. Config file is required.my_site_name="basic"hugo_site(name=my_site_name,config="config.toml",content= ["_index.md","about.md",    ],quiet=False,theme=":xmin",)# Run local development serverhugo_serve(name="local_%s"%my_site_name,dep= [":%s"%my_site_name],)# Tar it uppkg_tar(name="%s_tar"%my_site_name,srcs= [":%s"%my_site_name],)

Declare a hugo_site with a GitHub released archive theme in your BUILD file

load("@build_stack_rules_hugo//hugo:rules.bzl","hugo_site","hugo_theme","hugo_serve")hugo_theme(name="hugo_theme_geekdoc",theme_name="hugo-geekdoc",srcs= ["@com_github_thegeeklab_hugo_geekdoc//:files",    ],)# Note, here we are using the config_dir attribute to support multi-lingual configurations.hugo_site(name="site_complex",config_dir=glob(["config/**"]),content=glob(["content/**"]),data=glob(["data/**"]),quiet=False,theme=":hugo_theme_geekdoc",)# Run local development serverhugo_serve(name="serve",dep= [":site_complex"],)

Previewing the site

bazel run //site_complex:serve

Build the site

$ bazel build :basic[...]Target //:basic up-to-date:  bazel-bin/basic[...]

$ tree bazel-bin/basicbazel-bin/basic├── 404.html├── about│   └── index.html[...]

$ bazel build :basic_tar[...]Target //:basic up-to-date:  bazel-bin/basic_tar.tar

End