docs: add frontmatter defaults and enrich theming
Update Tera link to canonical URL, add authoring syntax pointer. Add Default column to frontmatter fields table with source-verified values. Enrich Theme System section with core CSS variables table and customization pattern.
This commit is contained in:
@@ -205,6 +205,36 @@ sukr includes several themes in the `themes/` directory:
|
||||
|
||||
Copy the theme files to your project and import as shown above.
|
||||
|
||||
### Core Variables
|
||||
|
||||
All themes define these CSS custom properties in `:root`:
|
||||
|
||||
| Variable | Description |
|
||||
| --------------- | ---------------------- |
|
||||
| `--hl-keyword` | Keywords, control flow |
|
||||
| `--hl-string` | String literals |
|
||||
| `--hl-function` | Function names |
|
||||
| `--hl-comment` | Comments |
|
||||
| `--hl-type` | Type names |
|
||||
| `--hl-number` | Numeric literals |
|
||||
| `--hl-variable` | Variables |
|
||||
| `--hl-operator` | Operators |
|
||||
|
||||
### Customizing a Theme
|
||||
|
||||
Import a theme, then override specific variables in your own CSS:
|
||||
|
||||
```css
|
||||
@import "themes/dracula.css";
|
||||
|
||||
/* Override just the keyword color */
|
||||
:root {
|
||||
--hl-keyword: #e879f9;
|
||||
}
|
||||
```
|
||||
|
||||
Changing a variable updates every scope that references it.
|
||||
|
||||
### Theme Structure
|
||||
|
||||
Themes use CSS custom properties for easy customization:
|
||||
|
||||
@@ -4,7 +4,7 @@ description: Customizable templates without recompilation
|
||||
weight: 1
|
||||
---
|
||||
|
||||
sukr uses [Tera](https://tera.netlify.app/), a Jinja2-like templating engine. Templates are loaded at runtime, so you can modify them without recompiling sukr.
|
||||
sukr uses [Tera](https://keats.github.io/tera/), a Jinja2-like templating engine. Templates are loaded at runtime, so you can modify them without recompiling sukr. See the [Tera documentation](https://keats.github.io/tera/docs/) for template authoring syntax (filters, blocks, inheritance).
|
||||
|
||||
## Template Directory Structure
|
||||
|
||||
|
||||
Reference in New Issue
Block a user