mirror of
https://github.com/squidfunk/mkdocs-material.git
synced 2024-06-14 11:52:32 +03:00
50d7c54bdf
* 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>
57 lines
2.7 KiB
Markdown
57 lines
2.7 KiB
Markdown
# Tutorials
|
|
|
|
In addition to the basic getting started guides, we offer tutorials that aim to
|
|
show how you can use Material for MkDocs in different use cases. In contrast to
|
|
the getting started guides or the reference documentation, the tutorials show
|
|
the breadth of features available in Material for MkDocs but also within
|
|
the wider MkDocs ecosystem.
|
|
|
|
The tutorials guide you through worked examples, so by following them you should
|
|
gain not only an understanding of how to use Material for MkDocs, but also
|
|
a template for your own projects. For convenience, these templates are also
|
|
available as template repositories on GitHub.
|
|
|
|
The tutorials assume that you have installed either the [public version] or the
|
|
[Insiders edition] of Material for MkDocs and that you have worked through the
|
|
[creating your site] setup guide.
|
|
|
|
Note that where the features we use require the Insiders edition, we mark these
|
|
with the heart icon: <!-- md:sponsors --> If you are using the public version
|
|
then you can skip these steps. Sometimes there will be ways of achieving the
|
|
same goal that differ between the public version and the Insider edition. In
|
|
that case, we will show them in a tabbed view so you can see one or the other.
|
|
|
|
[public version]: ../getting-started.md
|
|
[Insiders edition]: ../insiders/getting-started.md
|
|
[creating your site]: ../creating-your-site.md
|
|
|
|
!!! note "Feedback wanted!"
|
|
The tutorials are a recent addition to our documentation and we are still
|
|
working out what shape they should have in the end. Please contact us if you
|
|
want to provide feedback. <!--- TODO: how? -->
|
|
|
|
Note, however, that suggestions should be specific and feasible. We want to
|
|
focus on creating more content at the moment, instead of developing a
|
|
specific styling or behaviour for the tutorials. If there are worthwhile
|
|
improvements that we can make through simple customization then we are happy
|
|
to consider those.
|
|
|
|
## Blogs
|
|
* [Basics](blogs/basic.md) (20 min) <br/>
|
|
covers the basics of setting up a blog, including post metadata.
|
|
* [Navigation, pagination, multiple authors](blogs/navigation.md) (30 min)<br/>
|
|
describes how to make it easier for your readers to find content.
|
|
* [Engagement and dissemination](blogs/engage.md) (30 min)<br/>
|
|
walks you through ways of increasing engagement with your content.
|
|
|
|
[:octicons-repo-template-24: Template Repository](https://github.com/mkdocs-material/create-blog)
|
|
|
|
## Social cards
|
|
* [Basics](social/basic.md) (20 min) <br/>
|
|
shows you how to configure Material for MkDocs to create social cards for
|
|
your content.
|
|
* [Custom cards](social/custom.md) (15 min)<br/>
|
|
shows you how to design your own custom social cards.
|
|
|
|
[:octicons-repo-template-24: Template Repository](https://github.com/mkdocs-material/create-social-cards)
|