Fork of https://github.com/athul/archie with the goal to self-host everything (including js)
Go to file
Samuel Proulx 3fa25abce4
Add mathjax and katex support (#75)
* Add mathjax and katex support

* update readme
2022-12-29 17:22:53 +05:30
.github Update FUNDING.yml 2021-03-01 21:21:59 +05:30
archetypes Init 2020-04-09 00:14:29 +05:30
assets/css Fixed title and menu links overlap in header 2022-08-14 08:34:17 +05:30
exampleSite Option to use local font files instead of Google fonts, combined option for CDN use (#16) 2020-10-20 23:33:23 +05:30
images Added Dark mode Image 2020-04-16 23:00:30 +05:30
layouts Add mathjax and katex support (#75) 2022-12-29 17:22:53 +05:30
static Add dark mode toggle 2021-09-24 19:38:28 +02:00
LICENSE Init 2020-04-09 00:14:29 +05:30
README.md Add mathjax and katex support (#75) 2022-12-29 17:22:53 +05:30
theme.toml Update tag background color 2020-04-16 21:32:51 +05:30

README.md

Archie - Hugo theme

Archie is a minimal and clean theme for hugo with a markdown-ish UI.

Forked from Ezhil Theme

Demo

Check the Demo hosted on GitHub Pages 😄 . You can find the source code to that in the site branch of this repository

Feature

  • Google Analytics Script
  • Callouts
  • Tags
  • Auto Dark Mode(based on system theme)
  • Dark/Light Mode toggle
  • tl:dr; frontamatter
  • Cache busting for CSS files

Installation

In your Hugo website directory, create a new folder named theme and clone the repo

$ 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 of Hugo.

Writing Posts

Create a new .md file in the content/posts folder

---
title: Title of the post
description:
date:
tldr: (optional)
draft: true/false (optional)
tags: [tag names] (optional)
---

Credits

Forked from Ezhil Theme and Licensed under MIT License Inspired by design of blog.jse.li


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.

[params]
	customcss = ["css/first.css", "css/second.css"]

Config of the Demo Site

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,toggle or auto
	useCDN=false # don't use CDNs for fonts and icons, instead serve them locally.
	subtitle = "Minimal and Clean [blog theme for Hugo](https://github.com/athul/archie)"
	mathjax = true # enable MathJax support
	katex = true # enable KaTeX support

# Social Tags

[[params.social]]
name = "GitHub"
icon = "github"
url = "https://github.com/athul/archie"

[[params.social]]
name = "Twitter"
icon = "twitter"
url = "https://twitter.com/athulcajay/"

[[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

If you liked my work please consider supporting me on BuymeACoffee

Buy Me A Coffee