Hugo 主题
:boom: re-cover | 用于康复小组的 Hugo 主题
实时演示:这里
此主题旨在满足小组更常见的 Web 需求。也就是说,一个清晰、易读且易于任何成员访问的站点,以便:
- 查找有关会议的基本信息。例如,地点、时间、形式。
- 访问会议指南,无需纸质讲义即可参与。
- 访问任何仅限在线的会议资源。
- 轻松在线向小组捐款。
安装和使用
- 创建一个新的 Hugo 站点并将主题克隆到主题文件夹中
$ hugo new site yoursitename
$ cd yoursitename
$ git clone git@github.com:sieis/re-cover.git themes/recover
- 将 /themes/exampleSite 的内容复制到
yoursitename
根目录。
$ hugo server -D
12 步小组
模板中包含的示例站点基于 The Beagle Pack 的网页项目,并且此主题的创建是在为不同小组构建类似站点后产生的。
对于大多数配置,编辑 config.toml 文件就足够了。特别是对于自定义需求有限的小组,这将为小组或会议的主页提供足够的基本需求。
此项目是为了满足托管 AA 小组的读物和捐赠信息的简单、快速、易于访问且现代的网站的需求而构建的。
在许多情况下,该站点可以免费托管,唯一的可选费用是如果需要自定义域名,则需每年注册域名。(例如,meetingname.com 或 meetingname.org)
区域互助组
当地的互助组也可能会发现此主题很有用。如果您的需求超出此主题的简单性,请与我联系。
我曾与互助组合作,为现有站点提供定制解决方案。
配置
每个小组的许多特定数据都包含在 config.toml 文件中。从 exampleSite 中复制并修改此文件,以更改模板几乎每个部分中列出的详细信息。
颜色
该主题提供了匹配的自定义颜色和图片。可以修改 main.css 文件以添加或删除任何这些选择,并且您也可以将图像替换为您自己选择的新图像。有许多可用的图像资源。其中之一是 unDraw,我已将其用于此主题中的库存图像。
图标
我使用了 Font Awesome,尽管很少使用,并且通过 CDN 加载它。
元数据
在 head partial 中,为标题、描述、og:image 和 favicon 设置了几个元数据。根据您的需要编辑这些。Favicon 存储在 /static/favicons/ 中。
常规读物
许多流行的读物都包含在“常规读物”部分下。如果需要,可以更改这些内容。读物位于 content -> readings 文件夹中,作为单独的 markdown 文件。将 draft 设置为 true 将停用其中的任何一个。
您可以通过在 readings 文件夹中创建新的 markdown 文件来添加其他读物。
读物列表
有一个读物列表页面 (/readings/),它没有主动链接,但如果需要可以链接。它只是保存主页上模态下拉菜单中可用的每个可用读物的列表。控制此页面的模板是默认布局文件夹中的 section.html。同样,有一个 single.html 模板控制单个读物页面。
关于会议
对于您小组特定的会议和/或主席指南,关于页面包含占位符元素。在示例中,主席指南列出了六个部分。可以通过 data 文件夹编辑、删除或添加到这些部分。正在使用的指南包含在 data 文件夹中的 guidelines.json 文件中。
博客,或缺乏博客
基本模板没有适当的博客功能,但如果小组需要,可以添加。