当前位置: 首页 > news >正文

WebStack-Hugo | 一个静态响应式导航主题

WebStack-Hugo | 一个静态响应式导航主题 #10

shenweiyan announced in 1.3-折腾

WebStack-Hugo | 一个静态响应式导航主题#10

​编辑shenweiyan

on Oct 23, 2023 · 6 comments · 7 replies

Return to top

shenweiyan

on Oct 23, 2023

Maintainer

Via:我给自己做了一个导航网站 | BioIT爱好者

 

📢 让更多人的人制作自己的导航网站。如果你觉得本主题对你有所帮助,欢迎请作者 喝杯咖啡 >.<

主题开源地址

GitHub | Gitee | GitCode

主题展示地址

WebStack-Hugo 网址导航 | 生信网址导航

为什么做这个网站

之所以想着要给自己倒腾一个导航网站,主要有几个原因:

  • 购买了一个域名,且也备案成功了,总想折腾点跟它有关的事情;
  • 经常在公司、家里(有时候还有其他的临时场所)更换电脑,每次同步书签(或者登陆一些导航网站)需要各种登陆,麻烦。

说干就干,从 WebStack 的开源项目开始,断断续续的折腾了好几天,终于把轮子造起来了。

webstack-apple

跟其他导航网站有什么区别

这是 Hugo 版 WebStack 主题。可以借助 Github/Gitee Pages 或者云平台直接托管部署,无需服务器。

本项目是基于纯静态的网址导航网站 webstack.cc 制作的 Hugo 主题,其中部分代码参考了以下几个开源项目:

  • https://github.com/WebStackPage/WebStackPage.github.io
  • https://github.com/liutongxu/liutongxu.github.io
  • https://github.com/iplaycode/webstack-hugo

总体说一下特点:

  • 采用了一直以来最喜欢的 hugo 部署方式,方便高效。
  • 主要的配置信息都集成到了 config.toml,一键完成各种自定义的配置。
  • 导航的各个信息都集成在 data/webstack.yml 文件中,方便后续增删改动。
- taxonomy: 科研办公icon: fas fa-flask fa-lglist:- term: 生物信息links:- title: NCBIlogo: n/ncbi.jpgurl: https://www.ncbi.nlm.nih.gov/description: National Center for Biotechnology Information.- title: Biocondalogo: b/bioconda.jpgurl: https://anaconda.org/bioconda/description: "Bioconda :: Anaconda.org."- term: 云服务器links:- title: 阿里云logo: a/aliyun.jpgurl: https://www.aliyun.com/description: 上云就上阿里云。- title: 腾讯云logo: c/cloud-tencent.jpgurl: https://cloud.tencent.com/description: 产业智变,云启未来。
  • 做了手机电脑自适应以及夜间模式。
  • 增加了搜索功能,以及下拉的热词选项(基于百度 API)。
  • 增加了一言、和风天气的 API(和风天气 API 已经官方已经不再支持,目前还没到到替代)。

Windows 下安装部署

本安装部署在 Windows 7 x64 上测试没问题,相关操作同样适用于 Windows 10,如有任何问题,欢迎留言或者微信与我联系。

第一,下载 hugo

下载链接:https://github.com/gohugoio/hugo/releases,在这里我们下载 hugo_0.89.4_Windows-64bit.zip。

download-hugo-windows

第二,解压

我们把 hugo_0.89.4_Windows-64bit.zip 下载到 F:\WebStack 目录下,然后解压到当前文件夹。

解压完成后,在该目录会多出 hugo.exeLICENSEREADME.md 三个文件:

unzip hugo_0.89.4_Windows-64bit

第三,检测是否安装成功

通过下面的方法,检测 hugo 是否安装成功。

🏷️ 温馨提示:

Windows 命令运行窗口中可以使用 Tab 进行命令行补全,例如你当前目录下有一个 WebStack-Hugo 目录,你在命令行窗口中输入一个 w 后按下 Tab 键,命令行就会自动出现 WebStack-Hugo!

使用命令行补全,可以减少代码(或者文件名)的输入,方便快捷,又能减少错误!

  1. 在 Windows 中使用 Win+R 打开“运行”对话框,在对话框中输入“cmd”,点击确认。

    win-r-cmd

  2. 在 Windows 运行窗口,先切换盘符到 F 盘,然后进入 hugo 的解压缩目录(F:\WebStack),具体操作如下。

    • 在光标处输入 F:,然后按回车;

      cmd-change-dir

    • 我们就将盘符切换为 F 盘;

      cmd-f-dir

    • 接着输入 cd WebStack,回车,就进入了 F:\WebStack 目录;使用 ls 可以看到当前目录下的文件。

      webstack-win-ls

    • 最后,输入 hugo.exe version,回车,如图所示,则代表安装成功。

      hugo-exe-version

