创建hugo博客
您是否想创建一个博客以与各种软件框架共享您的最新经历? 您是否喜欢一个文献记载不充分的项目,并希望解决该问题? 还是只想创建一个个人网站?
许多想开博客的人都有一个重大警告:缺乏对内容管理系统(CMS)的知识或学习时间。 好吧,如果我说您不需要花几天时间学习新的CMS,建立基本的网站,对其进行样式设置以及对攻击者进行强化,该怎么办? 如果我说您可以在30分钟之内与Hugo建立博客,从头开始到结束怎么办?
Hugo是用Go语言编写的静态网站生成器。 你问为什么要使用雨果?
- 因为没有数据库,没有插件需要任何权限,并且服务器上没有运行任何基础平台,所以不会增加安全性。
- 该博客是一组静态网站,这意味着闪电般的服务时间。 此外,所有页面均在部署时呈现,因此服务器的负载很小。
- 版本控制很容易。 一些CMS平台使用自己的版本控制系统(VCS)或将Git集成到其界面中。 使用Hugo,您所有的源文件都可以在您选择的VCS上本地运行。
0-5分钟:下载Hugo并生成一个网站
为了简化Hugo的安装,请下载二进制文件。 为此:
- 下载适合您的操作系统的存档 。
- 将档案解压缩到您选择的目录中,例如
C:\hugo_dir
或~/hugo_dir
; 该路径将称为${HUGO_HOME}
。 - 打开命令行并转到目录:
cd ${HUGO_HOME}
。 - 验证雨果是否在工作:
- 在Unix上:
${HUGO_HOME}/[hugo version]
- 在Windows上:
${HUGO_HOME}\[hugo.exe version]
例如,c:\hugo_dir\hugo version
。
为了简单起见,我将把Hugo二进制文件(包括二进制文件)的路径称为
hugo
。 例如,hugo version
将在您的计算机上转换为C:\hugo_dir\hugo version
。如果收到错误消息,则可能是下载了错误的版本。 还请注意,有很多可能的方法来安装Hugo。 有关更多信息,请参见官方文档 。 理想情况下,您将Hugo二进制文件放在PATH上。 为了快速入门,可以使用Hugo二进制文件的完整路径。
- 在Unix上:
- 创建一个将成为您博客的
hugo new site awesome-blog
:hugo new site awesome-blog
。 - 转到新创建的目录:
cd awesome-blog
。
恭喜你! 您刚刚创建了新博客。
5-10分钟:主题化您的博客
使用Hugo,您既可以自己为博客设置主题,也可以使用一种精美的现成主题 。 我选择Kiera是因为它非常美味。 要安装主题:
- 进入主题目录:
cd themes
。 - 克隆您的主题:
git clone https://github.com/avianto/hugo-kiera kiera
。 如果您尚未安装Git:- 从GitHub下载.zip文件。
- 将其解压缩到站点的
themes
目录。 - 将目录从
hugo-kiera-master
重命名为kiera
。
- 将目录更改为awesome-blog级别:
cd awesome-blog
。 - 激活主题。 主题(包括Kiera)通常带有一个名为
exampleSite
的目录,该目录包含示例内容和示例设置文件。 要激活Kiera,请将提供的config.toml
文件复制到您的博客中:- 在Unix上:
cp themes/kiera/exampleSite/config.toml .
- 在Windows上:
copy themes\kiera\exampleSite\config.toml .
- 确认
Yes
以覆盖旧的config.toml
- 在Unix上:
- (可选)您可以启动服务器以直观地验证主题是否已激活:
hugo server -D
并在Web浏览器中访问http://localhost:1313
。 查看博客后,您可以通过在命令行中按Ctrl+C
来关闭服务器。 您的博客为空,但是我们到了某个地方。 它看起来应该像这样:
您刚刚以博客为主题! 您可以在雨果官方主题网站上找到数百个精美的主题。
10-20分钟:将内容添加到您的博客
虽然碗在空的时候最有用,但对于博客而言却并非如此。 在此步骤中,您将向博客添加内容。 雨果和Kiera主题简化了此过程。 要添加您的第一篇文章:
- 文章原型是您内容的模板。
- 将主题原型添加到您的博客站点:
- 在Unix上:
cp themes/kiera/archetypes/* archetypes/
- 在Windows上:
copy themes\kiera\archetypes\* archetypes\
- 确认
Yes
覆盖default.md
原型
- 在Unix上:
- 为您的博客文章创建一个新目录:
- 在Unix上:
mkdir content/posts
- 在Windows上:
mkdir content\posts
- 在Unix上:
- 使用Hugo生成您的帖子:
- 在Unix上:
hugo new posts/first-post.md
- 在Windows上:
hugo new posts\first-post.md
- 在Unix上:
- 在您选择的文本编辑器中打开新帖子:
- 在Unix上:
gedit content/posts/first-post.md
- 在Windows上:
notepad content\posts\first-post.md
- 在Unix上:
此时,您可以疯狂了。 请注意,您的帖子由两部分组成。 第一个用+++
分隔。 它包含有关您的帖子的元数据,例如标题。 在雨果中,这称为前沿问题 。 在前面的问题之后,文章开始。 创建第一篇文章:
+++
title = "First Post"
date = 2018-03-03T13:23:10+01:00
draft = false
tags = ["Getting started"]
categories = []
+++
Hello Hugo world! No more excuses for having no blog or documentation now!
现在您需要做的就是启动服务器: hugo server -D
。 打开浏览器,然后输入: http://localhost:1313/
。
20-30分钟:调整您的网站
我们所做的事情很棒,但仍有一些小问题需要解决。 例如,命名您的网站很简单:
- 通过在命令行上按
Ctrl+C
来停止服务器。 - 打开
config.toml
并编辑设置,例如博客的标题,版权,名称,社交网络链接等。
再次启动服务器时,您会看到博客的个性化程度更高。 缺少另一项基本功能:菜单。 这也是一个快速修复。 返回config.toml
,在底部插入以下内容:
[[menu.main]]
name = "Home" #Name in the navigation bar
weight = 10 #The larger the weight, the more on the right this item will be
url = "/" #URL address
[[menu.main]]
name = "Posts"
weight = 20
url = "/posts/"
这将添加“主页”和“帖子”菜单。 您仍然需要一个关于页面。 而不是从config.toml
文件引用它,而是从markdown文件引用它:
- 创建一个About文件:
hugo new about.md
。 请注意,它是about.md
,而不是posts/about.md
。 “关于”页面不是博客文章,因此您不希望其显示在“文章”部分中。 - 在文本编辑器中打开文件,然后输入以下内容:
+++
title = "About"
date = 2018-03-03T13:50:49+01:00
menu = "main" #Display this page on the nav menu
weight = "30" #Right-most nav item
meta = "false" #Do not display tags or categories
+++
> Waves are the practice of the water. Shunryu Suzuki
当启动Hugo服务器并打开http://localhost:1313/
,您应该会看到准备使用新博客。 (在我的GitHub页面上查看我的示例 。)如果您想更改菜单项的活动样式以使填充更好一点(例如GitHub实时版本),请将此补丁应用于您的themes/kiera/static/css/styles.css
文件。
翻译自: https://opensource.com/article/18/3/start-blog-30-minutes-hugo
创建hugo博客