Skip to content

Repository files navigation

English | 简体中文 | 繁體中文

MemE

Description

MemE is a powerful and highly customizable GoHugo theme for personal blogs, which focuses on elegance, simplicity, modernity, and best practices in coding.

Preview

tn.png

Browser support

MemE uses CSS variables and let statements extensively. These features are supported by the following browsers:

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

Internet Explorer does not support CSS variables.

Quick Start

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

Install Hugo (extended version)

For Arch Linux users:

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

For users of other systems, see: https://gohugo.io/getting-started/installing/

Install MemE

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

Blogging

  1. Replace hugo.toml with config examples.

    ~/blog $ rm hugo.toml && cp themes/meme/config-examples/en/config.toml config.toml
  2. Create a new post and the about page:

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

    ~/blog $ hugo server -D

Customize MemE

MemE uses SCSS via Hugo Pipes to generate CSS instead of static CSS file and provides a _custom.scss for customization.

Just create a ~/blog/assets/scss/custom/_custom.scss and add your own styles into this file. Your _custom.scss will override ~/blog/themes/meme/assets/scss/custom/_custom.scss and your custom CSS will be applied correctly.

Actually, you can override any template of theme in Hugo, see this unofficial mirror page: https://gohugobrasil.netlify.com/themes/customizing/

Update MemE

~/blog $ git submodule update --rebase --remote
# or~/blog $ cd themes/meme && git pull

If failed, try:

  1. Delete meme folder, e.g.

    ~/blog $ rm -rf themes/meme
  2. Clone MemE again

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

Note that MemE makes some brand new features or breaking changes sometimes, so please be sure to check the modification history of config.toml and update the related items after the update!

Awesome MemE

See #2.

Supported Front Matter

Click to expand!
NameDescriptionNotes
title*string
linkTitle*string
subtitledisplayed below the titlestring, Markdown supported
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
hideInHomepagehide this post in homepage posts listboolean, valid for "posts" homepage with enableHideInHomepage enabled
languageCodeadd lang attribute with this value to <article>string
metaset false to disable post-metaboolean, override enablePostMeta in config.toml
displayPublishedDatedisplay published date in post-metaboolean, override displayPublishedDate in config.toml
displayModifiedDatedisplay modified date in post-metaboolean, override displayModifiedDate in config.toml
displayExpiryDatedisplay expiry date in post-metaboolean, override displayExpiryDate in config.toml
displayCategorydisplay category in post-metaboolean, override displayCategory in config.toml
displayWordCountdisplay word count in post-metaboolean, override displayWordCount in config.toml
displayReadingTimedisplay reading time in post-metaboolean, override displayReadingTime in config.toml
displayBusuanziPagePVdisplay page views in post-metaboolean, override displayBusuanziPagePV in config.toml
tocdisplay TOCboolean, override enableTOC in config.toml
tocNumdisplay TOC numberboolean, override displayTOCNum in config.toml
anchorenable headings anchorboolean, override enableHeadingsAnchor in config.toml
displayCopyrightdisplay post-copyrightboolean, override displayPostCopyright in config.toml
badgedisplay updated-badgeboolean, override displayUpdatedBadge in config.toml
gitinfodisplay post-gitinfoboolean, override displayPostGitInfo in config.toml
sharedisplay post-shareboolean, override displayPostShare in config.toml
relateddisplay related-postsboolean, override displayRelatedPosts in config.toml
katexadd KaTeX supportboolean, override enableKaTeX in config.toml
mathjaxadd MathJax supportboolean, override enableMathJax in config.toml
mermaidadd Mermaid supportboolean, override enableMermaid in config.toml
commentsset false to disable comments in mainSections or set true to enable comments in non-mainSectionsboolean
smallCapssmall caps?boolean, override enableSmallCaps in config.toml
dropCapdrop cap?boolean, override enableDropCap in config.toml
dropCapAfterHrdrop cap after every horizontal rule tag?boolean, override enableDropCapAfterHr in config.toml
deleteHrBeforeDropCapdelete horizontal rule tag before drop cap?boolean, override deleteHrBeforeDropCap in config.toml
indentindent instead of margin?boolean, override paragraphStyle in config.toml
indentFirstParagraphindent the first paragraph?boolean, override indentFirstParagraph in config.toml
alignnormal, justify, centerstring, if equal to "normal", will override enableJustify in config.toml
originaloriginal? You can add the following 8 terms if you set false. The author is required, other optionalboolean, override original in config.toml
authorauthor of original poststring
linklink of original poststring, URL
copyrightlicense of the poststring, Markdown supported
websiteauthor’s websitestring
emailauthor’s emailstring
mottoauthor’s descriptionstring
avatarauthor’s avatarstring, URL
twitterauthor’s twitter idstring
fediverseauthor’s fediverse idstring
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

Sponsorship

We are grateful to the following sponsors for their support:

GitHub Sponsors

Powered by DartNode

*: Some of these links are affiliate links, which means that if you click on one of the product links, I’ll receive a small commission. This helps support me to spend more time developing MemE. Thank you for the support!

About

customized theme for pkgcraft website

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages