【问题标题】:Publish an Azure DevOps Wiki as a stand-alone static site将 Azure DevOps Wiki 作为独立静态站点发布
【发布时间】:2019-11-05 15:49:59
【问题描述】:

我已经在 Azure DevOps 中建立了一个 wiki,我想建立一个管道来获取 markdown 文件,将它们转换为 HTML 并将它们作为独立的静态网站发布。当有人在 Markdown 文件中提交更改时,我想使用 Azure DevOps 中的管道为站点构建新的静态文件。

Gatsby 是一个我有点熟悉的平台,但是 wiki 仅由 markdown 文件 + 一个名为“order”的文件组成,它决定了 wiki 中文档的顺序。

有人知道我应该如何设置吗?

【问题讨论】:

  • 澄清一点:“wiki 仅包含 markdonwn 文件 + 一个名为 order 的文件”以及附加到任何 wiki 页面的文件所在的根级“.attachments”文件夹。
  • 请考虑标记此azure-devops-wiki。我会这样做,但有五个标签的限制,我不想删除你的任何标签。

标签: azure-devops markdown gatsby wiki static-generator


【解决方案1】:

你需要这个设置:

  1. 通过 API 公开您的降价文件。 Azure 应该有某种无服务器 lambda 函数服务。查询结果应该是您需要的文件的数组或列表,按您需要的顺序排列。最好让基于 Azure 的 API 处理订单文件。 Gatsby 应该只关心按照您的 API 提供的正确顺序构建您的网站。
  2. 在 Gatsby 构建过程中调用您的 markdon API。请参阅docs,了解如何在构建时获取数据。
  3. 为您的所有 Wiki 页面创建一个模板页面。请参阅Gatsby tutorial part 7
  4. 您需要使用Gatsby node API 创建维基页面。使用createPages 函数。

PS:我对您决定使用哪种无服务器 lambda 函数服务很感兴趣,因为我遇到了类似的用例。随意评论您如何解决设置中的1.

【讨论】:

  • 我们通过将 wiki 从代码 wiki 更改为 Azure DevOps 中的常规 wiki 解决了这个问题。首先,提出整个问题的原因是让所有员工都可以访问 wiki,而不仅仅是开发人员。如果您有代码 wiki,则需要 DevOps 中的开发人员帐户。但是,如果您使用普通的 wiki,拥有免费帐户的人可以访问和编辑它。常规 wiki 仍然是基于 git 的,您可以照常查看和编辑。两全其美。
  • @tkahn 感谢您分享您的解决方案。您能否将其转换为答案,这可以使其他有相同问题的社区成员受益,我们可以存档此线程,谢谢。
猜你喜欢
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
  • 2019-06-11
  • 2020-01-18
  • 2021-05-05
  • 2022-12-03
相关资源
最近更新 更多