艾三元 Every day to be a little better

在网络世界上安一个家

一、前言

记录带新人的那些事,主要是一些工作技巧上的分享

最近因为忙于项目,所以都没时间更新文章了,正好也在带几个实习小妹。所以也建议他们要善于思考,学会总结,多写写笔记,便于记忆与查阅。

授人以鱼不如授人以渔。

当然了,在你写写笔记的同时,也可以以博客的形式发表个人的笔记,现在网络上又很多博客平台,我们都可以直接在上面发表,但是在这些平台存在比较不自由,会受到各种限制等等。所以,你就可以考虑搭建一个属于自己的平台,一个在网络世界中属于自己的家。

好记性不如烂笔头,将网络笔记当做自己的网络中的家,可以随时随地的查看,不受限制。

如果你有足够的成本和时间,完全可以自己写一个博客程序,通过购买服务器并部署自己编写的博客程序,定期的维护,通过这种方式搭建属于自己的家。当然了,这种方式可行但却太耗精力和成本。所以有的人建议,在github page平台上托管我们的博客。这样就可以安心的来写作,又不需要定期维护,而且hexo作为一个快速简洁的博客框架,用它来搭建博客真的非常容易。

各抒己见,每个人都可以通过自己的方式搭建一个家。

我来说说写博客的好处吧:

  1. 当你把经验的总结写成博客的时候思路会很清晰,会有新的启发,尤其是自己实践过后的思考总结;

  2. 当遇到问题,并解决的时候,可以给自己的技术和解决思路做存档,加深记忆,这样即使过一段时间忘了或者以后需要又或者遇到相同问题的时候,你就可以打开自己的博客看到自己的记录了;

  3. 可以记录自己的成长,记录自己的工作与生活;

  4. 当然了,博客给你带来的另一些价值利益好处就不言而喻了。

总的来说,你写了博客和不写,肯定收获是不一样的。

而在本文中,采取的方式利用hexo作为一个快速简洁的博客框架,用它来搭建博客,但因为部署托管到github page平台上有时候网络受限访问太慢了,所以就托管到并发布部署到自己的服务器上。这样不仅可以快速搭建访问博客也能将数据保存在自己手上。

Hexo是一款基于Node.js的静态博客框架, 可以快速生成静态文件,访问速度快;

方便快捷,可以搭建一个自由的个人博客,不需要后台;

数据安全,可以自行保存自己的笔记数据;

博客内容文章可以轻松快速打包、转移、发布到其它平台。

hexo

