NavSide Hugo静态网址导航主题源码

资源介绍

NavSide 是一个简洁、优雅且高效的 Hugo 网址导航主题，采用“匡”字结构，将侧边分类导航与卡片式网址目录结合，适合搭建个人导航、开发工具目录和常用网址收藏站。

功能特色

• 纯粹、简洁的导航界面，不预置搜索和热门新闻等额外栏目。
• 支持卡片式切换类目，网址目录可设置一级分类和二级分类。
• 支持 Font Awesome 5.15.4 与 Bootstrap Icons 1.11.3 图标。
• 支持顶部导航、左侧导航和友情链接配置，网址卡片可填写标题、图标、描述与链接。
• 适配电脑与手机，支持明暗显示模式、侧栏展开设置和预加载展示。
• 由 Hugo 生成静态文件，可部署到常见静态托管平台或自己的 Web 服务器。

主题默认不加载第三方统计脚本；网站统计可按需接入站长自己的服务。截图展示主题布局，示例目录内容可自行替换。

安装环境

需要 Hugo。本项目未声明明确的最低 Hugo 版本，建议使用与当前模板兼容的稳定版本。本主题为静态导航站模板，不依赖数据库或独立管理后台。

安装说明

1. 新建自己的 Hugo 项目，将源码放入项目的 themes/navside 目录，保持 layouts、static、theme.toml 等主题文件的目录结构。
2. 将主题内 exampleSite/config.toml 与 exampleSite/data 复制到自己项目的根目录，形成 config.toml 与 data/。检查并移除示例中的 themesDir 配置，确保 theme 指向 navside。
3. 在 config.toml 中填写自己的 baseURL、网站标题、描述、Logo 与展示设置，baseURL 应使用自己的站点域名。
4. 编辑 data/headers.yml 设置顶部导航，data/friendlinks.yml 设置友情链接，data/navsites.yml 设置分类和网址卡片。
5. 网站图标按 logosPath 配置保存在 static/assets/images/logos，也可填写自己的图标地址。
6. 在项目根目录执行 hugo server 进行本地预览；修改内容后执行 hugo --minify 构建，将生成的 public/ 静态文件部署到自己的站点。

若使用包内可选的 .deploy.sh 辅助脚本，请先阅读脚本说明，准备支持 GNU realpath 的环境，并确认输出目录为自己的 Hugo 项目目录。常规 Hugo 预览与构建无需执行此脚本。

开源许可

项目作者为 Jetsung Chan，使用 Apache License 2.0。完整 LICENSE、版权声明和原项目署名随源码提供。

更多免费源码、AI资源和实用文章，欢迎访问烛九资源网。