Hugo Theme Meme Versions Save

It’s been two years since our last release, the world has changed a lot. Still, we’re happy to announce that MemE 5.0.0 is out!

Some highlights:

• 7 more languages support
• A live preview site via GitHub Actions
• Third-party libraries customization

Thanks to all the contributors who contributed to this release!

Bug Fixes

• a11y: increase width of scrollbar (d392ab1)
• build error (74ea4db)
• check before loading comments (#374) (1c0beed)
• css: add transition for header (342939d)
• css: backdrop-filter supports at-rule for webkit (37d8a68)
• css: dim image in light mode (#367) (5e6c812), closes #365
• css: make code related backgound-color consistent (32224aa)
• css: margin issue of nested ol/ul (25de088)
• css: margin issue of post type poetry (a65114a)
• css: menu is not aligned on medium screen (ed7e68b)
• css: svg icon get cut off on safari (25e9e4d)
• css: url word-break for justify align (8112664)
• declares the social url as a safe url (#354) (72212b2), closes #353
• deprecated warning for .Path (e425890), closes #369
• deprecation warning of !global assignments (504ee32)
• drop cap to the identical paras only once (#356) (27ba8bb)
• escaped HTML in summary.html (47cead2), closes #213
• exclude medium-zoom for img tags directly under a tag (#346) (951b0ad)
• filter pages before limit (7cf1577)
• insertHrBySelf not working anymore (293d9a0)
• make header width to 100vw to avoid change when scroll bar appears (#351) (adefef8)
• modify start_url to meet the PWA's fast and reliable requirment (#314) (9be741a)
• remove extra white space in summary.html (8ebbfa8)
• resolve the editURL problem on Windows (#308) (25be50d), closes #279
• set app-mobile-web-app-status-bar-style to black (91bba2a), closes #280
• style: margin issue in toc (ca1d2b1)
• style: margin issue of nested ordered/unordered list (b52d699)
• sw.js: an object that was not a Response was passed to respondWith() (159652e)
• syntax error (e781e17)
• third-party: add tinyseg.js to scripts if japanese (#305) (ed7f353)
• undefined loadComments() in homepage (#326) (c2d2200)
• use network first strategy for sw.js (cddaf25)
• use pageref for internal links in menus (2479717), closes #343
• wrong glyph-correction URL when baseURL is set to sub-directory (#291) (28bcb78), closes #287

Features

• add Algolia Search support (#329) (2dc1f8b), closes #222
• add built-in service worker support (5470cbe)
• add copyleft 🄯 support (8964306)
• add Gitalk comments support (#324) (6941bd2)
• add html minify configuration (72e1a9d)
• add new config param displayBackToTopOnMobile (9d7ce99), closes #280
• add new front matter anchor (e927542), closes #276
• add new param displayFooter (2d17152)
• add support for color-scheme meta tag (7d7c485), closes #361
• add support for auto-hiding flex header (6e7027e), closes #293
• Add support for Yandex.Metrika (#323) (abd67d8)
• Adjust post markup to conform to h-entry spec (#253) (cb4fb52)
• i18n: add 'id' Bahasa (#388) (790d2ab)
• i18n: add FR lang support (#233) (a7c47aa)
• i18n: Add Hungarian language file (#363) (d1d3472)
• i18n: add Japanese support (#311) (6c8faec)
• i18n: add polish language support (#273) (f49ac2c)
• i18n: add zh-TW lang support (#270) (e051e0c)
• i18n: Added support for Russian language (#322) (eb0aecd)
• ignore suffix slash of image host (#358) (d8af0e0)
• ignore suffix slash of video host (597d20d)
• Make SRI for scripts and styles enabled separately from fingerprinting (#215) (b9869e7)
• new config param customizeScrollbar (2c06353)
• set up github actions for pages (#278) (8e0d1b5), closes #277
• support directly load the comments after pages loaded (#325) (29e4726)
• support host customization for third-party libraries (#389) (a6111f9)
• support hugo v0.73.0 (f1e3503), closes #207

BREAKING CHANGES

• enableFingerprint config parameter no longer enables Subresource Integrity. If you need it, you have to specify enableSRI parameter as well
• MemE now requires Hugo v0.73.0+.

Bug Fixes

• Avoid double escaping when using post description (#190) (44d4198)
• Do not load the script in 404 page (#200) (87e8586), closes #199
• make dark theme brighter (#195) (4e9c8fe)
• mermaidConfig is not defined error (f0b87b2)
• missing read-more on home-posts page (#198) (831d8fb)
• Safari doesn't support addEventListener on media queries (#184) (0fccbcc)
• Search index should include sections & co. if these have content (#192) (e2948b2)
• Unrelated localStorage changes would cause switch to light theme (#194) (db102eb)
• wrong utterances theme (9a041c1)

Code Refactoring

• Do not use inline scripts (#173) (f160158), closes #145
• Improve code highlighting (#188) (cf603f3), closes #169
• Make title.html partial more readable, fix title for taxonomy pages (#187) (ea09a86)
• Rename $Deliver into $ for clarity (#177) (81a773d)

Features

• allow to limit the number of tree posts (#196) (6f3aeba), closes #97
• apply markdownify to post title (#183) (1322fdd), closes #179
• support dark theme for mermaid (066138a), closes #205
• support override system preferences for dark mode (29bd11e), closes #201
• i18n: add Malaysian and Norwegian languages (#202) (f782a59)

BREAKING CHANGES

• Highlighting customization now works by overriding CSS variables, no longer by overriding theme-specific files
• Markdown in page titles will be processed now
• Deliver parameter to various templates is now called $
• custom.js is loaded at the top of the page now, before the page elements are available

MemE v4.4.0 comes with some big code refactoring by @palant, which makes MemE even more faster. Big thanks!

Also, make sure to follow the instructions when you update MemE to the latest version!

Bug Fixes

• allow .Params.indent to override global settings (188fc17)
• Do not rely on JavaScript to determine header width (#168) (820e0ab)
• generation failed error caused by readFile (62f6934), closes #133
• Get rid of unnecessary safeHTML usage (#135) (91e84a1), closes #134
• Improve accessibility of the theme switcher (#160) (e5e6230)
• Make sure to turn relative links absolute in feeds (#170) (4c6097a), closes #141
• pass $Content to custom/content.html (df739fa)
• Remove unnecessary safeJS/safeURL calls (a94cc42)
• Respect user's preferred theme even when JavaScript isn't enabled (#169) (46522c6)
• search on mobile and make url relative (#172) (5a3470a), closes #171
• Typos in README (#161) (0cd2733)
• When scrolling to an anchor, account for the header height (#158) (115914a), closes #146
• a11y: delete maximum-scale (37632a7)
• json-ld: missing image in non-mainSections page (26baf9d)
• post-copyright: missing colon when website param is not set (86bfc77), closes #116
• style: add tab-size support for firefox (afb0b4a), closes #105
• style: font-size bug in mobile safari (4094ff7), closes #109
• style: make color in dark mode less dazzling (9d35969)
• style: make color in dark mode less dazzling (e580a16)
• style: margin issue of caption in layout "poetry" (3754acc)
• style: margin issues of layout "poetry" (bbef0de)
• style: overflow and font-size bug in safari (e2646e3), closes #109
• unescaped ampersand(&) in xml (b1890ee), closes #103

Code Refactoring

• Make templates return results properly (#153) (418f72d), closes #137

Features

• add hashtags to share URLs (#100) (a323e45)
• Added search capability via lunr (#165) (fb54c61), closes #163
• Allow customization of post metadata (#138) (6cc1621), closes #136
• Allow extending header (#142) (5353fec)
• Allow to limit the number of articles listed per taxonomy entry (#148) (f3d9ad0), closes #147
• support social media icons (fd1546e), closes #123
• i18n: add Brazilian Portuguese translations (#102) (c4adfc5)

BREAKING CHANGES

• Various templates under utils/partials/ will return results directly rather than via .Scratch now.

Bug Fixes

• style: add transition, fix color contrast (e9880d7)
• style: font-size of copy button (ed015a9)
• style: make color in dark mode less dazzling (c0e0927)
• style: make color in dark mode less dazzling (cef984d)
• style: make the bg-color of dark mode darker (676fee1)
• clipboard polyfill (05a365b)
• i18n of script and style (e7871bb)
• make dark mode more gorgeous (06f79af)
• make dark mode respect system preferences (10d6cca)

Features

• change default highlight theme (e7e61d4)

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

Bug Fixes

• add “contributors” to license (f58f9aa)
• add backdrop-filter support for safari (fae1f2a)
• add fallback for backdrop-filter (60f611b)
• correct favicon's MIME type (f8ba8aa)
• correct zh-cn translation of license (070b1d3)
• emphasis point position U+2022 • (1cc02c3)
• google fonts style loading fails on firefox (e5ad6fe)
• header layout flex (44b352e)
• hide back-to-top on mobile (4c670b5)
• improve post-copyright style (a498cad)
• increase the margin of toc-num (8d9bad0)
• missing div tag in dark mode's regex (c1cda8b)
• optimize header-inner's display experience (fd95216)
• optimize user experience (e9f6d90)
• remove subset=chinese-simplified (de4def3)
• remove crappy param compatibleWithLaTeX (dc0c4ef), closes #50
• render links only if it exists (fc0fae8)
• style of header when enableNavToggle = false (6c3356e)
• style of langs on mobile (83f1046)
• style of medium zoom (5f49a0e)
• style of menu bar (0845e86)
• use em tag for emphasis point (a599634)

Code Refactoring

• remove i18n's region subtag (9f5916a)

Features

• add autohide param for copy button (bdb6077)
• add copy button and scroll for code blocks (94d7e05), closes #76
• add mermaid support (#75) (431ef63)
• added german translation (#74) (19892fc)
• brand new header layout flex (a11c06a)
• new param displayFooterInHome (075c8d2)
• new param tocNum (f30d684), closes #71
• responsive table & set its width to 100% (a995897)
• support instant page (6a9876b)
• support unordered toc (9093207)
• update google fonts css api to v2 (67bb2c5)

Performance Improvements

• add throttle for scroll and resize listener (6945afd)
• defer google fonts and add preconnect rel (5ff821d)
• drop instantclick support (b9cea3b)
• remove outdated keywords meta (fa5bf38)
• replace calc() with rem (acf1cae)
• use cilent side js selector for medium zoom (4eb0408)

BREAKING CHANGES

• compatibleWithLaTeX is removed

If you have enabled this param before, you can replace this feature with HTML <div> or <span> tag, e.g.

<div>
$$
...
$$
</div>

inline math <span>$...$</span>

...which prevents LaTeX code from being processed by the Markdown renderer.

Sorry for the inconvenience again :(

Revert

• cancel use Page.GetTerms (1331c92)

Bug Fixes

• correct zh-cn translation of weibo (9937e20)
• drop cap after hr (223b67b)
• emphasis point position U+2022 • (b07107b)
• fonts-src.scss & drop outdated code (ebccc0f)
• generate qrcode fails when url is too long (73a0d30)
• json-ld, open-graph (6dc995a)
• make color in dark mode less dazzling (262ddb1)
• render minimal-footer-about only if it exists (3be7996)
• style of blockquote (a31369a)
• style of footnote-icon, drop-cap (ac0684c)
• style of layout home-poetry, home-footage (76018fb), closes #59
• style of qrcode (5c81c01)
• style of qrcode again (1e6791b)
• style of text-decoration, scrollbar, code (b553842)
• style of tree categories page (d2ea8c0)
• subset glyph-correction (ffc6aa7)
• tree-categories, tree-sections (04bde37)
• twitter-cards (123eea1)

Code Refactoring

• main.scss and scss folder structure (abba97f), closes #52
• restructure partials folder (299c218), closes #68

Features

• add displayShareOnText param (77d1ee4)
• support share on socials (#62) (eae4359)
• use Page.GetTerms (110064a), closes #67
• third-party: update mathjax to v3.0.1 (d6ea45b)

BREAKING CHANGES

• partials folder structure is changed
• scss folder structure is changed

Bug Fixes

• homePoster, fofPoster in main.scss (e6105a9), closes #51
• data-attributes.scss (67bf0f5)
• delimit function (1ab41b1)
• do not justify if its type is poetry (0bd42e7)
• regex of compatibleWithLaTeX (b2bed6b)
• regex of compatibleWithLaTeX again (af1de8b)
• regex of content.html (6bb169d)
• regex of drop cap and indent (e4d4fd8)
• regex of external links and hosting (ca47e40)
• regex of indent (d49e3a6)
• regex of indent again (09f4e53)
• regex of markdownify.html (853db3d)
• regex of paragraph indent (c7ce9bb)
• regex of paragraph indent again (88ea2c6)
• style of medium zoom (8918a4b)
• style of table and highlight (5e7b9cc)
• styles related to text-align and indent (0c46faa)

Code Refactoring

• load highlight, emphasis-point on demand (bd6ca2b)
• simplify service worker notification (ff1d110)

Features

• do not indent the first paragraph (eaefda4), closes #36

Performance Improvements

• remove useless video regex (011fc32)

Bug Fixes

• missing <p> tag when content has one line (d7f4b8f), closes #49
• regex of content.html (01039b7)
• style of footnotes (f4a3dd0)

As I described in #26, I want to make MemE support Hugo's new default Markdown rendering engine Goldmark, and this is it. In this version, MemE will support Goldmark and no longer support Blackfriday.

Notes

1. Goldmark problems, see #43 (comment)

2. Compatibility with LaTeX, see gohugoio/hugo#6544

   Previously, I suggested adding some backslashes to escape some characters to solve the syntax conflict between Markdown and LaTeX. Now, I think that is not the right way -- it's troublesome and stupid.

   In v4.0.0, MemE adds a new compatibleWithLaTeX option as a temporary workaround. But note that it has some limitations, such as it can't exclude equations inside code block, it supports $ ... $ and $$ ... $$ only.

   And at last, apology for my wrong suggestion, which may take some of your time to modify the equations again.

3. With Hugo brand new Markdown renderer Goldmark, #14 should be fixed.

ATTENTION

MemE v4.0.0 requires Hugo v0.62.2 or higher.