Hugo 主题 Echo 使用教程

Hugo 主题 Echo 使用教程

hugo-theme-echoA super concise theme for Hugo 项目地址:https://gitcode.com/gh_mirrors/hu/hugo-theme-echo

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

hugo-theme-echo/
├── archetypes/
│   └── default.md
├── assets/
│   └── css/
│       └── main.css
├── layouts/
│   ├── _default/
│   │   ├── baseof.html
│   │   ├── list.html
│   │   └── single.html
│   ├── partials/
│   │   ├── footer.html
│   │   ├── header.html
│   │   └── sidebar.html
│   └── index.html
├── static/
│   ├── images/
│   └── js/
├── .gitignore
├── LICENSE
├── README.md
├── config.toml
└── theme.toml

• archetypes/: 包含默认的内容模板文件。
• assets/: 存放CSS和JavaScript文件。
• layouts/: 包含网站的HTML模板文件。
• static/: 存放静态资源文件，如图片和JavaScript文件。
• .gitignore: Git忽略文件配置。
• LICENSE: 项目许可证。
• README.md: 项目说明文档。
• config.toml: 项目配置文件。
• theme.toml: 主题配置文件。

2. 项目的启动文件介绍

• config.toml: 这是Hugo项目的核心配置文件，包含了网站的基本设置，如标题、描述、导航菜单等。

3. 项目的配置文件介绍

config.toml

baseURL = "https://example.com/"
languageCode = "en-us"
title = "My Blog"
theme = "hugo-theme-echo"

[params]
  htmlClass = "dark" # 可选，默认是空，为light
  favicon = "https://avatars0.githubusercontent.com/u/1725326?s=460&v=4"
  keywords = "Hugo theme echo"
  description = "Hugo theme echo example site"
  toc = true
  navItems = [
    ["HOME", "/"],
    ["ARCHIVE", "/posts.html"],
    ["ABOUT", "/about.html"],
    ["RSS", "/atom.xml"]
  ]
  # rss 全文输出
  rssFullContent = true
  uglyURLs = true
  busuanzi = true # 是否使用不蒜子统计站点访问量
  staticCDNPrefix = "https://cdn.bootcss.com/font-awesome/5.11.2"
  extraHead = '<script async src="https://www.googletagmanager.com/gtag/js?id=UA-xxx"></script>'
  postAds = ""
  profileAds = '<div class="bg-white shadow"><img class="object-cover w-auto mx-auto mt-6" src="https://blog-1251237404.cos.ap-guangzhou.myqcloud.com/20190424153337.png" alt="微信打赏"></div>'
  notFoundAds = ''

• baseURL: 网站的基本URL。
• languageCode: 网站的语言代码。
• title: 网站的标题。
• theme: 使用的主题名称。
• params: 包含各种参数设置，如HTML类、favicon、关键词、描述、目录、导航菜单等。

theme.toml

name = "hugo-theme-echo"
license = "MIT"
min_version = "0.55.0"

[author]
  name = "forecho"
  homepage = "https://forecho.com/"

[params]
  htmlClass = "dark" # 可选，默认是空，为light
  favicon = "https://avatars0.githubusercontent.com/u/1725326?s=460&v=4"
  keywords = "Hugo theme echo"
  description = "Hugo theme echo example site"
  toc = true
  navItems = [
    ["HOME", "/"],
    ["ARCHIVE", "/posts.html"],
    ["ABOUT", "/about.html"],
    ["RSS", "/atom.xml"]
  ]
  # rss 全文输出
  rss

hugo-theme-echoA super concise theme for Hugo 项目地址:https://gitcode.com/gh_mirrors/hu/hugo-theme-echo