发布
发布到网页
有多种情况下您可能希望将zim中的内容发布到网络上。通常,您在zim中编辑内容,然后在完成后将其转换为HTML进行发布。但您也可以运行内置的网络服务器来显示"实时"内容。
注意: 如果您希望公众编辑您的wiki,zim可能不是合适的工具,因为它不允许编辑WWW版本。虽然有一些在zim wiki上协作的场景(参见协作),但通常这些方式最适合小团队,而不是公共互联网访问。本节讨论如何发布内容的静态副本。
从zim发布的方式很简单,只需导出为HTML(使用文件-->导出)并将结果上传到您的服务器。服务器只需提供静态HTML,因此对服务器没有其他要求,您可以使用任何可用的托管服务。有关所有导出选项,请参阅导出帮助。
如果您经常发布,您可能希望编写一个小脚本,该脚本调用zim使用正确的模板执行导出,并一次性将输出上传到服务器。一旦有了该脚本,您可以将其作为自定义工具添加到zim工具栏。这样,您可以创建一个"一键式"发布选项,以适应您的工作方式。
Zim还包含一个内置的网络服务器。要使用它,请查看"工具
"菜单或尝试"./zim.py --server -V
"。这个内置的网络服务器可以即时将zim页面转换为HTML,并在您进行更改后立即显示这些更改。它主要用于那些您想快速向他人展示您的内容而不需要完整的网络服务器设置的情况。它不适合作为永久服务器运行,并且可能不如真正的网络服务器那样健壮。
网站设计
HTML输出的外观可以使用CSS样式表进行修改,布局可以在HTML模板中更改。有关模板语法,请参阅模板帮助,并查看zim默认安装的模板以获取一些示例。
链接到网络服务器上的其他文件
您可能希望链接到服务器上其他位置的文件。可能是使用不同软件创建的HTML页面,或者是上传到服务器上单独文件夹中的图像等资源。这里的问题是,您需要一种方法将本地文件路径转换为相对于服务器根文件夹的路径。
为了实现这一点,您可以为笔记本配置一个文档根目录。您可以在属性对话框中设置文档根文件夹。设置后,您可以通过以"/"开头的链接路径直接链接到该根目录下的文件(参见链接帮助),zim将把它们解析到文档根文件夹。导出时,您可以指定如何将此文件夹映射到服务器上有效的URL。这样,您的链接在本地和服务器上都能正常工作。
缩放图像
如果您在笔记本中使用大图像,您可能希望在发布前缩小它们。目前,zim不会为您做这件事,但快速的互联网搜索会找到多种可以帮助的工具。在包含导出HTML的文件夹上运行这样的工具。只要图像的文件名保持不变,所有链接都将继续工作。
其他格式
除了HTML外,Zim还支持其他输出格式,但大多数格式都需要进一步处理才能转变为可以立即发布的文档。
例如,要获得PDF文档,您可以导出为Latex然后从中编译pdf,或者您可以使用markdown或RST工具包。
如果您有脚本可以将输出编译成所需格式,您可以配置一个自定义工具,在zim工具栏中添加一个按钮来运行该脚本。