* added tutorials page and blog tutorial
* proof reading, some language improvements
* split blog tutorial into parts
and reworked on the basis of comments, improved language, added missing
things
* + custom slugify function example
* +blog tutorial on engagement
* + section blog ToC
* + instructions for X/FB share buttons and started discussion system
* fix: module name `code` shadowed Python standard library module
* added What's next section
* +blog tutorial engagement part
* fix: updated Giscus code snippet
* trying multiple tutorials with headings for each group
* + basic social cards tutorial
* + custom social card tutorial
* + estimated time for custom card tutorial
* added tutorial sections to nav
* fixed typos, removed sponsor icon from level one heading
* removed "tutorial" from level one heading
* added headings to custom layout example
* fixed broken link
* fixes after run-through, added links to template repos
* added comment for @squidfunk
* clarified use of logos, some proof-reading
* removed question I left for @squidfunk
* clarified relationship between background color and image
* added override for the background image
* fixed wording and indentation
* changed example to be releases, not events
* being more specific where to add the last bit of code in the layout
---------
Co-authored-by: squidfunk <martin.donath@squidfunk.com>
I found it difficult to find the instructions for setting up a
development environment with my usual GitHub habits. In fact, I assumed
they don't exist and missed the very helpful information.
I hope that this commit will help others find them.
Unicode, case-sensitive reference setting causes error below.
```
yaml.constructor.ConstructorError: expected a mapping node, but found scalar
```
Update related sections in the documentation to address this issue.
Newer Python-Markdown has `slugify_unicode` built-in, so this
```yaml
markdown_extensions:
- toc:
slugify: !!python/name:markdown.extensions.toc.slugify_unicode
```
also works for case-insensitive use cases.
Fixes: ee1e675da6 ("Update slug reference")
