E.Noorlander
9a5ab351ba
- Admin guide: RBAC roles, role-based dashboard, plugin types (content/system) - CodePress developer guide: plugin types, admin plugin API, SCSS compilation, asset serving - Theme developer guide: SCSS sole CSS source, css_compiled read-only, guide layout - Content manager guide: layout selection from theme.json, plugin order in frontmatter - Both NL and EN updated with identical structure - 35 files updated
73 lines
1.6 KiB
Markdown
73 lines
1.6 KiB
Markdown
# Layouts
|
|
|
|
Layouts definiëren de pagina structuur (sidebar links, volledige breedte, etc.). Layouts worden gedefinieerd in `theme.json` en gekozen via frontmatter in content bestanden.
|
|
|
|
## Layout kiezen in content
|
|
|
|
```markdown
|
|
---
|
|
layout: left_sidebar
|
|
---
|
|
|
|
# Pagina titel
|
|
|
|
Content...
|
|
```
|
|
|
|
## Layouts in theme.json
|
|
|
|
Layouts worden gedefinieerd in de `template` mapping. De `config.default_template` is de fallback voor pagina's zonder `layout:` frontmatter of met een onbekende layout:
|
|
|
|
```json
|
|
{
|
|
"config": {
|
|
"default_template": "full_content"
|
|
},
|
|
"template": {
|
|
"full_content": "full_content.twig",
|
|
"left_sidebar": "left_sidebar.twig",
|
|
"right_sidebar": "right_sidebar.twig",
|
|
"custom1": "custom1.twig",
|
|
"guide": "guide.twig"
|
|
}
|
|
}
|
|
```
|
|
|
|
## Layout template
|
|
|
|
Een layout template extends `base.twig` en vult het `content` block:
|
|
|
|
```twig
|
|
{% extends 'base.twig' %}
|
|
|
|
{% block content %}
|
|
<div class="container">
|
|
{{ content|raw }}
|
|
</div>
|
|
{% endblock %}
|
|
```
|
|
|
|
## Layouts met sidebar
|
|
|
|
Layouts met sidebar kunnen plugin content tonen:
|
|
|
|
```twig
|
|
{% extends 'base.twig' %}
|
|
|
|
{% block content %}
|
|
<div class="row">
|
|
<main class="col-md-8">
|
|
{{ content|raw }}
|
|
</main>
|
|
<aside class="col-md-4">
|
|
{{ sidebar_content|raw }}
|
|
</aside>
|
|
</div>
|
|
{% endblock %}
|
|
```
|
|
|
|
Als een pagina geen plugins heeft of de layout geen sidebar bevat, is `sidebar_content` leeg.
|
|
|
|
## Guide layout
|
|
|
|
De `guide` layout (`guide.twig`) is speciaal voor handleidingen. Het injecteert de Navigation plugin in de sidebar voor zijbalk navigatie. Wordt automatisch gebruikt voor pagina's in de `guide/` map. |