从零开始建立一个网站
写给想要拥有一个自己的网站但没有资金成本的小白与曾经的自己。
前言
虽说是网站，对于个人来说，或许一般叫作博客。
但我不希望它仅仅是一个博客，而是能够成为一个处于自己现实生活之外、自由、实验、不用畏惧他人眼光甚至可以独断专行的地方。
当然，这本质还是一个新手向教程，也许会有点科普的感觉。
我会从整体上对搭建网站的流程和使用到的技术及步骤进行介绍（因为要铺开讲，倘若包括轶事，实在太多太杂，我也会点到为止），并让你明白这个东西在网站的过程中起到什么样的作用。
但我不会就细枝末节展开叙述，譬如如何注册账号、安装时如何点击下一步。
我希望看完此篇文章后，此前对此方面知识一无所知的小白，到最后也能搭建出一个属于自己的站点。（前提是认识基础的英语单词和善用搜索引擎）
已经有所基础的同学大可跳读或者直接关闭。
注释处多为相关补充说明，对正常流程没有影响，若没有兴趣，可以略过。
与文章相关疑问都可在本文章的 GitHub Issues 中进行评论，其他疑问可到对应项目或文章下评论。
我会尽可能保持更新该文章所使用到的技术和做法，并随时接受勘误。
关键词
- Hexo
- 静态博客
- 无服务器
- GitHub Pages
- hexo-theme-yun（私货）
步骤
安装 Node.js
什么是 Node.js ？
这得从什么是 JS 说起，JS 也就是 JavaScript。（为什么有种从盘古开天辟地开始的感觉）没错，JavaScript 就是网页的盘古。JavaScript 是一种编程语言，我们所见到的网页中的交互和逻辑处理几乎都是由 JavaScript 完成。
JavaScript 语法简单，易学易用。（当然也请不要小瞧它，虽然它入门门槛低，但上限同样也很高。包括但不限于实现网站前后端，手机桌面应用程序，机器学习，计算机图形学等。）
在 Node.js 诞生前，JavaScript 都运行于浏览器端。也就是说，它是鱼，浏览器是装满了水的水缸。
2008 年，Chrome V8 诞生。2009 年，Node.js 诞生。并成为 GitHub 早期最著名的开源项目。GitHub 可能大家已有所了解，后续再说。
Node.js 便是一个基于 Chrome V8 引擎的 JavaScript 运行环境。（当年第一次看到这句话时，我也一脸懵逼。）按照我的理解，JavaScript 是鱼，Chrome V8 就是抽水机，Node.js 则把这台抽水机也装在你电脑上。于是你的电脑也有了 Node.js 这个和浏览器相似的水缸，也可以在里面运行 JavaScript 了！
当然 Node.js 和浏览器端还是因为自身定位和一些历史原因而有些许区别的，不再展开。
Node.js | 百度百科
JavaScript | MDN
建议下载长期支持版而非当前发布版（因为如果是最新版，容易出现一些奇妙的 bug）。
全部默认下一步进行安装。
Windows 打开命令提示符，macOS 打开终端。（= =，这个不会就请百度吧。）
Linux 用户右上角关闭本标签页。
后续如提到输入命令，均默认指打开终端进行输入。
输入 node --version，如果得到的版本号与你方才安装的一致，那么 Node.js 就已经成功安装。
Node.js 安装成功时也默认安装了
npm，在此后将会用到。npm是随 Node.js 一起被安装的包管理工具，你可以理解成 Node.js 自带的应用商店。
对了，国内使用 npm 可能很慢。
你可以考虑切换为 taobao 镜像源。
1 | npm config set registry https://registry.npm.taobao.org |
yarn 是 Facebook 出品的另一个包管理工具，同样可以管理 npm 中的包，安装已缓存的包时速度更快，你也可以使用它来替代 npm。
官网下载或通过命令行安装。
1 | npm install -g yarn |
Git 与 GitHub
安装 Git
Visual Studio Code，简称 VS Code。
目前最为强大易用的编辑器，轻量且快速。（宇宙第一编辑器）
注意：它并不是我们常常听到的 VS，VS 常常指的是 Visual Studio，是一个功能强大的 IDE（集成开发环境），体积也相比 VS Code 都要大上一个量级。
在此之前，我建议你先安装 VS Code。因为安装 Git Bash 时，可以设置 VS Code 作为默认编辑器。
Git 是一个开源的分布式版本控制系统，由 Linus Torvalds（同时也是 Linux 的作者）为了管理 Linux 开发而开发。
简而言之，是一个版本管理工具。譬如设计师设计好了第三版的海报，客户却说还是要第一版吧，这时便可以通过 Git 快速回退到最初的版本。
你只需要把每次更改的状态（Git 会自动进行检测，你只要掌握基础的几条命令就可以了）告诉 Git，而不需要每个版本都保存一份压缩包，既方便也能大大节约空间。
（当然这主要只对代码文本起作用，因为 Git 的本质是记录各行代码的增减，倘若是像视频、海报这类二进制文件来说便体现不出丝毫优势了。当然想要应对这种场景还有 Git LFS。）
macOS 用户可以下载官网的安装包进行安装，也可以直接安装 App Store 的 Xcode（附带会安装 Git，但是比较大）。
类似的工具还有：SVN。但始终更推荐 Git，因为它功能更为强大且它的背后还有更强大的生态：GitHub。
注册 GitHub
这一部分内容，你也可以放到本地调试并预览成功后并打算线上部署的时候，再回过头来看。
GitHub 一听便与 Git 有所渊源。
Git在英文中是懒人、饭桶之意。Hub则是中心、集线器的意思。譬如 USB 集线器就是 USB Hub。所以 GitHub 就是饭桶中心（大雾）。
GitHub 是全世界最大的开源项目与代码托管平台，也是众多开发者的交流场所。还是全球最大的同性交友网站。
而代码托管本身用到的正是上文提到的 Git 技术。
注册 GitHub 账号。（虽然都是英文，但不必畏惧，也并不会造成使用障碍，只要记得最常用的选项含义即可，以及善用手头的翻译软件。）
注意：注册时的英文用户名将成为你可以使用的免费域名前缀。
登录 GitHub。
为什么要用 GitHub？
对于平民玩家来说，在初次尝试建立自己的网站时，也许并不会有闲钱或者说决心来购买自己的服务器与域名。
而 GitHub 则提供了 GitHub Pages 这一服务。
用户们可以利用这一服务，部署自己的静态站点。
点击右上角的 + -> New repository 新建仓库。
我这里因为已经有同名仓库，所以提示了重复。
仓库名称务必为 你的用户名.github.io，用户名是英文，大小写无所谓，但建议统一小写。（因为你会发现时常切换大小写很麻烦）
为什么必须这个作为仓库名？
GitHub Pages 服务的命名规范，同时它也将成为你的专属域名。当然，你也可以购置自己的专属域名并用它来提供内容。
点击 Create repository。
安装 Hexo
- GitHub: https://github.com/hexojs/hexo
- 官方文档（直接参考文档也是一个不错的选择）
为嘛使用 Hexo ？
Hexo 是一个快速、简洁而强大的博客框架，基于 Node.js，同样托管于 GitHub 之上。生态中拥有众多插件主题。你可以基于它快速生成一些静态页面。
你可以使用别人的各种主题与插件，也可以自己定制开发想要的功能。
为什么不是…?
其他常用的博客框架还有 WordPress，Typecho，Ghost 等，但这些往往都需要购置自己的服务器，而无法静态化地部署到 GitHub Pages 上。（当然，相应的功能和灵活性也大大提升。）静态化站点还有一个优势就是访问速度往往更快。
静态网站生成器还有 Vuepress，Gatsby 等。但这些多是为了写文档而量身定制的，你也可以使用它们，但是相较 Hexo 的博客定位，它们关于博客的插件和主题以及解决办法会少得多。
Hexo 提供的功能与 Hugo 几乎都有，（生成大量文件时，甚至比 Hexo 更快）不过它是基于 GO 语言。日后你想对自己的网站进行自定义，即便是 Hugo，你编写前端的交互仍旧需要使用 JavaScript，所以选择基于 JavaScript 的 Hexo 可以降低学习成本。（你若对 GO 有兴趣，仍然可以尝试使用 Hugo，但本教程将不会针对 Hugo 进行展开。）
所以对于新手来说，使用 Hexo 作为起始点，不失为一个好选择。（当然如果你有钱租服务器，并希望快速上手的话，就可以考虑考虑 WordPress 或者 Typecho）
这里顺带推荐一下小伙伴 染川瞳 的 WordPress 主题 Sakurairo，阔落 的 Typecho 主题 miracles，都是很漂亮的主题。
在终端中输入以下命令：
1 | npm install hexo-cli -g |
install自然是安装。hexo-cli则是hexo的终端工具，可以帮助你生成一些模版文件，之后再用到。-g代表的是全局安装。也就是在任何地方都可以使用，否则会只能在安装的目录下使用。
此时，请先通过 cd 进入你本地电脑打算存储网站代码的文件夹目录。（或者右键文件夹 Git Bash Here）
譬如：
注意：这里是你自定义的目录，请不要复制粘贴
1 | # '#' 字符后的文字代表注释，不需要输入 |
接下来输入：
1 | hexo init 你的名字.github.io |
hexo正是因为我们之前安装了hexo-cli这一个包，所以我们可以在终端中使用hexo这一命令。init初始化博客的模版文件。后面跟的是你要新建的文件夹，最好和你此前新建的仓库名一致。
1 | # 进入你的博客文件夹 |
server 代表开启本地的 Hexo 服务器，这时你就可以打开浏览器，在地址栏中输入 localhost:4000 就可以看到本地的网页了。
按 Ctrl + C 中断服务器的运行。
至此，基础的模版页面便已经搭建好了。
使用 Hexo 主题
Hexo 默认提供的是 hexo-theme-landscape 主题。
默认主题样式简单，功能较少。所以大多数人并不会使用默认主题。
这里将示范如何使用我自己开发的主题 hexo-theme-yun。
(:з」∠) 顺带求 Star，代表收藏，就在点进链接后的右上角。
你可以前往 云游君的小站 查看示例效果。
Hexo-Theme-Yun 的速度检测
谷歌 
谷歌浏览器 Audits - Lighthouse 检测分数
当然，你也可以在 Themes | Hexo 发现更多有趣美丽的主题。使用方法大致相同。
当你具备一定开发能力时，你可以开发属于自己的主题，或者为 hexo-theme-yun 提交 PR 添加你想要的功能。
- hexo-theme-yun - GitHub
- hexo-theme-yun 使用文档：更详细的配置进阶指南。
- 示例效果
下载 Hexo 主题
进入终端（确保路径处于你此前使用 Hexo 初始化好的文件夹目录下，即 xxx.github.io，后简称为 Hexo 目录），输入以下命令。
实际上你也可以直接在 VS Code 中使用终端。
1 | git clone https://github.com/YunYouJun/hexo-theme-yun themes/yun |
这里便使用到了我们此前安装的 Git，
git clone即代表克隆（也就是复制的作用）我的主题（托管于 GitHub，链接便是主题所在的地址），themes/yun则代表放在你 Hexo 文件夹下的themes/yun文件夹里（没有该文件夹会自动新建）。
编辑 Hexo 配置
右键文件夹使用 VS Code 打开，或者进入 VS Code 打开你存储网站的文件夹。此后操作都将默认你已处于该工作目录下。
在你此前通过 Hexo 初始化生成的文件目录下，会存在一个 _config.yml 文件。
yml是 YAML 文件的后缀名，YAML 是 “YAML Ain’t a Markup Language”（YAML 不是一种标记语言） 的缩写，但它实际上还是一种标记语言。你可以将其理解为存储数据的一种文本格式，这也是其诞生的目的。 如果你听说过 JSON，那你就更能明白它是干什么的了。
它是 Hexo 的配置文件，关于各配置选项的意义你可以查看 配置 | Hexo。
在 _config.yml 中找到 theme 这个字段，将其后的 landscape 修改为 yun。
1 | theme: yun |
pug 是一种模板引擎，可以渲染为 HTML 字符串。类似的还有 ejs，swig 等，语法和设计理念有所不同。
stylus 是一种 CSS 预处理器，可以渲染为 CSS。类似的还有 scss，less，同样只是语法和设计理念有所差异。
由于我的主题使用了 pug 和 stylus，而 Hexo 自带的一般是 ejs 与 stylus，所以你可能还需要输入以下命令安装渲染器。
1 | npm install hexo-render-pug hexo-renderer-stylus |
这时再像此前那般使用 hexo server 重新启动服务器，你就可以看到一个不一样的主题风格的页面了。
自定义主题配置
当启动时，会使用主题的默认配置。但这不一定是你想要的。
所以你可以对主题进行一些自定义。
主题的配置文件放在 themes/yun/_config.yml 文件中。
且慢，你最好不要直接修改主题的默认配置。倘若日后主题升级更新了怎么办，难道还要重新配置一遍吗？
最好的解决方案就是在博客根目录下（不是主题目录）新建 source/_data/yun.yml。（若 source/_data 目录不存在，请新建）
本主题将自定义配置与默认配置进行合并，因此你只需要在 yun.yml 文件中自定义你需要的配置即可，其余仍将自动采用默认配置。
譬如我们需要更换头像。在 yun.yml 中填写。
你可以在
source文件夹下新建images文件夹，用来存储你的图片。
也可以使用 SM.MS 等图床工具配合 PicGo 上传你的图片文件，获取在线链接。
1 | avatar: |
更换主题色彩，比如换成黑色，黑色的十六进制颜色代码是 #000000。
1 | colors: |
这时你的主题色调就会变为黑色。
这只是一个配置项的简单示例，更多配置你可以参考 Yun 主题文档 或直接在 theme/yun/_config.yml 中查看，并根据自己的需要进行配置。
生成静态文件
至今我们的工作都是在本地进行，想必你也很想放到线上与小伙伴们分享。
这便轮到了 GitHub Pages 的出场，不过 GitHub Pages 只支持纯静态文件。
所以我们需要使用以下命令先来生成站点的静态文件。
1 | # 如果进行多次生成，为了避免受错误缓存影响，最好使用 hexo clean 先清除一遍。 |
此时你的文件夹目录下会出现 public 这个文件夹，里面存放的就是你站点的静态文件。
与远程仓库建立关联
接下来我们将本地的仓库与此前在 GitHub 上建立的仓库建立关联。
1 | git init # 初始化 Git 仓库，只需要执行一次即可 |
在将其部署到 GitHub Pages 上之前，我们最好先建立一个分支。
什么是分支？
Git 提供了版本管理功能，其中还有一个分支功能，你现在可以简单地将其理解为平行世界。
你的名字.github.io 部署后，GitHub Pages 将默认使用你的 master 分支作为静态文件部署。
所以我们最好新建一个 hexo 分支（命名无所谓）用来存储 Hexo 地源代码，master 分支则用来存储部署后的静态文件。
1 | git checkout -b hexo |
这时便成功建立了一个 hexo 分支。（此后的工作都将在 hexo 分支下进行）
你可以通过 git branch -v 来查看当前有哪些分支，使用 git checkout 分支名 来切换到对应的分支。
部署
为了更方便的部署到 GitHub Pages，Hexo 提供了 hexo-deployer-git 插件。
老规矩，安装。
1 | npm install hexo-deployer-git |
在 _config.yml 中配置。
1 | deploy: |
保存，部署！
第一次可能需要你输入用户名与密码。
密码输入的时候不会出现 ***，不要害怕，已经输入进去了。
1 | hexo deploy |
等待完成后，打开网址 https://你的名字.github.io 就能看到你的线上网站了。
使用 https，http 可能无法正常打开。HTTPS 是多了安全加密的 HTTP，Chrome 浏览器已经默认会显示
http链接为不安全。
为了安全，建议开启强制 https 跳转。项目地址页面 -> Settings -> Options -> GitHub Pages -> Enforce HTTPS。（翻到下面）
此时，http 网址会自动重定向到 https
备份与自动部署
我们当前只是将生成的静态文件部署到了云端。
为了以防万一，我们应该将网站的源代码文件也推送到 GitHub 仓库备份。
1 | # 与远程 Git 仓库建立连接，只此一次即可 |
接下来准备提交，这几句命令将是你以后每次备份所需要输入。
1 | # 添加到缓存区 |
每次推送都要输入这三条命令，你可能觉得有些麻烦。
那么你可以编写 bash 脚本。
譬如，在根目录下新建 update.sh。
1 | # 如果没有消息后缀，默认提交信息为 `:pencil: update content` |
此后更新的话，只需要在终端执行 sh update.sh 即可。
更新麻烦，每次部署也很麻烦，可以使用持续集成进行自动部署。
什么是持续集成？
持续集成是一种软件开发实践。对软件进行自动化构建，以此来发现错误。
Travis CI 就是一个线上持续集成服务的提供商。它可以拉取你每次推送到 GitHub 上的代码，然后根据你的要求对其进行构建。
我们可以趁机让它自动生成网站静态文件，然后自动帮我们部署。
除此之外，你还可以使用 GitHub Actions ，Netlify 等服务。
GitHub Actions 相比 Travis 等，自身便拥有仓库的 Token，不再需要额外设置，可以直接使用secrets.GITHUB_TOKEN。
推荐一个专门用来部署 gh-pages 的 Actions actions-gh-pages
关于更多更具体的自动化部署方案和操作步骤，你可以参考我的小伙伴 ChrAlpha 的 初探无后端静态博客自动化部署方案。
他在文章中详细介绍了 Netlify 、GitHub Actions 和 Travis CI 的部署方法。
你也可以参考 Hexo 的官方文档 将 Hexo 部署到 GitHub Pages
我就不在此画蛇添足。
当然还有个更简便的方法，直接参考我的 gh-pages.yml。
去掉夹在 yarn install 与 yarn build 之间的 algolia 部分，直接粘贴到你的 .github/workflows/ 文件夹（自己新建）下 xxx.yml 文件里即可。
推送后便可直接自动部署。
至此，你的站点便基本搭建完成，此后继续对主题进行自定义吧。
开始写作
文章
输入以下命令即可新建 xxx.md 文件。
1 | hexo new post xxx |
md是Markdown的后缀名，是一种简洁方便的文本标记语言。你只需要记住简单的几种语法，就可以快速进行编写。
为什么使用 Markdown？
首先 Hexo 本身就是将 Markdown 转化为静态的 Html 文件，来方便用户编写文章。
Markdown 就好似介于 Word 与 TXT 文本之间。Word 体积大、大部分功能实际上根本用不到，且最后的文档常常带有许多冗余信息。
而 TXT 却无法实现加粗、标题、下划线、水平分割线等常用的功能。
（这里所说的 TXT 只是一种纯文本格式的代称，实际上 Markdown 也是纯文本文件，不过通过语法和 Markdown 编译器，我们就可以看到一些简单的样式。）
譬如本文就是通过 Markdown 编写。
1 | # 一级标题 |
更多语法（虽然说是更多，但是其实也没多少）：Markdown 基本语法
这是我写的一个 Markdown 样式：star-markdown-css
上面是渲染过后的效果，你可以与其 Markdown 的纯文本原文进行对比。
添加标签/分类
例如本文 Markdown 的头部。
1 | --- |
页面
你可以新建一些自己的自定义页面。
譬如直接在 Hexo 目录下的 source 文件夹下直接新建 HTML 进行编写。
也可以通过以下命令来新建页面。（当然还是 Markdown，不过也是可以在 Markdown 里写 HTML 的，也会被渲染出来。）
1 | hexo new page xxx |
说到这里，就不得不提一提本主题的特色功能了。
生成你的老婆列表页面。按一定格式书写即可。见文档。
预览：Lovely Girls
FAQ
视频？
没有视频，一是懒，二是文字更利于更新勘误。
以及文章中将会频繁出现参考链接，更方便使用。
如何绑定你的自定义域名？
首先，你得有个自己的域名。
避免广告嫌疑，你可以自行前往相关域名提供商购买。
但是如果你有幸能看到谷歌广告（概率较小），可以考虑点一点。
并使用 CNAME 解析到 你的名字.github.io。（当然 A 记录直接解析到 GitHub Pages IP 地址也可以。）
在 Hexo 工作目录下 source 文件夹下新建 CNAME 文件（没有后缀名）。
CNAME 即相当于告诉 GitHub 允许将 xxx.github.io 为你的域名提供服务。
source 目录下的文件除了特殊的 markdown 会被解析为 html，其余都会原样复制到生成的静态文件夹中。
所以你需要在 source 文件夹下建有 CNAME，它会在生成静态文件时，将 CNAME 拷贝到静态文件夹并部署到 master 分支。
如果只是在 GitHub 上设置（项目地址页面 -> Settings -> Options -> GitHub Pages -> Custom domain），它会自动添加到 master 分支上，但随后不包含 CNAME 的部署会将其覆盖。
内容填写你的域名即可。
备案
如果想要使用国内的一些服务，比如 CDN，不备案确实寸步难行。
此处我指的是 ICP 备案，并非公安备案。（实际上我从来没有进行过公安备案，且目前在使用服务时，并未受到任何相关限制。）
我只在腾讯云备案过，所以只能分享一点此方面的经验。
国内备案往往意味着你还需要一台国内的服务器，譬如通过腾讯云备案时会需要你设置关联的服务器（阿里云应当也是如此）。
实际上你的网站并不一定得在这台服务器上，即便你只是免费试用了一个月，但是备案成功了，之后过期了对备案也不会有何影响。
也就是说你完全可以使用学生优惠（10 元左右）购买一个月的云服务器，用于关联，并在这个月内抓紧备案好，此后云服务器过期不会影响备案问题。
学生优惠的话 阿里云 或者 腾讯云 都有。
备案前需要注意的几点就是：
- 确定你的域名是否可以备案（一些少见/独特的域名后缀，国内是无法备案的，比如
moe） - 关闭评论区
- 提交备案时的备注说明不得含有
交流字样 - 首页不能含有其他网站的直达链接
- 遵纪守法无不良信息（这是当然的）
你也可以直接关停网站，等待备案成功后再重新打开。（今后每年偶尔会复查，但相对会宽松许多。）
此后，按照网站指引的备案步骤一步步来即可。（以前还要等待幕布寄送拍照，现在可以直接在手机上人脸验证）
备案成功后页脚必须清晰地展示备案号，且备案号含有指向 http://www.beian.miit.gov.cn/ 的超链接。
更多可能有帮助的内容
其他平台
毕竟自己的站点可能还是不会有什么人看，所以发到其他平台了（然而还是没有人）。不过在这里阅读体验应该是最好的。
- 教你如何从零开始搭建一个属于自己的网站 - 云游君的文章 - 知乎
- 教你如何从零开始搭建一个属于自己的网站 - bilibili 专栏（不支持外链、代码高亮、Markdown，太难了）
- 教你如何从零开始搭建一个属于自己的网站 - 腾讯云（该说不愧是腾讯吗？SEO 绝了。最晚（晚了几个星期）发的，次日搜全名就变百度第一条了。）
结语
个人网站同样可以用来做许多事情，你可以将其用来记录生活、回忆、创作、学习笔记、开发经验等（包括作为一个试验平台）。
可以与熟悉的人分享，也可以作为另一个世界另一个自己的展示。
多年后，回看起自己当初写下的内容，未尝不是件有趣的事情。
善始者众，善终者寡。
臣闻善作者，不必善成；善始者，不必善终。「史记·乐毅列传」
希望大家能有毅力坚持下去，不忘初心。
永远相信美好的事情即将发生
相关讨论与问题，可前往 Discussions 反馈。
主题相关问题请到 Issues ｜ hexo-theme-yun 反馈。
by.yunyoujun
