https://github.com/babeneso/hugo-neso
Neso is a carefully crafted Hugo theme that delivers a refined experience in a minimal aesthetic.
https://github.com/babeneso/hugo-neso
blog dark-mode design hugo hugo-theme landing-page personal-website responsive-design ssg tailwind tailwindcss
Last synced: 2 months ago
JSON representation
Neso is a carefully crafted Hugo theme that delivers a refined experience in a minimal aesthetic.
- Host: GitHub
- URL: https://github.com/babeneso/hugo-neso
- Owner: babeneso
- License: mit
- Created: 2025-10-12T12:30:04.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-10-14T21:39:28.000Z (8 months ago)
- Last Synced: 2025-11-27T09:18:42.281Z (7 months ago)
- Topics: blog, dark-mode, design, hugo, hugo-theme, landing-page, personal-website, responsive-design, ssg, tailwind, tailwindcss
- Language: HTML
- Homepage: https://babeneso.github.io/hugo-neso/
- Size: 13 MB
- Stars: 5
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Hugo Neso Theme
Clean and modern — fully responsive with light/dark mode, Tailwind built in for easy customization, and solid SEO.
**[View the demo site](https://babeneso.github.io/hugo-neso/)**
> This theme is derived from “[PaperMod](https://github.com/adityatelange/hugo-PaperMod)” with modifications. Special thanks to the original author, please visit the repo and give it a star.
(The preview above supports light and dark modes, try adjusting your display settings to see it switch!)
Neso is a carefully crafted Hugo theme that delivers a refined experience in a minimal aesthetic. It's lightweight and fast, fully responsive, supports light/dark mode, and offers easy theming via built‑in Tailwind and parameterized CSS; thoughtful SEO defaults help your content get discovered.
## Highlights
- Neutral, modern, minimal design.
- Fibonacci‑based spacing rhythm for natural, pleasing typography.
- Consistent icon sizing and precise alignment throughout.
- Fully responsive design with elegant main‑menu transitions.
- Light/dark mode, with graceful behavior even without JavaScript.
- Direction‑aware icons render correctly in RTL locales.
- Thoughtful accessibility support.
- Readable, polished code blocks with copy‑to‑clipboard.
- Supports GitHub Markdown [Alert](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-syntax#alerts) syntax.
- Three home layouts: Profile, Intro, and Fully Custom.
- Tailwind CSS 4 integration with a refined Typography (Prose) setup.
- Parameterized CSS design tokens for easy customization.
- OG Image, X Card, and JSON‑LD structured data.
- Prewired favicon and PWA `manifest.json`, just drop in your icons.
- Built‑in search (powered by [Fuse.js](https://github.com/krisk/fuse)).
- Archives page included.
- Organized to match Hugo’s [new template system](https://gohugo.io/templates/new-templatesystem-overview/).
## Installation & Usage
The [demo site](https://babeneso.github.io/hugo-neso/) also serves as documentation, please visit it to learn more.
> [!NOTE]
> This theme requires Hugo `v0.150.0` or later.
## Support
I’m not a professional software developer; if you could give the project a star, it would mean a lot to me. 🫰
---
# Chinese
簡潔、現代 – 具備 RWD 與明／暗色模式，整合 Tailwind 易於客製，並有穩健的 SEO 表現。
**[瀏覽 Demo 站](https://babeneso.github.io/hugo-neso/zh-tw/)**
> 此佈景主題基於「[PaperMod](https://github.com/adityatelange/hugo-PaperMod)」修改製作而成，特別感謝原作者，請務必前往該 Repo 給予星星。
(上面預覽圖支援深 / 淺色模式，調整你的顯示器設定看看！)
Neso 是精心設計的 Hugo 佈景主題，以極簡風格呈現細膩的網站體驗。輕量快速，具備 RWD、深淺色模式，透過內建的 Tailwind 與參數化 CSS 輕鬆調整風格；並有完善的 SEO 設定，讓你的內容更容易被看見。
## 亮點功能
- 中性、現代、簡約的設計。
- 基於費氏數列的排版間距，內容韻律美觀自然。
- 各處 icon 視覺大小一致，皆完美對齊。
- 完整的響應式設計、精美的主選單轉場動畫。
- 支援淺 / 深色模式，即使無 JavaScript 也可正常作用。
- 所有與方向相關的 icon 在 RTL 環境皆能正確地指向。
- 細膩的 accessibility 支援。
- 閱讀體驗極佳的程式碼展示區塊，包含複製功能。
- 可使用 GitHub Markdown [Alert](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#alerts) 語法。
- 三種首頁排版可選：個人頁面模式、簡介模式、全自訂模式。
- 整合 Tailwind CSS 4 與經過改良的 Typography plugin (Prose)。
- 參數化的 CSS 設定，易於客製化。
- OG Image、X Card，與 JSON-LD 結構化資料。
- 已設定完成的 Favicon 與 PWA `manifest.json`，你只需要放置圖片。
- 具備搜尋功能 (感謝 [Fuse.js](https://github.com/krisk/fuse))
- 具備文章彙整頁面。
- 符合[新版的 template system](https://gohugo.io/templates/new-templatesystem-overview/) 檔案整理方式。
## 安裝與使用
[Demo 網站](https://babeneso.github.io/hugo-neso/zh-tw/)同時作為說明文件，請前往進一步了解使用方式。
> [!NOTE]
> 此佈景主題需要 Hugo `v0.150.0` 或之後的版本
## 贊助與支持
我並非專業的軟體開發者，如果你能給我一顆星星對我會是非常大的鼓勵 🫰