6

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

我研究了有关管理项目文档的网站页面,确认这是我想要跟进的一种技术,但我不知道如何去做。

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

我已经在几个地方尝试过,但都没有奏效。该文档当前是 %fossil-root%\doc\foo.wiki,(我在 Windows 上),其中 %fossil-root% 是保存 _ _FOSSIL__ 的目录(由于降价,文件名略有损坏),但是已经启动了一个服务器当fossil ui我将浏览器指向 时http://localhost:8080/doc/foo.wiki,fossil 向我显示了一个格式精美的页面,说它找不到index.html。我创建了 /doc/index.html 来看看会发生什么,但这并没有什么不同。

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

4

3 回答 3

7

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

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

该 URL 分解如下:

  • http://localhost:8080是运行时访问 Fossil 的根 URLfossil ui
  • /doc表示您要访问嵌入式文档的信号
  • /trunk表示包含您希望访问的文档的签入
  • /doc/foo.wiki是存储库中文档的路径

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

在您使用的 URL 中http://localhost:8080/doc/foo.wikifoo.wiki被解释为签入名称,并且没有指定文档路径,这在逻辑上意味着 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表示我们要从主干获取文件
  • /www/是存储库中请求文件的路径
  • index.wiki是存储库中文件的名称。

因此,在存储库的“主干”分支中,文件www/index.wiki包含 Fossil 网站的主页。

于 2013-07-03T23:02:01.783 回答
4

您只需将文档放在%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您可以轻松组织您特别希望呈现为文档的文件,从而更容易链接到它们。

于 2013-07-03T16:08:33.413 回答
1

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

在化石 1.33 之后,只需在存储库中准备您的文档。如果 wiki 文件被放入

/doc/index.wiki

并使用网络浏览器进行设置 -> 管理 -> 配置。有一个“索引页”字段,填写你的主index.html。例如:

/doc/trunk/doc/index.wiki

或者,如果您只想要发布的版本:

/doc/<version>/doc/index.wiki
于 2015-08-20T06:16:50.860 回答