diff --git a/docs/conventions.md b/docs/conventions.md index 0363412ab..a9da90ed1 100644 --- a/docs/conventions.md +++ b/docs/conventions.md @@ -91,3 +91,4 @@ Besides plugins, there are some utilities that build on top of MkDocs in order to provide extended functionality, like for example support for versioning. [Insiders]: insiders/index.md + diff --git a/docs/setup/setting-up-a-blog.md b/docs/setup/setting-up-a-blog.md index bd1afab45..8f1c3253b 100644 --- a/docs/setup/setting-up-a-blog.md +++ b/docs/setup/setting-up-a-blog.md @@ -22,6 +22,7 @@ __Check out our [blog], which is created with the new [built-in blog plugin]!__ + The built-in blog plugin adds support for building a blog from a folder of posts, which are annotated with dates and other structured data. First, add the diff --git a/docs/setup/setting-up-social-cards.md b/docs/setup/setting-up-social-cards.md index 0603cb08c..53fc620f0 100644 --- a/docs/setup/setting-up-social-cards.md +++ b/docs/setup/setting-up-social-cards.md @@ -37,6 +37,7 @@ Social card of our [formatting] reference + The built-in social plugin automatically generate a custom preview image for each page. Install all [dependencies for image processing] and add the diff --git a/docs/setup/setting-up-versioning.md b/docs/setup/setting-up-versioning.md index cc90634fa..7d62a3bf5 100644 --- a/docs/setup/setting-up-versioning.md +++ b/docs/setup/setting-up-versioning.md @@ -13,6 +13,7 @@ documentation remain untouched. + [mike] makes it easy to deploy multiple versions of your project documentation. It integrates natively with Material for MkDocs and can be enabled via diff --git a/material/overrides/hooks/shortcodes.py b/material/overrides/hooks/shortcodes.py index 92c78be35..3b2188a11 100644 --- a/material/overrides/hooks/shortcodes.py +++ b/material/overrides/hooks/shortcodes.py @@ -54,7 +54,8 @@ def on_page_markdown( elif type == "plugin": return _badge_for_plugin(args, page, files) elif type == "extension": return _badge_for_extension(args, page, files) elif type == "utility": return _badge_for_utility(args, page, files) - elif type == "example": return _badge_for_example(args, page, files) + elif type == "example": return _badge_for_example(args, page, files) + elif type == "demo": return _badge_for_demo(args, page, files) elif type == "default": if args == "none": return _badge_for_default_none(page, files) elif args == "computed": return _badge_for_default_computed(page, files) @@ -212,11 +213,21 @@ def _badge_for_example_download(text: str, page: Page, files: Files): icon = "material-folder-download" href = f"https://mkdocs-material.github.io/examples/{text}.zip" return _badge( - icon = f"[:{icon}:]({href} 'Download example')", + icon = f"[:{icon}:]({href} 'Download example files')", text = f"[`.zip`]({href})", type = "right" ) +# Create badge for demo repository +def _badge_for_demo(text: str, page: Page, files: Files): + icon = "material-github" + href = f"https://github.com/mkdocs-material/{text}" + return _badge( + icon = f"[:{icon}:]({href} 'Demo repository')", + text = text, + type = "right" + ) + # Create badge for default value def _badge_for_default(text: str, page: Page, files: Files): icon = "material-water" @@ -280,4 +291,4 @@ def _badge_for_experimental(page: Page, files: Files): href = _resolve_path("conventions.md#experimental", page, files) return _badge( icon = f"[:{icon}:]({href} 'Experimental')" - ) + ) \ No newline at end of file diff --git a/material/overrides/assets/javascripts/iconsearch_index.json b/src/overrides/assets/javascripts/iconsearch_index.json similarity index 100% rename from material/overrides/assets/javascripts/iconsearch_index.json rename to src/overrides/assets/javascripts/iconsearch_index.json diff --git a/src/overrides/hooks/shortcodes.py b/src/overrides/hooks/shortcodes.py index 92c78be35..3b2188a11 100644 --- a/src/overrides/hooks/shortcodes.py +++ b/src/overrides/hooks/shortcodes.py @@ -54,7 +54,8 @@ def on_page_markdown( elif type == "plugin": return _badge_for_plugin(args, page, files) elif type == "extension": return _badge_for_extension(args, page, files) elif type == "utility": return _badge_for_utility(args, page, files) - elif type == "example": return _badge_for_example(args, page, files) + elif type == "example": return _badge_for_example(args, page, files) + elif type == "demo": return _badge_for_demo(args, page, files) elif type == "default": if args == "none": return _badge_for_default_none(page, files) elif args == "computed": return _badge_for_default_computed(page, files) @@ -212,11 +213,21 @@ def _badge_for_example_download(text: str, page: Page, files: Files): icon = "material-folder-download" href = f"https://mkdocs-material.github.io/examples/{text}.zip" return _badge( - icon = f"[:{icon}:]({href} 'Download example')", + icon = f"[:{icon}:]({href} 'Download example files')", text = f"[`.zip`]({href})", type = "right" ) +# Create badge for demo repository +def _badge_for_demo(text: str, page: Page, files: Files): + icon = "material-github" + href = f"https://github.com/mkdocs-material/{text}" + return _badge( + icon = f"[:{icon}:]({href} 'Demo repository')", + text = text, + type = "right" + ) + # Create badge for default value def _badge_for_default(text: str, page: Page, files: Files): icon = "material-water" @@ -280,4 +291,4 @@ def _badge_for_experimental(page: Page, files: Files): href = _resolve_path("conventions.md#experimental", page, files) return _badge( icon = f"[:{icon}:]({href} 'Experimental')" - ) + ) \ No newline at end of file