优雅的使用Webstack打造个人网址导航

原文链接:优雅的使用Webstack打造个人网址导航

前言

一款基于 WebStackPage 的 Hexo 主题。本人选择的是 hexo-theme-webstack

效果预览

具体效果请移步 个人网址导航


步骤

  1. 在目标路径(我这里选的路径为【D:/studytype/My_Blog】)打开cmd命令窗口,执行hexo init初始化项目。

    hexo init Nav_Tzy(项目名)
  2. 进入Nav_Tzy ,输入npm i安装相关依赖。

    cd Nav_Tzy  //进入Nav_Tzy文件夹
    npm i

    执行完命令之后,文件目录大概如下图:

    【node_modules】:依赖包
    【scaffolds】:生成文章的一些模板
    【source】:用来存放你的文章
    【themes】:主题
    【.npmignore】:发布时忽略的文件(可忽略)
    【_config.landscape.yml】:主题的配置文件
    【_config.yml】:博客的配置文件
    【package.json】:项目名称、描述、版本、运行和开发等信息

  3. 安装主题

    # hexo >= 4.0 
    git clone https://github.com/HCLonely/hexo-theme-webstack themes/webstack
    # hexo >= 5.0  
    npm install hexo-theme-webstack -S
  4. 应用主题
    修改站点配置文件_config.yml,把主题改为webstack,注意这里初始值是landscape

    theme: webstack

    将根目录下_config.landscape.yml改名为_config.webstack.yml
    将【D:/studytype/My_Blog/Nav_Tzy/node_modules/hexo-theme-webstack】下的_config.example.yml中的内容复制到根目录下的_config.webstack.yml

  5. 编译运行

    hexo g && hexo s

    打开浏览器,输入地址:http://localhost:4000/,即可看到如下效果:

配置

网站图标

favicon: /favicon.ico

banner

banner: /images/webstack_banner_cn.png

网站 logo

  • expanded: 侧边栏展开式左上角的 logo
  • collapsed: 侧边栏收起式左上角的 logo
  • dark: 顶栏为暗色时左上角的 logo, 仅 about 页面生效
logo:
  expanded: /images/logo@2x.png
  collapsed: /images/logo-collapsed@2x.png
  dark: /images/logo_dark@2x.png

flag

语言标识。

  • icon: 语言图标,默认仅有flag-cn和flag-us, 其他图标自行寻找存放于主题目录/source/images/flags/
  • name: 语言名称
  • default: 该语言是否为默认语言
  • index: 页面链接
flag:
  - name: Chinese
    default: true
    icon: flag-cn
    index: /index.html

search

是否显示搜索框。

search: true

userDefinedSearchData

自定义搜索引擎。

  • custom: 是否启用自定义配置
  • thisSearch: 当前搜索引擎的搜索链接
  • thisSearchIcon: 当前搜索引擎的图标链接,格式为url(图片链接)
  • hotStatus: 是否启用搜热词功能
  • data: 多搜索引擎配置
  • name: 搜索引擎名字 img: 搜索引擎的搜索链接 url: 搜索引擎的图标链接,格式为url(图片链接)
