Hugo博客

HugoMDL — Hugo 博客模板

作者 jchatkinson

HugoMDL 是一个基于 Material Design Lite 示例博客布局的 Hugo 多页响应式博客与作品集主题，采用 Apache-2.0 许可。

打开源站下载源码 ZIP

看看你的网站会是什么样

浏览真实页面截图，比较内容排版与手机效果。点击下方缩略图切换，放大查看整页细节。

1 个预览视图

作者提供的预览

访问演示网站在新标签页打开

作者提供的预览首屏预览

来自项目 README 的原始预览。

目前有 1 张原始预览，可打开完整图片查看设计细节。

截图用于了解视觉与布局，交互效果请以实际项目为准。

采集于 2026-09-30查看来源

值得关注的模板亮点

从已有项目资料中，快速了解它的特点。

基于 Material Design Lite 示例博客布局构建的 Hugo 主题

同时支持博客文章与项目/作品集两类内容

首页与文章页使用卡片式布局，可配置缩略图、页头图、背景色和标题颜色

通过 exampleSite/config.toml 配置站点背景、作者信息与导航菜单

文章与项目 front matter 支持 author 信息及 repo、web 链接字段

采用 Apache-2.0 许可发布

模板详细介绍

HugoMDL 是一个面向 Hugo 的多页响应式博客/作品集主题，基于 Google 的 Material Design Lite 示例博客布局构建。主题同时提供博客文章与项目（作品集）两种内容类型，首页以卡片形式展示内容，卡片可配置缩略图、页头图、背景色与标题颜色。

主题通过 exampleSite/config.toml 进行站点级配置，包括背景、作者名称与联系方式，并可在该文件中定义导航菜单的顶层条目。文章与项目使用相似的 front matter：文章支持 title、description、date、categories、tags 以及可选的 cardthumbimage、cardheaderimage、cardbackground、cardtitlecolor 和 author 信息；项目额外支持 repo 与 web 链接字段，未设置时对应图标不显示。仓库 README 同时给出了 About 页面示例与在 c9 环境下的开发、启动命令。

该主题的最近更新时间为 2018 年，README 中说明其当前满足作者自身需求，并欢迎通过 fork 与 pull request 改进。仓库未在资料中列出所依赖的具体框架版本，使用前建议自行核对 Hugo 版本兼容性。

Hugo博客

适合你的项目吗？

适用场景

使用 Hugo 搭建个人博客并希望采用 Material Design 风格
在博客之外展示个人项目或作品集列表
需要卡片式首页布局并自定义卡片图片与配色的站点
希望通过配置文件集中管理站点导航与作者信息的场景

适合人群

使用 Hugo 构建个人博客的开发者
需要同时呈现文章与项目作品集的个人站点
偏好 Material Design Lite 视觉风格的用户
能够自行阅读并调整 Hugo 主题配置的使用者

上手与定制指南

结合仓库当前版本的说明，按下面的资料检查内容、配置与运行要求。

1
在 Hugo 站点目录下创建 themes 文件夹，进入后执行 git clone https://github.com/jchatkinson/HugoMDL
2
参考 exampleSite/config.toml 配置站点背景、作者信息与导航菜单
3
文章与项目需按 README 中的 front matter 字段填写，cardthumbimage、cardheaderimage、cardbackground、cardtitlecolor 均为可选
4
项目 front matter 中的 repo 与 web 字段未设置时不会显示对应图标
5
仓库最近更新于 2018 年，使用前建议自行核对 Hugo 版本兼容性

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

本次收录的是公开仓库中采用 Apache-2.0 许可的免费版本；免费范围为该版本代码，不代表外部服务或第三方素材免费。

使用时需要遵守

允许免费使用、修改、商用和分发；分发时需随附 Apache-2.0 许可证。
修改过的文件需显著标明改动，并保留相关版权、专利、商标及归属声明。
若原项目附有 NOTICE 文件，分发衍生作品时需保留其中适用的归属声明。
许可包含适用的贡献者专利授权；发起许可所述专利诉讼会终止该专利授权，且不授予商标使用权。
代码按现状提供；担保与责任限制以原许可证及适用法律为准。

额外费用与待核对事项

演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 Apache-2.0 许可判断。
域名、托管、数据库、支付或 AI 等外部服务可能另外收费。

查看原文依据

no-charge, royalty-free, irrevocable copyright license
许可证原文

https://github.com/jchatkinson/HugoMDL/blob/master/LICENSE https://github.com/jchatkinson/HugoMDL/blob/master/README.md

DeepSeek 根据仓库许可证和 README 整理 ·2026-10-01。结果仅覆盖已读取资料，依赖、图片、字体及后续条款变更以各自原文为准。

项目核对记录与介绍依据

模板资料

来源平台: GitHub
资料与维护参考分: 资料一般 · 72 / 100
技术栈: Hugo
网站类型: 博客

这个分数如何计算

