后台技术-docs配置返回“错误:生成mkdocs ENOENT”

Question

当我试图在本地运行后台并访问项目文档时，我会得到以下错误：

错误:无法构建docs页面:未能从/tmp/backment-5lZR3i生成文档到/tmp/ docs -hvh4yi；由错误引发:生成mkdocs ENOENT {“时间戳”：“2022-06-02T18:02:06.573Z”}

​

​

有人有线索吗？

我在试着配置后台技术文档。我有一个外部Gitlab，我将以下文件放在repo根目录中：

mkdocs.yml

site_name: ${{values.component_id}}
site_description: ${{values.description}}

nav:
  - Home: index.md

plugins:
  - techdocs-core

docs/index.md

# example docs

This is a basic example of documentation.

在后台，我的组件yaml如下所示

packages/catalog-model/components/my-site.yaml

apiVersion: backstage.io/v1alpha1
kind: Component
metadata:
  name: My-Site
  description: This is a component.
  annotations:
    argocd/app-name: 'my-site'
    gitlab.com/project-id: '007'
    backstage.io/view-url: https://some.website/catalog-info.yaml
    backstage.io/edit-url: https://git.my-company.net/my-company/backstage/blob/main/packages/catalog-model/components/my-site-component.yaml
    backstage.io/source-location: url:https://git.my-company.net/my-company/my-site
    backstage.io/techdocs-ref: url:https://git.my-company.net/my-company/my-site/
spec:
  type: component
  lifecycle: experimental
  owner: Dream
  system: Platform

Answer 1

我认为当mkdocs不在本地安装时会发生此错误。您可以参考这些安装指南，这个问题应该得到解决