academic-cv fails building online due to shortcode: cite

[SaeedShurrab]

Preliminary Checks

• This issue is not a duplicate. Before opening a new issue, please search existing issues: https://github.com/HugoBlox/hugo-blox-builder/issues?q=is%3Aissue
• This issue is not a question, feature request, or anything other than a bug report directly related to Hugo Blox Builder. Please post those things on Discord: https://discord.gg/z8wNYzb

Description

I am trying to deploy the academic-cv theme from the https://hugoblox.com/templates/details/academic-cv/ but the build fails.

Reproduction Link

https://hugoblox.com/templates/details/academic-cv/

Steps to Reproduce

1.fro this page https://hugoblox.com/templates/details/academic-cv/
2. press Deploy for free on github
3.
...

Expected Result

An initial website ready for editing similar to the demo

Actual Result

during the build action i get this response:

Run echo "Hugo Cache Dir: $(hugo config | grep cachedir)"
echo "Hugo Cache Dir: $(hugo config | grep cachedir)"
hugo --minify --baseURL "https://saeedshurrab.github.io/"
shell: /usr/bin/bash -e {0}
env:
WC_HUGO_VERSION: 0.148.2
GITHUB_PAGES: true
HUGO_ENVIRONMENT: production
Hugo Cache Dir: cachedir = '/tmp/hugo_cache_runner/'
Start building sites …
hugo v0.148.2-40c3d8233d4b123eff74725e5766fc6272f0a84d+extended linux/amd64 BuildDate=2025-07-27T12:43:24Z VendorInfo=gohugoio

Total in 110 ms
Error: error building site: process: readAndProcessContent: "/home/runner/work/SaeedShurrab.github.io/SaeedShurrab.github.io/content/post/teach-courses/index.md:26:1": failed to extract shortcode: template for shortcode "cite" not found
hugo: collected modules in 5173 ms
Error: Process completed with exit code 1.

this image shows how the website looks after the deployment ends

What Hugo Module versions does your site use?

module github.com/HugoBlox/hugo-blox-builder/starters/academic-cv

go 1.19

require (
github.com/HugoBlox/hugo-blox-builder/modules/blox-plugin-netlify v1.1.2-0.20231209203044-d31adfedd40b
github.com/HugoBlox/hugo-blox-builder/modules/blox-tailwind v0.4.1
)

What operating system(s) are you seeing the problem on?

macOS

What browser(s) are you seeing the problem on?

Chrome

Which Hugo Blox template are you using?

Academic-cv

What version of Hugo are you using?

0.148.2

[gcushen]

Thanks for reporting this.

The issue is in the demo content you referenced in the error: /home/runner/work/SaeedShurrab.github.io/SaeedShurrab.github.io/content/post/teach-courses/index.md:26:1

The quick fix is to delete the above demo file from your site (can be done via the GitHub UI) or just delete the cite shortcode line within it.

Alternatively, you can install the cite shortcode by upgrading to the latest version by setting the version to main in go.mod: github.com/HugoBlox/hugo-blox-builder/modules/blox-tailwind main

[SaeedShurrab]

these errors no longer appear, now the error appearing is:
Run echo "Hugo Cache Dir: $(hugo config | grep cachedir)"
echo "Hugo Cache Dir: $(hugo config | grep cachedir)"
hugo --minify --baseURL "https://saeedshurrab.github.io/"
shell: /usr/bin/bash -e {0}
env:
WC_HUGO_VERSION: 0.148.2
GITHUB_PAGES: true
HUGO_ENVIRONMENT: production
Hugo Cache Dir: cachedir = '/tmp/hugo_cache_runner/'
Start building sites …
hugo v0.148.2-40c3d8233d4b123eff74725e5766fc6272f0a84d+extended linux/amd64 BuildDate=2025-07-27T12:43:24Z VendorInfo=gohugoio

Total in 13965 ms
Error: error building site: TAILWINDCSS: failed to transform "/css/main.css" (text/css). You need to install TailwindCSS CLI. See https://gohugo.io/functions/css/tailwindcss/: binary with name "tailwindcss" not found using npx
hugo: collected modules in 7695 ms
Error: Process completed with exit code 1.

[gcushen]

@SaeedShurrab thanks for reporting this. We had just released a major update and the GitHub Actions had not been updated yet to reflect that - if you install the new GitHub Action in your site, it should deploy fine: https://github.com/HugoBlox/hugo-blox-builder/blob/ee50bbf7e8aa355b89aeef87ba625784ef356107/starters/academic-cv/.github/workflows/publish.yaml

[SaeedShurrab]

Thanks for the swift response,

I just copied the contents of publish.yaml link you provided and paste it to my website repo. the build is now ok but deployment has issues as shown in the image below:

[gcushen]

Thanks for the swift response,

I just copied the contents of publish.yaml link you provided and paste it to my website repo. the build is now ok but deployment has issues as shown in the image below:

Those errors are coming from the repository’s GitHub Pages environment protection settings, not from Hugo Blox or our publish.yaml.

The workflow’s deploy job targets the github-pages environment, and the error “Branch 'main' is not allowed to deploy to github-pages” means that environment has restrictions that exclude main (or requires approvals).

To check/fix:

• Settings → Pages:
  • Build and deployment: set to “GitHub Actions”.
• Settings → Environments → github-pages:
  • Deployment branches: allow “All branches” or add main.
  • If “Required reviewers” or wait timers are enabled, approve the deployment or temporarily remove those rules.
• If their default branch isn’t main, update on.push.branches in the workflow accordingly.
• Also ensure they don’t have a second, auto‑generated Pages workflow (GitHub sometimes adds pages.yml). It won’t cause this specific error, but it can confuse which workflow is running.

No changes are needed to Hugo Blox; the failure is due to non‑standard repo configuration.

[SaeedShurrab]

it works correctly, thank you so much