我正在尝试使用Docusaurus工具创建文档网站。到目前为止,一切都还好,直到我遇到了版本控制。
我的理解是:
/docs/**/*.md
中的所有内容都是下一个发布版本的最新文档- 您的文档的早期版本可以在
/website/versioned-docs/version-${version-number}
目录中找到
对我来说不清楚的是如何维护/发布以前版本的更改?我在/docs/**
目录中的更改还没有准备好发布。那么,如何维护旧版文档的更改机制是什么?
Docusaurus的文档还说:
回退功能每次指定新版本时,只有位于docs目录和侧边栏文件中与最新版本不同的文件才会被复制。如果在不同版本之间没有变化,则Docusaurus将使用该文件的最新版本。
例如,对于最新版本1.0.0存在具有原始ID doc1的文档,并且其内容与docs目录中具有ID doc1的文档相同。当创建新版本2.0.0时,将不会将doc1的文件复制到versioned_docs/version-2.0.0/中。仍将存在一个页面用于docs/2.0.0/doc1.html,但它将使用来自版本1.0.0的文件。
https://docusaurus.io/docs/en/versioning#fallback-functionality
假设我现在需要维护/更新先前版本的文档,但该文件没有被复制,因为在创建新版本时,这个特定文件没有任何更改。那么,流程是什么?我需要手动将必要的文件复制到 /website/versioned-docs/version-${version-number}
目录中,然后进行更改吗?