tiskifer-theme/README.md

68 lines
1.7 KiB
Markdown
Raw Normal View History

2023-02-05 22:00:05 +01:00
# Tiskifer Theme
2022-10-29 10:39:10 +02:00
2023-02-05 22:00:05 +01:00
Originaly forked from [Shadharon](https://syedzayyan.github.io/shadharon).
2022-10-29 10:39:10 +02:00
<details open>
<summary>Dark theme</summary>
2022-10-29 11:14:16 +02:00
2022-10-29 11:13:21 +02:00
![blog-dark](https://raw.githubusercontent.com/syedzayyan/shadharon/main/screenshot.png)
2022-10-29 10:52:12 +02:00
</details>
<details close>
<summary>Light theme</summary>
2023-02-05 22:00:05 +01:00
2022-10-29 10:52:12 +02:00
![light-dark](https://raw.githubusercontent.com/syedzayyan/shadharon/main/screenshot-light.png)
2022-10-29 10:39:10 +02:00
</details>
## Features
- [X] Themes (light, dark). Default theme is dark with a switcher in the navbar
- [X] Projects page
- [x] Social Links
- [x] Tags
## Installation
2022-10-29 10:52:12 +02:00
0. Initialize Git Repo if not initialized
2022-10-29 10:39:10 +02:00
1. Download the theme
```
2023-02-05 22:00:05 +01:00
git submodule add https://git.sr.ht/~koehr/tiskifer-theme themes/tiskifer
2022-10-29 10:39:10 +02:00
```
2023-02-05 22:00:05 +01:00
2. Add `theme = "tiskifer"` to your `config.toml`
2022-10-29 11:13:21 +02:00
2022-10-29 10:39:10 +02:00
3. Copy the example content
```
2023-02-05 22:00:05 +01:00
cp -R themes/tiskifer/content/. content
2022-10-29 10:39:10 +02:00
```
2022-10-29 11:13:21 +02:00
2022-10-31 09:18:16 +01:00
## Customization
1. For customization refer to config.toml files, which has comments.
2. For customizing the banner on the homepage the content/posts/_index.md needs modification. The desc variable under `extra`, specifically. You could delete this as well to remove banner. For an about page or any aditional page an .md file in the "content" directory will do.
You can add stylesheets to override the theme:
```toml
[extra]
stylesheets = [
"override.css",
]
```
2022-10-29 10:39:10 +02:00
These filenames are relative to the root of the site. In this example, the two CSS files would be in the `static` folder.
2022-10-31 09:18:16 +01:00
2022-10-29 10:39:10 +02:00
## References
2023-02-05 22:00:05 +01:00
This theme is a fork of
[Shadharon](https://syedzayyan.github.io/shadharon)
which originally takes inspiration from
- [apollo](https://github.com/not-matthias/apollo).
2022-10-29 11:13:21 +02:00
- [Tania's Website](https://tania.dev/)
2022-10-29 13:19:10 +02:00
- [Anpu Zola Theme](https://github.com/zbrox/anpu-zola-theme)