From e713663d77fb5a60487ddf4c667c4b535e5c1c19 Mon Sep 17 00:00:00 2001 From: Joe Hutchinson Date: Mon, 3 Aug 2020 21:36:14 -0400 Subject: [PATCH] Update theme and readme around syntax highlighter to have a better default look --- README.md | 6 ++++++ assets/css/style.css | 3 +++ theme.toml | 4 ++-- 3 files changed, 11 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 76aec33..8bdcc48 100644 --- a/README.md +++ b/README.md @@ -39,6 +39,10 @@ disqusShortname = "Your shortname for Disqus - optional" homeimg = "Path, within the 'assets' folder, of the image used for the home button at the bottom of each post - optional" bgimg = "Path, within the 'assets' folder, of the image used for the page background - optional" rssinmenu = whether you would like a RSS feed link to appear in the navigation menu (true, false) - optional + +[markup] + [markup.highlight] + style = "igor" ``` The `title` parameter is used for each page title, the title that search engines display in search results. If you would like the title shown in the top left of the page to be different from the page title, use the `brand` parameter. For instance, the title parameter for my site is `Joe Hutchinson` but the brand parameter is set to `joehutch`. @@ -47,6 +51,8 @@ Find your `language code` [here](https://www.metamodpro.com/browser-language-cod The `homeimg` and `bgimg` parameters give you the ability to customize the look of your site further. Both the homeimg and the bgimg should reside in the assets folder of your site. The homeimg parameter is the image used for the home button at the bottom of every page. Since the text used on the home button is white, a darker background image is preferred. If the homeimg parameter is not specified, a fallback image is used. Similarly, the bgimg parameter is used for the background of each webpage. Aether is designed to look best with a subtle tiling image for the background. If no background image is specified, the background will be a solid gray color. +The default syntax highlighter `style` does not look great with aether so I recommend using igor. If you want to change the highlighter theme you can specify a different one from [this list](https://xyproto.github.io/splash/docs/all.html). To configure the syntax highlighter further, such as adding line numbers, check out [this Hugo doc section](https://gohugo.io/getting-started/configuration-markup#highlight). + That is the only configuration required at the site level! You can now begin writing content for your site. #### Favicons diff --git a/assets/css/style.css b/assets/css/style.css index 2dc750f..9dc678e 100644 --- a/assets/css/style.css +++ b/assets/css/style.css @@ -363,6 +363,9 @@ pre > code { overflow-x: auto; color: black; } +.highlight > pre { + background-color: unset !important; +} hr { border: 0; border-bottom: thin solid #D1D1D1; diff --git a/theme.toml b/theme.toml index 866ea00..35c0f1f 100644 --- a/theme.toml +++ b/theme.toml @@ -8,5 +8,5 @@ features = ["Responsive", "Highlight.js", "KaTeX", "Google analytics", "Disqus"] min_version = "0.41" [author] -name = "Joe Hutchinson" -homepage = "https://www.joehutch.com" + name = "Joe Hutchinson" + homepage = "https://www.joehutch.com" \ No newline at end of file