本站按许可资料（最高30分）、演示链接（12分）、预览图（10分）、Star数（15分）、记录的维护时间（15分）、描述完整度（8分）、功能记录（5分）和分类资料（5分）计算。它不是代码、安全或性能测试，也不是 Google 评分；有链接不代表已实测可用。

这个项目需要核对什么

记录的仓库更新时间: 2018-12-31
截图检查日期: 2026-10-01

已收录演示链接。请用你的内容与屏幕尺寸检查；有演示不代表表单、认证或支付已经可用。

目录记录的主要技术栈是 Hugo。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料，不代表代码审计或部署实测。

查看具体选型方法 →

介绍的制作与核对状态

介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。

已完成服务器许可规则与 AI 来源核对；未经过人工编辑审核。

查看当时使用的来源资料

SHA-256: 82374a7560de3ce8c3f5193f73393484b1958eca32d206354f3fe9e7d8594dd0

2026-10-01T15:18:39.451Z

来源文件 / 仓库

# HugoMDL

HugoMDL is a multipage responsibe blog/portfolio theme for [Hugo](http://gohugo.io). The theme is based on the
[Material Design Lite](http://www.getmdl.io/) sample blog layout. 

At present it suits my needs, but feel free to help improve this theme by forking a copy and submitting a pull request. 

![HugoMDL Homepage Screenshot](https://raw.githubusercontent.com/jchatkinson/HugoMDL/master/images/screenshot.png)

![HugoMDL Projects Screenshot](https://raw.githubusercontent.com/jchatkinson/HugoMDL/master/images/projects.png)

![ HugoMDL Post Screenshot](https://raw.githubusercontent.com/jchatkinson/HugoMDL/master/images/post.png)

## Installation

Inside the folder of your Hugo site run:

    $ mkdir themes
    $ cd themes
    $ git clone https://github.com/jchatkinson/HugoMDL

For more information read the official [setup guide](//gohugo.io/overview/installing/) of Hugo.

(Note for myself)
To develop on c9, add the hugo binary to the workspace, then add it to the path using `export PATH=$PATH:/home/ubuntu/workspace/hugo`
To serve the site from c9, cd to site root and use `hugo server --bind="0.0.0.0" --port=8080  --watch --disableLiveReload` 

# Configure the Theme

There are a few different places you need to configure. First, check exampleSite/config.toml for an example site
configuration file. Here, you can set site-wide options like background, author name, and contact info.

You can also use this file to configure your site's menu system. The stanzas in this file correspond to the top level
items in the site navigation menus. You may rename, remove, or add any entries as you see fit.

If you use the suggested entry names listed in the example configuration file, your site's pages will inherit this
theme's formatting. The following subsections detail these specialized styles.

### About page

Look at the `exampleSite\about.md` file for an example 'About' page. 

### Posts

Posts use the following front-matter:

```
---
title: "First Post"
description: "first post with Hugo website engine"
date: "2015-08-18"
categories:
    - "post"
tags:
    - "meta"
    - "test"
cardthumbimage: "/images/default.jpg" #optional: default solid color if unset
cardheaderimage: "/images/default.jpg" #optional: default solid color if unset
cardbackground: "#263238" #optional: card background color; only shows when no image specified
#cardtitlecolor: "#fafafa" #optional: can be changed to make text visible over card image
"author":
    name: "Firstname Lastname"
    description: "Writer of stuff"
    website: "http://example.com/"
    email: "[email protected]"
    twitter: "https://twitter.com/"
    github: "https://github.com/"
    image: "/images/avatar-64x64.png"
---
```

`cardthumbimage` is used as the card media on the front page. If unset, a solid color will be displayed.
`cardheaderimage` is used as the card media on the post page. If unset, a solid color will be displayed.
`cardbackground` is used as the solid color if no image is specified. If unset, the default theme color is displayed.
`cardtitlecolor` is used to modify the default white title color (for instance, if you have a light colored background) 
`author` parameters are used to populate the card and post with author's data 


### Projects

Projects have similar frontmatter to posts. 

```
---
title: "My Project Title"
description: "Description of the sample project" #optional
cardthumbimage: "/images/default.jpg" #optional: default solid color if unset
cardheaderimage: "/images/default.jpg" #optional: default solid color if unset
cardbackground: "#263238" #optional: card background color; only shows when no image specified
#cardtitlecolor: "#fafafa" #optional: can be changed to make text visible over card image
repo: "http://github.com/" #optional: no icon appears if unset
web: "http://github.com/" #optional: no icon appears if unset
date: "2015-08-18"
categories:
    - "project"
tags:
    - "meta"
    - "project"
"author": # used to fill out the project page
    name: "Firstname Lastname"
    description: "Writer of stuff"
    website: "http://example.com/"
    email: "[email protected]"
    twitter: "https://twitter.com/"
    github: "https://github.com/"
    image: "/images/avatar-64x64.png"

---
```

## License

This theme is released under the Apache License 2.0. It uses content from Google's material design lite project, also released under Apache License 2.0.

反馈内容错误