Yihui.org 开源项目教程

庞锦宇

于 2025-04-22 07:01:28 发布

阅读量551

点赞数 8

本文链接：https://blog.csdn.net/gitblog_00092/article/details/147406066

版权

Yihui.org 开源项目教程

yihui.org Personal website and discussion board of Yihui Xie | 谢益辉项目地址: https://gitcode.com/gh_mirrors/yi/yihui.org

1. 项目的目录结构及介绍

yihui.org 项目是一个基于 Markdown 和 Hugo 静态网站生成器的个人网站。以下是项目的目录结构及其介绍：

content/：存放网站的 Markdown 内容文件。
static/：存放静态文件，如图片、CSS 和 JavaScript 文件。
themes/：存放网站主题文件。
.gitmodules：定义子模块，如 Hugo 主题。
config.yaml：配置文件，定义网站的元数据和其他设置。
README.md：项目的说明文件。
LICENSE：项目使用的许可证文件。
build.sh：构建网站的脚本文件。
其他文件和目录，如 .Rprofile、.gitignore 等，用于项目特定的配置和设置。

2. 项目的启动文件介绍

项目的启动主要是通过 Hugo 生成静态网站。以下是启动项目的基本步骤：

确保已经安装了 Hugo。

克隆项目到本地：

git clone --recursive git@github.com:yihui/yihui.org.git

进入项目目录：
```
cd yihui.org
```
构建网站：
```
hugo
```
运行本地服务器查看网站：
```
hugo server
```

在完成上述步骤后，你可以在浏览器中访问 http://localhost:1313 查看生成的网站。

3. 项目的配置文件介绍

项目的配置文件为 config.yaml，它控制了网站的行为和外观。以下是一些主要的配置项：

baseURL：网站的根 URL。
languageCode：网站的语言代码。
title：网站标题。
theme：使用 Hugo 主题的名称。
paginate：分页设置。
disqusShortname：Disqus 的短名称，用于评论系统。
googleAnalytics：谷歌分析跟踪 ID。

例如：

baseURL: "https://yihui.org"
languageCode: "zh-cn"
title: "谢益辉的个人网站"
theme: "hugo-ivy"
paginate: 5
disqusShortname: "yihuiorg"
googleAnalytics: "UA-123-45"

通过修改 config.yaml 文件，你可以自定义网站的行为和外观，以满足你的需求。

yihui.org Personal website and discussion board of Yihui Xie | 谢益辉项目地址: https://gitcode.com/gh_mirrors/yi/yihui.org