Hexo博客搭建教程系列·预备知识

1.1 为什么搭建博客

在你想要搭建一个自己的博客前,你需要问自己两个问题。

我真的有必要搭建博客吗?

我能做到持续输出文章吗?

可以看看这篇文章:个人网站存在的意义 - JoyQi

在考虑了以上两个问题后,你仍然决定搭建博客的话。那就往下面看吧。我会讲一些搭建博客需要了解的知识。

1.2 必看视频

这些合集视频解释了搭建一个博客网站的教程和、遇到的各种名词和解决方法。

1.3 代码相关知识

1.3.1 Git 和 GitHub

Git 是一个命令行工具,一个分布式版本控制系统,可以管理和跟踪你的代码历史版本。而 GitHub 是一个代码托管云服务网站,帮助开发者存储和管理其项目源代码,且能够追踪、记录并控制用户对其代码的修改。

以上链接来自 GitHub中文社区 (githubs.cn)

1.3.2 前端三件套

如果你是一个对编程零基础的人,建议初步了解、学习 HTML、CSS、JavaScript,这对你搭建博客有很大帮助。有了一定前端基础后,修改博客主题更加方便,主题文档也能看懂。

1.3.2 Markdown 语法

什么是 Markdown 语言?

Markdown 是一种 轻量级标记语言,创始人为约翰·格鲁伯 。它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的 XHTML (或者 HTML )文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。

详情请看: Markdown - 维基百科,自由的百科全书 (wikipedia.org)

博客文章采用 MD 格式。下面介绍 Markdown 基本语法。由于我不想污染整篇文章的排版,所以我只给出相应的语法,不给出示例。且 Markdown 文章渲染出来的样式与使用的 CSS 样式文件有很大关系。给出示例,容易引起误导。

1、标题

# 一级标题
## 二级标题
### 三级标题
##### 四级标题
###### 五级标题
####### 六级标题

标题从一级到六级,N 个 # 对应 N 级标题。

2、文字样式

2.1 加粗		**这是加粗文本**
2.2 倾斜		*这是倾斜文本*
2.3 删除线		~~我被删除啦~~

3、块引用

3.1 基本用法
> 大家好,我是镜湖月。
> 大家好,我是镜湖月。

3.2 嵌套
> 大家好,我是父级块引用。
>> 大家好,我是子级块引用。

不推荐使用。

4、段落

在 Markdown 语法中, enter(硬换行)代表另起一段, shift+enter(软换行)代表在本段另起一行。如下:

这是一个自然段。

这也是一个自然。
这是软换行效果。

5、列表

5.1 无序列表
- 哈哈哈
- 哈哈哈

5.2 有序列表
1. 哈哈哈
2. 哈哈哈

6、表格

|      |      |      |
| ---- | ---- | ---- | 
|      |      |      |
|      |      |      |
|      |      |      |

----:   右对齐
:----   左对齐
:----:  居中对齐

7、代码

7.1 行内代码
`xxx`
eg:`jinghu-moon`

7.2 代码块
```代码语言
xxx
xxx
```
//示例
#include<stdio.h>
int main()
{
    printf("hello world\n");
    printf("你好,镜湖月!\n");
    return 0;
}

8、超链接

