写代码啦
使用 Hugo 搭建个人博客
回复数(0) 浏览数(38)
{{topic.upvote_count || 0}} 编辑 回复

今天学习了 Hugo ,据说这是目前世界上最快的博客生成器,是用 Go 语言编写的。学完决定写博客,对这个工具的使用进行一些整理,纯新手,如果说的不对还请见谅。

下载 Hugo

鉴于我使用的是 Mac,我就只讲 Mac 的操作了。
因为之间装了 Homebrew,所以我只需要使用brew install hugo命令就可以下载 hugo 到电脑上。然后为了确认自己是否已经安装成功,以及想知道 hugo 的版本,就使用hugo version命令,得到一个V开头的数字串就是安装成功了。

搭建博客网站

这个网站的官网有一个官方引导,写得很详细,只要按照它的引导来就行,这里也简单地说一下大概的步骤
1. hugo new xxxx
xxxx 是新文件夹的名字,因为是作为博客生成器,所以用一个比较有意义的名字,让我们知道这是用来干什么的,所以老师推荐我们用的是 hugo new xxxx.github.io-creator,这里的xxxx就是你 github 的用户名了,比较方便。
2. 使用一个主题
cd 你刚才建的文件夹进入你刚才建的目录里,然后git init,然后使用官网给的示例主题git submodule add https://github.com/budparr/gohugo-theme-ananke.git themes/ananke,可能会有点慢。最后,使用echo 'theme = "ananke"' >> config.toml命令,将这个主题名字写入到配置文件中。
3. 创建第一篇博客
搞定以上步骤之后,就可以创建我们的第一篇博客了,使用
hugo new posts/xxxx.md命令,这里的xxxx就是你的第一篇博客的名字。然后使用你自己的编辑器打开这个文件进行编辑。需要注意的是,打开之后,它文件里原先有的东西,先不要动。另起一行,写下你的第一篇博客。然后回到文件顶部,有一个设置draft: true,将它改成false`,意思就是可以发布让别人看到了。

预览网站

已经写完了博客,那接下来我们需要看一下它的效果。
1. 使用命令hugo server -D来预览你写好的博客网站,看看有没有哪里不对,可以再回去更改。
2. 如果博客是用中文居多的话,我们还需要用编辑器打开config.toml,对其中的东西进行修改。将languageCode = "en-us"中得en-us改成zh-Hans
3. 没有什么问题的话,就可以生成第一篇博客了。使用hugo -D命令,就会在当前目录下生成一个public文件夹,第一篇博客里的东西都在里面。

上传到 GitHub 上

这里我们需要注意一些事,首先就是,我们要把发布的博客和博客生成器分开。分别要有两个仓库,一个用来放博客生成器,另一个用来放你的博客。
1. 为了不将public文件夹里的东西和博客生成器里的东西混淆,我们在博客生成器目录里新建一个.gitignore文件,然后在里面输入/public/,目的是让它上传到github得时候忽略掉public这个文件夹。
2. 进入public文件夹,重新生成一个项目。然后push到github上。

第二篇博客

这样我们的第一篇博客就是完成了,那如果要写第二篇怎么办呢。
1. 在我们的xxxx.github.io-creator目录下,记得千万不要在你的public目录了,运行hugo new posts/xxxx.md。xxxx就是你的第二篇博客名字,然后你就可以进入文件写第二篇博客了。
2. 写完之后,使用命令hugo -D 生成了新的public目录。
3. 进入public目录,使用git命令将你的文件push到github上,稍等一下,就能在网站看到你的第二篇博客了。

做完这些之后,我发现我的博客出现了一个BUG,首页没问题,但是我点击我的博客想看详细内容的时候,出现了奇怪的页面。
1. 找到之前的 config.toml文件,用编辑器打开它,将其中的example.org改成你的博客地址。
2. 然后重新上传到github上更新这个文件,稍等一会儿再打开网站,就正常了。

这些大概就是今天学习的基本收获了,如果有问题以后会进行修改。

{{topic.upvote_count || 0}}

今天学习了 Hugo ,据说这是目前世界上最快的博客生成器,是用 Go 语言编写的。学完决定写博客,对这个工具的使用进行一些整理,纯新手,如果说的不对还请见谅。

下载 Hugo

鉴于我使用的是 Mac,我就只讲 Mac 的操作了。
因为之间装了 Homebrew,所以我只需要使用brew install hugo命令就可以下载 hugo 到电脑上。然后为了确认自己是否已经安装成功,以及想知道 hugo 的版本,就使用hugo version命令,得到一个V开头的数字串就是安装成功了。

搭建博客网站

这个网站的官网有一个官方引导,写得很详细,只要按照它的引导来就行,这里也简单地说一下大概的步骤
1. hugo new xxxx
xxxx 是新文件夹的名字,因为是作为博客生成器,所以用一个比较有意义的名字,让我们知道这是用来干什么的,所以老师推荐我们用的是 hugo new xxxx.github.io-creator,这里的xxxx就是你 github 的用户名了,比较方便。
2. 使用一个主题
cd 你刚才建的文件夹进入你刚才建的目录里,然后git init,然后使用官网给的示例主题git submodule add https://github.com/budparr/gohugo-theme-ananke.git themes/ananke,可能会有点慢。最后,使用echo 'theme = "ananke"' >> config.toml命令,将这个主题名字写入到配置文件中。
3. 创建第一篇博客
搞定以上步骤之后,就可以创建我们的第一篇博客了,使用
hugo new posts/xxxx.md命令,这里的xxxx就是你的第一篇博客的名字。然后使用你自己的编辑器打开这个文件进行编辑。需要注意的是,打开之后,它文件里原先有的东西,先不要动。另起一行,写下你的第一篇博客。然后回到文件顶部,有一个设置draft: true,将它改成false`,意思就是可以发布让别人看到了。

