dracublog/readme.md

85 lines
1.9 KiB
Markdown
Raw Permalink Normal View History

2022-05-18 10:53:32 -04:00
# Dracublog
2021-02-05 11:36:58 -05:00
[![git repo](https://img.shields.io/badge/repo-git-informational.svg?logo=gitea)](https://git.earne.link/earnestma/dracublog)
A simple, fully-featured Hugo blogging theme with Dracula colors.
2021-02-06 12:55:46 -05:00
Features:
- Basic support for [Gemini output](https://gemini.circumlunar.space/)
- Full content RSS feed by default
- Support for author/ multi-author posts
- Support for "comments" through Mastodon's API (toot)
- Optional openring styling (generates a list of recent posts from blogs you follow)
- `noindex` param to prevent certain pages from being indexed
2021-02-05 14:30:16 -05:00
## Install
2022-05-18 10:53:32 -04:00
**Tarball**
2021-02-05 14:30:16 -05:00
2022-05-18 10:53:32 -04:00
- Version: `https://git.earne.link/earnestma/dracublog/archive/$VERSION.tar.gz`
- Main branch: `https://git.earne.link/earnestma/dracublog/archive/main.tar.gz`
2021-02-05 14:30:16 -05:00
2022-05-18 10:53:32 -04:00
You can add `themes/dracublog` to `.gitignore`, and extract it there.
2021-02-05 14:30:16 -05:00
2022-05-18 10:53:32 -04:00
**Through a git submodule**
2021-02-05 14:30:16 -05:00
2022-05-18 10:53:32 -04:00
`git submodule add https://git.earne.link/earnestma/dracublog.git themes/dracublog`
2021-02-05 14:30:16 -05:00
## Configuration
2021-02-05 11:36:58 -05:00
2021-02-06 12:55:46 -05:00
## Gemini Output
Improvements welcome.
`config.toml`:
```toml
[mediaTypes]
[mediaTypes."text/gemini"]
suffixes = ["gmi"]
[outputFormats]
[outputFormats.Gemini]
name = "GEMTEXT"
isPlainText = true
isHTML = false
mediaType = "text/gemini"
protocol = "gemini://"
permalinkable = true
path = "gemini/"
[outputs]
section = ["HTML", "RSS"]
```
Blog posts (`post-filename.md`):
A post that has both html and gemini output:
```
title: "Example"
date: 2020-01-01 13:23:00 -0500
draft: false
outputs:
- html
- gemtext
```
Just gemini:
```
outputs:
- gemtext
```
Gemini content will go in the same `post-filename.gmi`. A Makefile or automated CI can be used to transfer output and exclude certain files/ directories to the correct directories.
2021-02-05 11:36:58 -05:00
## Contributing
2021-02-05 14:30:16 -05:00
Please see [contributing.md](contributing.md). This project is licensed under the [MIT License](license.md).
2021-02-05 11:36:58 -05:00
## Thanks
- [Dracula theme](https://draculatheme.com/) (MIT)
- [Simple CSS](https://simplecss.org/) (MIT)