python - 将 Mkdocs 部署到 Azure Web 应用

Question

似乎无法将Mkdocs( Material )站点部署到Azure Web Apps。我们为我们的资料和文档构建了一个 Mkdocs 站点，我曾多次尝试使用 Azure(Web 应用程序、静态应用程序和 DevOps) 托管它，但似乎没有任何效果。

不要使用 Git 页面或第 3 方托管应用如果有人做到了，请分享一个分步指南如何做到这一点

下面是我的 GitHub 存储库的样子:

Answer 1

您可以按照可用的静态站点生成器教程之一进行操作，例如 hugo 的教程。例如。

实际上有两个主要步骤将成为构建管道的一部分，例如 GitHub Actions 或 ADO 管道

1. 生成静态资源

对于 MkDocs，这是通过运行 mkdocs builds

来完成的

部署到 Azure

为此，根据您的构建解决方案，使用适当的插件进行部署。对于 GitHub 操作，它会是这样的

- name: Build And Deploy
   id: builddeploy
   uses: Azure/static-web-apps-deploy@v1
   with:
      azure_static_web_apps_api_token: ${{ secrets.AZURE_STATIC_WEB_APPS_API_TOKEN }}
      repo_token: ${{ secrets.GITHUB_TOKEN }} # Used for GitHub integrations (i.e. PR comments)
      action: "upload"
      ###### Repository/Build Configurations - These values can be configured to match you app requirements. ######
      # For more information regarding Static Web App workflow configurations, please visit: https://aka.ms/swaworkflowconfig
      app_location: "/" # App source code path
      output_location: "site" # Built app content directory - optional
      ###### End of Repository/Build Configurations ######