第四,下载 WebStack-Hugo

浏览器打开 https://github.com/shenweiyan/WebStack-Hugo,点击 Code 下的 "Download ZIP",把 WebStack-hugo-main.zip 下载到刚才 hugo 解压缩的目录(F:\WebStack)。

webstack-download-zip

webstack-hugo-main-zip

第五,解压和重命名

把 WebStack-Hugo-main.zip 解压到当前目录。

webstack-hugo-main-unzip

webstack-hugo-main-rename

第六,安装主题

首先,进入 F:\WebStack 目录;

然后,创建一个 themes 的文件夹;

create-themes-dir

接着,把解压后的 WebStack-Hugo 整个文件夹移动到 themes 中。

mv-webstack-hugo-to-themes

第四,将 themes/WebStack-Hugo/exampleSite 目录下的所有文件复制到 hugo 站点根目录(即 F:\WebStack)。

cp-examplesite

第七,启动预览

在刚才已经打开的 Windows 命令运行窗口中,使用下面的命令执行 hugo server,启动站点——Hugo 可以启动一个 Web 服务器,同时构建站点内容到内存中并在检测到文件更改后重新渲染,方便我们在开发环境实时预览对站点所做的更改。

hugo.exe server

hugo-exe-server

最后,在浏览器中打开 http://127.0.0.1:1313/,即可看到生成的站点。

webstack-hugo-1313

Linux 下安装部署

安装完本 WebStack-Hugo 主题后,将 exampleSite 目录下的文件复制到 hugo 站点根目录,根据需要把 config.toml 的一些信息改成自己的,导航的网址信息可通过 data 目录下 webstack.yml 修改。

具体执行步骤如下:

