From 3c7fef6ba39bdedb93940488500e93c84b9ca362 Mon Sep 17 00:00:00 2001 From: Aditya Telange <21258296+adityatelange@users.noreply.github.com> Date: Sat, 11 Apr 2026 12:28:01 +0530 Subject: [PATCH 01/12] Update README.md and adjust shield labels and resource table layout --- README.md | 62 +++++++++++++++++++++---------------------------------- 1 file changed, 24 insertions(+), 38 deletions(-) diff --git a/README.md b/README.md index 9fc46f0345..678df9ae4d 100644 --- a/README.md +++ b/README.md @@ -3,18 +3,16 @@ **A fast, clean, and responsive theme for [Hugo](https://gohugo.io/).** [![hugo-papermod](https://img.shields.io/badge/Hugo--Themes-@PaperMod-blue)](https://themes.gohugo.io/themes/hugo-papermod/) -[![Minimum Hugo Version](https://img.shields.io/static/v1?label=min-HUGO-version&message=>=v0.146.0&color=blue&logo=hugo)](https://github.com/gohugoio/hugo/releases/tag/v0.146.0) +[![Minimum Hugo Version](https://img.shields.io/static/v1?label=Hugo&message=v0.146.0%2B&color=blue&logo=hugo)](https://github.com/gohugoio/hugo/releases/tag/v0.146.0) [![Discord](https://img.shields.io/discord/971046860317921340?label=Discord&logo=discord)](https://discord.gg/ahpmTvhVmp) -[![GitHub](https://img.shields.io/github/license/adityatelange/hugo-PaperMod)](https://github.com/adityatelange/hugo-PaperMod/blob/master/LICENSE) -![code-size](https://img.shields.io/github/languages/code-size/adityatelange/hugo-PaperMod) > Based on [hugo-paper](https://github.com/nanxiaobei/hugo-paper/tree/4330c8b12aa48bfdecbcad6ad66145f679a430b3), with additional features and customization options. -| Resource | Link | -|----------|------| -| Live Demo | [adityatelange.github.io/hugo-PaperMod](https://adityatelange.github.io/hugo-PaperMod/) | -| Documentation | [Wiki](https://github.com/adityatelange/hugo-PaperMod/wiki) | -| Example Site Source | [exampleSite branch](https://github.com/adityatelange/hugo-PaperMod/tree/exampleSite) | +| Resource | Link | +| ------------------- | --------------------------------------------------------------------------------------- | +| Live Demo | [adityatelange.github.io/hugo-PaperMod](https://adityatelange.github.io/hugo-PaperMod/) | +| Documentation 📚 | [Wiki](https://github.com/adityatelange/hugo-PaperMod/wiki) | +| Example Site Source | [exampleSite branch](https://github.com/adityatelange/hugo-PaperMod/tree/exampleSite) |

Mockup image @@ -22,7 +20,9 @@ --- -## Features +## Features 💥 + +`☄️ Fast | ☁️ Fluent | 🌙 Smooth | 📱 Responsive` - **Asset pipeline** -- Hugo's built-in asset generator with fingerprinting, bundling, and minification. - **Three layout modes** -- [Regular](https://github.com/adityatelange/hugo-PaperMod/wiki/Features#regular-mode-default-mode), [Home-Info](https://github.com/adityatelange/hugo-PaperMod/wiki/Features#home-info-mode), and [Profile](https://github.com/adityatelange/hugo-PaperMod/wiki/Features#profile-mode). @@ -40,41 +40,27 @@ - **Related post suggestions** - **Zero JS build dependencies** -- No webpack, Node.js, or other tooling required. -For the full list, see the **[Features wiki page](https://github.com/adityatelange/hugo-PaperMod/wiki/Features)**. - ---- - -## Installation - -Detailed installation and update instructions are available in the **[Installation guide](https://github.com/adityatelange/hugo-PaperMod/wiki/Installation)**. - ---- - -## FAQs and How-To Guides - -Common questions and configuration walkthroughs are covered in the **[FAQ wiki](https://github.com/adityatelange/hugo-PaperMod/wiki/FAQs)**. +| Topic | Description | +| ------------------------------------------------------------------------------------------------- | ----------------------------------------------- | +| **[Installation guide](https://github.com/adityatelange/hugo-PaperMod/wiki/Installation)** | Detailed installation and update instructions | +| **[Features wiki page](https://github.com/adityatelange/hugo-PaperMod/wiki/Features)** | In-depth explanations of all features | +| **[FAQ wiki](https://github.com/adityatelange/hugo-PaperMod/wiki/FAQs)** | Common questions and configuration walkthroughs | +| **[Icons wiki](https://github.com/adityatelange/hugo-PaperMod/wiki/Icons)** | Documentation for social icons and share icons | +| **[Variables wiki](https://github.com/adityatelange/hugo-PaperMod/wiki/Variables)** | List of all available template variables | +| **[Overiding templates](https://github.com/adityatelange/hugo-PaperMod/wiki/Template_Overrides)** | Guide to customizing templates without forking | +| **[Releases](https://github.com/adityatelange/hugo-PaperMod/releases)** | Detailed history of releases | --- -## Icons - -Documentation for social icons and share icons can be found in the **[Icons wiki](https://github.com/adityatelange/hugo-PaperMod/wiki/Icons)**. - ---- - -## Changelog - -See **[Releases](https://github.com/adityatelange/hugo-PaperMod/releases)** for a detailed history of changes. - ---- - -## Performance +## Performance ☄️ PaperMod consistently scores near-perfect results on [Pagespeed Insights](https://pagespeed.web.dev/report?url=https://adityatelange.github.io/hugo-PaperMod/). +image + --- -## Support +## Support 🫶 - Star this repository to show your support. - Share PaperMod with others who might find it useful. @@ -82,7 +68,7 @@ PaperMod consistently scores near-perfect results on [Pagespeed Insights](https: --- -## Acknowledgements +## Special Thanks 🌟 - [Highlight.js](https://github.com/highlightjs/highlight.js) - [Fuse.js](https://github.com/krisk/fuse) @@ -92,6 +78,6 @@ PaperMod consistently scores near-perfect results on [Pagespeed Insights](https: --- -## Stargazers +## Stargazers 📈 [![Stargazers over time](https://starchart.cc/adityatelange/hugo-PaperMod.svg?background=%23ffffff00&axis=%23858585&line=%236b63ff)](https://starchart.cc/adityatelange/hugo-PaperMod) From 84385318607f2e8c5aea9acd0f0680a7a5f69049 Mon Sep 17 00:00:00 2001 From: Aditya Telange <21258296+adityatelange@users.noreply.github.com> Date: Sat, 11 Apr 2026 12:41:03 +0530 Subject: [PATCH 02/12] Remove scrollbar styles and related conditions from head.html - Deprecates var `site.Params.assets.disableScrollBarStyle` --- assets/css/includes/scroll-bar.css | 59 ------------------------------ layouts/partials/head.html | 11 ------ 2 files changed, 70 deletions(-) delete mode 100644 assets/css/includes/scroll-bar.css diff --git a/assets/css/includes/scroll-bar.css b/assets/css/includes/scroll-bar.css deleted file mode 100644 index 1e0656e097..0000000000 --- a/assets/css/includes/scroll-bar.css +++ /dev/null @@ -1,59 +0,0 @@ -/* from reset */ -::-webkit-scrollbar-track { - background: 0 0; -} - -::-webkit-scrollbar-thumb { - background: var(--tertiary); - border: 5px solid var(--theme); - border-radius: var(--radius); -} - -[data-theme="light"] .list::-webkit-scrollbar-thumb { - border: 5px solid var(--code-bg); -} - -::-webkit-scrollbar-thumb:hover { - background: var(--secondary); -} - -::-webkit-scrollbar:not(.highlighttable, .highlight table, .gist .highlight) { - background: var(--theme); -} - -/* from post-single */ -.md-content .highlighttable td .highlight pre code::-webkit-scrollbar { - display: none; -} - -.md-content :not(table) ::-webkit-scrollbar-thumb { - border: 2px solid var(--code-block-bg); - background: rgb(113, 113, 117); -} - -.md-content :not(table) ::-webkit-scrollbar-thumb:hover { - background: rgb(163, 163, 165); -} - -.gist table::-webkit-scrollbar-thumb { - border: 2px solid rgb(255, 255, 255); - background: rgb(173, 173, 173); -} - -.gist table::-webkit-scrollbar-thumb:hover { - background: rgb(112, 112, 112); -} - -.md-content table::-webkit-scrollbar-thumb { - border-width: 2px; -} - -/* from zmedia */ -@media screen and (min-width: 768px) { - - /* reset */ - ::-webkit-scrollbar { - width: 19px; - height: 11px; - } -} diff --git a/layouts/partials/head.html b/layouts/partials/head.html index 565709b47a..9edc894b4d 100644 --- a/layouts/partials/head.html +++ b/layouts/partials/head.html @@ -42,11 +42,6 @@ {{- $includes := slice }} {{- $includes = $includes | append (" " | resources.FromString "assets/css/includes-blank.css")}} -{{- if not (eq site.Params.assets.disableScrollBarStyle true) }} - {{- $ScrollStyle := (resources.Get "css/includes/scroll-bar.css") }} - {{- $includes = (append $ScrollStyle $includes) }} -{{- end }} - {{- $includes_all := $includes | resources.Concat "assets/css/includes.css" }} {{- $theme_vars := (resources.Get "css/core/theme-vars.css") }} @@ -139,12 +134,6 @@ } } - @media (prefers-color-scheme: light) { - .list::-webkit-scrollbar-thumb { - border-color: var(--code-bg); - } - } - {{- end }} From 730ab0de355b075301bbe0f6ee84fa082a69328f Mon Sep 17 00:00:00 2001 From: Aditya Telange <21258296+adityatelange@users.noreply.github.com> Date: Sat, 11 Apr 2026 13:02:59 +0530 Subject: [PATCH 03/12] Remove focus outline 0 from footer and search styles --- assets/css/common/footer.css | 5 ----- assets/css/common/post-single.css | 4 ---- assets/css/common/search.css | 1 - 3 files changed, 10 deletions(-) diff --git a/assets/css/common/footer.css b/assets/css/common/footer.css index 5addb1e0fb..5f65cb2113 100644 --- a/assets/css/common/footer.css +++ b/assets/css/common/footer.css @@ -53,8 +53,3 @@ .top-link:hover { color: var(--primary); } - -.top-link:focus, -#theme-toggle:focus { - outline: 0; -} diff --git a/assets/css/common/post-single.css b/assets/css/common/post-single.css index 34a0847240..b21b9b0f19 100644 --- a/assets/css/common/post-single.css +++ b/assets/css/common/post-single.css @@ -82,10 +82,6 @@ margin-inline-start: var(--gap); } -.toc summary:focus { - outline: 0; -} - .post-content { color: var(--content); margin: 30px 0; diff --git a/assets/css/common/search.css b/assets/css/common/search.css index 38d5b6bc41..bba7c1b388 100644 --- a/assets/css/common/search.css +++ b/assets/css/common/search.css @@ -36,7 +36,6 @@ height: 100%; top: 0px; left: 0px; - outline: none; } #searchResults .focus { From 7ca348827e9d744504135095afa18de8d2e58000 Mon Sep 17 00:00:00 2001 From: Aditya Telange <21258296+adityatelange@users.noreply.github.com> Date: Sat, 11 Apr 2026 13:07:30 +0530 Subject: [PATCH 04/12] Update terms.html to use LinkTitle instead of Name --- layouts/_default/terms.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/layouts/_default/terms.html b/layouts/_default/terms.html index 6fd26540b7..2c723c5739 100644 --- a/layouts/_default/terms.html +++ b/layouts/_default/terms.html @@ -18,7 +18,7 @@

{{ .Title }}

{{- $count := .Count }} {{- with site.GetPage (printf "/%s/%s" $type $name) }}
  • - {{ .Name }} {{ $count }} + {{ .LinkTitle }} {{ $count }}
    • {{- end }} {{- end }} From fb9b5984fa94831165362ce4c3d08d97780175c2 Mon Sep 17 00:00:00 2001 From: Aditya Telange <21258296+adityatelange@users.noreply.github.com> Date: Sat, 11 Apr 2026 13:12:06 +0530 Subject: [PATCH 05/12] Enhance terms-tags styles for better layout and spacing --- assets/css/common/terms.css | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/assets/css/common/terms.css b/assets/css/common/terms.css index 244614bc99..d04c603548 100644 --- a/assets/css/common/terms.css +++ b/assets/css/common/terms.css @@ -1,12 +1,18 @@ +.terms-tags { + display: flex; + flex-wrap: wrap; + gap: 20px; + margin-top: var(--content-gap); +} + .terms-tags li { display: inline-block; - margin: 10px; font-weight: 500; } .terms-tags a { display: block; - padding: 3px 10px; + padding: 4px 10px; background: var(--tertiary); border-radius: 6px; transition: transform 0.1s; From 96f8b27fd101fd543a9405aad373b509b6ed8552 Mon Sep 17 00:00:00 2001 From: Aditya Telange <21258296+adityatelange@users.noreply.github.com> Date: Sat, 11 Apr 2026 13:37:38 +0530 Subject: [PATCH 06/12] Update profile mode styles for improved spacing - Change gap in profile_inner from 10px to 1rem - Adjust button styles for consistent padding --- assets/css/common/profile-mode.css | 15 +++------------ 1 file changed, 3 insertions(+), 12 deletions(-) diff --git a/assets/css/common/profile-mode.css b/assets/css/common/profile-mode.css index 9e98df55b4..8f6d18384d 100644 --- a/assets/css/common/profile-mode.css +++ b/assets/css/common/profile-mode.css @@ -14,7 +14,7 @@ display: flex; flex-direction: column; align-items: center; - gap: 10px; + gap: 1rem; } .profile img { @@ -24,20 +24,11 @@ .buttons { flex-wrap: wrap; max-width: 400px; + gap: 1rem; } .button { background: var(--tertiary); border-radius: var(--radius); - margin: 8px; - padding: 6px; - transition: transform 0.1s; -} - -.button-inner { - padding: 0 8px; -} - -.button:active { - transform: scale(0.96); + padding: 0.4rem 0.8rem; } From adc2d0af8130b766b5e03d9cd6325594f4930992 Mon Sep 17 00:00:00 2001 From: Aditya Telange <21258296+adityatelange@users.noreply.github.com> Date: Sat, 11 Apr 2026 13:38:14 +0530 Subject: [PATCH 07/12] Fix social icon padding in main and post-entry styles --- assets/css/common/main.css | 4 ---- assets/css/common/post-entry.css | 5 +++++ 2 files changed, 5 insertions(+), 4 deletions(-) diff --git a/assets/css/common/main.css b/assets/css/common/main.css index c6dc887f19..25ae4dae59 100644 --- a/assets/css/common/main.css +++ b/assets/css/common/main.css @@ -33,10 +33,6 @@ padding: 10px; } -.social-icons a:first-of-type { - padding-inline-start: 0; -} - .social-icons a svg { height: 26px; width: 26px; diff --git a/assets/css/common/post-entry.css b/assets/css/common/post-entry.css index 5ca7d7702c..d6a83138b3 100644 --- a/assets/css/common/post-entry.css +++ b/assets/css/common/post-entry.css @@ -38,6 +38,11 @@ margin: 0; } +.home-info .social-icons a:first-of-type { + padding-inline-start: 0; +} + + .post-entry { position: relative; margin-bottom: var(--gap); From c17406565e906459b0879b2c5238c81f265c6202 Mon Sep 17 00:00:00 2001 From: Aditya Telange <21258296+adityatelange@users.noreply.github.com> Date: Sat, 11 Apr 2026 14:10:28 +0530 Subject: [PATCH 08/12] Update footer styles for improved scroll-to-top button - Adjust top-link padding and transition effects - Replace SVG icon with a more detailed chevron design --- assets/css/common/footer.css | 4 ++-- layouts/partials/footer.html | 6 ++++-- 2 files changed, 6 insertions(+), 4 deletions(-) diff --git a/assets/css/common/footer.css b/assets/css/common/footer.css index 5f65cb2113..80d2ba0f45 100644 --- a/assets/css/common/footer.css +++ b/assets/css/common/footer.css @@ -39,9 +39,9 @@ background: var(--tertiary); width: 42px; height: 42px; - padding: 12px; + padding: 10px; border-radius: 64px; - transition: visibility 0.5s, opacity 0.8s linear; + transition: visibility .3s, opacity .3s cubic-bezier(0.4, 0, 1, 1); } .top-link, diff --git a/layouts/partials/footer.html b/layouts/partials/footer.html index 6d05117032..929aad39b6 100644 --- a/layouts/partials/footer.html +++ b/layouts/partials/footer.html @@ -24,8 +24,10 @@ {{- if (not site.Params.disableScrollToTop) }} - - + + + {{- end }} From 67f02cdc8520aa9625118eebedfb70255894c887 Mon Sep 17 00:00:00 2001 From: Aditya Telange <21258296+adityatelange@users.noreply.github.com> Date: Sat, 11 Apr 2026 14:14:10 +0530 Subject: [PATCH 09/12] Update Hugo version default to latest in gh-pages workflow --- .github/workflows/gh-pages.yml | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/.github/workflows/gh-pages.yml b/.github/workflows/gh-pages.yml index c36e6cef1b..8378a371e5 100644 --- a/.github/workflows/gh-pages.yml +++ b/.github/workflows/gh-pages.yml @@ -15,7 +15,7 @@ on: hugoVersion: description: "Hugo Version" required: false - default: "0.146.0" + default: "latest" # Allow one concurrent deployment concurrency: @@ -34,8 +34,14 @@ jobs: contents: read runs-on: ubuntu-latest env: - HUGO_VERSION: ${{ github.event.inputs.hugoVersion || '0.146.0' }} + HUGO_VERSION: ${{ github.event.inputs.hugoVersion || 'latest' }} steps: + - name: Resolve Hugo version + run: | + if [ "${HUGO_VERSION}" = "latest" ]; then + HUGO_VERSION=$(curl -s https://api.github.com/repos/gohugoio/hugo/releases/latest | grep '"tag_name"' | sed 's/.*"v\([^"]*\)".*/\1/') + echo "HUGO_VERSION=${HUGO_VERSION}" >> $GITHUB_ENV + fi - name: Install Hugo CLI run: | wget -O ${{ runner.temp }}/hugo.deb https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_${HUGO_VERSION}_linux-amd64.deb \ From 1b45b3f6a113a46b1b13599b8f6395c8669e3332 Mon Sep 17 00:00:00 2001 From: Aditya Telange <21258296+adityatelange@users.noreply.github.com> Date: Sat, 11 Apr 2026 14:21:17 +0530 Subject: [PATCH 10/12] Update Go version to 1.16 in go.mod --- go.mod | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/go.mod b/go.mod index af95855690..4a7947141d 100644 --- a/go.mod +++ b/go.mod @@ -1,3 +1,3 @@ module github.com/adityatelange/hugo-PaperMod -go 1.12 +go 1.16 From a05b4773409b17ddd228bc03b7c3ca80d2d98f81 Mon Sep 17 00:00:00 2001 From: Aditya Telange <21258296+adityatelange@users.noreply.github.com> Date: Sat, 11 Apr 2026 14:31:33 +0530 Subject: [PATCH 11/12] Refactor CSS class names for consistency and clarity - Update selectors from IDs to classes in header, search, and zmedia styles. - Ensure consistent usage of class names across relevant files. --- assets/css/common/header.css | 16 ++++++++-------- assets/css/common/search.css | 14 +++++++------- assets/css/core/zmedia.css | 4 ++-- layouts/_default/search.html | 4 ++-- layouts/partials/header.html | 8 ++++---- 5 files changed, 23 insertions(+), 23 deletions(-) diff --git a/assets/css/common/header.css b/assets/css/common/header.css index 689643334a..7ca29352bc 100644 --- a/assets/css/common/header.css +++ b/assets/css/common/header.css @@ -13,7 +13,7 @@ } .logo, -#menu { +.menu { display: flex; margin: auto var(--gap); } @@ -36,35 +36,35 @@ margin-inline-end: 8px; } -button#theme-toggle { +.theme-toggle { font-size: 26px; margin: auto 4px; } -[data-theme="dark"] #moon { +[data-theme="dark"] .moon { display: none; } -[data-theme="light"] #sun { +[data-theme="light"] .sun { display: none; } -#menu { +.menu { list-style: none; word-break: keep-all; overflow-x: auto; white-space: nowrap; } -#menu li + li { +.menu li + li { margin-inline-start: var(--gap); } -#menu a { +.menu a { font-size: 16px; } -#menu .active { +.menu .active { font-weight: 500; border-bottom: 2px solid currentColor; } diff --git a/assets/css/common/search.css b/assets/css/common/search.css index bba7c1b388..5ea9d3b036 100644 --- a/assets/css/common/search.css +++ b/assets/css/common/search.css @@ -1,4 +1,4 @@ -#searchbox input { +.searchbox input { padding: 4px 10px; width: 100%; color: var(--primary); @@ -7,11 +7,11 @@ border-radius: var(--radius); } -#searchbox input:focus { +.searchbox input:focus { border-color: var(--secondary); } -#searchResults li { +.searchResults li { list-style: none; border-radius: var(--radius); padding: 10px; @@ -20,17 +20,17 @@ font-weight: 500; } -#searchResults { +.searchResults { margin: 10px 0; width: 100%; } -#searchResults li:active { +.searchResults li:active { transition: transform 0.1s; transform: scale(0.98); } -#searchResults a { +.searchResults a { position: absolute; width: 100%; height: 100%; @@ -38,7 +38,7 @@ left: 0px; } -#searchResults .focus { +.searchResults .focus { transform: scale(0.98); border: 2px solid var(--tertiary); } diff --git a/assets/css/core/zmedia.css b/assets/css/core/zmedia.css index a68fd7189e..6a3355e204 100644 --- a/assets/css/core/zmedia.css +++ b/assets/css/core/zmedia.css @@ -48,8 +48,8 @@ .button:active, .post-entry:active, .top-link, - #searchResults .focus, - #searchResults li:active { + .searchResults .focus, + .searchResults li:active { transform: none; } } diff --git a/layouts/_default/search.html b/layouts/_default/search.html index bb7d436dcb..fc1b518c10 100644 --- a/layouts/_default/search.html +++ b/layouts/_default/search.html @@ -20,10 +20,10 @@

    {{- (printf "%s " .Title ) | htmlUnescape -}} {{- end }} - {{- $currentPage := . }} -