hugo-neso — Hugo 作品集模板

SHA-256: cb6f9e21de8fb3271fa025ecf57b1563595e1832483633b853a691a421bf0cab

2026-10-02T10:20:14.689Z

# 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.

<picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/babeneso/hugo-neso/master/images/screenshot-dark.png">
    <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/babeneso/hugo-neso/master/images/screenshot-light.png">
    <img alt="Screenshot" src="https://raw.githubusercontent.com/babeneso/hugo-neso/master/images/screenshot.png">
</picture>

(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/).

![Responsive design preview](https://raw.githubusercontent.com/babeneso/hugo-neso/master/images/screenshot-mobile.png)

![Responsive design preview](https://raw.githubusercontent.com/babeneso/hugo-neso/master/images/screenshot-2-mobile.png)


## 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 給予星星。

<picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/babeneso/hugo-neso/master/images/screenshot-dark.png">
    <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/babeneso/hugo-neso/master/images/screenshot-light.png">
    <img alt="Screenshot" src="https://raw.githubusercontent.com/babeneso/hugo-neso/master/images/screenshot.png">
</picture>

(上面預覽圖支援深 / 淺色模式，調整你的顯示器設定看看！)

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/) 檔案整理方式。

![佈景主題在行動裝置的預覽畫面](https://raw.githubusercontent.com/babeneso/hugo-neso/master/images/screenshot-mobile.png)

![佈景主題在行動裝置的預覽畫面](https://raw.githubusercontent.com/babeneso/hugo-neso/master/images/screenshot-2-mobile.png)

## 安裝與使用

[Demo 網站](https://babeneso.github.io/hugo-neso/zh-tw/)同時作為說明文件，請前往進一步了解使用方式。

> [!NOTE]  
> 此佈景主題需要 Hugo `v0.150.0` 或之後的版本


## 贊助與支持

我並非專業的軟體開發者，如果你能給我一顆星星對我會是非常大的鼓勵 🫰