mkdir /home/shenweiyan/mysite
cd /home/shenweiyan/mysite# 安装 WebStack-Hugo 主题
git clone https://github.com/shenweiyan/WebStack-Hugo.git themes/WebStack-Hugo# 将 exampleSite 目录下的文件复制到 hugo 站点根目录
cd /home/shenweiyan/mysite
cp -r themes/WebStack-Hugo/exampleSite/* ./# 启动 hugo 站点
hugo server
# 如果你知道你的公网 ip, 如下面的 132.76.230.31, 可以使用下面的方式执行 hugo server
hugo server --baseUrl=132.76.230.31 --bind=0.0.0.0

也可以参考 @jetsung 在 pull 15 所用的方法安装部署:

# 创建项目
mkdir navsites
cd $_# 初始化项目
git init# 将 WebStack-Hugo 源下载到 themes/WebStack-Hugo 文件夹
git submodule add https://github.com/shenweiyan/WebStack-Hugo.git themes/WebStack-Hugo
cp -r themes/WebStack-Hugo/exampleSite/* ./# 安装 hugo
go install github.com/gohugoio/hugo@latest# 本地测试
hugo server# 生成 docs 文件夹,将并静态内容生成至此处
hugo -D

导出 HTML 静态资源

Windows/Linux 下执行的 hugo server 命令将会通过热加载的方式临时启动一个 Hugo 服务器(Hugo 可以启动一个 Web 服务器,同时构建站点内容到内存中并在检测到文件更改后重新渲染,方便我们在开发环境实时预览对站点所做的更改),这个时候我们打开浏览器 http://127.0.0.1:1313/,就可以看到我们站点的样子了。

如果我们想要把我们的站点部署到 GitHub/Gitee Pages(或者本地的服务器),我们可以:

1. 生成静态页面内容

可以通过下面的命令,生成(构建)静态页面内容。

hugo -D 或者 hugo --minify

这个命令会默认在 public/ 目录中生成您的网站,当然您可以通过改变站点配置中的 publishDir 选项来配置这个输出目录。

🏷️ Hugo 小知识 - 草案、未来和过期内容

Hugo 允许您在网站内容的前言设定中设置文档的draftpublishdate甚至expirydate字段。默认情况下,Hugo 不会发布下面内容:

  1. publishdate 发布日期值设定在未来的内容;
  2. draft:true 草案状态设置为真的内容;
  3. expirydate 过期日期值设置为过去某事件的内容。

这三个可以在本地开发和部署编译时通过对hugohugo server分别添加如下参数来重新设定,或者在配置文件中设定对应(不包含--)域的 boolean 值:

  1. -F, --buildFuture include content with publishdate in the future
  2. -D, --buildDrafts include content marked as draft
  3. -E, --buildExpired include expired content

2. 部署站点

把生成的 public/ 静态内容目录上传到 GitHub,开启 GitHub/Gitee Pages,并且绑定 cname 域名即可。

使用说明与技巧

这是一个开源的公益项目,你可以拿来制作自己的网址导航,也可以做与导航无关的网站。

左导航栏图标

左侧、顶部导航栏图标用的都是 Font Awesome 图标库 v5 版本 Free 的图标。链接如下:

🔗 Find the Perfect Icon for Your Project in Font Awesome 5 | Font Awesome

fontawesome-v5-free

调整头部搜索栏

头部搜索栏的默认位置可以通过下面的方法进行修改。

  1. 直接修改 layouts/partials/content_search.html,调整对应部分的位置。
  2. 调整默认的搜索(即点击"常用/搜索/工具 ...." 时下指箭头的指向),把对应的 id 添加到对应的 label 里面。

set-default-search-bing

view-default-search-bing

自定义头部导航

WebStack-Hugo 把头部的导航菜单的各个信息集成在了 data/header.yml 文件中,每个人可以根据自己的需要调整。

- item: 首页icon: fa fa-homelink: "./"- item: 作者icon: fa fa-booklink: https://www.yuque.com/shenweiyan- item: 配置icon: fa fa-coglink: ""list:- name: 源码url: "#"- name: 图标url: "#"

获取网站图标

Bio & IT 网址导航默认使用的是个人收集的网站图标,主要是查看网站源码、百度、谷歌等途径把对应导航的图标下载下来,这个方法比较原始繁琐,适合导航不是很多的情况。

一为

你也可以使用一为提供的的 Favicon 图标 API:获取网站 Favicon - 免费 API 数据接口调用服务平台。

使用方法:

  1. 获取 Favicon 图标
https://api.iowen.cn/favicon/www.iowen.cn.png
  1. 刷新缓存
https://api.iowen.cn/favicon/www.iowen.cn.png?refresh=true
  1. 将上方代码中的 www.iowen.cn 替换为你需要获取的网址域名。
Favicon.im

除了一为的 API,你也可以使用 Favicon.im: Instant Website Favicon Fetcher 来在网页中插入其他网站的 Favicon 图片,可以放大显示。

favicon-im

Favicon Extractor

类似网站 Favicon Downloader,代码开源。

favicon-extractor

已知问题

  1. 日间模式与夜间模式切换时候,头部搜索栏的背景图片切换不够流畅(个人的 js 知识有限,在 footer.html 做了一些简单的调整来实现),如果你有更好的想法,欢迎 PR 或者交流。

感谢墙

本主题的部分代码参考了以下几个开源项目,特此感谢。

  • WebStackPage/WebStackPage.github.io
  • liutongxu/liutongxu.github.io
  • iplaycode/webstack-hugo

感谢 WebStack 的作者 Viggo 的肯定和推广宣传。

twitter-decohack-webstack-hugo

感谢以下所有朋友对本主题所做出的贡献。
@yanbeiyinhanghang
@jetsung

赞赏

如果你觉得本项目对你有所帮助,欢迎请作者喝杯热咖啡 >.<

donate-wecaht-aliapy

反馈与交流

最后,最重要的,秉承 WebStack 的宗旨,这是一个开源的公益项目,你可以拿来制作自己的网址导航,也可以做与导航无关的网站。

WebStack 有非常多的魔改版本,这是其中一个。

如果你对本主题进行了一些个性化调整,欢迎在本项目中 issues 中一起分享交流!

如果参考本主题构建了属于你自己的网址导航,欢迎在本评论区(或源码 issues 区)留下你网站的访问链接 >.<

Replies:6 comments · 7 replies

CharlieLZ

on Nov 14, 2023

Built in 35 ms
Environment: "development"
Serving pages from memory
Running in Fast Render Mode. For full rebuilds on change: hugo server --disableFastRender
Web Server is available at http://localhost:1313/ (bind address 127.0.0.1)
Press Ctrl+C to stop

CMD显示了这个,但是打开http://127.0.0.1:1313/ 显示的是Page Not Found

我有重命名对应文件夹,但是全部放在E盘,然后下载的是hugo_0.120.4_windows-amd64 (没有)

重新下载了hugo_0.89.4_Windows-64bit.zip

名字一模一样 问题 解决

2 replies

@shenweiyan

shenweiyanon Nov 14, 2023

MaintainerAuthor

问题解决就好 >.<

@iwrain

iwrainon Mar 9

是为什么,我也有这样的问题。

takayashoshi888

on May 20, 2024

非常好,感谢感谢

0 replies

konglquan

on Jul 15, 2024

用hugo server启动的时候 一切都是正常的,但是hugo -D 生成静态之后左侧、顶部导航栏图标不能显示了,变成了一个方块。大佬这个怎么解决,感谢。

1 reply

@shenweiyan

shenweiyanon Jul 15, 2024

MaintainerAuthor

F12 看一下对应图标的 url 链接是不是正常的,如果不正常,可以参考 shenweiyan/WebStack-Hugo#24 去排查一下。

jiespring

on Aug 22, 2024

希望安装步骤写完整一点,linux 的安装方法写详细一点。生成的网站样式错误,图片文件和样式文件加载全是404。

2 replies

@shenweiyan

shenweiyanon Aug 23, 2024

MaintainerAuthor

linux 的安装方法写详细一点,想问一下具体指的是哪个步骤?针对 404 的问题建议使用 F12 先对有问题的资源排查一下。

@jiespring

jiespringon Aug 23, 2024

linux 的安装方法写详细一点,想问一下具体指的是哪个步骤?针对 404 的问题建议使用 F12 先对有问题的资源排查一下。

按照步骤,在命令行中操作,已经重新安装成功了。
建议增加链接跳转确认页面,像知乎那样。

dsshbz

on Sep 17, 2024

想修改一下网格背景,但是为什么修改了custom-style.css这个文件后,网站样式没有变化啊。

2 replies

@dsshbz

dsshbzon Sep 17, 2024

我的地址NavNest

@shenweiyan

shenweiyanon Sep 18, 2024

MaintainerAuthor

有可能跟其他的样式发生了冲突,建议使用 F12 开发者模式调试一下,看一下具体是哪里出问题了。

musica2016

on Sep 24, 2024

这文档可以写得再清晰一点,看着有点晕啊

0 replies

Add a comment

Comment



Add your comment here...

 

Remember, contributions to this repository should follow our GitHub Community Guidelines.

Category

🛠️

1.3-折腾

Labels

语雀1.3.25-静态网站

8 participants

@shenweiyan

@jiespring

@musica2016

@CharlieLZ

@iwrain

@konglquan

@dsshbz

@takayashoshi888

Notifications

You’re not receiving notifications from this thread.

http://www.dtcms.com/a/301821.html

相关文章:

  • 回归预测 | MATLAB实现BiTCN双向时间卷积神经网络多输入单输出回归预测
  • 船舶模型预测控制路径跟踪仿真研究
  • JAVA进阶--MySQL
  • 学习游戏制作记录(改进投掷剑的行为)7.27
  • 分类预测 | MATLAB基于四种先进的优化策略改进蜣螂优化算法(IDBO)的SVM多分类预测
  • 内网后渗透攻击过程(实验环境)--4、权限维持(3)
  • 下载 | Win11 官方精简版,系统占用空间极少!(7月更新、Win 11 IoT物联网 LTSC版、适合老电脑安装使用)
  • 墨者:SQL手工注入漏洞测试(MySQL数据库)
  • 罗盘数据门户:挖掘数据价值,让数据助力更多可能
  • 洛谷 P10446 64位整数乘法-普及-
  • RTOS 基础知识
  • 打开postman后一直空白
  • mcu hardfault
  • Process Monitor学习
  • keil debug失败问题
  • 【二分查找 树状树状】P9588 「MXOI Round 2」队列|普及+
  • 7月27日打卡
  • 【0基础PS】PS工具详解--选择工具--快速选择工具
  • web刷题
  • 卸载某个软件的方法
  • ABB机器人多任务详解
  • J2EE模式---服务层模式
  • Min-Max标准化​ 和 ​Z-score标准化
  • MySQL - 索引(B+树)
  • IDEA安装Key Promoter X插件记录快捷键使用频率提高生产率
  • JavaWeb学习打卡17(监听器使用、Filter过滤器实现权限拦截案例)
  • 网络虚拟化:veth,bridge,network namespace与docker网络
  • JavaScript核心概念全解析
  • 基于CNN图像特征提取流程(简化版)
  • Python训练Day25