I needed a newer version of hugo because one of my modules need a minimal version 141. I was using the module before and it worked but I needed a new functionality and thus updated the modules.
Now everything is still working locally (with hugo 0.151.0) but the youtube module is broken on the online version.
(note that the gitlab version I use hugo 145 because I still need to fix my css to adapt to changes from hugo 146).
Can you help me understand why the youtube hugo module is not working on my gitlab pages setup ?
Here’s my .gitlab-ci.yaml
default:
image: hugomods/hugo:exts-0.145.0
# image: "${CI_TEMPLATE_REGISTRY_HOST}/pages/hugo/hugo_extended:latest"
variables:
GIT_SUBMODULE_STRATEGY: recursive
HUGO_ENV: production
before_script:
- apk add --no-cache go curl bash nodejs
## Uncomment the following if you use PostCSS. See https://gohugo.io/hugo-pipes/postcss/
# - npm install postcss postcss-cli autoprefixer
test:
script:
- hugo
rules:
- if: $CI_COMMIT_BRANCH != $CI_DEFAULT_BRANCH
pages:
script:
- hugo
artifacts:
paths:
- public
rules:
- if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
environment: production
First, I would use the GitLab Pages workflow from the Hugo documentation. This has been thoroughly tested and does not depend on a third-party container.
Second, the modules you reference were not created, nor are they maintained, by the Hugo project team. Please contact the module author.
Running with gitlab-runner 18.4.0~pre.115.gb2218bab (b2218bab)
on blue-3.saas-linux-small-amd64.runners-manager.gitlab.com/default zxwgkjAPH, system ID: s_d5d3abbdfd0a
Preparing the "docker+machine" executor 00:20
Using Docker executor with image golang:1.25.1-bookworm ...
Using effective pull policy of [always] for container golang:1.25.1-bookworm
Pulling docker image golang:1.25.1-bookworm ...
Using docker image sha256:80d0c273b68be554ca551c61b4a22ef66baae074f3a9562636139ba01972e5b1 for golang:1.25.1-bookworm with digest golang@sha256:c423747fbd96fd8f0b1102d947f51f9b266060217478e5f9bf86f145969562ee ...
Preparing environment 00:03
Using effective pull policy of [always] for container sha256:751a6f0ec9e2dbd89d056fdc53c38823e9cbf94b94e595cfb7b5fd613e20e91f
Running on runner-zxwgkjaph-project-61737769-concurrent-0 via runner-zxwgkjaph-s-l-s-amd64-1759955067-fb5cebfe...
Getting source from Git repository 00:03
Gitaly correlation ID: 86389844ef2f40cc9d3f0469de2bd6dc
Fetching changes...
Initialized empty Git repository in /builds/kulusesouriant/website/.git/
Created fresh repository.
Checking out f839d639 as detached HEAD (ref is master)...
Updating/initializing submodules recursively...
Submodule 'themes/hugo-cloak-email' (https://github.com/martignoni/hugo-cloak-email.git) registered for path 'themes/hugo-cloak-email'
Submodule 'themes/hugo-coder' (https://github.com/luizdepra/hugo-coder.git) registered for path 'themes/hugo-coder'
Synchronizing submodule url for 'themes/hugo-cloak-email'
Synchronizing submodule url for 'themes/hugo-coder'
Cloning into '/builds/kulusesouriant/website/themes/hugo-cloak-email'...
Cloning into '/builds/kulusesouriant/website/themes/hugo-coder'...
Submodule path 'themes/hugo-cloak-email': checked out '19e0284810127d1d56e2d813a311b0bd73bba96c'
Submodule path 'themes/hugo-coder': checked out '6bc00595434affd85e9d55af98779460de6fb1cd'
Updated submodules
Synchronizing submodule url for 'themes/hugo-cloak-email'
Synchronizing submodule url for 'themes/hugo-coder'
Entering 'themes/hugo-cloak-email'
Entering 'themes/hugo-coder'
Entering 'themes/hugo-cloak-email'
Entering 'themes/hugo-coder'
$ git remote set-url origin "${CI_REPOSITORY_URL}" || echo 'Not a git repository; skipping'
Executing "step_script" stage of the job script 00:13
Using effective pull policy of [always] for container golang:1.25.1-bookworm
Using docker image sha256:80d0c273b68be554ca551c61b4a22ef66baae074f3a9562636139ba01972e5b1 for golang:1.25.1-bookworm with digest golang@sha256:c423747fbd96fd8f0b1102d947f51f9b266060217478e5f9bf86f145969562ee ...
$ echo "Creating directory for user-specific executable files..."
Creating directory for user-specific executable files...
$ mkdir -p "${HOME}/.local"
$ echo "Installing utilities..."
Installing utilities...
$ apt-get update
Get:1 http://deb.debian.org/debian bookworm InRelease [151 kB]
Get:2 http://deb.debian.org/debian bookworm-updates InRelease [55.4 kB]
Get:3 http://deb.debian.org/debian-security bookworm-security InRelease [48.0 kB]
Get:4 http://deb.debian.org/debian bookworm/main amd64 Packages [8791 kB]
Get:5 http://deb.debian.org/debian bookworm-updates/main amd64 Packages [6924 B]
Get:6 http://deb.debian.org/debian-security bookworm-security/main amd64 Packages [281 kB]
Fetched 9333 kB in 1s (8772 kB/s)
Reading package lists...
$ apt-get install -y brotli xz-utils zstd
Reading package lists...
Building dependency tree...
Reading state information...
The following NEW packages will be installed:
brotli xz-utils zstd
0 upgraded, 3 newly installed, 0 to remove and 2 not upgraded.
Need to get 1449 kB of archives.
After this operation, 4196 kB of additional disk space will be used.
Get:1 http://deb.debian.org/debian bookworm/main amd64 xz-utils amd64 5.4.1-1 [471 kB]
Get:2 http://deb.debian.org/debian bookworm/main amd64 brotli amd64 1.0.9-2+b6 [277 kB]
Get:3 http://deb.debian.org/debian bookworm/main amd64 zstd amd64 1.5.4+dfsg2-5 [701 kB]
debconf: delaying package configuration, since apt-utils is not installed
Fetched 1449 kB in 0s (10.4 MB/s)
Selecting previously unselected package xz-utils.
(Reading database ... 15617 files and directories currently installed.)
Preparing to unpack .../xz-utils_5.4.1-1_amd64.deb ...
Unpacking xz-utils (5.4.1-1) ...
Selecting previously unselected package brotli.
Preparing to unpack .../brotli_1.0.9-2+b6_amd64.deb ...
Unpacking brotli (1.0.9-2+b6) ...
Selecting previously unselected package zstd.
Preparing to unpack .../zstd_1.5.4+dfsg2-5_amd64.deb ...
Unpacking zstd (1.5.4+dfsg2-5) ...
Setting up xz-utils (5.4.1-1) ...
update-alternatives: using /usr/bin/xz to provide /usr/bin/lzma (lzma) in auto mode
Setting up zstd (1.5.4+dfsg2-5) ...
Setting up brotli (1.0.9-2+b6) ...
$ echo "Installing Dart Sass ${DART_SASS_VERSION}..."
Installing Dart Sass 1.93.2...
$ curl -sLJO "https://github.com/sass/dart-sass/releases/download/${DART_SASS_VERSION}/dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz"
$ tar -C "${HOME}/.local" -xf "dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz"
$ rm "dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz"
$ export PATH="${HOME}/.local/dart-sass:${PATH}"
$ echo "Installing Hugo ${HUGO_VERSION}..."
Installing Hugo 0.145.0...
$ curl -sLJO "https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.tar.gz"
$ mkdir "${HOME}/.local/hugo"
$ tar -C "${HOME}/.local/hugo" -xf "hugo_extended_${HUGO_VERSION}_linux-amd64.tar.gz"
$ rm "hugo_extended_${HUGO_VERSION}_linux-amd64.tar.gz"
$ export PATH="${HOME}/.local/hugo:${PATH}"
$ echo "Installing Node.js ${NODE_VERSION}..."
Installing Node.js 22.18.0...
$ curl -sLJO "https://nodejs.org/dist/v${NODE_VERSION}/node-v${NODE_VERSION}-linux-x64.tar.xz"
$ tar -C "${HOME}/.local" -xf "node-v${NODE_VERSION}-linux-x64.tar.xz"
$ rm "node-v${NODE_VERSION}-linux-x64.tar.xz"
$ export PATH="${HOME}/.local/node-v${NODE_VERSION}-linux-x64/bin:${PATH}"
$ echo "Verifying installations..."
Verifying installations...
$ echo Dart Sass: $(sass --version)
Dart Sass: 1.93.2
$ echo Go: $(go version)
Go: go version go1.25.1 linux/amd64
$ echo Hugo: $(hugo version)
Hugo: hugo v0.145.0-666444f0a52132f9fec9f71cf25b441cc6a4f355+extended linux/amd64 BuildDate=2025-02-26T15:41:25Z VendorInfo=gohugoio
$ echo Node.js: $(node --version)
Node.js: v22.18.0
$ echo brotli: $(brotli --version)
brotli: brotli 1.0.9
$ echo xz: $(xz --version)
xz: xz (XZ Utils) 5.4.1 liblzma 5.4.1
$ echo zstd: $(zstd --version)
zstd: archetypes assets config content go.mod go.sum i18n layouts resources static themes Zstandard CLI (64-bit) v1.5.4, by Yann Collet archetypes assets config content go.mod go.sum i18n layouts resources static themes
$ echo "Installing Node.js dependencies..."
Installing Node.js dependencies...
$ [[ -f package-lock.json || -f npm-shrinkwrap.json ]] && npm ci --prefer-offline || true
$ echo "Configuring Git..."
Configuring Git...
$ git config core.quotepath false
$ echo "Building site..."
Building site...
$ hugo --gc --minify --baseURL "${CI_PAGES_URL}"
hugo: collected modules in 1061 msStart building sites …
hugo v0.145.0-666444f0a52132f9fec9f71cf25b441cc6a4f355+extended linux/amd64 BuildDate=2025-02-26T15:41:25Z VendorInfo=gohugoio
| FR | EN
-------------------+----+-----
Pages | 69 | 67
Paginator pages | 12 | 12
Non-page files | 0 | 0
Static files | 22 | 22
Processed images | 0 | 0
Aliases | 4 | 3
Cleaned | 6 | 6
Total in 1682 ms
$ echo "Compressing published files..."
Compressing published files...
$ find public/ -type f -regextype posix-extended -regex '.+\.(css|html|js|json|mjs|svg|txt|xml)$' -print0 > files.txt
$ time xargs --null --max-procs=0 --max-args=1 brotli --quality=10 --force --keep < files.txt
$ time xargs --null --max-procs=0 --max-args=1 gzip -9 --force --keep < files.txt
real 0m0.732s
user 0m1.130s
sys 0m0.304s
real 0m0.161s
user 0m0.084s
sys 0m0.205s
Uploading artifacts for successful job 00:02
Uploading artifacts...
public: found 714 matching artifact files and directories
Uploading artifacts as "archive" to coordinator... 201 Created correlation_id=d27da22effb14d4a8bf803257e09ef73 id=11652405392 responseStatus=201 Created token=6b_B9c_zf
Cleaning up project directory and file based variables 00:00
Job succeeded
As for the different versions it’s my bad I might have copied a log from when I tried version 141 instead of 145. I want to use 145.0 because the changes in 146 broke my css theme and I don’t know yet how to fix it. I have a workaround in my local version (hugo 151) but it only works with hugo server and not when I compile the site. I know I’ll have to dig into this but I didn’t have time for this now and it’s more important to have the youtube videos working on my website now.
Concerning the RAW html omitted warning I don’t see it in the newer logs with hugo 145. It has to do with the cloakemail module but I can safely ignore it.
Locally (hugo version 151.0), except the broken theme which needs a workaround, the hugo modules works…
Do you think it really is because of the hugo or the go versions ?
I don’t see anything mentioning the hugo module in the pipeline logs, so it seems to me that the youtube module doesn’t even compile on the gitlab version.
I know its author, @davidsneighbour is around sometimes. If you see this and have the time maybe you could help me understand how to make it work in the situation
Include a link to the source code repository of your project, because we really need the context of seeing your templates and partials to be able to help you. It is trivial to do a quick git clone on your repo, then run hugo server in your project, to help you out. On the other hand, recreating your code from screenshots, or sort of guessing at it, is not.
If you can’t share your repository for whatever reason, consider creating a dummy repo that you can share, which reproduces the problem you’re experiencing.
Edit : I was able to fix the display problem (css not loading) in newer versions of hugo so I pushed it to gitlab with hugo version 151, same as in the local version.
The hugo module works locally but still not online with the same hugo and go versions.
PS> cd topic-56064-gitlabYoutube
PS> hugo server
Watching for changes in C:\_repos\github\clone\topic-56064-gitlabYoutube\{_vendor,archetypes,assets,content,i18n,layouts,static,themes}
Watching for config changes in C:\_repos\github\clone\topic-56064-gitlabYoutube\config\_default, C:\_repos\github\clone\topic-56064-gitlabYoutube\_vendor\github.com\davidsneighbour\hugo-modules\modules\youtube\config\_default, C:\_repos\github\clone\topic-56064-gitlabYoutube\themes\hugo-coder\hugo.toml, C:\_repos\github\clone\topic-56064-gitlabYoutube\go.mod
Start building sites …
hugo v0.151.0-c70ab27ceb841fc9404eab5d2c985ff7595034b7+extended windows/amd64 BuildDate=2025-10-02T13:30:36Z VendorInfo=gohugoio
INFO build: step process substep collect files 116 files_total 116 pages_total 116 resources_total 0 duration 5.3515ms
INFO build: step process duration 5.3515ms
INFO build: step assemble duration 3.39ms
INFO static: syncing static files to \ duration 18.853ms
DEBUG Write redirect to main language fr: http://localhost:1313/fr/
INFO build: step render substep pages site fr outputFormat html duration 246.9331ms
INFO build: step render substep pages site fr outputFormat rss duration 9.3033ms
INFO build: step render substep pages site en outputFormat html duration 77.6151ms
INFO build: step render substep pages site en outputFormat rss duration 2.9577ms
INFO build: step render pages 160 content 122 duration 341.4325ms
INFO build: step render deferred count 0 duration 0s
INFO build: step postProcess duration 0s
INFO build: duration 350.174ms
│ FR │ EN
──────────────────┼────┼────
Pages │ 69 │ 67
Paginator pages │ 12 │ 12
Non-page files │ 0 │ 0
Static files │ 22 │ 22
Processed images │ 0 │ 0
Aliases │ 4 │ 3
Cleaned │ 0 │ 0
Built in 352 ms
Environment: "development"
Serving pages from disk
Running in Fast Render Mode. For full rebuilds on change: hugo server --disableFastRender
Web Server is available at http://localhost:1313/ (bind address 127.0.0.1)
Press Ctrl+C to stop
browse to these and open your developer console (F12 in Chrome)
and indeed there’s no such javascript file in your published site.
I did not dig into the shortcode code of the module, but if you copy the missing lite-yt-embed.js file to your static/libs/liteyoutube folder - all is fine and the videos play
guess there’s some code to fetch the resource from assets somewhere and publish it without defensive coding either inside the original or your customization.
update: just seen you also _vendor the modules, so you won’t get any updates …
The repo I shared is the same as my main. I just forked it because the main one needs to be private to work with gitlab pages.
To be sure I cloned the forked repo and launched hugo server(I used the exact same commands as you). And it works for me. The videos are working. The module is supposed to generate and mount the needed files, which it does for me locally.
I created a static/libs/liteyoutube folder and copied the missing file, then pushed it to gitlab. This solved the problem for the online website. The videos are loading now.
But I don’t understand why it is needed since I don’t need to for the local version. I don’t know why it’s not working for you either…
Also I won’t have updates on this file I guess…
Maybe something is missing in my .gitlab-ci.yml file to generate the module files ?
Btw you’re right, I removed the _vendor folder which is not necessary (it was here for testing purposes).
Ok I did all this before except clean my browser cache. I did it now and, you’re right, it doesn’t work. It explains why it worked for you and not for me…
That means that the public folder in my gitlab repo contains a static/libs/liteyoutube/lite-yt-embed.js file from a while ago, right ? (since I didn’t have a static/libsfolder before…
Before I mark this as solved I have one more question. Since I manually copied this file to static/libs, when the module will get updated, this file won’t be updated so I’ll need to manually get it from the module’s github and copy it there right ?
It does solve the problem, which is great. But it feels like a workaround. The module is suppose to take care loading this file into the public folder no?
Anyway thank you again for helping with this issue, it is really precious to have people like you with a better understanding of the things when you are still learning…
You need to add the following files to your pipelines
For example…
git clone --single-branch -b hugo-forum-topic-56064 https://github.com/jmooring/hugo-testing hugo-forum-topic-56064
cd hugo-forum-topic-56064
hugo server
