hugo-theme-archie/README.md

112 lines
2.5 KiB
Markdown
Raw Normal View History

2020-04-09 06:36:48 +00:00
# Archie - Hugo theme
2020-04-11 14:45:12 +00:00
Archie is a minimal and clean theme for hugo with a markdown-ish UI.
Forked from [Ezhil Theme](https://github.com/vividvilla/ezhil)
## Demo
2020-05-04 19:14:33 +00:00
[Check the Demo](https://athul.github.io/archie/) hosted on GitHub Pages :smile: . You can find the source code to that in the `site` branch of this repository
2020-04-11 14:45:12 +00:00
![](/images/theme.png)
2020-04-16 17:30:30 +00:00
![](/images/archie-dark.png)
2020-04-11 14:45:12 +00:00
## Feature
- Google Analytics Script
- Callouts
- Tags
2020-04-16 16:18:45 +00:00
- Auto Dark Mode(based on system theme)
2020-04-11 14:45:12 +00:00
- tl:dr; frontamatter
## Installation
In your Hugo website directory, create a new folder named theme and clone the repo
```bash
$ mkdir themes
$ cd themes
$ git clone https://github.com/athul/archie.git
```
Edit the `config.toml` file with `theme="archie"`
For more information read the official [setup guide](https://gohugo.io/overview/installing/) of Hugo.
## Writing Posts
2020-04-16 16:18:45 +00:00
Create a new `.md` file in the *content/posts* folder
2020-04-11 14:45:12 +00:00
```yml
---
title: Title of the post
description:
date:
tldr: (optional)
2020-04-16 16:18:45 +00:00
draft: true/false (optional)
tags: [tag names] (optional)
2020-04-11 14:45:12 +00:00
---
```
## Credits
2020-04-16 16:18:45 +00:00
Forked from [Ezhil Theme](https://github.com/vividvilla/ezhil) and Licensed under MIT License
2020-04-16 17:30:30 +00:00
Inspired by design of blog.jse.li
2020-05-04 19:14:33 +00:00
----
## Config of the Demo Site
```toml
baseURL = "https://athul.github.io/archie/"
languageCode = "en-us"
title = "Archie"
theme="archie"
copyright = "© Athul"
# Code Highlight
pygmentsstyle = "monokai"
pygmentscodefences = true
pygmentscodefencesguesssyntax = true
paginate=3 # articles per page
[params]
mode="auto" # color-mode → light,dark or auto
useCDN=false # don't use CDNs for fonts and icons, instead serve them locally.
2020-05-04 19:14:33 +00:00
subtitle = "Minimal and Clean [blog theme for Hugo](https://github.com/athul/archie)"
# Social Tags
[[params.social]]
name = "GitHub"
icon = "github"
url = "https://github.com/athul/archie"
[[params.social]]
name = "Twitter"
icon = "twitter"
2020-09-16 11:35:03 +00:00
url = "https://twitter.com/athulcajay/"
2020-05-04 19:14:33 +00:00
[[params.social]]
name = "GitLab"
icon = "gitlab"
url = "https://gitlab.com/athul/"
# 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
```
2021-03-01 15:50:33 +00:00
---
If you liked my work please consider supporting me on [BuymeACoffee](https://www.buymeacoffee.com/athulca)
<a href="https://www.buymeacoffee.com/athulca" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-red.png" alt="Buy Me A Coffee" height="41" width="174" ></a>