mirror of
https://0xacab.org/anarsec/anarsec.guide.git
synced 2025-06-21 04:54:21 -04:00
43 lines
1.8 KiB
Markdown
43 lines
1.8 KiB
Markdown
+++
|
|
title = "Theme extension"
|
|
description = "Extending a theme"
|
|
date = 2022-02-07
|
|
|
|
[taxonomies]
|
|
categories = ["Documentation"]
|
|
tags = ["theme", "zola"]
|
|
|
|
[extra]
|
|
toc = true
|
|
comments = false
|
|
+++
|
|
|
|
DeepThought theme can be extended with [usual Zola extension mechanisms](https://www.getzola.org/documentation/themes/extending-a-theme/).
|
|
|
|
<!-- more -->
|
|
|
|
# Replacing a template
|
|
|
|
As any theme, all DeepThought templates [can be replaced to override a whole template](https://www.getzola.org/documentation/themes/extending-a-theme/#replacing-a-template).
|
|
|
|
# Blocks to extend
|
|
|
|
If you don't want to replace a whole DeepThought template, but override parts of it, [you can extend the template and redefine some specific blocks](https://www.getzola.org/documentation/themes/extending-a-theme/#overriding-a-block).
|
|
|
|
Here is a WIP list of blocks in DeepThought templates to override:
|
|
|
|
| Template location[^1] | Block | Description |
|
|
| ------ | ----------- | -- |
|
|
| `base.html` | `user_custom_stylesheet` | Custom stylesheet (css or saas) to fine-tune DeepThought styling |
|
|
| `base.html` | `title` | Customize default page's titles |
|
|
| `base.html` | `analytics` | Provide your own analytics script. Google Analytics by default |
|
|
| `base.html` | `header` | Customize page's header |
|
|
| `base.html` | `content` | Customize page's content |
|
|
| `base.html` | `search` | Provide your own search box partial template |
|
|
| `base.html` | `pagination` | Override default pagination |
|
|
| `base.html` | `comment` | Provide your own pagination partial template |
|
|
| `base.html` | `other_lang_search_js` | Provide custom search behavior, eg. [to use languages others than English](https://github.com/RatanShreshtha/DeepThought/#elasticlunr-search-in-other-language) |
|
|
| `base.html` | `user_custom_js` | Provide any custom JS scripts at the end of the body of the page |
|
|
|
|
---
|
|
[^1]: Relative to the `templates` directory
|