lukasjoswiak / etch

A simple, responsive writing theme for Hugo.

Etch

Etch is a simple, responsive theme for Hugo with a focus on writing. A live demo is available at https://lukasjoswiak.github.io/etch/.

Features:

• Homepage with list of posts.
• Support for pages.
• Responsive design for optimized mobile experience.
• Syntax highlighting with customizable theme.
• Dark theme which automatically adjusts based on users' setting (example).
• No external dependencies, no JavaScript, no web fonts.
• Internationalization friendly: use default English translations or create your own

Installation

To install etch, download the repository into the themes folder in the root of your site.

$ git submodule add https://github.com/LukasJoswiak/etch.git themes/etch

Then, use the theme to generate your site.

$ hugo server -t etch

Use the sample configuration as a starting point. See the configuration page for more info.

Read the wiki to learn about more options.

etch's Issues

Code blocks too wide

The background of code blocks sticks out quite a bit from the rest of the text. To my eyes this is quite jarring, but I saw you have code blocks on your own blog and don't seem to mind, so maybe it's just me! I thought I'd give you the feedback anyway, but feel free to close this right away if you don't think it's a problem. Love the theme in any case!

submodule install method to the readme

Can I add the submodule install method to the readme file?
so we don't need to check the hugo website to install.

This is really the theme I'm looking for, thanks for your work.

Question: how to set the post creation dates visible?

Hi,
In Your example You have visible dates on the posts

In my case these dates does not appear:

I have the same config as in the example site.
Is there a specific param to set in order to get this work?

Mathjax/Katex doesn't seem to work.

Been trying to add equations, but none of the the fore mentioned library works. Tried various tutorials. Posting one for reference https://mertbakir.gitlab.io/hugo/math-typesetting-in-hugo/

Include post heading's on taxonomy pages?

I'd like to see post titles alongside the date on the taxonomy pages, like on the "posts" page, to provide some context. If this isn't something you'd like to incorporate into the project, I'm open to suggestions on how I could go about this.

Thanks!

failed to load translations (deploy vercel)

It works on my local machine, but fails when deploying to vercel with the following error:

[15:29:42.597] Cloning completed: 640.336ms [15:29:43.045] Restored build cache [15:29:43.102] Running "vercel build" [15:29:43.756] Vercel CLI 28.10.0 [15:29:44.520] Error: add site dependencies: load resources: loading translations: "/vercel/path0/themes/etch/i18n/en.toml:1:1": failed to load translations: unable to parse translation #0 because invalid plural category title [15:29:44.520] map[id:posts translation:map[date:map[other:Jan 2, 2006] title:map[other:Posts]]] [15:29:44.535] Error: Command "hugo -D --gc" exited with 255

My hugo version is:

hugo v0.109.0-47b12b83e636224e5e601813ff3e6790c191e371+extended linux/amd64 BuildDate=2022-12-23T10:38:11Z VendorInfo=snap:0.109.0

Pagination problem

I currently have eight blog posts. I want to write a new article, but the page does not show it. I tried to adjust the paginate tag, but it didn't help.

site not building

when I write hugo -t etch, 0 files builds but website shows when I put -D with it

Anyway to set a different url when click on the website's name?

I just added support to another language on my website but when I click on the website's name it brings me back to the baseURL, anyway to override this when using a different language?

feature request: override CSS from config

First of all, thank you for the awesome theme! I'm using it for my personal blog website.

Now I'd like to customize a bit of default CSS(width and font-family a bit) and it'd be great if I can inject my CSS via config.toml. Of course I can fork and customise but it's a bit cumbersome and also I'd like to follow the latest update as well.

Thank you in advance!

ref: https://discourse.gohugo.io/t/how-to-override-css-classes-with-hugo/3033/4

rendering problems with rss

Hi there--thanks for the nice theme!

I'm trying to deploy a MWE to get your permalinks working as shown in your nice example site.

The MWE renders, but I get some errors that mention RSS:

$ hugo new site etc_hugo_permalinks
$ cd etc_hugo_permalinks/
$ git init
$ git remote add origin https://github.com/lucasreddinger/etc_hugo_permalinks.git
$ git submodule add https://github.com/LukasJoswiak/etch.git themes/etch
$ hugo new posts/post-aaa.md
$ vim content/posts/post-aaa.md
$ vim config.toml
$ cat content/posts/post-aaa.md
---
title: "Post Aaa"
date: 2021-09-28T09:43:40-07:00
draft: false
---

This is a post.
$ cat config.toml
baseURL = "https://www.lucasreddinger.com/etc/hugo_permalinks/"
languageCode = "en-us"
title = "etc / hugo permalinks"
theme = "etch"

[permalinks]
  posts = "/:title/"
