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:
Timothy DeHerrera
2026-02-12 13:10:22 -07:00
parent bdf8976378
commit f40233cb6e
4 changed files with 46 additions and 16 deletions

View File

@@ -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:

View File

@@ -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