Move theme from subrepo into the main repo

the theme is customized for this site so having it as a sub repo dosent make sense
2025-12-24 11:05:37 -05:00
parent dd9c76b24b
commit 9a313c53a8
56 changed files with 2652 additions and 4 deletions
--- a/themes/hugo-theme-minos/README.md
+++ b/themes/hugo-theme-minos/README.md
@@ -0,0 +1,145 @@
+# Minos
+
+**_A simple and retro styled theme, concentrated more on your ideas._**
+
+Minos is a Hugo theme ported from Hexo theme [Minos](https://github.com/ppoffice/hexo-theme-minos). Requires Hugo v0.59+.
+
+## Screenshots
+
+![Home](https://cdn.rawgit.com/carsonip/hugo-theme-minos/cb2cdd88/images/screenshot.png)
+![Article](https://cdn.rawgit.com/carsonip/hugo-theme-minos/cb2cdd88/images/article.png)
+![Tag](https://cdn.rawgit.com/carsonip/hugo-theme-minos/cb2cdd88/images/tag.png)
+
+## 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](https://github.com/Khan/KaTeX)
+* Syntax highlighting using [highlight.js](https://github.com/isagalaev/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](https://gohugo.io/overview/configuration/#configuration-variables).
+
+## 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](https://github.com/carsonip/hugo-theme-minos/blob/master/LICENSE.md) file for more details.