入门

2020-10-19
3分钟阅读时长

在本文中你将了解到如何快速搭建一个Eureka主题的Hugo网站。

前提

正常使用Eureka需要安装以下内容:

安装

Eureka可以快速集成于Hugo项目中,目前Eureka可以通过Git SubmoduleHugo 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 serverhugo不会生成草稿内容。生成的网页位于public文件夹内。你可以将其部署于Github Pages或Netlify等静态网页部署平台上。

下一页 内容管理