[标题](网址)
示例:
[望月家](https://blog.seeyue.top/)

9、图片

![标题](图片网址)
示例:
![博客头像](https://blog.seeyue.top/img/avatar.png)

10、分隔线

三个短横线表示

---

11、转义字符

可使用反斜杠 \ 来转义如下字符:

字符中文名称
\反斜杠
`` `反引号
*星号
_下划线
{}花括号
[]方括号
()圆括号
#井号
+加号
-短横线(减号)
.
!感叹号
``

12、待办事项

- [x] 待办事项一
- [ ] 待办事项二
- [ ] 待办事项三

13、脚注

你好[^脚注1]

[^脚注1]: hello!

以上为 Markdown 最基本使用方法。总的来说,很简单。

参考资料

1.4 常见博客框架

博客框架大致分为两种:动态博客与静态博客。两者最大的区别就是动态博客自带后端,可以随时登录后台写文章、发文章,很方便。而静态博客就必须在本地写作,再部署到远端上。

动态博客:WordPress、typecho、Halo;静态博客:Hexo、Hugo。

搭博客到底选什么框架?Hexo还是Hugo?Typecho还是Wordpress? - bilibili ,可以看下。

1.4.1 动态博客

WordPress

Typecho

  • 介绍:一个简单、轻量级的博客系统,适合个人博客和小型网站使用。由国人开发。文档详细。
  • 特点:超低的 CPU 和内存使用率。主题多,插件不多,但满足使用需求。如果想要搭建动态博客,推荐使用。对于服务器的要求很低。
  • 教程腾讯云轻量应用服务器搭建 Typecho 网站

Halo

  • 介绍:强大易用的开源建站工具,配合上丰富的模板与插件,帮助你构建你心中的理想站点。由国人开发。文档详细。
  • 特点:初始界面耐看,操作简单,适合小白。对于服务器的要求较高。目前不支持市面上的云虚拟主机,需要使用云服务器或者 VPS。
  • 教程Halo博客搭建 - bilibili

总结:学生用户不推荐搭建动态博客。无法确定搭建博客是不是一时兴起。购买服务器就有点浪费了。如果手里就有闲置的服务器或者不差钱,直接搭建动态博客,自带后端,用起来方便得多。

1.4.2 静态博客

Hexo

  • 介绍:快速、简洁且高效的博客框架。基于 Node.js,易于安装和使用,拥有丰富的主题和插件生态系统。
  • 特点:主题超级多,插件多。比较热门的几个主题都有中文文档。配置起来很方便。网上的搭建教程也很多。无后端,只能在本地写文章,再部署到 GitHub 上。无评论系统。
  • 教程【Hexo】2023年零基础玩转Hexo全网最全系列 -bilibili

Hugo / Hugo中文文档

  • 介绍:世界上最快的网站构建框架。使用 Go 语言开发,速度快,内置模板和功能丰富。
  • 特点:可以快速渲染几百篇 Markdown 文章,而 Hexo 则可能会话费较长时间。部署比 Hexo 麻烦一点。无后端,只能在本地写文章,再部署到 GitHub 上。无评论系统。国内使用人少,遇到问题,不好解决。
  • 教程【实用】基于 Github Pages 的 hugo 博客搭建 - bilibili

1.4.3 其他框架

还有一些框架主要用于搭建文档网站,但拿来搭建博客,也不是不行。

VitePress

Docusaurus

  • 介绍:快速构建以内容为核心的最佳网站,使用 React 构建。
  • 特点:使用 Markdown 创建文档,开箱即用的本地化,易于将文档翻译为多种语言。为用户提供所有版本的项目文档,支持 Algolia 文档搜索。
  • 教程静态网站生成器Docusaurus使用入门 - bilibili

Astro

  • 介绍:Astro 是内容驱动型网站的 Web 框架。它为世界上速度最快的网站、客户端 Web 应用、动态 API 端点以及中间件提供支持。
  • 特点:可以任意选择的 UI 框架来创建 Astro,同时加载速度快、具有良好 SEO。只需几行代码就能为你的项目添加新的功能和行为。**Astro 是一个集多功能于一体的 Web 框架。**它内置包含了你构建网站所需的一切。
  • 教程用 Astro 搭建一个高性能博客 - bilibili

以上三个框架都有详细的中文文档。

总结:对于初次接触搭建博客的同学来说,推荐使用 Hexo 搭建博客。简单易上手。等熟悉了,再考虑是否更换博客框架。

1.5 搜索与提问

1.5.1 提问

首先,我们要明白一个问题,我们在网上提出的问题,并不一定有人会回答。这时,你可能会生气,但这不能解决你的问题。为了提高问题被回答的几率,我建议你看看这篇文章:《提问的智慧》精读注解版 - 链滴 (ld246.com),再去提问。如果觉得这篇文章太长的话,看这篇文章:《提问的智慧》思维导图 Xmind 版的 分享一下 - 链滴 (ld246.com)

1.5.2 搜索

维基百科镜像,内容有审核:万维百科 (wanweibaike.net)

现在国内主要的搜索引擎有百度、搜狗、必应等。百度目前是中文互联网上最大的搜索引擎,但它的表现不太行。用百度搜索,排在前面的很有可能是广告、盗版网站,一些转载了不知道多少次的文章。搜索效率较低。在国内,我推荐使用必应和百度一起使用。

个人感觉,谷歌对个人网站的收录优于百度。我搭建博客时,参照了不少谷歌上的教程。当然在中国大陆范围,谷歌是不能访问的。在大陆,可以使用谷歌镜像 Google (luciaz.me),第一次访问需要回答问题,答案依次是心灵之约水朝夕csxy@123.com

另附两篇文章:

但这是不够的。有时候学习、工作、娱乐需要访问一些国外的网站,却无法访问。就比如我常访问的 GitHub,时而打开时而打不开。这时候就需要「科学上网」,请自行解决。

互联网并非法外之地。发言得过脑子。

1.6 文章排版

以下为我个人意见。如果你觉得没有必要,请跳过。

1、中英文之间需要增加空格。

2、中文与数字之间需要增加空格。

3、英语专有词汇,按官方格式书写。例如:GitHub。

4、数字与单位之间需要增加空格。例如:20 TB。

5、行内代码与前后文字(包括符号)各空一格。

6、链接前后增加空格。

参考文章: 中文文案排版指北

推荐看下 ruanyf/document-style-guide: 中文技术文档的写作规范

1.7 版权意识

当你开始写博文的时候,难免会使用图片,引用他人的文章。此时你需要注意图片是否为无版权图片。引用文章采用的是什么许可协议。我认为,作为一名博主,需要具备一定的版权意识。下面我会简单介绍大多数博客文章采用的许可协议,同时分享一些无版权图片、字体、图标网站。

1.7.1 许可协议

参考链接关于许可协议 - Creative Commons知识共享许可协议_百度百科 (baidu.com)知识共享许可协议 - 维基百科,自由的百科全书 (wikipedia.org)

一般来说,你会在博客文章最后面看到这样一句话:

版权声明: 本博客所有文章除特别声明外,均采用 CC BY-SA 4.0 协议 / CC BY-SA 4.0 协议 / CC BY 4.0 协议 ,转载请注明出处!

其中的字母代表什么意思,下面来解释。

1、CC 协议

全称为 Creative Commons license,译为知识共享许可协议,简称 CC 协议。是一种允许他人分发作品的公共版权许可。2002 年 12 月 16 日,美国非盈利性组织知识共享(Creative Commons)首次发布 CC 协议。

CC 4.0 版本于 2013 年 11 月 25 日发布。此后,CC 4.0 被鼓励在全球范围内适用。除了放弃版权将作品完全公布到公共领域(即 CC0 协议)之外,CC 4.0 版本中一共有 6 种常用的版权规定组合。

CC 协议主要用于书籍、戏剧、电影、音乐、文章、照片、博客、网站

2、BY

  • 英语:Attribution(归属),简称 BY。译为署名

  • 使用条件:您可以自由复制、散布、展示及演出本作品;您必须按照作者或授权人所指定的方式,保留其姓名标示

3、SA

  • 英语:ShareAlike(一模一样),简称 SA。译为相同方式共享
  • 使用条件:您可以自由复制、散布、展示及演出本作品;如果您改变、转变或改作本作品,仅在遵守与本著作相同的授权条款下,您才能散布由本作品产生的衍生作品。

4、NC

  • 英语:Noncommercial(非商业性的),简称 NC。译为非商业性使用
  • 使用条件:您可以自由复制、散布、展示及演出本作品;您不得为商业目的而使用本作品。

5、ND

  • 英语:No Derivative Works(没有衍生作品),简称 ND。译为禁止改作 / 禁止演绎
  • 使用条件:您可以自由复制、散布、展示及演出本作品;您不得改变、转变或改作本作品

以上四种条件组合共有 16 种可能。4 种组合是同时包括「ND」和「SA」的条件,相互排斥;还有 1 种没有包括任何条件(CC0 协议),因此有 5 个组合无效。11 种有效组合中,因为 98% 的特许人要求署名,5 种缺乏「BY」的条件不再使用。所以只有 6 种组合可以使用。

问题:如何选择适合自己的许可协议?

看图!

CC 许可协议

附上 6 种 CC 许可协议的链接。

我的选择: BY-NC-SA 4.0

1.7.2 无版权图片

1、Unsplash

互联网上最大的免费分享图片的平台之一。强推!上面的图片都很好看。注意这是一个英文网站。搜索只能用英语。

国内镜像:Beautiful Free Images & Pictures | Unsplash (dogedoge.com)

2、pixabay

免费正版高清图片素材库。Pixabay 拥有超过 2.5百万 张优质图片和视频素材,让你轻松应对各种设计场景。支持中文搜索。

3、咸柠檬壁纸(ZL Wallpaper)

图片源自 Wallpaper Abyss - 高清壁纸, 桌面背景 (alphacoders.com) ,支持中文搜索。图片质量,我觉得还行。

上面三个是我主用的图库。如果觉得不够,看下面的链接。

5 个免版权高清视频素材下载网站(一) - Topbook

5 个免版权高清视频素材下载网站(二) - Topbook

10 个免版权高清图片素材下载网站 - Topbook

1.7.3 图标库

1、iconfont-阿里巴巴矢量图标库

目前国内最大的图标库,可编辑图标大小、颜色、方向,可生成 CSS/JS 在线链接引用。

注意:该素材仅供广大用户交流学习使用,未经 iconfont 或其关联公司书面授权许可,不得用于任何商业用途。

2、ByteDance IconPark

2400+ 基础图标,29 种图标分类。IconPark 图标库是一个通过技术驱动矢量图标样式的开源图标库。可以对图标进行较大的编辑。

3、Feather

简单漂亮的开源图标,可调节图标大小、线条粗细。只有 287 个图标。点击图标,就下载。

4、Tabler Icons: 4950+ free vector icons for web design - Tabler: Free and Open-Source HTML Dashboard Template

免费且开源的图标,旨在使您的网站或应用具有吸引力、视觉一致性和简单美观。超过 4950 个完美的图标,用于网页设计。可作为 webfont 使用。

5、Radix Icons

一套清爽的、15×15 大小的开源图标库,共有 333 个图标。只能复制图标 SVG 或者下载所有图标。

6、Remix Icon

为设计师和开发者精心打造的开源中性风格系统符号。 所有图标均可免费用于个人和商业用途。共有 2580 个图标,不仅单独下载,还能将收集的所有图标下载为字体。

7、xicons - Icons for Vue & React

集成了多个开源图标库的 SVG Vue/React 组件,图标样式修改通过代码实现。点击图标,就下载。

8、Ionicons

高品质设计的图标,可用于Web、iOS、Android和桌面应用。支持SVG格式。完全开源。可复制 SVG 格式或者作为 webfont 使用。

9、Material Symbols & Icons

谷歌出品的图标库,整合了超过 3237 个字形在一个字体文件中,提供广泛的设计变体。支持 SVG 或 PNG 格式下载。

Material 图标指南 | Google Fonts | Google for Developers

10、Lucide

Lucide 是一个开源图标库,提供 1000 多个矢量 (生SVG) 文件,美丽且一致的图标,支持 SVG 或 PNG 格式下载。

11、Icon & Font Libraries

一套经过精心设计且完全开源的图标库,共 8000 余个图标,支持 SVG 或 PNG 格式下载。PNG 格式可调整图标大小、边距、方向。

12、Line icons

庞大的图标库,包含超过 8400 个专业设计的 SVG 图标,分为免费和付费图标。具有线条和填充两种样式。支持 PNG 格式下载,可作为 webfont 使用。

13、BlendIcons

免费且顶级的图标库,以有趣、简单和快速的方式为您的项目找到免费图标,图标有 7 种风格可选,支持 SVG 或 PNG 格式下载。

13、SVGPORN

国外知名公司的 logo,支持 SVG 格式下载。

15、Worldvectorlogo

国内外知名公司的 logo,支持 SVG 格式下载。完全免费无限制。

16、Yesicon

精选全球高品质、开源、免费的矢量图标库集合。

总结iconfontTabler IconsRemix IconMaterial Symbols & Icons 我比较推荐。

1.7.4 可商用字体

免费商用中文字体下载网站

猫啃网,最新最全的可免费商用中文字体下载网站!喵啃~ (maoken.com)

1、霞鹜文楷

一款楷体字体,很不错。 lxgw/LxgwWenKai: 一款基于 FONTWORKS 出品字体 Klee One 改造的开源中文字体 ,猫啃网下载链接: 霞鹜文楷 - 猫啃网

2、思源宋体、思源黑体

思源宋体 (github.com)思源黑体 (github.com)

GitHub 可能会下载失败,推荐这个网站: 字体天下 - 提供字体免费下载和在线预览

3、鸿蒙黑体

我很喜欢它的数字样式,下载地址: 字体-视觉风格-通用设计基础-HarmonyOS应用开发

4、MiSans

超大字库,下载地址: MiSans

如有疑问,请在评论区留言,我会尽快回复。觉得文章不错?点击右侧按钮可复制文章链接。

评论区