我是如何建立这个网站的

2022-09-24
作者 Jinky
~2.39K 字

1. 安装Hexo
2. 启动项目
3. 部署到GitHub pages
4. 书写第一篇博客
5. 套用一个主题
6. 本地预览
7. 使用SSH配置git

从知乎上的回答来看，主流的Markdown建立静态网页的方式有三种

JekyII
Hexo
hugo

而因为本人的电脑上刚好事先安装了Node.js所以为了方便起见选择了第二种

安装Hexo

在安装好Node.js后，只需要在Shell输入以下命令即可安装Hexo

1	npm install -g hexo-cli

再安装完成后输入hexo help测试是否正确安装，如果成功安装，应得到以下结果

Usage: hexo <command>

Commands:
  help     Get help on a command.
  init     Create a new Hexo folder.
  version  Display version information.

Global Options:
  --config  Specify config file instead of using _config.yml
  --cwd     Specify the CWD
  --debug   Display all verbose messages in the terminal
  --draft   Display draft posts
  --safe    Disable all plugins and scripts
  --silent  Hide output on console

For more help, you can use 'hexo help [command]' for the detailed information
or you can check the docs: http://hexo.io/docs/

启动项目

先为自己的网页新建一个目录，在目录中使用命令，以生成必要的文件

hexo init

此时项目已经基本可以使用了，输入hexo n <新文章名称>即可开始第一篇博客的书写

部署到GitHub pages

首先需要在自己的GitHub网页版中新建一个repo，而repo名必须确保为<用户名>.github.io。如果用户名都是大小写混合的，因为域名不区分大小写，所以只需要将用户名的全小写填入即可。

如本人的GitHub用户名为Jinky-X，repo名则填写jinky-x.github.io

repo建立后，还需要启用hexo的git部署功能，输入以下命令进行安装

1	npm install hexo-deployer-git --save

最后，修改网站目录下的_config.yml中,Deployment的部分设置为

deploy:
  type: git
  repo: <你的repo地址>
  branch: master

命令行输入以下命令即可完成第一次部署

1 2	hexo g # generate 生成博客的HTML文件 hexo d # deploy

值得注意的一点是，由于国内访问GitHub并不是很顺利，如果push使用HTTPS方式可能会被连接重置(原因略)，所以更推荐使用ssh方式。(ssh的准备附在文后)

书写第一篇博客

上面已经提到过，使用hexo n <标题>可以开始一篇文章的写作，输入该命令后，会在source/_post目录下生成<标题>.md文件，在这个文件下书写你的文章即可。文章完成后，记得将它生成为HTML文件

1	hexo g # generate 生成博客的HTML文件

套用一个主题

我这里使用的是Kratos-Rebirth主题，具体安装配置过程可以参考其网站，和文档站
一键安装请使用以下命令

1	npm install --save hexo-theme-kratos-rebirth

本地预览

部署到GitHub Pages前，我们可以先本地预览博客站的效果

1	hexo s # server 建立一个server

此时再前往localhost:4000即可预览博客

当你认为万事具备之后，使用hexo d正式部署到GitHub上

使用SSH配置git

在命令行中输入以下命令生成秘钥对

1	ssh-keygen

之后的交互全部按enter使用默认配置即可。生成秘钥后，在用户文件夹/.ssh目录下会生成两个文件

id_rsa
id_rsa.pub

其中前者为私钥，永远不能让别人知道；后者为公钥，我们将要使用它

永远不要将私钥交给别人

可以直接输入以下命令获取公钥

cat ~/.ssh/id_rsa.pub # linux用户使用

cat $env:userprofile\.ssh\id_rsa.pub  # powershell 用户使用

cat %USERPROFILE%\.ssh\id_rsa.pub  # CMD用户使用 (这玩意真的有人用吗)

打开GitHub秘钥配置页面,点击New SSH key即可添加秘钥(注意是放公钥不是私钥

添加完成后，回到shell界面做一下测试

1	ssh -T git@github.com

初次输入会询问是否信任公钥，如果自己目前的网络不安全，可以跟GitHub官方提供的公钥核对一下
看到以下结果即说明配置成功

1	Hi <用户名>! You've successfully authenticated, but GitHub does not provide shell access.

该内容采用 CC BY-NC-ND 4.0 许可协议，著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。

开发经验分享站