此处不允许使用 yaml 映射值（语法）答案

【问题标题】：yml mapping values are not allowed here (syntax)此处不允许使用 yaml 映射值（语法）
【发布时间】：2020-03-12 16:22:10
【问题描述】：

我在这个 yaml 文件中删除了一半我想要的内容，试图找到一种方法来让它构建我的 mkdocs 测试站点，但我遇到了一个错误。

'''
mkdocs.yml
doc/
Scaling-Issue.md
FreeSwitch.md
User-Sessions.md
nav:
-Common Issues:
 -Scaling Issue:'Scaling-Issue.md'
 -FreeSwitch:'FreeSwitch.md'
 -User Sessions:'User-Sessions.md'
'''

错误：6:4 语法错误：此处不允许映射值

【问题讨论】：

代码块的全部内容是否都在您的文件内容之上？如果没有，请编辑您的问题，这样就可以了。
是的，这就是我的代码块中剩下的所有内容。我只是想启动并运行一个基本版本，以了解我使用了正确的语法和所有内容。

标签： yaml markdown mkdocs

【解决方案1】：

您的配置文件中似乎有很多不属于您的内容。您的文件应如下所示：

site_name: 'Your Site Name'
nav:
    - Common Issues:
        - Scaling Issue:'Scaling-Issue.md'
        - FreeSwitch:'FreeSwitch.md'
        - User Sessions:'User-Sessions.md'

首先，site_name 选项是必需的。当然，您可以将实际名称更改为您想要的任何名称。

虽然nav 是可选的，但还是推荐使用。我已经清理了缩进（建议使用四个空格，而不是您使用的那个）。此外，您应该在列表项中的每个连字符后留一个空格。

其他的东西不在文件里。例如，文件名不应包含在文件中。而且我不确定这三个点是从哪里来的。最后，文件列表不是文件中的内容。我意识到所有这些东西都可能存在于文档中，但这些都是文件结构的示例，它们不是要添加到配置文件中的东西。

【讨论】：

好吧，我整天都在搞砸一些例子，我会发布它的开头和结尾，因为它太长而无法发布，但它的中间只是字体和主题。 site_name: DirectCare_Documentation site_url: pages.github.cerner.com/directcare/DC__Documentation repo_name: 'GitHub' repo_url: github.cerner.com/CB071663/DC__Documentation/blob/patch-8/docs edit_uri: edit/master/docs/ strict: true
nav: - 主页：'index.md' - 常见问题： - 缩放问题：'Scaling-Issue.md' - FreeSwitch：'FreeSwitch.md' - 用户会话：'用户会话。 md'
以下错误：C:\Users\cb071663>python -m mkdocs build INFO - 清理站点目录信息 - 将文档构建到目录：C:\Users\cb071663\site 警告 - 到 ' 的相对路径DC_Connect/Scaling-Issue.md' 包含在 'nav' 配置中，在文档文件中找不到警告 - 'DC_Connect/FreeSwitch.md' 的相对路径包含在 'nav' 配置中在文档文件中找到警告 - 'DC_Connect/User-Sessions.md' 的相对路径包含在 'nav' 配置中，在文档文件中找不到
请编辑您的问题，并以我们可以阅读和理解的格式包含其中的信息。