Chore/update hugo theme to latest upstream #599
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This reverts commit 0a48d12.
|
🎉 A preview for this PR is available at: https://preview-developer.espressif.com/pr599/ |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Description
This PR updates the versions of the software:
0.141.0to0.152.2(latest supported by Blowfish v2.86.0)v2.86.00b06a64139beba6287e7685f4c810ad4ff772fdeTue May 27 01:03:33 2025 +0100v2.92.081f0e887100f4ddc9856c6d662883b62ab7b1043Mon Nov 3 22:34:25 2025 +0000Background information
As you might know, the
espressif/blowfishrepo is added to ourdeveloper-portalrepo as a submodule in the folderthemes/blowfish/. Over time, we copied a few Blowfish layout files fromthemes/blowfish/layouts/tolayouts/and applied some changes. Comparing the files inthemes/blowfish/layouts/with our overridden versions inlayouts/revealed considerable updates in the former (submodule).We usually fast-forward the Blowfish submodule changes once in a few months and only incorporate the upstream changes from
themes/blowfish/layouts/into respective overridden files if the website fails to build or if we discover critical issues. One of such issues was non-functioning burger menu button fixed in PR #362.Although, skipping incorporation of non-critical upstream changes saves our time, it leads to accumulating maintenance debt. Ideally, we need to incorporate the upstream changes to our overriden files at least once a year.
I decided to partially incorporate the upstream changes as this will help us better prepare for implementing our own updates planned for the near future, such as adding the Dark theme and improving the main page.
This time, I did the following:
layouts/files with their repective copies inthemes/blowfish/layouts/at the time of applying these changesv2.92.0. This task usually requires considerable efforts in figuring out how to implement the changes as simple copying and pasting is usually not possible.As a result, the following files have been updated so far:
layouts/partials/article-link/card-related.htmllayouts/partials/article-link/card.htmllayouts/partials/footer.htmllayouts/partials/head.htmllayouts/partials/header/basic.htmlWith these updates, the website builds stably. No major bugs have been identified so far.
As of now, the following files are yet to be updated:
layouts/partials/hero/basic.htmllayouts/partials/toc.htmllayouts/_default/baseof.htmllayouts/_default/single.htmlRelated
Testing
Checklist
Before submitting a Pull Request, please ensure the following: