update

Author: holzi1005

docs/blog/index.md

@@ -0,0 +1 @@
+# Blog

docs/index.md

@@ -1 +1,17 @@
-# Tutorials
+# Welcome to MkDocs
+
+For full documentation visit [mkdocs.org](https://www.mkdocs.org).
+
+## Commands
+
+* `mkdocs new [dir-name]` - Create a new project.
+* `mkdocs serve` - Start the live-reloading docs server.
+* `mkdocs build` - Build the documentation site.
+* `mkdocs -h` - Print help message and exit.
+
+## Project layout
+
+    mkdocs.yml    # The configuration file.
+    docs/
+        index.md  # The documentation homepage.
+        ...       # Other markdown pages, images and other files.

docs/tags.md

@@ -0,0 +1,2 @@
+# Tag index
+<!-- material/tags -->

ext/__init__.py

@@ -0,0 +1,23 @@
+
+import re, functools, unicodedata
+
+RE_HTML_TAGS = re.compile(r'</?[^>]*>', re.UNICODE)
+RE_INVALID_SLUG_CHAR = re.compile(r'[^\w\- ]', re.UNICODE)
+RE_WHITESPACE = re.compile(r'\s', re.UNICODE)
+
+def _make_slug(text, sep, **kwargs):
+    slug = unicodedata.normalize('NFC', text)
+    slug = RE_HTML_TAGS.sub('', slug)
+    slug = RE_INVALID_SLUG_CHAR.sub('', slug)
+    slug = slug.strip().lower()
+    slug = RE_WHITESPACE.sub(sep, slug)
+    return slug
+
+def _make_slug_short(text, sep, **kwargs):
+    words = _make_slug(text, sep, **kwargs).split(sep)
+    return sep.join(words[:5])
+
+def slugify(**kwargs):
+    if 'short' in kwargs and kwargs['short']:
+        return functools.partial(_make_slug_short, **kwargs)
+    return functools.partial(_make_slug, **kwargs)

ext/slugs.py

@@ -0,0 +1,21 @@
+from textwrap import dedent
+import urllib.parse
+import re
+
+x_intent = "https://twitter.com/intent/tweet"
+fb_sharer = "https://www.facebook.com/sharer/sharer.php"
+include = re.compile(r"blog/[1-9].*")
+
+def on_page_markdown(markdown, **kwargs):
+    page = kwargs['page']
+    config = kwargs['config']
+    if not include.match(page.url):
+        return markdown
+
+    page_url = config.site_url+page.url
+    page_title = urllib.parse.quote(page.title+'\n')
+
+    return markdown + dedent(f"""
+    [Share on :simple-x:]({x_intent}?text={page_title}&url={page_url}){{ .md-button }}
+    [Share on :simple-facebook:]({fb_sharer}?u={page_url}){{ .md-button }}
+    """)

hooks/socialmedia.py

@@ -1,4 +1,51 @@
 site_name: H2 invent Docs
 site_url: https://h2-invent.github.io/docs
 theme:
-  name: material
+  name: material
+  features:
+    - navigation.indexes
+
+plugins:
+  - search
+  - blog:
+      blog_toc: true
+      archive_date_format: MMMM yyyy
+      categories_allowed:
+        - Holidays
+        - News
+      authors_profiles: true
+      pagination_per_page: 5
+      archive_pagination_per_page: 10
+      categories_pagination_per_page: 10
+      post_slugify: !!python/object/apply:ext.slugs.slugify
+        kwds:
+          short: true
+  - meta
+  - tags
+  - rss:
+      match_path: "blog/posts/.*"
+      date_from_meta:
+        as_creation: date.created
+        as_update: date.updated
+
+extra:
+  social:
+    - icon: fontawesome/brands/mastodon
+      name: squidfunk on Mastodon
+      link: https://fosstodon.org/@squidfunk
+
+hooks:
+  - hooks/socialmedia.py
+
+markdown_extensions:
+  - attr_list
+  - pymdownx.emoji:
+      emoji_index: !!python/name:material.extensions.emoji.twemoji
+      emoji_generator: !!python/name:material.extensions.emoji.to_svg
+
+nav:
+  - Home: index.md
+  - Tags: tags.md
+  - Blog:
+     - blog/index.md
+     - blog/tags.md