https://github.com/mildronize/hugo-theme-mild
Hugo Theme: Mild
https://github.com/mildronize/hugo-theme-mild
Last synced: about 1 year ago
JSON representation
Hugo Theme: Mild
- Host: GitHub
- URL: https://github.com/mildronize/hugo-theme-mild
- Owner: mildronize
- License: mit
- Created: 2022-04-16T02:26:51.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2022-04-21T13:44:49.000Z (about 4 years ago)
- Last Synced: 2025-01-23T10:15:42.398Z (over 1 year ago)
- Language: CSS
- Size: 3.45 MB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Hugo Theme: Mild
Mild is a theme for hugo which is ported from [simpleness](https://github.com/RainerChiang/simpleness).
[](https://github.com/mildronize/hugo-theme-mild/actions/workflows/deploy-gh-pages.yaml)
## Lighthouse Pagespeed (Mobile)
[](https://htmlpreview.github.io/?https://raw.githubusercontent.com/mildronize/hugo-theme-mild/lighthouse/lighthouse_results/mobile/thadaw_com_hugo_theme_mild_.html)
## Live Demo
[](https://thadaw.com/hugo-theme-mild/)
## Features
- MathJax suport
- Google Analytics support
- Comment systems include: disqus, valine
- Table of content
- PostCSS
- TypeScript
- Theme Switch
- Code Highlight using Prism JS based on theme
## TODO
- [ ] Pagination for posts
## Quick Start
### 1. Install Hugo
[Download](https://github.com/gohugoio/hugo/releases) the appropriate version for your platform.
I used [hugo_extended_0.75.1_Linux-64bit.deb](https://github.com/gohugoio/hugo/releases/download/v0.75.1/hugo_extended_0.75.1_Linux-64bit.deb) to develop this theme.
### 2. Create a New Site
```shell
hugo new site myBlog
```
### 3. Use hugo theme mild
```shell
cd myBlog
git init
git submodule add https://github.com/mildronize/mild-theme.git themes/mild
```
copy the content of exampleSite
```shell
cp themes/mild/exampleSite/config.toml .
cp -r themes/mild/exampleSite/content .
```
build site
```shell
hugo server
```
then, open http://localhost:1313/ in your browser。
## Todo
- [ ] Write Hugo Shortcode for render hightlight block for Prismjs, [Line Number](https://prismjs.com/plugins/line-numbers/), [Light Highlight](https://prismjs.com/plugins/line-highlight)
```html
```
Note: The native shortcode from Hugo `{{< highlight html >}}` only support `chroma`
## Local Development
Change `exampleSite/config.yaml` from `baseURL: /hugo-theme-mild/` to `baseURL: /`
```
npm install
npm run dev
```
Release new version
```
npm run publish
```
Build only (for Pipeline)
```
npm run build
```
Note: Disable Cache when develop
## Original Author
- Rainer Chiang