76 lines
1.6 KiB
Markdown
76 lines
1.6 KiB
Markdown
|
# no style, please!
|
||
|
|
|
||
|
|
A (nearly) no-CSS, fast, minimalist [Zola](https://www.getzola.org/) theme.
|
||
|
|
Ported from from [riggraz](https://riggraz.dev/)'s [no style, please! Jekyll theme](https://riggraz.dev/no-style-please/), and I use it for [my site](https://4b.cx/)
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
## Installation
|
||
|
|
|
||
|
|
First download this theme to your `themes` directory:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
cd themes
|
||
|
|
git clone https://gitlab.com/4bcx/no-style-please.git
|
||
|
|
```
|
||
|
|
|
||
|
|
and then enable it in your `config.toml`:
|
||
|
|
|
||
|
|
```toml
|
||
|
|
theme = "no-style-please"
|
||
|
|
```
|
||
|
|
|
||
|
|
## Options
|
||
|
|
|
||
|
|
### Pages list in homepage
|
||
|
|
|
||
|
|
To enable listing of pages in homepage add the following in `content\_index.md` frontmatter
|
||
|
|
|
||
|
|
```toml
|
||
|
|
[exta]
|
||
|
|
list_pages = false
|
||
|
|
```
|
||
|
|
|
||
|
|
### Extra data
|
||
|
|
|
||
|
|
- `author` can be set in both main config and in pages metadata
|
||
|
|
- `image` variable can be used in pages to add an image to HTML `<meta>` tags
|
||
|
|
- Same for `logo` in main config, except this one is also used as the site icon
|
||
|
|
|
||
|
|
### Horizontal rule shortcode `hr()`
|
||
|
|
|
||
|
|
Adds the option to insert text in the thematic break
|
||
|
|
|
||
|
|
```html
|
||
|
|
{{ hr(data_content="footnotes") }}
|
||
|
|
```
|
||
|
|
|
||
|
|
is rendered
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
### Invertable image `iimg()`
|
||
|
|
|
||
|
|
Images are not inverted in darkmode by default. To add an invertable image use the following
|
||
|
|
|
||
|
|
```html
|
||
|
|
{{ iimg(src="logo.png", alt="alt text") }}
|
||
|
|
```
|
||
|
|
|
||
|
|
In light mode
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
In dark mode
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
## TODO
|
||
|
|
|
||
|
|
- [ ] Add RTL support
|
||
|
|
- [ ] Write proper test pages
|
||
|
|
|
||
|
|
## License
|
||
|
|
|
||
|
|
The theme is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
|