我正在使用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/
是存储库index.wiki
是存储库中文件的名称。 因此,在存储库的'trunk' branch中,文件www/index.wiki包含Fossil网站的主页。
关于fossil - 使用化石嵌入文档,我们在Stack Overflow上找到一个类似的问题:https://stackoverflow.com/questions/17452809/