carsonip/hugo-theme-minos

A simple and retro styled Hugo theme ported from Hexo

Minos

A simple and retro styled theme, concentrated more on your ideas.

Minos is a Hugo theme ported from Hexo theme Minos. Requires Hugo v0.59+.

Screenshots

Features

• Everything in the original Mino theme, except
  • Gallery (fancybox)
  • Duoshuo comment
  • Search box
  • Hierarchical categories (since this isn't supported in Hugo)
• Smart table of contents (will highlight and expand current section in TOC)
• Disqus
• Google Analytics
• KaTeX
• Syntax highlighting using highlight.js

Installation

To install Minos as your theme, first clone this repository in the themes/ directory:

$ cd themes/
$ git clone --depth 1 https://github.com/carsonip/hugo-theme-minos

Second, specify hugo-theme-minos as your default theme in the config.toml file. Just add the line

theme = "hugo-theme-minos"

Options

Pagination

paginate = 10

Smart TOC

[params]
    smartToc = true

Post Navigation

[params]
    noPostNavigation = true

This option disables links to next and previous post at the bottom of posts.

Disqus

disqusShortname = "xxxxxx"

Google Analytics

googleAnalytics = "UA-123-45"

KaTeX

[params]
    katex = true

This option enables the KaTeX auto-render extension. To render block math, use $$ ... $$. For inline math, use \\( ... \\). For more details, please refer to https://github.com/KaTeX/KaTeX/blob/v0.7.1/contrib/auto-render/auto-render.js#L73 .

Custom CSS

[params]
    customCss = ["css/foo.css"]

Others

For other configuration variables, visit Hugo documentation.

Post Params

Featured Image displayed in index.html

+++
featuredImage = "img/foobar.jpg"
+++

Hide the post from index.html

This can be used when creating an "About me"-page.

+++
hidden = true
+++

Enable KaTeX for this post

Enable KaTeX for a specific post without enabling the global switch.

+++
katex = true
+++

Suppress date in an article

Hide the date from an article, e.g. because it's just an index:

+++
omitDate = true
+++

Contributing

1. Fork it!
2. Create your feature branch: git checkout -b my-new-feature
3. Commit your changes: git commit -am 'Add some feature'
4. Push to the branch: git push origin my-new-feature
5. Submit a pull request :D

Original Author

PPOffice

• https://github.com/ppoffice

Ported by

Carson Ip

• https://github.com/carsonip

License

Licensed under the MIT License. See the LICENSE file for more details.

hugo-theme-minos's Issues

Use this SCSS/CSS file to bring Minos to the dark side..

Use this SCSS / CSS file to switch to a dark theme for Minos

You can either download the SCSS file, edit and compile it, or you can simply download the CSS file and use it.

In either case, don't forget to add this line to your config.toml file:

[params]
    customCSS = ["minos-dark.min.css"]

Any plans to upgrade to fontawesome version 5?

how to service 'categories', 'tags', 'archives' and 'search'

I am a rookie both Hugo and HTML/CSS for the static blog. I saw your blog screenshot image. So, I installed your theme. However, I don't know how to service 'categories', 'tags', 'archives' and 'search' on the HEADER.
Could you help me?

No toc for posts in asciidoc format

Hi, I am using asciidoc as the content format, the toc doesn't show up for *.adoc but works for markdown, is there any option to turn this on or it's just unimplemented? Thanks!

How to create a about page?

how create a about page not as a post in posts lists
i try hugo new hugo new about.md
but useless， always take it as a post in index lists

What about a social section near the footer?

I think that it would nice to have a section of the site where we could put some social network URLs, for example a Facebook logo that goes to the relative account page.

I have borrowed a small portion of code from another Hugo theme ( https://github.com/kimcc/hugo-theme-noteworthy ) and I was thinking that you could display this section on the footer like this:

However, I still have to ask permission to kimcc to use his code. If he will allow me to use that code, would you accept a pull request for that?

Changing default font sizes

I am new to Hugo themes and really like Minos for KaTeX support.

Can MathJax support be specified in the source .md file?

I also really like your choice of font but would like it to be larger.

Is there a way to specify a larger font size?

Theme demo is broken on the Hugo Themes Site

Hello @carsonip

It seems that commit 95686c0 broke your theme:

9:53:44 AM:  ==== PROCESSING  hugo-theme-minos  ======
9:53:45 AM: Building site for theme hugo-theme-minos using config "/opt/build/repo/_script/hugoThemeSite/config-hugo-theme-minos.toml" to ../themeSite/static/theme/hugo-theme-minos/
9:53:45 AM: Error: Error building site: failed to render pages: render of "taxonomy" failed: "/opt/build/repo/hugo-theme-minos/layouts/taxonomy/tag.html:7:60": execute of template failed: template: taxonomy/tag.html:1:3: executing "taxonomy/tag.html" at <partial "head.html" .>: error calling partial: "/opt/build/repo/hugo-theme-minos/layouts/partials/head.html:7:60": execute of template failed: template: partials/head.html:6:7: executing "partials/head.html" at <partial "meta.html" .>: error calling partial: "/opt/build/repo/hugo-theme-minos/layouts/partials/meta.html:7:60": execute of template failed: template: partials/meta.html:7:60: executing "partials/meta.html" at <$author>: range can't iterate over Hugo
9:53:45 AM: FAILED to create demo site for hugo-theme-minos

Please look at it and let me know.

Thanks

Pagination: current site not shown on mobile view

In the pagination the current page is "highlighted" with a circle but when you make your browser window very small or open the site from mobile the circle and the page number disappear. You can also see this in your demo.

Don't use deprecated variables

WARNING: Page's .Prev is deprecated and will be removed in a future release. Use .NextPage (yes, not .PrevPage).
WARNING: Page's .Next is deprecated and will be removed in a future release. Use .PrevPage (yes, not .NextPage).

Footnotes shown in excerpt on mainpage

When using footnotes they are shown in the excerpt on the mainpage although the link leads to nowhere.
For example see https://blog.mdosch.de in the excerpts for the posts on 2018-05-09 and 2018-05-08.

Also sometimes links are in the excerpt, sometimes not. Don't know if these are theme issues or hugo issues but I guess the creation of the mainpage is defined in the theme.

I want to know about Kerning size

I am Korean. I am using Korea in my blog. The Kerning of Minos theme to use Korean is very narrow. I know the CSS, which are 'letter-spacing', 'word-spacing'. But I don't know which file to modify.

Please show me~

How to add pages to the navigation?

Hello, I was wondering how one would go about adding pages links to the navigation bar. I mean, in the typical blog fashion where you have a series of posts but also individual pages like About Me, etc. I tried to do this by placing two files, one in content/about.md and one in content/posts/my-first-post.md and I expected the About page to show up as a separate link but it doesn't:

As you can see, the About page also became one of the blog posts.

Please don't say "Go read the Hugo docs" as I've struggled a lot already! 😅 I just need this one thing and can then peacefully work on my producing content for my blog. 🙏

There is no i18n key for "Read More"

It would be nice to have an option for i18n of "Read More" string on the index page.

Button to TOP and Pagination

Hello, could you please to add button to Top page and modify the pagination since if the post more than 100 look the number is so many especially on mobile ...

How to push the code into your repository theme. Since I am newbie for go especially hugo.

Anyway..thanks for great theme 👍😊

Double-digit item list alignment is wrong

Create a list such as

1. a
2. b
3. c
4. d
5. e
6. f
7. g
8. h
9. i
10. j

Unfortunately, the 10th item is improperly aligned, so '1' is being clipped by the side margin.

A fix or a workaround would be greatly appreciated. Thank you.

Disqus comments don't load

Hi, I've changed the disqus shortname in config.toml, but comments won't load (even if they do in other themes). Is there something I'm missing? Thanks!

How to create a archives page with pagination like author's blog？

Thanks for such elegant theme :) I'm a new person to github and want to ask author a questoin. In author's blog, there is a arvhices page with pagination.

In my situation, I put all posts into a directory whose name is archives, however there is no pagination in /archives page. But there is pagination in / page.

So how can I make pagination in /archives page.

Custom CSS?

Hello, thanks for the theme! is it possible to easily add custom CSS? I don't want to mess with the theme's Git repo as I might lose changes when I upgrade or just carelessly delete later.

Mixed Content in the Minos theme demo on the Hugo website

Hello @carsonip I am one of the maintainers of the Hugo Themes repository.

Recently I reviewed the deploy log of the Hugo Themes website and apparently line 17 of your theme's header partial causes a Mixed Content browser warning on the Hugo website because it references an insecure URL. The Hugo website is served under HTTPS.

To fix this warning either change line 17 of the header partial to <link href="https://gmpg.org/xfn/11" rel="profile"> or delete it, if it's no longer needed. (I notified the author of the Hugo Octopress Theme earlier about the exact same line of code and he determined that this is no longer needed)

Once you do the above please let me know.

Thanks

Required Hugo version

From the README.md, the required Hugo version is 0.20+, but it actually needs a more recent one because of the use of hugo.Generator. The 0.4 version is still to old, 0.59 works fine.

.Now will be deprecated with Hugo v0.20

.Now will be deprecated replaced with the now template function in Hugo v0.20 which eventually will be released on Monday. It's likely that the deprecation will cause builds to fail.

Highlight current section in the TOC on the right

Hi,

I like the simplicity of your theme and the TOC shown on the right.

Can you please add few features to the TOC if you have time:

• Highlight the current section in the TOC. So if the top of the browser is after section 2, the TOC should highlight section 2.
• When the TOC length is greater than the browser height, if the user scrolls to a section that is currently not visible in the TOC, the TOC should scroll along with page scroll, and end up showing the section in the TOC, highlighted.

If the above explanation is too abstract, I am talking about the TOC behavior as in twitter bootstrap -- example.

how to disable article`s toc?

how to disable articles toc? i dont know

[params]
smartToc = false
not work

不支持归档页吗？

Optimize TOC height

Hello,

Based on the below code:

.article-toc {
  display: none;
  position: fixed;
  left: 50%;
  top: 110px;
  font-size: 0.9em;
  width: 260px;
  margin-left: 400px;
  padding-left: 20px;
  overflow-y: auto;
  line-height: 1.4em;
  max-height: 40.32em;
}

the TOC max height is limited to 40.32em.

Is it possible to make that dynamic.. based on the browser window height?

With the default, I see a lot of white space at the bottom and then a scrollbar for the TOC:

No trailing slash in baseURL causes CSS issue

When a user does not append a trailing slash to their baseURL config setting, one of the theme's CSS links breaks. This is because line 15 in layouts/partials/head.html does not have a slash (/) between {{ .Site.BaseURL }} and css/style.css.

I see two ways to remedy this.

1. Update the theme's docs to say to always add a trailing slash to the baseURL value
2. Update the CSS links to use absURL instead of {{ .Site.BaseURL }}, this way it does not matter if the user's baseURL has a trailing slash or not (I recommend this way)

For example:

<link href="{{ "webfonts/ptserif/main.css" | absURL }}" rel='stylesheet' type='text/css'>
<link href="{{ "webfonts/source-code-pro/main.css" | absURL }}" rel="stylesheet" type="text/css">

<link rel="stylesheet" href="{{ "css/style.css" | absURL }}">

See below discussion for the initial report of the issue:
https://discourse.gohugo.io/t/solved-beginner-question-missing-css-or-wrong-baseurl-on-gitlab-pages/15307/3

smart TOC don't work

under HUGO version 0.25
I build a whole new site
setup config.toml as below

baseURL = "http://example.org/"
languageCode = "en-us"
title = "My New Hugo Site"
theme = "hugo-theme-minos"

[params]
    smartToc = true

add one post with command

hugo new posts/1.md

1.md look like this

---
title: "1"
date: 2017-08-05T15:42:46+08:00
draft: false
---

[TOC]

# H1
2222

## H2
444

and the result look like this

can you help me figure it out ? or tell me where the document I can see ?
thanks very much

TOC not showing after setting smartToc to true

Adding

[params]
  smartToc = true

to config has no effect. I had to delete this line and change logic here to:

<div class="article-toc" {{if not .Site.Params.SmartToc }} style="display:none;" {{end}}>

to make it work as intended. Is the TOC showing in your original setup?

google analytics setting in config

In the readme here and on hugo's site, the GA setup is quoted as so

[params]
    googleAnalytics = "UA-123-45"

but it will result in the GA code not being inserted. The doc should be updated to be simply:

googleAnalytics = "UA-123-45"

which is consistent with other theme's doc.

A blog description

-Would it be possible to add an optional tag that included a blog description right below the blog title?-

I'll just submit a PR and do it myself.

edit: What I really wanted to ask : how do you get those menu bars at the top. I don't see it anywhere in the manual.

edit 2: nevermind - found that out, too.

Numbered list with more than 10 elements is not shown correctly

Hey,

I found an issue with template when I render numbered list with more than nine elements.

E.g.

1. Element 1
...
9. Element 9
10. Element 10

It will be rendered as:

1. Element 1
9. Element 9
0. Element 10

I think entry ol { margin: 20px } needs to be extended. Due to part of number of element is hidden.

Please confirm. I can create pull request.

Thanks!