前言

曾听闻前辈所言,作为一名程序员一定要多写博客,既能加深自己的理解,方便日后再次使用,也可能给别人带来帮助。我不奢求给别人带来什么帮助,只想为自己即将走过半程的本科阶段最后能留下些值得回味的东西。从小白一路走来,算是浅浅入了程序员的门,也逐渐开始写一些小项目。在学习技术的过程中,很多知识都需要依靠自学。我在这里将自己走过的路记录下来、分享出来,若能被有缘人看到并提供了帮助,这是很幸福的事情。另一方面,看到身边的许多人都拥有自己的博客,也算是随了一个潮流。

我并不是一个勤于记录的人,很可能一段时间后就停止记录和维护了,不过还是希望能一路坚持下去吧。平时在学业方面的压力还是有的,也不一定能抽出很多时间来记录,像现在这样有一大段空闲时间的机会很难得,也不知道下一次是什么时候了,所以,且写且珍惜吧。

博客的建立

建这篇博客并没有花我太多的时间,一方面我已经装好node.js,并且在macOS系统中使用brew安装hexo也非常方便,另一方面我的github也已绑定ssh密钥,使用github page很方便。下面大概说明在macOS系统下建博的步骤:

  1. 安装node.js

    1.1.官网安装包:https://nodejs.org/en/

    1.2.使用homebrew下载:brew install node

  2. 安装hexo

    使用homebrew下载:brew install hexo

    使用homebrew安装时需要梯子,否则速度奇慢或者直接无法连接

  3. 创一个新的文件夹,如Blog.Test,然后进入该文件夹,并初始化一个hexo博客

    1
    2
    3
    mkdir Blog.Test
    cd Blog.Test
    hexo init
  4. hexo的几个常用命令

    1
    2
    3
    4
    5
    6
    hexo init               # 在当前目录初始化helloworld博客模板,可以在此基础上修改
    hexo new "post-name" # 新建文章,在source中的.md文件中修改保存即可
    hexo clean (hexo cl) # 清除缓存文件db.json和已生成的静态页面所在的public目录
    hexo generate (hexo g) # 生成静态页面至public目录
    hexo server (hexo s) # 开启本地预览,默认布置在端口4000上
    hexo deploy (hexo d) # 将项目部署到Github上

    一般情况下,当本地对博客进行更新后,可以使用hexo g hexo s hexo d更新到Github仓库上。

  5. hexo主题

    hexo官方提供了很多主题:https://hexo.io/themes/,当然也可以自行DIY设计。我使用了别人的butterfly主题,步骤如下:

    1. 在项目目录下clone该主题的远程仓库
    1
    git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly
    1. 修改配置文件
    1
    vi _config.yml

    hexo init时应该会自动生成_config.yml文件,修改其中的theme属性并保存,

    1
    theme: butterfly

    然后安装hexo渲染器,

    1
    npm install hexo-renderer-pug hexo-renderer-stylus --save

    此时在本地生成并运行页面,即可在端口4000看到自己的博客,

    1
    2
    hexo g
    hexo s
  6. 上传Github仓库

    首先你得有个Github账号,并建立一个仓库,命名为"<your github name>.github.io",然后在配置文件_config.yml中修改deploy属性并保存,

    1
    2
    3
    4
    deploy:
    type: git
    repository: <your github repository>
    branch: main

    然后安装自动部署发布工具:

    1
    npm install hexo-deployer-git --save

    最后hexo generatehexo deploy即可,在hexo d时会询问Github的账号和密码,由于2020年7月起Github不再支持密码登陆,因此需要设定一个token令牌,在输入密码时直接粘贴令牌即可;令牌的设置在Github网页端,点击右上角头像,下拉菜单中的Settings,如下图所示:注意新生成的令牌需要及时复制,因为它只出现一次;当某个项目(比如这个博客)在第一次deploy时设定令牌后,后续deploy便自动通过。

    当然也可以通过设定Github账号密钥进行绑定,即ssh密钥,可以自行网上查找教程,一般是将~/.ssh目录下的id_rsa.pub公钥复制到Github网页端对应的地方即可;设定要ssh密钥后,在以后push仓库时便不需要再次输入密码或令牌了。

  7. 访问GitPage个人博客

    如果成功hexo deploy,那么你已经能在<your github name>.github.io访问到你的个人博客了,到此也是你现在看到的我的这个博客的样子。当然后续我会继续更改样式、美化网站,但我现在得先写一些之前比赛的总结,否则我再也写不出来了(忘光了)。