在本文中你将了解到如何快速搭建一个Eureka主题的Hugo网站。
前提
正常使用Eureka需要安装以下内容:
安装
Eureka可以快速集成于Hugo项目中,目前Eureka可以通过Git Submodule及Hugo Modules两种方式进行安装。
Hugo Modules需要Go 1.12及以上版本,推荐所有拥有或愿意安装Go的用户使用此方式进行安装。
使用Git Submodule安装
如果当前环境下拥有或愿意安装Go 1.12及以上版本,可以使用更为方便快捷的Hugo Modules进行安装。
使用Git Submodule安装时您只需在项目位置下执行:
git submodule add https://github.com/wangchucheng/hugo-eureka.git themes/eureka
接下来,将exampleSite中的config
文件夹复制到项目根目录下,对config
文件夹的内容进行配置。配置后删除原先的config.toml
文件即可。
完成以上步骤后使用以下命令即可在浏览器中预览项目:
hugo server
草稿不会被Hugo部署,所以你需要将内容头部的draft
属性设为false
或使用hugo server -D
预览网站。
如果你对Hugo的基础用法并不熟悉或想了解更多Hugo相关的内容,可以参考Hugo Basic Usage。
使用Hugo Modules安装
使用Hugo Modules安装Eureka时需要Go 1.12及以上版本,推荐所有满足依赖要求的用户使用此方式进行安装。
首先,在项目根目录下初始化一个新的Hugo Module:
hugo mod init <module_name>
接下来,将exampleSite中的config
文件夹复制到项目根目录下,对config
文件夹的内容进行配置。
最后将config/_default/config.toml
中的theme = "eureka"
注释并将theme = "github.com/wangchucheng/hugo-eureka"
取消注释。配置后删除原先的config.toml
文件即可。
完成以上步骤后使用以下命令即可在浏览器中预览项目:
hugo server
草稿不会被Hugo部署,所以你需要将内容头部的draft
属性设为false
或使用hugo server -D
预览网站。
如果你对Hugo的基础用法并不熟悉或想了解更多Hugo相关的内容,可以参考Hugo Basic Usage。
添加内容
安装Eureka后,即可开始向网站中添加相应内容。你可以在content
文件夹中手动创建文件并添加信息。同时你也可以使用hugo new
为你完成以上内容。
在项目中添加一篇默认类型的内容:
hugo new posts/hello-world.md
这会帮助你在content/post
文件夹下生成一篇内容如下的文件。
+++
title = "Hello World"
description = ""
toc = true
authors = []
tags = []
categories = []
series = []
date = "2020-10-20T10:30:48+08:00"
lastmod = "2020-10-20T10:30:48+08:00"
featuredImage = ""
draft = false
+++
你可以对其中的值进行修改或在文件最后的+++
后开始编写你的正文内容。
Eureka还为你提供了其他类型的模板,你可以通过-k KIND
指定类型:
hugo new -k authors authors/new-author
这会在content/authors
文件夹下生成作者类型的内容。
Eureka提供的全部内容类型可以参考archetypes。
修改配置
由于Eureka致力于提供一个高度可定制且功能丰富的主题,因此我们将自动生成的config.toml
文件替换为config
文件夹以提供更清晰的结构。你可以修改配置文件中的任意内容:
title = "My Own Title"
生成网站
生成网站只需:
hugo
类似于hugo server
,hugo
不会生成草稿内容。生成的网页位于public
文件夹内。你可以将其部署于Github Pages或Netlify等静态网页部署平台上。