Question

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

我研究过关于managing project documentation的网页，确认这是我想要跟进的技术，但我不知道该怎么做。

我已经剪切并粘贴了我的一个wiki页面，并将其添加到我的化石仓库中，但我无法确定它应该在目录结构中的哪个位置可以访问，如上页所述。< / p>

我曾尝试过几个地方都没有用过。该文件目前是％fossil-root％\ doc \ foo.wiki，（我在Windows上），其中％fossil-root％是保存_ _FOSSIL__的目录（由于降价而略显错误的文件名），但启动了服务器使用fossil ui时，当我将浏览器指向http://localhost:8080/doc/foo.wiki时，化石会向我显示一个格式很好的页面，说它无法找到 index.html 。我创建了/doc/index.html以查看会发生什么，但它没有任何区别。

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

Answer 1

如果您的文档位于%fossil-root%\doc\foo.wiki，则可以通过以下网址访问该文档：

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

此网址细分如下：

http://localhost:8080是您在运行fossil ui
/doc表示您要访问嵌入式文档
/trunk表示包含您要访问的文档的签到
/doc/foo.wiki是存储库中文档的路径

您也可以指定标记或分支名称，甚至是十六进制签入标识符，而不是trunk。

在您使用的网址中，http://localhost:8080/doc/foo.wiki， foo.wiki 被解释为签入名称，并且未指定文档路径，这在逻辑上意味着化石找不到任何东西。

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

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

，其中

https://www.fossil-scm.org/index.html是Fossil的根网址
/doc表示嵌入式文档请求
/trunk表示我们要从主干
/www/是存储库中的path to the requested file
index.wiki是存储库中文件的名称。

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

Answer 2

您只需将文档放在存储库中的%fossil-root%\www\目录（或版本控制下的任何其他目录）下，然后您可以将以下行添加到标题的mainmenu部分以链接到它：

html "<a href='$home/doc/trunk/www/foo.wiki'>Documentation</a>\n"

正如我所说，它可以是版本控制下的任何目录。要对此进行测试，请选择存储库中的任何文件，让我们说顶级的README文件，然后转到http://localhost:8080/doc/trunk/README。您应该在原始文本格式中看到README文件在浏览器中加载。通过将wiki或html文件放在特定目录（例如www）下，您可以轻松地组织您特别希望作为文档呈现的文件，这样可以更轻松地链接到它们。

Answer 3

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

化石1.33之后，只需在存储库中准备文档即可。如果wiki文件放在

中

/doc/index.wiki

使用网络浏览器进行设置 - ＆gt;管理员 - ＆gt;组态。有一个“索引页”字段，请填写您的主index.html。例如：

/doc/trunk/doc/index.wiki

或者，如果您只想要发布的版本：

/doc/<version>/doc/index.wiki

使用化石嵌入式文档

3 个答案: