javascript - 如何支持由 docusaurus 维护的旧版本文档的更改

Question

我正在试用 Docusaurus 工具来创建文档站点。到目前为止，一切正常，直到我开始版本控制。

我的理解是:

1. /docs/**/*.md 中的任何内容都是您下一个 版本的最新文档
2. 您的文档的以前版本在 /website/versioned-docs/version-${version-number} 目录中可用

我不清楚的是如何维护/发布对以前版本的更改？我在 /docs/** 目录中所做的更改尚未准备好发布。那么，维护旧版本文档更改的机制是什么？

此外，Docusaurus 的文档说明如下:

Fallback Functionality

Only files in the docs directory and sidebar files that differ from those of the latest version will get copied each time a new version is specified. If there is no change across versions, Docusaurus will use the file from the latest version with that file.

For example, a document with the original id doc1 exists for the latest version, 1.0.0, and has the same content as the document with the id doc1 in the docs directory. When a new version 2.0.0 is created, the file for doc1 will not be copied into versioned_docs/version-2.0.0/. There will still be a page for docs/2.0.0/doc1.html, but it will use the file from version 1.0.0.

https://docusaurus.io/docs/en/versioning#fallback-functionality

所以，假设我现在需要维护/更新以前版本的文档，但该文件没有重复，因为在创建新版本时，这个特定文件没有任何更改。现在，过程是什么？我是否手动将必要的文件复制到 /website/versioned-docs/version-${version-number} 目录，然后进行更改？

Answer 1

这里是 Docusaurus 维护者。由于版本控制的实现方式，在 V1 中更新以前的版本并不容易。您可能不想更新以前的版本，因为版本在发布时应该被卡住，并且应该对新版本进行更新。

但如果您坚持，您始终可以在 versioned_docs/version-X.X.X 目录下编辑生成的文件。但是，我建议更改最新版本并鼓励您的用户升级到最新版本。