# moeka

Theme for [Pelican](https://getpelican.com/) inspired by [Brutalist](https://brutalistpelican.com/) and [IBM Plex](https://www.ibm.com/plex/).

I mostly develop this theme for my [personal blog](https://kingdread.de/blog) (which you can also use as a demo), as such, the features that I use are implemented. The theme is not complete yet, and many features are missing (like pagination or author profiles).

## Features

* IBM Plex for body text and source code
* Monokai theme for Pygments code highlight
* Icons for GitHub, GitLab, Codeberg, Mastodon profiles
* Zero JavaScript
* No trackers/analytics
* No remote resources needed, everything is bundled
* Helps me to work on and improve my typography and web design skills

## Usage

Set `THEME = "moeka"` in your `pelicanconf.py`.

### Asterism

You can insert an asterism to separate specific sections visually. To do so,
use the following snippet:

```rst
.. raw:: html

    <p class="asterism"></p>
```

## Settings

This theme supports the following settings (set them in your `pelicanconf.py`).
All of them are optional, if not given, the element will simply be hidden:

```python
# Menu items as a list of (title, url) tuples, like in the standard theme.
# See https://docs.getpelican.com/en/4.9.1/settings.html#MENUITEMS
MENUITEMS = [
    ("Pelican!", "https://getpelican.com/"),
]

# Show a small line at the bottom of the page linking to this theme.
ATTRIBUTION = True

# If set, shows as a line that notes under which licence the content on your
# website is available. If this starts with "CC-BY-SA", the theme also shows
# the Creative Commons icons.
CONTENT_LICENCE = "CC-BY-SA 4.0"

# If set and True, shows the authors of articles.
DISPLAY_ARTICLE_AUTHORS = True

# Set to the name/path (relative to the base of your site) to use the given
# image as a favicon.
FAVICON = "images/favicon.png"
# Simlarly, set this to the path of a logo image that is shown above the menu.
LOGO = "images/logo.png"

# The URL of your GitHub profile. If set, shows a GitHub icon that links to
# your profile ...
GITHUB = "https://github.com/..."
# ... similar for GitLab ...
GITLAB = "https://gitlab.com/..."
# ... similar for Codeberg ...
CODEBERG = "https://codeberg.org/..."
# ... similar for Mastodon ...
MASTODON = "https://mastodon.social/..."
```

## Licence

    Copyright (C) 2023 Daniel Schadt

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.

The included font (IBM Plex) is licensed under the SIL Open Font License, Version 1.1.

All trademarks, logos and brand names are the property of their respective owners. All company, product and service names used in this theme are for identification purposes only. Use of these names, trademarks and brands does not imply endorsement.