servius/sukr
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: fix tutorial path with inline templates

Browse Source 
Replace stale `cargo install sukr` with install-from-source.
Replace Step 4 dead-end with inline base.html, page.html,
and content/default.html templates. Add "View your site"
completion step. Improve Next Steps with reading-order context.
This commit is contained in:
Timothy DeHerrera
2026-02-12 12:45:09 -07:00
parent 978ae679ff
commit ce830767ff
3 changed files with 60 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

58
docs/content/getting-started.md
View File

@@ -59,7 +59,54 @@ This is my site built with sukr.
### 4. Create templates
Copy the default templates from the sukr repository, or create your own Tera templates.
Create `templates/base.html`:
```html
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>{{ title }} | {{ config.title }}</title>
<link rel="stylesheet" href="{{ prefix }}/style.css" />
</head>
<body>
<main>{% block content %}{% endblock content %}</main>
</body>
</html>
```
Create `templates/page.html`:
```html
{% extends "base.html" %} {% block content %}
<article>
<h1>{{ page.title }}</h1>
{{ content | safe }}
</article>
{% endblock content %}
```
Create `templates/content/default.html`:
```html
{% extends "base.html" %} {% block content %}
<article>
<h1>{{ page.title }}</h1>
{{ content | safe }}
</article>
{% endblock content %}
```
Your templates directory should look like this:
```text
templates/
├── base.html
├── page.html
└── content/
└── default.html
```
### 5. Build
@@ -67,9 +114,12 @@ Copy the default templates from the sukr repository, or create your own Tera tem
sukr
```
Your site is now in `public/`.
### 6. View your site
Open `public/index.html` in your browser. You should see your "Hello, World!" page rendered with the template you created.
## Next Steps
- Learn about [Configuration](configuration.html)
- Explore [Features](features/index.html)
- [Configuration](configuration.html) — customize `site.toml` options (paths, navigation, base URL)
- [Content Organization](content-organization.html) — learn how directories map to site sections
- [Features](features/index.html) — syntax highlighting, math, diagrams, and more