$ hugo
Building sites … ERROR 2021/09/28 09:45:57 render of "Posts" failed: "/home/lucas/etc_hugo_permalinks/themes/etch/layouts/_default/rss.xml:5:18": execute of template failed: template: _default/rss.xml:5:18: executing "_default/rss.xml" at <$pctx.RegularPages>: can't evaluate field RegularPages in type *hugolib.PageOutput
ERROR 2021/09/28 09:45:57 render of "Tags" failed: "/home/lucas/etc_hugo_permalinks/themes/etch/layouts/_default/rss.xml:9:19": execute of template failed: template: _default/rss.xml:9:19: executing "_default/rss.xml" at <.Site.Config.Services.RSS.Limit>: can't evaluate field RSS in type services.Config
ERROR 2021/09/28 09:45:57 render of "etc / hugo permalinks" failed: "/home/lucas/etc_hugo_permalinks/themes/etch/layouts/_default/rss.xml:9:19": execute of template failed: template: _default/rss.xml:9:19: executing "_default/rss.xml" at <.Site.Config.Services.RSS.Limit>: can't evaluate field RSS in type services.Config
Total in 140 ms
Error: Error building site: failed to render pages: render of "Categories" failed: "/home/lucas/etc_hugo_permalinks/themes/etch/layouts/_default/rss.xml:9:19": execute of template failed: template: _default/rss.xml:9:19: executing "_default/rss.xml" at <.Site.Config.Services.RSS.Limit>: can't evaluate field RSS in type services.Config
$

Thanks much for your help!

Feature request: categories and tags

Hi there,

Thanks for such a nice theme, I really like it.
I do miss being able to assign tags and categories to posts and having them listed upon selecting a given category / tag though. Do you plan to add this feature to your theme?

I'd appreciate your feedback.
Cheers!

Footnotes text size renders incorrectly with Hugo 0.98.0 or later

When using Hugo 0.98.0 or later, the footnotes text size is the same size as the main content of the blog post, and fiddling with main#content section.footnotes in main.css does nothing.

It seems something changed with Hugo 0.98.0, because reverting to Hugo 0.97.3 or earlier fixes the problem.

Body needs to have 100% height to address issue with dark mode

I just wanted to give a heads-up about a minor issue with dark mode. On pages with less content, the bottom of the page is white.

I suggest to add height: 100% to the body.

failed to load translations?

(base) Mac:sites Lexi$ cd maie
(base) Mac:maie Lexi$ git init
Initialized empty Git repository in /Users/Lexi/Desktop/sites/maie/.git/
(base) Mac:maie Lexi$ git submodule add https://github.com/LukasJoswiak/etch themes/etch
Cloning into '/Users/Lexi/Desktop/sites/maie/themes/etch'...
remote: Enumerating objects: 461, done.
remote: Counting objects: 100% (127/127), done.
remote: Compressing objects: 100% (46/46), done.
remote: Total 461 (delta 97), reused 81 (delta 81), pack-reused 334
Receiving objects: 100% (461/461), 317.00 KiB | 874.00 KiB/s, done.
Resolving deltas: 100% (239/239), done.
(base) Mac:maie Lexi$ echo theme = "etch" >> config.toml
(base) Mac:maie Lexi$ hugo server
Error: add site dependencies: load resources: loading translations: "/Users/Lexi/desktop/sites/maie/themes/etch/i18n/en.toml:1:1": failed to load translations: unable to parse translation #0 because invalid plural category date
map[id:posts translation:map[date:map[other:Jan 2, 2006] title:map[other:Posts]]]
(base) Mac:maie Lexi$ hugo version
Hugo Static Site Generator v0.59.1/extended darwin/amd64 BuildDate: unknown

Feature request: Last modified date

This is a great theme for technical writing, which I think benefits from including lastmod info.

Thanks!

Output not having correct css

I am trying to output my website to html so I can upload to my web host. When I run hugo -t etch the css does not show up in the outputted website.

There is the correct css when I am running the live server but not when I output to html.

A topic customization problem.

Excuse me, how to set the post text above the article list.

Because I want to customize it into Chinese.

Please add table of contents

Netlify deploy needs themes/etch to be added as a submodule

This Netlify deployment error was fixed by adding this to the .gitmodules file:

[submodule "themes/etch"]
	path = themes/etch
	url = https://github.com/LukasJoswiak/etch.git

It would be useful to include this in the setup instructions. Maybe instead of the above manual way, this can be suggested(instead of cloning)-
git submodule add https://github.com/LukasJoswiak/etch.git themes/etch

Taxonomies not working

Hi,

Great theme, thanks for all your work!

On your example site the tags and categories pages work fine, but when I download the repo and run the example site locally, the taxonomies pages just show the post list. Is this a bug?

Thanks

Question: how to set the post creation dates visible? (accidentaly duplicated)

Does this support pagination in the front page?

If I have so many posts already, will it support pagination? And any way to set the pagination number of posts cut off?

Adding Latex Support/RSS Support

It would be great if this theme supports RSS and Latex.

Thanks.

Front page blog description not visible

Hi there!

Thanks for the great theme once again. I am having an issue with the front page blog description not visible above posts. Please refer to the red frame on the screenshot below.

May I ask you how could I enable this blog description?

Thanks!

Adding new features

Hello,

I'm using your theme for one of my blogs. I really like the simplicity of it, but sometimes I wish it to have more features.

Here's the features I'm considering adding:

• Date: Use locale to format date
• Date: User can provide custom date format in blog settings
• Taxonomies: Display tags and categories in a post
• Misc: Display custom title for posts (i.e paintings, recipes, talks...)

Are you open to PR or should I fork your repo ?

Thanks

how to add menus?

I might be missing something (I'm not a developer), but the default method to insert methods I'm used to from other themes doesn't seem to be working. I'm following the instructions from the documentation, for example

[menu]

  [[menu.main]]
    identifier = "page"
    name = "my page title"
    url = "/mypage/"
    weight = 1

Doesn't result in a menu. Is there another way to create menu items for the navigation bar?

Cheers!