README.zh-cn.md

简体中文 | English

MemE

简介

MemE 是一个强大且可高度定制的 GoHugo 博客主题，专为个人博客设计。MemE 主题专注于优雅、简约、现代，以及代码的正确性。同时，希望你将像欣赏一个模因一样欣赏 MemE，希望你将像分享一个模因一样分享 MemE，就像你的博客和文章所做的那样😝！

预览

浏览器支持

MemE 广泛地使用了 CSS 变量和 let 声明。这些特性被以下浏览器所支持：

• Chrome 49+
• Firefox 44+
• Edge 15+
• Opera 36+
• Safari 10+

IE（Internet Explorer）浏览器不支持 CSS 变量。

快速开始

https://gohugo.io/getting-started/quick-start/

安装 Hugo（extended 扩展版）

对于 Arch Linux 的用户：

~ $ sudo pacman -S hugo
~ $ hugo new site blog

对于其它系统的用户，请查看：https://gohugo.io/getting-started/installing/

安装 MemE

~ $ cd blog
~/blog $ git init
~/blog $ git submodule add --depth 1 https://github.com/reuixiy/hugo-theme-meme.git themes/meme

开始写作

1. 将 config.toml 替换为示例配置。

   ~/blog $ rm config.toml && cp themes/meme/config-examples/zh-cn/config.toml config.toml

2. 新建一篇文章和一个关于页面：

   ~/blog $ hugo new "posts/hello-world.md"
   ~/blog $ hugo new "about/_index.md"

3. 现在：

   ~/blog $ hugo server -D

定制 MemE

MemE 通过 Hugo 管道实现使用 SCSS 生成 CSS，而非静态的 CSS 文件，同时提供一个 _custom.scss 文件以供用户定制。

直接新建一个 ~/blog/assets/scss/custom/_custom.scss 并将你自己的样式加入其中，就能覆盖主题的 ~/blog/themes/meme/assets/scss/custom/_custom.scss 文件，且其会正确地被应用。

事实上，在 Hugo 中你可以覆盖主题的任何模板，见这个非官方的镜像网页：https://gohugobrasil.netlify.com/themes/customizing/

更新 MemE

~/blog $ git submodule update --rebase --remote

如果失败了，请尝试：

1. 删除 meme 文件夹，比如

   ~/blog $ rm -rf themes/meme

2. 重新克隆 MemE

   ~/blog $ git clone --depth 1 https://github.com/reuixiy/hugo-theme-meme.git themes/meme

特别注意：MemE 主题有时会新增一些全新功能或一些毁灭改动，所以在你更新完后，请务必检查 config.toml 的改动历史并将相应内容也更新！

Awesome MemE

请看 #2。

支持的 Front Matter

名字	描述	说明
title	*	string
linkTitle	*	string
subtitle	displayed below the title	string, Markdown supported, MemE only
date	*	string
lastmod	*	string
publishDate	*	string
expiryDate	*	string
<taxonomies> eg: categories, tags, series	*	array
description	*	string, Markdown supported
summary	*	string, Markdown supported
images	*	array
slug	*	string
url	*	string
draft	*	boolean
isCJKLanguage	*	boolean
weight	*	integer
type	*	string, if equal to "poetry", will use a special layout for it
layout	*	string
outputs	*	array
aliases	*	array
markup	*	string
meta	set false to disable post-meta	boolean, MemE only
toc	display TOC	boolean, override enableTOC in config.toml, MemE only
tocNum	display TOC number	boolean, override displayTOCNum in config.toml, MemE only
displayCopyright	display post-copyright	boolean, override displayPostCopyright in config.toml, MemE only
badge	display updated-badge	boolean, override displayUpdatedBadge in config.toml, MemE only
gitinfo	display post-gitinfo	boolean, override displayPostGitInfo in config.toml, MemE only
share	display post-share	boolean, override displayPostShare in config.toml, MemE only
related	display related-posts	boolean, override displayRelatedPosts in config.toml, MemE only
katex	add KaTeX support	boolean, override enableKaTeX in config.toml, MemE only
mathjax	add MathJax support	boolean, override enableMathJax in config.toml, MemE only
mermaid	add Mermaid support	boolean, override enableMermaid in config.toml, MemE only
comments	set false to disable comments in mainSections or set true to enable comments in non-mainSections	boolean, MemE only
smallCaps	small caps?	boolean, override enableSmallCaps in config.toml, MemE only
dropCap	drop cap?	boolean, override enableDropCap in config.toml, MemE only
dropCapAfterHr	drop cap after every horizontal rule tag?	boolean, override enableDropCapAfterHr in config.toml, MemE only
deleteHrBeforeDropCap	delete horizontal rule tag before drop cap?	boolean, override deleteHrBeforeDropCap in config.toml, MemE only
indent	indent instead of margin?	boolean, override paragraphStyle in config.toml, MemE only
indentFirstParagraph	indent the first paragraph?	boolean, override indentFirstParagraph in config.toml, MemE only
align	normal, justify, center	string, if equal to "normal", will override enableJustify in config.toml, MemE only
original	original? You can add the following 8 terms if you set false. The author is required, other optional	boolean, override original in config.toml, MemE only
author	author of original post	string, MemE only
link	link of original post	string, URL, MemE only
copyright	license of the post	string, Markdown supported, MemE only
website	author’s website	string, MemE only
email	author’s email	string, MemE only
motto	author’s description	string, MemE only
avatar	author’s avatar	string, URL, MemE only
twitter	author’s twitter id	string, MemE only
disqus_url	*	string, if not set, will use Permalink as default
disqus_identifier	*	string, if not set, will use RelPermalink as default
disqus_title	*	string, if not set, will use Title as default

*: see https://gohugo.io/content-management/front-matter/
and https://gohugo.io/templates/internal/#configure-disqus