前言

笔者之前使用过很多的笔记类的软件,如:leanote、印象笔记、onenote等,最后感觉不是这款软件少了这个功能,就是那款软件少了那个功能。于是决定自己搭建一个个人博客,自己需要的功能很简单,同时,也可以定制自己的博客主题,还能够更好的管理自己的文章,更重要的是,我一直梦想着有自己的一台笔记本,周末等业余时间,找一家咖啡厅,点上一杯咖啡,耳机里面听着轻音乐,敲着代码……乐不思蜀。哈哈哈,于是自己不断折腾,总结出来了一种比较完善的流程。现在分享给大家~

但是,笔者不会分享具体的使用,只会简单的介绍一下实现的思路。这就需要读者需要具有一定的基础:atom的使用、git的使用、GitHub的使用以及hugo的使用。

配置写作环境

搭建的个人博客,是使用hugo作为静态网页生成工具,使用markdown作为原生文章文件扩展名的。因此我们需要在自己的电脑上面搭建一个可以markdown的编辑器。

atom的安装与配置

atom工具是一款开源的编辑器,功能丰富,在这里我们使用它作为我们的markdown编辑器。

  • 安装

直接去官方网站,下载atom的exe执行文件,然后双击进行安装。安装完毕之后,在桌面上会出现快捷方式,并且在命令行中,也可以使用apm -version命令查看具体的版本。(关于apm可以自行百度安装)注意:下载文件的速度有些慢。

  • 设置

这个步骤可选。打开file-settings,把主题调节成atom-light。

  • 设置国内源

atom功能丰富的一个根本原因在于它有着丰富的插件库。在这里,我们需要使用两三个插件:

1
2
3
4
platformio-ide-terminal
markdown-priview-plus
markdown-writer
markdown-scroll-sync

但是,我们在packages里面进行安装的时候,发现很慢,这是由于墙的问题,所以,我们可以先行配置atom的源。

打开cmd,在cmd里面执行apm config set registry http://registry.npm.taobao.org,将atom的源修改为淘宝的源。

  • 安装插件

安装插件的命令很简单,只需要在cmd中执行apm install XXXX即可。

git的安装与配置

  • 安装

git的安装很简单,只需要下载好git,然后双击进行安装即可。当然,需要注意的是需要生成sshkey,然后配置到github上去。

hugo的安装与配置

  • 安装

这里需要注意,笔者的hugo版本是0.48版本,需要特别注意这一点,只需要把下载好的hugo.exe放到对应的安装目录下面即可。

  • 设置环境变量

设置环境变量,这样在cmd里面任何位置都可以使用hugo命令了。

写作

文章实时预览

安装好atom里面的terminal工具之后,就可以在atom中打开实时预览,这样可以一边在atom编写文章,一边又可以在浏览器中实时预览文章的具体效果。

生成一篇新文章

如果需要生成一篇新的文章的时候,可以使用hugo new ./post/xxxx.md命令进行生成,其中命令中的点是以content作为根目录的。

提交文章并完成部署过程

编写完成一篇文章,并且在浏览器中实时预览发现没有问题之后,就可以进行提交了,我们使用的是github账号,所以,我们也需要提交到GitHub仓库。

提交仓库需要命令很多,故此,笔者写了一个sh的脚本,这样可以直接执行脚本即可。执行时可以新开一个terminal的命令窗口,输入./deploy.sh "这是注释"即可。

注意

  1. 要注意git安装过程中的某些配置。(sshkey配置、用户名和密码等的配置)
  2. hugo的版本好没有用对,导致文章的导航目录丢失。