为什么我的 TYPO3 文档的生成没有正确的错误就失败了?

Why is the generation of my TYPO3 documentation failing without a proper error?

我有一台新笔记本电脑,我尝试根据 https://docs.typo3.org/m/typo3/docs-how-to-document/master/en-us/RenderingDocs/Quickstart.html#render-documenation-with-docker 上的步骤在本地呈现 TYPO3 的更新日志。它一直持续到最后,但最后显示一些非零退出代码。

project : 0.0.0 : Makedir
   makedir /ALL/Makedir
   2021-02-16 10:32:50 654198,  took: 173.34 seconds,  toolchain: RenderDocumentation
   REBUILD_NEEDED because of change,  age 448186.6 of 168.0 hours,  18674.4 of 7.0 days
   OK:
   ------------------------------------------------
   FINAL STATUS is: FAILURE (exitcode 255)
                    because HTML builder failed
   ------------------------------------------------
   exitcode:   0            39 ms

当我在另一个文档项目中 运行 命令时,它呈现得很好。

我发现了这个问题。 docker 容器似乎没有分配足够的内存。我在 Docker Desktop 中将可用内存从 2 Gb 更改为 4 Gb,此问题已解决。

你已经解决了问题。但是如果出现类似的错误: 要获取有关失败的更多信息,您还可以使用此技巧:

在渲染前创建一个目录tmp-GENERATED-temp。通常,这是自动创建的,然后在渲染后删除。如果您在渲染之前创建它,您将在此目录中找到包含更多详细信息的日志文件。

查看 Troubleshooting 页面。

我遇到了一些错误,发现控制台中的输出不足,这帮助我缩小了问题范围。


如果出现其他问题,我会在 GitHub 存储库中提出问题:https://github.com/t3docs/docker-render-documentation


注意:这是特定于 TYPO3 文档渲染的,将来可能会更改。