README

Hugo-Bootstrap-CSS

目录

简介

本仓库为Hugo使用BootstrapCSS模板,仓库在

https://github.com/huzhenghui/Hugo-Bootstrap-CSS/

效果参见

https://huzhenghui.github.io/Hugo-Bootstrap-CSS/

本文发表在

https://blog.csdn.net/hu_zhenghui/article/details/128676150

版本

v0.1

初始版本,位置在

https://github.com/huzhenghui/Hugo-Bootstrap-CSS/tree/v0.1

仓库结构

命令

tree -a -F -I '.git/'

结果

./
├── .github/
│   └── workflows/
│       └── hugo.yml
├── README.md
├── archetypes/
│   └── default.md
├── config.toml
├── content/
│   └── posts/
│       ├── README.md -> ../../README.md
│       └── _index.md
├── data/
├── layouts/
│   ├── _default/
│   │   ├── baseof.html
│   │   └── list.html
│   └── posts/
│       └── single.html
├── public/
├── resources/
│   └── _gen/
│       ├── assets/
│       └── images/
├── static/
└── themes/

16 directories, 9 files

GitHub Action

使用GitHub自动创建的Hugo Action,位置在

https://github.com/huzhenghui/Hugo-Bootstrap-CSS/blob/master/.github/workflows/hugo.yml

Since v0.1

https://github.com/huzhenghui/Hugo-Bootstrap-CSS/blob/v0.1/.github/workflows/hugo.yml

README.md

本文件,位置在

https://github.com/huzhenghui/Hugo-Bootstrap-CSS/blob/master/README.md

Since v0.1

https://github.com/huzhenghui/Hugo-Bootstrap-CSS/blob/v0.1/README.md

原型(内容模板)

Hugo自动创建的文件,位置在

https://github.com/huzhenghui/Hugo-Bootstrap-CSS/blob/master/archetypes/default.md

Since v0.1

https://github.com/huzhenghui/Hugo-Bootstrap-CSS/blob/v0.1/archetypes/default.md

---
title: "{{ replace .Name "-" " " | title }}"
date: {{ .Date }}
draft: true
---

Hugo配置

Hugo的配置文件,位置在

https://github.com/huzhenghui/Hugo-Bootstrap-CSS/blob/master/config.toml

Since v0.1

https://github.com/huzhenghui/Hugo-Bootstrap-CSS/blob/v0.1/config.toml

baseURL      = 'https://huzhenghui.github.io/Hugo-Bootstrap-CSS/'
languageCode = 'zh-cn'
title        = 'Hugo Bootstrap CSS'

内容

content/posts/README.md

软链接到根目录的README.md README.md 文件,位置在

https://github.com/huzhenghui/Hugo-Bootstrap-CSS/blob/master/content/posts/README.md

Since v0.1

https://github.com/huzhenghui/Hugo-Bootstrap-CSS/blob/v0.1/content/posts/README.md

content/posts/_index.md

索引页,内容显示在

https://huzhenghui.github.io/Hugo-Bootstrap-CSS/posts/

文件位置在

https://github.com/huzhenghui/Hugo-Bootstrap-CSS/blob/master/content/posts/_index.md

Since v0.1

https://github.com/huzhenghui/Hugo-Bootstrap-CSS/blob/v0.1/content/posts/_index.md

---
title: Hugo Bootstrap CSS Posts(索引页标题)
date: 2023-01-13
publishdate: 2023-01-13
---

# Hugo Bootstrap CSS Posts
(索引页正文内容)

模板

layouts/_default/baseof.html

基本模板,位置在

https://github.com/huzhenghui/Hugo-Bootstrap-CSS/blob/master/layouts/_default/baseof.html

Since v0.1

https://github.com/huzhenghui/Hugo-Bootstrap-CSS/blob/v0.1/layouts/_default/baseof.html

<!DOCTYPE html>
<html lang="zh-CN">

<head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>{{ block "title" . }}
        {{ .Site.Title }}
        {{ end }}
    </title>
    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.2.3/dist/css/bootstrap.min.css" rel="stylesheet"
        integrity="sha384-rbsA2VBKQhggwzxH7pPCaAqO46MgnOM80zW1RWuH61DGLwZJEdK2Kadq2F9CUG65" crossorigin="anonymous">
</head>

<body class="container">
    {{ block "main" . }}
    {{ end }}
    {{ block "footer" . }}
    {{ end }}
</body>

</html>

layouts/_default/list.html

列表页面模版,效果参见

https://huzhenghui.github.io/Hugo-Bootstrap-CSS/posts/

文件位置在

https://github.com/huzhenghui/Hugo-Bootstrap-CSS/blob/master/layouts/_default/list.html

Since v0.1

https://github.com/huzhenghui/Hugo-Bootstrap-CSS/blob/v0.1/layouts/_default/list.html

{{ define "main" }}
<main>
    <article>
        <header>
            <h1 class="display-1">{{.Title}}</h1>
        </header>
        {{.Content}}
    </article>
    <ul class="list-group list-group-flush">
        {{ range .Pages }}
        <li class="list-group-item">
            <a class="link-primary" href="{{.Permalink}}">{{.Date.Format "2006-01-02"}} | {{.Title}}</a>
        </li>
        {{ end }}
    </ul>
</main>
{{ end }}

layouts/posts/single.html

单独页面模板,效果参见

https://huzhenghui.github.io/Hugo-Bootstrap-CSS/posts/readme/

文件位置在

https://github.com/huzhenghui/Hugo-Bootstrap-CSS/blob/master/layouts/posts/single.html

Since v0.1

https://github.com/huzhenghui/Hugo-Bootstrap-CSS/blob/v0.1/layouts/posts/single.html

{{ define "main" }}
<section id="main">
    <h1 id="title" class="display-1">{{ .Title }}</h1>
    <div>
        <article id="content" class="lead">
            {{ .Content }}
        </article>
    </div>
</section>
<aside id="meta">
    <div>
        <section>
            <h4 id="date"> {{ .Date.Format "Mon Jan 2, 2006" }} </h4>
            <h5 id="wordcount"> {{ .WordCount }} Words </h5>
        </section>
        {{ with .GetTerms "topics" }}
        <ul id="topics">
            {{ range . }}
            <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
            {{ end }}
        </ul>
        {{ end }}
        {{ with .GetTerms "tags" }}
        <ul id="tags">
            {{ range . }}
            <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
            {{ end }}
        </ul>
        {{ end }}
    </div>
    <div>
        {{ with .PrevInSection }}
        <a class="previous link-primary" href="{{.Permalink}}"> {{.Title}}</a>
        {{ end }}
        {{ with .NextInSection }}
        <a class="next link-primary" href="{{.Permalink}}"> {{.Title}}</a>
        {{ end }}
    </div>
</aside>
{{ end }}