二、准备

  1. 安装git客户端 (为了展示效果,我是用的window环境下安装git客户端)

  2. 安装node.js (这个可以看之前的文章

  3. 有一个个人github账号(没有的可以注册一个)(如果有服务器的话,可以直接使用服务器)

    (本文不对git部署方式进行说明,可自行网上查阅。)

  4. 熟悉markdown语法。(便于后续通过markdown语法编写文章)

官网建议Node.js 版本需不低于 10.13,建议使用 Node.js 12.0 及以上版本。

本文用的环境:

node.js@ 12.13.1 ( 指令 :node -v)

hexo @ 5.1.1 ( 指令 :hexo -v)

git @ 2.24 ( 指令 :git version)

三、搭建

3.1 安装 Hexo 包

npm install -g hexo

注意

安装以后,可以通过 Hexo 指定的方式执行相应的操作。

如果出现 hexo不存在的情况,需要将 Hexo 所在的目录下的 node_modules 添加到环境变量之中即可直接使用 hexo <command>

环境变量下:

环境变量

3.2 初始化

在指定文件位置新建一个文件夹,如果本文的路径F:\site, 切换到相应的文件夹目录后,通过初始化的

方式将代码存放在这个文件目录下

hexo init

1970944824

初始化后生成的以下目录结构如下:

3.3 生成

hexo g

执行生成指令后,文件目录下就会有public文件夹,对应的生成相关的html文件。这个public文件夹目录下的文件是可以进行部署个人服务器发布或提交到github上面进行部署的。

3.4 启动

hexo s

启动服务,这个是可以进行本地预览效果的,默认端口4000,打开就可以看到你即将部署的站点的模样了。

通过以上步骤,hexo已经为我们搭建一个站点的框架和默认的主题样式。当然了,你也可以根据自己的喜欢选择相应的官方主题进行修改。

四、更换主题

本文采用的主题是 hexo-theme-matery, 当然了,我自己现在用的也是这个主题。

4.1 下载

切换到目录 F:\site\themes 执行下载主题

git clone https://github.com/blinkfox/hexo-theme-matery.git

下载完之后,将F:\site目录下的_config.yml中的theme:landscape改为我们想要的主题theme: hexo-theme-matery, 然后再次执行 hexo g指令重新生成。

如果出现问题,可以尝试先执行hexo clean清理public文件夹的内容,再重新生成hexo g和发布。

再次启动服务hexo s,这次可以预览到的效果就是我们更换主题后想要的效果了。

4.2 配置

4.2.1 新建分类 categories 页

categories 页是用来展示所有分类的页面,如果在你的博客 source 目录下还没有 categories/index.md 文件,那么你就需要新建一个,命令如下:

hexo new page "categories"

编辑你刚刚新建的页面文件 /source/categories/index.md,至少需要以下内容:

---
title: "分类"
date: 2020-09-13 17:06:27
type: "categories"
layout: "categories"
---

4.2.2 新建标签 tags 页

tags 页是用来展示所有标签的页面,如果在你的博客 source 目录下还没有 tags/index.md 文件,那么你就需要新建一个,命令如下:

hexo new page "tags"

编辑你刚刚新建的页面文件 /source/tags/index.md,至少需要以下内容:

---
title: "标签"
date: 2020-09-13 17:07:18
type: "tags"
layout: "tags"
---

4.2.3 新建关于我 about 页

about 页是用来展示关于我和我的博客信息的页面,如果在你的博客 source 目录下还没有 about/index.md 文件,那么你就需要新建一个,命令如下:

hexo new page "about"

编辑你刚刚新建的页面文件 /source/about/index.md,至少需要以下内容:

---
title: about
date: 2020-09-13 17:07:42
type: "about"
layout: "about"
---

4.2.4 新建 404 页

如果在你的博客 source 目录下还没有 404.md 文件,那么你就需要新建一个

编辑你刚刚新建的页面文件 /source/404.md,至少需要以下内容:

---
title: 404
date: 2018-09-30 17:25:30
type: "404"
layout: "404"
description: "Oops~,我崩溃了!找不到你想要的页面 :("
---

4.2.4 代码高亮

由于 Hexo 自带的代码高亮主题显示不好看,所以主题中使用到了 hexo-prism-plugin 的 Hexo 插件来做代码高亮,安装命令如下:

npm i -S hexo-prism-plugin

然后,修改 Hexo 根目录下 _config.yml 文件中 highlight.enable 的值为 false,并新增 prism 插件相关的配置,主要配置如下:

highlight:
  enable: false

prism_plugin:
  mode: 'preprocess'    # realtime/preprocess
  theme: 'tomorrow'
  line_number: false    # default false
  custom_css:

4.2.5 搜索

本主题中还使用到了 hexo-generator-search 的 Hexo 插件来做内容搜索,安装命令如下:

npm install hexo-generator-search --save

在 Hexo 根目录下的 _config.yml 文件中,新增以下的配置项:

search:
  path: search.xml
  field: post

4.2.6 中文链接转拼音

如果你的文章名称是中文的,那么 Hexo 默认生成的永久链接也会有中文,这样不利于 SEO,且 gitment 评论对中文链接也不支持。我们可以用 hexo-permalink-pinyin Hexo 插件使在生成文章时生成中文拼音的永久链接。

安装命令如下:

npm i hexo-permalink-pinyin --save

在 Hexo 根目录下的 _config.yml 文件中,新增以下的配置项:

permalink_pinyin:
  enable: true
  separator: '-' # default: '-'

:除了此插件外,hexo-abbrlink 插件也可以生成非中文的链接。

更多具体的操作,可以查阅该主题的具体的操作文档说明

五、部署

根据上文自定义的方式配置主题后,根据自己的需求,修改对应的信息之后,发布部署。

5.1 部署

如果没有服务器的可以通过注册github账号,通过github pages服务搭建博客。(具体的github发布hexo可以网上查阅)

因为刚好有一个服务器可以使用,暂用的空间也不大,所以我就直接将发布后的文件部署到服务器上了。绑定后域名后,就可以进行访问。

可以得到如下的效果。

5.2 最终效果

站点地址: http://www.i3yuan.top

六、说明

简写指令:

`hexo init` #初始化XX文件夹名称
`hexo n "我的第一篇文章"` # 等价于  `hexo new "我的第一篇文章"`还等价于`hexo new post "我的第一篇文章"` 
`hexo p` 等价于 `hexo publish`    #通过 publish 命令将草稿移动到 source/_posts 文件夹 
`hexo g` 等价于 `hexo generate`  # 生成静态网页(生成在public文件夹)
`hexo s`等价于 `hexo server`     # Hexo 会监视文件变动并自动更新,除修改站点配置文件外,无须重启服务器,直接刷新网页即可生效。
`hexo d` 等价于 `hexo deploy` # 将本地数据部署到远端服务器(如github)
`hexo deploy -g`  等价于 `hexo deploy --generate`
`hexo generate -d`等价于`hexo generate --deploy
`hexo clean` #清除缓存 ,网页正常情况下可以忽略此条命令,执行该指令后,会删掉站点根目录下的public文件夹

注: hexo clean 没有 简写, git --version 没有简写

npm update hexo -g#升级
npm install hexo -g#安装
node-v #查看node.js版本号
npm -v #查看npm版本号
git --version #查看git版本号
hexo -v #查看hexo版本号

错误

  1. 网页将代码中片的 {} 解析为 &#123 的错误

    错误这个问题,无法转换{ },直接找到路径node_modules/hexo_prism_plugin/src/index.js下的文件,代码如下:

    const map = {
      '&#39;': '\'',
      '&amp;': '&',
      '&gt;': '>',
      '&lt;': '<',
      '&quot;': '"'
    };
    

    解决方法就是多加&#123&#125对花括号的转义

    const map = {
      '&#39;': '\'',
      '&amp;': '&',
      '&gt;': '>',
      '&lt;': '<',
      '&quot;': '"',
      '&#123': '{',
      '&#125': '}'
    };
    

    这里的采用的方式是直接找到对应的源码修改代码里面内容,实现花括号转换问题。当然了,你也可以采取别的方式,欢迎指定,提出更好的方案。

    如果你在使用搭建过程中也遇到其他问题,可以评论提出,方便大家一并学习汇总。

七、总结

  1. 在后续中我们可以通过Markdown编写博客文章,发布到各个平台的同时,也可以发布到自己搭建的个人博客站点,方便自己学习记录,便于查阅。
  2. 如果有不对的或不理解的地方,希望大家可以多多指正,提出问题,一起讨论,不断学习,共同进步。
  3. 本文中参考资料: Hexo官方简介hexo-theme-matery主题
posted @ 2020-09-19 19:46  艾三元  阅读(1413)  评论(1编辑  收藏  举报