预览网站

已经写完了博客,那接下来我们需要看一下它的效果。
1. 使用命令hugo server -D来预览你写好的博客网站,看看有没有哪里不对,可以再回去更改。
2. 如果博客是用中文居多的话,我们还需要用编辑器打开config.toml,对其中的东西进行修改。将languageCode = "en-us"中得en-us改成zh-Hans
3. 没有什么问题的话,就可以生成第一篇博客了。使用hugo -D命令,就会在当前目录下生成一个public文件夹,第一篇博客里的东西都在里面。

上传到 GitHub 上

这里我们需要注意一些事,首先就是,我们要把发布的博客和博客生成器分开。分别要有两个仓库,一个用来放博客生成器,另一个用来放你的博客。
1. 为了不将public文件夹里的东西和博客生成器里的东西混淆,我们在博客生成器目录里新建一个.gitignore文件,然后在里面输入/public/,目的是让它上传到github得时候忽略掉public这个文件夹。
2. 进入public文件夹,重新生成一个项目。然后push到github上。

第二篇博客

这样我们的第一篇博客就是完成了,那如果要写第二篇怎么办呢。
1. 在我们的xxxx.github.io-creator目录下,记得千万不要在你的public目录了,运行hugo new posts/xxxx.md。xxxx就是你的第二篇博客名字,然后你就可以进入文件写第二篇博客了。
2. 写完之后,使用命令hugo -D 生成了新的public目录。
3. 进入public目录,使用git命令将你的文件push到github上,稍等一下,就能在网站看到你的第二篇博客了。

做完这些之后,我发现我的博客出现了一个BUG,首页没问题,但是我点击我的博客想看详细内容的时候,出现了奇怪的页面。
1. 找到之前的 config.toml文件,用编辑器打开它,将其中的example.org改成你的博客地址。
2. 然后重新上传到github上更新这个文件,稍等一会儿再打开网站,就正常了。

这些大概就是今天学习的基本收获了,如果有问题以后会进行修改。

38
回复 编辑