fossil - 使用化石嵌入文档

Question

我正在使用 fossil 来管理一些家庭项目并在 wiki 中记笔记。这样运行了几个月后，我想至少尝试一下使用嵌入式文档；主要是为了能够轻松返回到以前的版本。

我研究了关于managing project documentation的网站页面这证实了这是我想要跟进的一项技术，但我不知道如何去做。

我已经剪切并粘贴了我的一个 wiki 页面并将其添加到我的化石存储库中，但我无法确定它应该在目录结构中的哪个位置才能按照上页所述进行访问。

我在几个地方都尝试过，但没有一个起作用。该文档当前位于 %fossil-root%\doc\foo.wiki(我在 Windows 上)，其中 %fossil-root% 是包含 _ _FOSSIL__ 的目录(由于 markdown，文件名略有损坏)，但已启动服务器使用fossil ui，当我将浏览器指向http://localhost:8080/doc/foo.wiki时，fossil会向我展示一个格式良好的页面，说它可以'找不到index.html。我创建了/doc/index.html 来看看会发生什么，但这没有什么区别。

请有人帮助我，和/或向我指出包含嵌入式文档或其他“操作方法”文档的示例存储库。

Answer 1

如果您的文档位于%fossil-root%\doc\foo.wiki，您可以通过以下 URL 访问它:

http://localhost:8080/doc/trunk/doc/foo.wiki

此 URL 分割如下:

• http://localhost:8080 是运行 fossil ui 时访问 Fossil 的根 URL
• /doc 表示您想要访问嵌入式文档
• /trunk 表示包含您要访问的文档的 checkin
• /doc/foo.wiki 是存储库内文档的路径

除了trunk，您还可以指定标签、分支名称，甚至十六进制 checkin 标识符。

在您使用的 URL 中，http://localhost:8080/doc/foo.wiki、foo.wiki 被解释为 checkin 名称，并且没有指定文档路径，这在逻辑上意味着 Fossil 不会找到任何东西。

对于包含嵌入式文档的示例存储库，Fossil 网站本身的主页就是一个很好的例子:

https://www.fossil-scm.org/index.html/doc/trunk/www/index.wiki

哪里

• https://www.fossil-scm.org/index.html 是 Fossil 的根 URL
• /doc 表示请求嵌入文档
• /trunk 表示我们要从 trunk 获取文件
• /www/ 是 path to the requested file在存储库内
• index.wiki 是存储库内文件的名称。

所以，在 'trunk' branch存储库的文件 www/index.wiki包含 Fossil 网站的主页。