参与和传播¶

添加RSS源

将RSS插件安装到您的项目中：

$ pip install mkdocs-rss-plugin

重要的是要有“site_name”、“site_description”和 site_url设置配置为[基本博客教程中的说明]。 RSS插件利用这些信息来构建提要，因此 确定您已经配置了它们。

现在，在mkdocs.yml中配置插件。提供的选项限制 为博客文章创建RSS条目的页面，即 可能是你想要的。另请注意日期字段的配置 匹配Material for MkDocs用于容纳 创建日期和更新日期。

plugins:
    - ...
    - rss:
        match_path: "blog/posts/.*"
        date_from_meta:
          as_creation: date.created
          as_update: date.updated

看一看 http://localhost:8000/feed_rss_created.xml 查看RSS 尽情享受XML的荣耀。您可以使用Firefox或Chrome等浏览器 可以显示原始RSS提要，也可以使用curl获取提要，使用xmllint获取提要 格式化它。（您可能需要安装这些工具。）

curl -s http://localhost:8000/feed_rss_created.xml | xmllint --format -

您可能还想使用提要阅读器尝试提要。有各种各样的桌面 以及移动应用程序和在线服务。当然，要使用后者，你 将需要将您的项目部署到他们可以访问的地方。

添加社交媒体个人资料链接

在你的mkdocs.yml中添加一个extra部分，并在其中添加一个社交 部分包含链接定义列表。这些由徽标组成 使用和指向配置文件的链接。

extra:
  social:
    - icon: fontawesome/brands/mastodon
      name: squidfunk on Mastodon
      link: https://fosstodon.org/@squidfunk

对于icon，您可以选择与捆绑在一起的图标的任何有效路径 主题。name将用作图标的标题属性 包括这一点提高了可访问性。 对于流行的社交媒体系统，链接需要是绝对的 需要包括该方案，最有可能是https://。

您还可以使用其他方案。例如，要创建一个图标，允许 要创建电子邮件，请添加以下内容：

extra:
  social:
  - icon: /fontawesome/regular/envelope
    name: send me an email
    link: mailto:<email-address>

最后，您可以在网站中指定一个URL，例如指向您的联系人 页面。可以仅指定页面的路径：

extra:
  social:
  - icon: /material/mailbox
    name: contact us
    link: /contact

添加共享按钮

为了添加共享按钮，您可以添加一个附加按钮的钩子 用于共享当前页面。

在项目根目录中创建一个目录hooks并对其进行配置 在您的mkdocs.yml中：

hooks:
  - hooks/socialmedia.py

使用以下Python代码添加文件hooks/socialmedia.py：

from textwrap import dedent
import urllib.parse
import re

x_intent = "https://x.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 }}
    """)

钩子首先检查当前页面是否是博客文章，然后附加 共享按钮的Markdown代码。按钮使用图标，因此您还需要 配置以下markdown扩展：

markdown_extensions:
  - attr_list
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg

打开讨论并安装Giscus应用程序

设置存储库后，转到其设置页面并查找 Features部分中的General。勾选Discussions复选框。 您将看到Discussions出现在 存储库。如果您正在使用实时存储库，那么您可能需要添加一些 此时将讨论部分的内容最小化，然后回到 辅导的。

接下来，您需要按照以下链接安装Giscus app 句子，选择“安装”，然后按照说明进行选择 Giscus应用程序的安装位置：

1. 为要使用的存储库选择帐户或组织。
2. 选择仅在选定的存储库上安装，然后选择您要安装的存储库 想要使用。请注意，您可以在此处选择多个存储库。
3. 在末尾选择“安装”。您可能需要进行身份验证才能提供 允许这种情况发生。
4. 您最终将进入设置中的“应用程序”页面，在那里您 可以控制Gicsus应用程序，并在需要时卸载它。

配置将Giscus嵌入博客所需的代码

转到Giscus homepage并配置嵌入代码。有一个 设置数量：

1. 选择语言
2. 输入用户名/组织名称和存储库名称
3. 选择如何将讨论映射到博客上的页面。 因为对于博客文章来说，标题是URL的基础，它使 使用“讨论标题包含页面