https://www-staging.alwaldend.com/tags/hugo/ Recent content in Hugo on Alwaldend Hugo en https://www-staging.alwaldend.com/docs/projects/alwaldend.com/ Mon, 01 Jan 0001 00:00:00 +0000 https://www-staging.alwaldend.com/docs/projects/alwaldend.com/ <p>Alwaldend.com is the repository&rsquo;s main website and documentation site. It uses Hugo with Docsy to publish project documentation on GitHub Pages.</p> <h2 id="links">Links<a class="td-heading-self-link" href="#links" aria-label="Heading self-link"></a></h2><ul> <li>Source code: <a href="https://github.com/alwaldend/src/tree/master/projects/alwaldend.com">https://github.com/alwaldend/src/tree/master/projects/alwaldend.com</a></li> <li>Github Pages repo: <a href="https://github.com/alwaldend/alwaldend.github.io">https://github.com/alwaldend/alwaldend.github.io</a></li> <li>Hugo rules: <a href="https://www-staging.alwaldend.com/docs/tools/rules_hugo/">../../tools/rules_hugo</a></li> </ul> <h2 id="features">Features<a class="td-heading-self-link" href="#features" aria-label="Heading self-link"></a></h2><ul> <li><a href="https://gohugo.io">Hugo</a> site</li> <li><a href="https://github.com/google/docsy">Docsy</a>, <a href="https://getbootstrap.com">Bootstrap</a></li> </ul> <h2 id="local-preview-and-validation">Local preview and validation<a class="td-heading-self-link" href="#local-preview-and-validation" aria-label="Heading self-link"></a></h2><p>Run from the repository root:</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-sh" data-lang="sh"><span style="display:flex;"><span>bazel_agent bazel build //projects/alwaldend.com:site </span></span><span style="display:flex;"><span>bazel_agent bazel test //projects/alwaldend.com:site_test </span></span><span style="display:flex;"><span>bazel_agent bazel run //projects/alwaldend.com:site_serve </span></span></code></pre></div><p>The preview serves the local build at http://127.0.0.1:1313.</p> <h2 id="blog">Blog<a class="td-heading-self-link" href="#blog" aria-label="Heading self-link"></a></h2><p>The site publishes dated articles from <code>content/blog</code>. Each post is its own Bazel package with an <code>index.md</code> and a <code>BUILD.bazel</code> declaring its <code>docs_filegroup</code>; the section package aggregates them. The section publishes HTML, an RSS feed, and a print edition, and appears in the main navigation. The section index and its posts carry a <code>github_subdir</code> cascade so the per-page GitHub links point at the content sources.</p> https://www-staging.alwaldend.com/docs/misc/hugo/ Mon, 01 Jan 0001 00:00:00 +0000 https://www-staging.alwaldend.com/docs/misc/hugo/ <p>Hugo is a static site builder</p> <h2 id="environment-variables">Environment variables<a class="td-heading-self-link" href="#environment-variables" aria-label="Heading self-link"></a></h2><p>Hugo has an allowlist of environment variables, and <code>js_binary</code> rules do not work because they need a <code>BAZEL_BINDIR</code> variable</p> <p>Fix:</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-toml" data-lang="toml"><span style="display:flex;"><span>[<span style="color:#a6e22e">security</span>.<span style="color:#a6e22e">exec</span>] </span></span><span style="display:flex;"><span><span style="color:#a6e22e">osEnv</span> = [ </span></span><span style="display:flex;"><span> <span style="color:#e6db74">&#39;(?i)^((HTTPS?|NO)_PROXY|PATH(EXT)?|APPDATA|TE?MP|TERM|GO\w+|(XDG_CONFIG_)?HOME|USERPROFILE|SSH_AUTH_SOCK|DISPLAY|LANG|SYSTEMDRIVE|BAZEL.+)$&#39;</span>, </span></span><span style="display:flex;"><span>] </span></span></code></pre></div><p>Configuration reference: <a href="https://gohugo.io/configuration/security/">https://gohugo.io/configuration/security/</a></p> https://www-staging.alwaldend.com/docs/tools/hugo/ Mon, 01 Jan 0001 00:00:00 +0000 https://www-staging.alwaldend.com/docs/tools/hugo/ <p>Hugo binary toolchain for the repository. Build rules live in <a href="https://www-staging.alwaldend.com/docs/tools/rules_hugo/"><code>rules_hugo</code></a>.</p> https://www-staging.alwaldend.com/docs/tools/rules_hugo/ Mon, 01 Jan 0001 00:00:00 +0000 https://www-staging.alwaldend.com/docs/tools/rules_hugo/ <p><code>rules_hugo</code> builds Hugo sites with a registered Hugo toolchain. It keeps the site archive in the target configuration and the Hugo binary in the execution configuration so site sources are not rebuilt for the execution platform.</p> <p><code>al_hugo_site</code> wraps a site source archive and its PostCSS tooling. <code>al_hugo_run_binary</code> builds the site with the registered Hugo toolchain and <code>al_hugo_binary</code> exposes a runnable Hugo command for a site. The optional <code>al_hugo_worker</code> rule runs the build through a persistent worker.</p>