在没有警告的情况下,在 RST 中可以使用长 Link 的项目符号列表吗?
Is a Bullet List With a Long Link Possible in RST Without Warnings?
我长这样link逃过一劫:
`Build Azure Devops Agents With Linux cloud-init for Dotnet Development \
[terraform, azure, devops, docker, dotnet, cloud-init]`_
.. _Build Azure Devops Agents With Linux cloud-init for Dotnet Development [terraform, azure, devops, docker, dotnet, cloud-init]: https://codingsoul.org/2022/04/25/build-azure-devops-agents-with-linux-cloud-init-for-dotnet-development/
但是,如果我尝试将 link 作为项目符号列表的一部分:
- `Build Azure Devops Agents With Linux cloud-init for Dotnet Development \
[terraform, azure, devops, docker, dotnet, cloud-init]`_
.. _Build Azure Devops Agents With Linux cloud-init for Dotnet Development [terraform, azure, devops, docker, dotnet, cloud-init]: https://codingsoul.org/2022/04/25/build-azure-devops-agents-with-linux-cloud-init-for-dotnet-development/
我收到以下警告:
Inline interpreted text or phrase reference start-string without end-string.
我不知道如何解析该警告,文档/在线搜索对我没有帮助。
长 link 的项目符号列表肯定是常见的用例,我只是在某处遗漏了一些明显的文档,对吧?
这是一个项目符号列表(巧合的是长 links)我在搜索中遇到但没有帮助:
- How to use inline code with a trailing whitespace?
- https://github.com/sphinx-doc/sphinx/issues/3778
- https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#lists-and-quote-like-blocks
这对我有用。您需要缩进列表项中的第二行和后续行以与第一行中的第一个字符对齐。
- `Build Azure Devops Agents With Linux cloud-init for Dotnet Development \
[te3rraform, azure, devops, docker, dotnet, cloud-init]`_
.. _Build Azure Devops Agents With Linux cloud-init for Dotnet Development [te3rraform, azure, devops, docker, dotnet, cloud-init]: https://codingsoul.org/2022/04/25/build-azure-devops-agents-with-linux-cloud-init-for-dotnet-development/
您的 link 标签也不匹配,这导致了 ERROR: Unknown target name: "Build Azure Devops Agents With Linux cloud-init for Dotnet Development \ [terraform, azure, devops, docker, dotnet, cloud-init]".
的错误
我长这样link逃过一劫:
`Build Azure Devops Agents With Linux cloud-init for Dotnet Development \
[terraform, azure, devops, docker, dotnet, cloud-init]`_
.. _Build Azure Devops Agents With Linux cloud-init for Dotnet Development [terraform, azure, devops, docker, dotnet, cloud-init]: https://codingsoul.org/2022/04/25/build-azure-devops-agents-with-linux-cloud-init-for-dotnet-development/
但是,如果我尝试将 link 作为项目符号列表的一部分:
- `Build Azure Devops Agents With Linux cloud-init for Dotnet Development \
[terraform, azure, devops, docker, dotnet, cloud-init]`_
.. _Build Azure Devops Agents With Linux cloud-init for Dotnet Development [terraform, azure, devops, docker, dotnet, cloud-init]: https://codingsoul.org/2022/04/25/build-azure-devops-agents-with-linux-cloud-init-for-dotnet-development/
我收到以下警告:
Inline interpreted text or phrase reference start-string without end-string.
我不知道如何解析该警告,文档/在线搜索对我没有帮助。
长 link 的项目符号列表肯定是常见的用例,我只是在某处遗漏了一些明显的文档,对吧?
这是一个项目符号列表(巧合的是长 links)我在搜索中遇到但没有帮助:
- How to use inline code with a trailing whitespace?
- https://github.com/sphinx-doc/sphinx/issues/3778
- https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#lists-and-quote-like-blocks
这对我有用。您需要缩进列表项中的第二行和后续行以与第一行中的第一个字符对齐。
- `Build Azure Devops Agents With Linux cloud-init for Dotnet Development \
[te3rraform, azure, devops, docker, dotnet, cloud-init]`_
.. _Build Azure Devops Agents With Linux cloud-init for Dotnet Development [te3rraform, azure, devops, docker, dotnet, cloud-init]: https://codingsoul.org/2022/04/25/build-azure-devops-agents-with-linux-cloud-init-for-dotnet-development/
您的 link 标签也不匹配,这导致了 ERROR: Unknown target name: "Build Azure Devops Agents With Linux cloud-init for Dotnet Development \ [terraform, azure, devops, docker, dotnet, cloud-init]".