themu/README.md

107 lines
2.1 KiB
Markdown
Raw Normal View History

2020-04-11 17:45:12 +03:00
## Demo
2023-07-26 19:22:55 +03:00
[Check the Demo](https://fruw.org)
2020-04-11 17:45:12 +03:00
## Feature
- Google Analytics Script
- Callouts
- Tags
- Cache busting for CSS files
2020-04-11 17:45:12 +03:00
## Installation
2023-07-26 19:22:55 +03:00
In your Hugo website directory, create a new folder named themes and clone the repo
2020-04-11 17:45:12 +03:00
```bash
$ mkdir themes
2023-07-26 19:22:55 +03:00
$ git submodule add https://github.com/fruworg/themu themes/themu
2020-04-11 17:45:12 +03:00
```
2023-07-26 19:22:55 +03:00
Edit the `config.toml` file with `theme="themu"`
2022-11-11 09:52:05 +03:00
For more information read the official [setup guide](https://gohugo.io/installation/) of Hugo.
2020-04-11 17:45:12 +03:00
## Writing Posts
2020-04-16 19:18:45 +03:00
Create a new `.md` file in the *content/posts* folder
2020-04-11 17:45:12 +03:00
```yml
---
title: Title of the post
description:
date:
2020-04-16 19:18:45 +03:00
draft: true/false (optional)
tags: [tag names] (optional)
2020-04-11 17:45:12 +03:00
---
```
## Config Options
### Custom CSS
Custom CSS files can be included though the `customcss` config parameter.
Note: CSS files should be placed under the `assets` directory e.g. `assets/css/first.css`.
```toml
[params]
customcss = ["css/first.css", "css/second.css"]
```
2020-05-04 22:14:33 +03:00
## Config of the Demo Site
```toml
2023-07-26 19:22:55 +03:00
baseURL = "https://<name>.github.io"
2020-05-04 22:14:33 +03:00
languageCode = "en-us"
2023-07-26 19:22:55 +03:00
title = "<name>"
theme="themu"
2020-05-04 22:14:33 +03:00
# Code Highlight
pygmentsstyle = "monokai"
pygmentscodefences = true
pygmentscodefencesguesssyntax = true
paginate=3 # articles per page
[params]
2021-09-25 19:23:24 +03:00
mode="auto" # color-mode → light,dark,toggle or auto
useCDN=false # don't use CDNs for fonts and icons, instead serve them locally.
2023-07-26 19:22:55 +03:00
subtitle = "Minimal and Clean [blog theme for Hugo](https://github.com/fruworg)"
mathjax = true # enable MathJax support
katex = true # enable KaTeX support
2020-05-04 22:14:33 +03:00
# Social Tags
[[params.social]]
name = "GitHub"
icon = "github"
2023-07-26 19:22:55 +03:00
url = "https://github.com/<name>"
2020-05-04 22:14:33 +03:00
[[params.social]]
name = "Twitter"
icon = "twitter"
2023-07-26 19:22:55 +03:00
url = "https://twitter.com/<name>"
2020-05-04 22:14:33 +03:00
[[params.social]]
name = "GitLab"
icon = "gitlab"
2023-07-26 19:22:55 +03:00
url = "https://gitlab.com/<name>"
2020-05-04 22:14:33 +03:00
# Main menu Items
[[menu.main]]
name = "Home"
url = "/"
weight = 1
[[menu.main]]
name = "All posts"
url = "/posts"
weight = 2
[[menu.main]]
name = "About"
url = "/about"
weight = 3
[[menu.main]]
name = "Tags"
url = "/tags"
weight = 4
```
2023-07-26 19:26:07 +03:00
## Credits
Forked from [Archie Theme](https://github.com/athul/archie) and Licensed under MIT License