使用 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 呗!

相关文章
|
弹性计算 网络协议 安全
【图文教程】阿里云服务器开放端口设置(超详细)
阿里云服务器端口怎么打开?云服务器ECS端口在安全组中开启,轻量应用服务器端口在防火墙中打开,阿里云服务器网以80端口为例,来详细说下阿里云服务器端口开放图文教程,其他的端口如8080、3306、443、1433也是同样的方法进行开启端口:
46816 2
|
11月前
|
存储 安全 中间件
Hugo博客搭建教程以及配置调优
Hugo博客搭建教程以及配置调优
528 9
|
11月前
|
开发工具 git
10分钟搭建自己的blog网站
10分钟搭建自己的blog网站
493 6
10分钟搭建自己的blog网站
|
存储 网络安全 PHP
在阿里云服务器上如何搭建网站,网址怎么建站图文教程详解案例及步骤.
做好一个网站不仅需要我们对站点装修及内容发布,也需要我们学会对网站运营,如进行站长推送,将我们内容快速推送到各大搜索平台,有效的让用户能搜索到我们内容,或者需要在谷歌推广就必须对网站添加SSL证书,这样搜索域名的时候搜索框不会出现<不安全>字符在域名前面,以及运行网站要懂运维,出现BUG时要去及时解决查找原因.自始至终自身要不断学习网络相关知识,遇到问题方能迎刃而解. 本文结束,如还有不懂的同学可联系作者,倾力而为,祝您成功!
2411 75
|
Go 开发工具 git
CF+hugo部署要点随记
本文介绍了使用Hugo搭建静态博客的方法,Hugo是一款用Go语言编写的静态站点生成器。文中详细描述了在Windows环境下安装Go、Git和Hugo的步骤,并提供了快速启动指南。此外,还介绍了如何通过Git子模块引入主题,以及如何在本地创建和编辑文章。最后,给出了常用Markdown语法示例,帮助用户轻松撰写博客内容。
791 5
|
存储 安全 网络安全
阿里云国际站:阿里云服务器端口配置
悟空云@CloudWuKong阿里云是全球领先的云计算服务提供商,为用户提供弹性计算、数据库、存储、网络安全等一系列云计算服务。在使用阿里云服务器时,合理配置端口非常重要,可以提高服务器安全性和稳定性。
|
监控 安全 网络协议
永久免费SSL证书教程—自动续签
要实现免费SSL证书的自动续签,选择合适的证书颁发机构(CA)至关重要。推荐使用JoySSL,填写注册码230922可获得免费且支持自动续签的SSL证书。申请步骤包括注册账户、选择证书类型、提交申请、验证域名所有权及安装证书。配置自动续签需安装续签工具、生成密钥和CSR,并设置续签参数。定期检查证书状态、备份证书和密钥,确保续签顺利进行。注意CA机构的政策和服务条款变化,以保持证书的有效性。
|
前端开发 Go iOS开发
如何通过hugo部署一套技术博客
一步一步带你搭建一个完成的技术播客
|
网络协议 应用服务中间件 网络安全
阿里云免费SSL申请流程(白嫖20张SSL免费证书)2024年新版教程
本文详述了2024年最新的阿里云免费SSL证书申请流程。用户可通过阿里云数字证书管理服务控制台一键申请最多20张免费单域名SSL证书,每张证书有效期为3个月。首先登录控制台,选择“SSL证书管理”下的“个人测试证书”,同意协议并完成购买流程。之后需创建证书、输入域名等信息并进行域名验证。验证方法包括手动DNS验证、域名授权自动化验证或文件验证。完成验证后,等待审核通过即可下载适用于不同服务器类型的SSL证书。请注意,阿里云免费SSL证书到期后不支持续费,需重新申请。了解更多详情,请访问阿里云官方SSL证书页面。

热门文章

最新文章

下一篇
开通oss服务