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

我研究了有关managing project documentation的网站页面,该页面确认这是我想要跟进的技术,但我不知道该怎么做。

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

我在几个地方都没有尝试过。该文档当前为%fossil-root%\doc\foo.wiki,(我在Windows上),其中%fossil-root%是包含_ _FOSSIL __(由于markdown导致文件名被错误调整)的目录,但是已经启动了服务器使用fossil ui时,当我将浏览器指向http://localhost:8080/doc/foo.wiki时,化石为我提供了一个格式正确的页面,表示无法找到index.html。我创建了/doc/index.html来查看会发生什么,但是没什么区别。

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

最佳答案

如果您的文档位于%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是化石的根URL
  • /doc表示对嵌入式文档
  • 的请求
  • /trunk表示我们要从中继线
  • 中获取文件
  • /www/是存储库
  • 中的path to the requested file
  • index.wiki是存储库中文件的名称。

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

    关于fossil - 使用化石嵌入文档,我们在Stack Overflow上找到一个类似的问题:https://stackoverflow.com/questions/17452809/

    10-13 07:27