使用 Hugo 快速搭建一个云博客系统

简介: 使用Hugo快速搭建博客,Hugo是基于Go的静态站点生成器,以其简单、高效著称。[官网](https://gohugo.io/) 提供多种主题,如[m10c](https://themes.gohugo.io/themes/hugo-theme-m10c/)等。在Mac上可通过`brew install hugo`安装。创建站点`hugo new site ~/hugo-blog`,

Hugo 快速搭建一个博客系统

Hugo 是由 Go 语言实现的静态网站生成器。简单、易用、高效、易扩展、快速部署。支持 markdown 语法。

hugo-homepage.png

hugo-article-detail.png

这里我使用的主题是 m10c,你也可以使用更多的主题,比如:

blist.png

图文并茂类型的


PaperMod.png

极简类型的


ananke.png

传统博客类型的


m10c.png

极客风格的


安装 Hugo

直接去 Hugo Releases 页面下载对应系统版本的 Hugo 二进制文件即可。

如果是 Mac OS 系统,那么还可以直接使用 Homebrew 安装

brew install hugo

这里不太推荐使用源码安装,可能对一些新手朋友不太友好。老司机,随便怎样,无所谓。

检查 hugo 是否安装成功

# 会打印出 hugo 的版本号
hugo version

创建站点

这里假设在自己的家目录创建站点。

Windows 用户,建议使用 Git Bash

# ~ 表示当前用户的家目录
hugo new site ~/hugo-blog

这里有一点需要说明的是,Hugo 默认是不会提供主题的,需要我们自己去配置一个主题,否则是无法跑起来的。 Hugo 的主题有专门的官方主题网址,不同的主题配置方式也会有所不同,请注意甄别。

这里假设我们只想快速把 Hugo 跑起来,做一下体验。

来吧,安装主题。

# 切换到我们的项目根目录下
cd ~/hugo-blog

# 初始化仓库地址
git init

# 下载一个主题
git clone  https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke

# 将主题写入配置文件,使其使用我们下载的主题
echo "theme = 'ananke'" >> hugo.toml

# 启动 Hugo
hugo server

然后我们在浏览器中访问 http://localhost:1313 即可。

好了,就这么几步,Hugo 就已经跑起来了,是不是很简单?

写文章

光是 Hugo 跑起来还是不行,我们用它主要是来写文章的,那么我们如何写文章呢?请继续往下看。

# 在项目根目录下执行以下命令,即可在 `content/posts` 目录下,创建 `hello.md` 文件
hugo new content posts/hello.md

我们通过编辑器打开 content/posts/hello.md 文件,大致会有以下内容:

---
title: "Hello"
date: 2023-12-01T16:13:46+08:00
draft: true
---

这里我们注意到了 draft: true 表示,默认新建的文章为草稿,如果我们使用 hugo server 启动 Hugo 我们会发现是无法看到我们这篇文章的,解决方式有两种:

第一种,我们将 draft: true 更改成 draft: false,然后执行 hugo server
第二种,我们可以直接使用 hugo server -D 命令,即可。

---
title: "Hello"
date: 2023-12-01T16:13:46+08:00
draft: false
author: "Alex"
description: "文章描述信息"

tags: [
  "我的博客标签1",
  "我的博客标签2",
]

---

## Introduction

Hello, I'm **Alex** ! A Software Engineer and Backend Developer.

This is my blog website `https://pudongping.github.io`

然后我们在浏览器中访问 http://localhost:1313 即可预览到我们写的文章。

如何部署

这里我使用的是 Github Pages 作为演示。你也可以通过访问 https://pudongping.github.io/hugo-blog 来访问我的教程示例。

直接在项目根目录下执行:

# 不需要添加任何参数
hugo

我们即可看到项目根目录下会生成一个 public 目录,我们只需要将 public 目录下的所有文件推送到 Github 仓库中即可。这就涉及到 Github Pages 相关的知识了,这里不做过多的讲解,主要还是讲解 Hugo 的使用。

需要注意的是: 最好每次部署时,先清空 public 目录,然后再使用 hugo 命令生成。

你也想要和我一样的博客?

项目在线访问地址为: https://pudongping.github.io/hugo-blog/

  1. 克隆我的项目仓库
# github
git clone https://github.com/pudongping/hugo-blog.git ~/hugo-blog

# gitee (要是网速不是很好则可以使用 gitee)
git clone https://gitee.com/pudongping/hugo-blog.git ~/hugo-blog
  1. 拉取主题子模块
git submodule update --init --recursive
  1. 直接启动 Hugo 即可
cd ~/hugo-blog && hugo server -D
  1. 你的自定义

将项目根目录下的 hugo.toml 相关配置改成你自己的即可。
然后将 content/posts 目录下我的所有文章删除,添加你自己的文章即可。

就这几步,就完了。恭喜你,又学会了一项新技能!

如果对你有帮助,请帮我点一个 Star 呗!

相关文章
|
存储 JavaScript 编译器
玩转vitepress1.0,搭建个人网站~
当初1月份的时候为了后续春招求职,就使用vitepress搭建了一个个人网站,然后把自己本地的一些md文件整理了发布在了上面,不过当时vitepress还未发布正式版本,还是0.22.x这样的版本, 所以其实有很多不满意的地方,比如侧边栏折叠之前没有,明暗模式之前没有,单篇文章的大纲好像也没有,侧边栏在不同tab下有问题,这些我不太确定,可能功能是有的,但是官方文档上没更新罢了
544 0
|
JavaScript 搜索推荐 程序员
Vuepress + gitee五分钟免费搭建个人博客(保姆级教程)
前言 作为一个程序员,没有折腾过个人博客是不算完整的。技术文章的输出是我们程序员能力的一种体现,也是一种非常好的个人总结。 市面上有很多搭建个人博客的工具或框架,包括hexo、wordpress等等。不可否认,市面上有些博客系统做得很好,博客主题也很丰富,但是往往存在一个问题:比较重。 作为一个Vue程序员,我就比较推荐使用vuepress搭建个人博客,因为它毕竟是Vue出品的,大家熟知的vue官方就是利用vuepress搭建的。 本篇文章就从零开始教大家搭建一个免费的博客,零基础小白也可以学习哦!
2467 0
Vuepress + gitee五分钟免费搭建个人博客(保姆级教程)
|
7月前
|
JavaScript 网络安全 开发工具
[保姆级-从0到1]利用hexo+github托管实现搭建个人博客
[保姆级-从0到1]利用hexo+github托管实现搭建个人博客
|
弹性计算 JavaScript Shell
github+hexo来搭建个人博客——保姆级教程
github+hexo来搭建个人博客——保姆级教程
1737 0
|
JavaScript
使用 hexo 框架 快速搭建个人博客(一)
使用 hexo 框架 快速搭建个人博客(一)
160 0
使用 hexo 框架 快速搭建个人博客(一)
|
搜索推荐 Shell 开发工具
github + hexo 小白超快搭建功能强大的个人博客网站(2)
github + hexo 小白超快搭建功能强大的个人博客网站(2)
157 0
github + hexo 小白超快搭建功能强大的个人博客网站(2)
|
索引
github + hexo 小白超快搭建功能强大的个人博客网站(3)
github + hexo 小白超快搭建功能强大的个人博客网站(3)
145 0
github + hexo 小白超快搭建功能强大的个人博客网站(3)
|
缓存 JavaScript Shell
|
开发工具 数据安全/隐私保护 git
使用 hexo 框架 快速搭建个人博客(二)
使用 hexo 框架 快速搭建个人博客(二)
129 0
使用 hexo 框架 快速搭建个人博客(二)