Skip to content

idevsig/navside

Folders and files

NameName
Last commit message
Last commit date

Latest commit

665a8b4 · Feb 26, 2025

History

14 Commits
Feb 19, 2025
Feb 24, 2025
Feb 24, 2025
Feb 26, 2025
Feb 24, 2025
Feb 24, 2025
Feb 3, 2025
Feb 2, 2025
Feb 24, 2025
Feb 24, 2025
Feb 20, 2025
Feb 20, 2025
Feb 24, 2025

Repository files navigation

NavSide

NavSide 是一个简洁、优雅且高效的 Hugo 网址导航主题

特征

  • 字结构主题
  • 纯粹、简洁,无搜索、热门新闻等多余的功能
  • 支持卡片式切换类目
  • 支持 Font Awesome 5.15.4 图标
  • 支持 Bootstrap Icons 1.11.3 图标
  • 支持 51.LA 网站统计

预览图

NavSide 主题手机版

NavSide 主题

演示

hugo serve --source=exampleSite

使用教程

  1. 创建新项目
mkdir mynav
cd mynav
git init
  1. 安装此主题

在项目根目录下运行:

# 添加主题(未添加此主题时)
git submodule add https://github.com/idevsig/navside.git themes/navside

# 首次使用(首次从 Git 拉取代码时)
git submodule update --init --recursive

# 拉取当前主题最新代码
git submodule update --remote themes/navside

# 拉取所有最新主题代码
git submodule foreach git pull origin main
  1. 复制 exampleSite
cp -r themes/navside/exampleSite/* .
  1. 设置数据
content
├── friendlinks.yml # 友情链接(左下)
├── headers.yml     # 顶部导航(顶部)
└── navsites.yml    # 网址列表 (中间)
  • friendlinks.yml 格式:
- title: 杰森
  url: https://i.jetsung.com/
  description: 个人网站    
  • headers.yml 格式:
- item: 主页
  icon: fas fa-blog
  link: "https://i.jetsung.com"
  target: _blank 

- item: 源码
  icon: fab fa-git
  list:
    - name: Code
      url: "https://git.jetsung.com/jetsung"
      target: _blank 
  • navsites.yml 格式:
- taxonomy: 杰森
  icon: bi bi-star-fill
  list:
    - term: 社交
      links:
        - title: 爱开发
          logo: idev.png
          favicon:
          url: https://www.idev.top/
          description: 开发者技术资讯网站
          qrcode:

- taxonomy: 杰森 # 一级目录
  icon: bi bi-star-fill # 一级目录图标。支持 `Font Awesome` 和 `Bootstrap Icons` 图标
  list: # 列表
    - term: 社交 # 二级目录
      links: 
        - title: 爱开发 # 网站标题
          logo: idev.png # 网站图标名称
          favicon: # 网络上的网站图标网址。若未配置此链接,则网站图标通过网络获取,通过 .deploy.sh 拉取
          url: https://www.idev.top/ # 网站链接
          description: 开发者技术资讯网站 # 网站描述
          qrcode: # 二维码
  1. *图标保存位置(根据 config.tomllogosPath 参数)
mkdir -p static/assets/images/logos

可自行将网站的图标保存至此处。可参考 .deploy.sh,通过 API 方式获取图标。

  1. 配置 config.toml
    删除 themesDir 此行
sed -i '/themesDir/d' config.toml
  1. 运行本地测试
hugo serve
  1. 构建项目
hugo build --minify
  1. *复制其它文件
cp themes/navside/{.gitignore,.deploy.sh} . 

仓库镜像

Author

Jetsung Chan