userDefinedSearchData:
  custom: true
  thisSearch: https://www.baidu.com/s?wd=
  thisSearchIcon: url(https://www.baidu.com/favicon.ico)
  hotStatus: true
  data:
    - name: 百度
      img: url(https://www.baidu.com/favicon.ico)
      url: https://www.baidu.com/s?wd=
    - name: 谷歌
      img: url(https://www.google.com/favicon.ico)
      url: https://www.google.com/search?q=

githubCorner

右上角的 github corner , 将 href 的属性改为自己的 github 地址即可。

githubCorner: '<a href="https://github.com/tzy13755126023/" class="github-corner" aria-label="View source on GitHub"><svg width="80" height="80" viewBox="0 0 250 250" style="fill:#151513; color:#fff; position: absolute; top: 0; border: 0; right: 0;" aria-hidden="true"><path d="M0,0 L115,115 L130,115 L142,142 L250,250 L250,0 Z"></path><path d="M128.3,109.0 C113.8,99.7 119.0,89.6 119.0,89.6 C122.0,82.7 120.5,78.6 120.5,78.6 C119.2,72.0 123.4,76.3 123.4,76.3 C127.3,80.9 125.5,87.3 125.5,87.3 C122.9,97.6 130.6,101.9 134.4,103.2" fill="currentColor" style="transform-origin: 130px 106px;" class="octo-arm"></path><path d="M115.0,115.0 C114.9,115.1 118.7,116.5 119.8,115.4 L133.7,101.6 C136.9,99.2 139.9,98.4 142.2,98.6 C133.8,88.0 127.5,74.4 143.8,58.0 C148.5,53.4 154.0,51.2 159.7,51.0 C160.3,49.4 163.2,43.6 171.4,40.1 C171.4,40.1 176.1,42.5 178.8,56.2 C183.1,58.6 187.2,61.8 190.9,65.4 C194.5,69.0 197.7,73.2 200.1,77.6 C213.8,80.2 216.3,84.9 216.3,84.9 C212.7,93.1 206.9,96.0 205.4,96.6 C205.1,102.4 203.0,107.8 198.3,112.5 C181.9,128.9 168.3,122.5 157.7,114.1 C157.9,116.9 156.7,120.9 152.7,124.9 L141.0,136.5 C139.8,137.7 141.6,141.9 141.8,141.8 Z" fill="currentColor" class="octo-body"></path></svg></a><style>.github-corner:hover .octo-arm{animation:octocat-wave 560ms ease-in-out}@keyframes octocat-wave{0%,100%{transform:rotate(0)}20%,60%{transform:rotate(-25deg)}40%,80%{transform:rotate(10deg)}}@media (max-width:500px){.github-corner:hover .octo-arm{animation:none}.github-corner .octo-arm{animation:octocat-wave 560ms ease-in-out}}</style>'

since

建站年份,显示在页面底部。

since: 2020

menu

侧边栏菜单设置。

  • name: 分组名
  • icon: 分组图标
    config: [主要]分组内容(详细设置查看Config),如果有二级菜单则不需要此项!
  • submenu: 二级菜单,如果有二级菜单则不需要config, 此选项内容包含name, icon, config选项
menu:
  - name: 常用工具
    icon: far fa-star
    config: hotTools
  - name: 其他工具
    icon: fas fa-tools
    submenu:
      - name: 开发工具
        icon: fas fa-tools
        config: devTools
      - name: 我的博客
        icon: fas fa-blog
        config: myBlog

expandAll

是否将侧边栏全部展开。

expandAll: true

about

侧边栏的关于本站。

  • url: 关于页面链接
  • name: 在侧边栏显示的文字
  • icon: 图标
about:
  url: /about/
  icon: far fa-heart
  name: 关于本站

busuanzi

不蒜子统计。

  • enable: 是否启用不蒜子统计
  • position: 访问量显示位置, footer显示在页脚, sidebar显示在侧边栏
  • pv: 访问量显示的内容, $pv会被替换为访问量
  • uv: 访客数显示的内容, $uv会被替换为访客数
busuanzi:
  enable: true
  position: sidebar
  pv: 本站总访问量$pv
  uv: 本站总访客数$uv

config

网站内容设置。

  • name: 网站名称
  • url: 网站链接
  • img: 网站图标
  • description: 网站描述
- name: Ethan.Tzy
  url: https://tzy1997.com/
  img: https://bu.dusays.com/2022/05/17/6283c38e6368f.ico
  description: 不忘初心,方得始终。

关联设置名称并添加网站

menusubmenu中设置的config的内容为此选项的名称。

menu

menu:
  - name: 常用工具
    icon: far fa-star
    config: hotTools

常用工具分组里的网站有以下两种添加方式:

  1. 在主题的_config.yml里添加:

    hotTools:
      - name: Ethan.Tzy
     url: https://tzy1997.com/
     img: https://bu.dusays.com/2022/05/17/6283c38e6368f.ico
     description: 不忘初心,方得始终。
      - name: Github
     url: https://github.com/
     img: /images/logos/github.png
     description: 面向开源及私有软件项目的托管平台。
  2. 在站点根目录/source/_data/(没有自行创建)内新建hotTools.yml文件,文件内容如下:

  3. name: Ethan.Tzy
    url: https://tzy1997.com/
    img: https://bu.dusays.com/2022/05...
    description: 不忘初心,方得始终。
  4. name: Github
    url: https://github.com/
    img: /images/logos/github.png
    description: 面向开源及私有软件项目的托管平台。

以上两种方式任选一种即可,建议使用第二种。

这里只写了部分配置,更多详细配置 请参考 hexo-theme-webstack

部署

如果你了解过【Hexo + Butterfly】的搭建流程,想必【Hexo + Webstack】对于你来说也不会太难。

你可以将编译出来的文件夹【D:/studytype/My_Blog/Nav_Tzy/public】丢进你的服务器目录。也可以部署到 Github 上,方法同【Hexo + Butterfly】一样。

例如,我的个人站的地址是【tzy1997.com】,个人导航站的地址【nav.tzy1997.com】,我只需将【个人导航站】以外链的形式嵌入【个人站】即可。

如果你没有服务器,没有多余的 Github(不想那么麻烦的话),可以使用下面本站所使用的方法:

将编译出来的【D:/studytype/My_Blog/Nav_Tzy/public/index.html】直接丢进【Hexo + Butterfly】项目中。然后跳过 Hexo 的编译即可。

在这里需要将【index.html】重新命名(xxx.html),避免与【Hexo + Butterfly】项目的根页面冲突。

将【xxx.html】文件丢进【BlogRoot/soruce】文件夹中,然后在站点配置文件【BlogRoot/_config.yml】,修改skip_render属性即可。

skip_render: ['xxx.html']   # 跳过多个目录,或者多个文件

最后在【Hexo + Butterfly】主题配置文件中的menu将页面嵌入即可。例如:

  首页: / || fas fa-home
  其他||fa-fw fas fa-coffee:
    需求墙: /demandWall/ || fa fa-bug
    网址收藏: https://tzy1997.com/nav.html || fa-fw fas fa-infinity

到此,你学废了吗?

有问题记得及时留言!

14 声望
1 粉丝
0 条评论
推荐阅读
Uni-App 如何实现消息推送功能?
原文链接:Uni-App 如何实现消息推送功能?前言这里用的是uni-app自带的UniPush1.0(个推服务),所以只针对UniPush1.0介绍实现步骤。建议查阅的文章:UniPush 1.0 使用指南Unipush 常见问题当然现在已经出了UniP...

唐志远阅读 260

手把手教你写一份优质的前端技术简历
不知不觉一年一度的秋招又来了,你收获了哪些大厂的面试邀约,又拿了多少offer呢?你身边是不是有挺多人技术比你差,但是却拿到了很多大厂的offer呢?其实,要想面试拿offer,首先要过得了简历那一关。如果一份简...

tonychen152阅读 17.8k评论 5

封面图
正则表达式实例
收集在业务中经常使用的正则表达式实例,方便以后进行查找,减少工作量。常用正则表达式实例1. 校验基本日期格式 {代码...} {代码...} 2. 校验密码强度密码的强度必须是包含大小写字母和数字的组合,不能使用特殊...

寒青56阅读 8.5k评论 11

JavaScript有用的代码片段和trick
平时工作过程中可以用到的实用代码集棉。判断对象否为空 {代码...} 浮点数取整 {代码...} 注意:前三种方法只适用于32个位整数,对于负数的处理上和Math.floor是不同的。 {代码...} 生成6位数字验证码 {代码...} ...

jenemy48阅读 7.1k评论 12

从零搭建 Node.js 企业级 Web 服务器(十五):总结与展望
总结截止到本章 “从零搭建 Node.js 企业级 Web 服务器” 主题共计 16 章内容就更新完毕了,回顾第零章曾写道:搭建一个 Node.js 企业级 Web 服务器并非难事,只是必须做好几个关键事项这几件必须做好的关键事项就...

乌柏木75阅读 7.1k评论 16

再也不学AJAX了!(二)使用AJAX ① XMLHttpRequest
「再也不学 AJAX 了」是一个以 AJAX 为主题的系列文章,希望读者通过阅读本系列文章,能够对 AJAX 技术有更加深入的认识和理解,从此能够再也不用专门学习 AJAX。本篇文章为该系列的第二篇,最近更新于 2023 年 1...

libinfs42阅读 6.8k评论 12

封面图
从零搭建 Node.js 企业级 Web 服务器(一):接口与分层
分层规范从本章起,正式进入企业级 Web 服务器核心内容。通常,一块完整的业务逻辑是由视图层、控制层、服务层、模型层共同定义与实现的,如下图:从上至下,抽象层次逐渐加深。从下至上,业务细节逐渐清晰。视图...

乌柏木45阅读 8.6k评论 6

14 声望
1 粉丝
宣传栏