Zwiki使用指南

  • 格式:pdf
  • 大小:297.49 KB
  • 文档页数:6

即:把 zope 安装实例中的 zope.conf 配置文件中的 rest-input-encoding 和 rest-output-encoding 设置为 utf-8。 六、 STX 与 RST 格式简介
Zwiki 中默认新建的页面的格式为 StructuredText(简称 STX), 这种格式是一种很老的排版 格式,后有人以 StructuredText 为基础建立一种 reStructuredText 的格式(简称 RST),RST 比 STX 功能更强,所以推荐大家使用 RST。
RST 格式:类似于 StructuredText,是另外一种书写格式,更加严格,适合书写正式的
文档,能够转换成各种格式。 (可以容易地设定使其支持中文) 。
参考: /blog/livahu/restructuredtextshigehaodongxi
Zwiki 中默认新建的页面的格式为 StructuredText(简称 STX), 这种格式是一种很老的排版 格式,后有人以 StructuredText 为基础建立一种 reStructuredText 的格式(简称 RST),RST 比 STX 功能更强,所以推荐大家使用 RST。而在默认的 RST 中,也不支持非 ascii 码的编 码(如果新建的文档中有非 ascii 码的编码,则些文件在保存时会出错),需要一些简单的 修改。修改内容如下:
点击 related,则会出现此页面的相关页面管理页面。
其中父层是指此子主题的上层主题
回溯是指此主题页面中所引用的主题 子页面是指此主题的所有子主题,可以调整顺序。 变更父层是指从此主题的当前父主题变更到另外一个主题,作为此主题的新 的父主题。 五、 令 wiki 支持中文(rst 格式)
解决 zwiki 中的特殊格式不支持中文的情况:
Zwiki 使用指南
一、 新建 zwiki 在 plone 站点中新建立一个 zwiki 站点过程如下: 1. 以管理员身份登录,在 ZMI 中找到你想建立百科的目录,在左上角的
下拉选框中, 选择 ZWiki 选项,则会出现下面一个页面,
在 ID 一栏中添入此 wiki 的目录名(会显示在此 wiki 的 url 中) 。Title 栏中 填入此 wiki 的标题。 (这里建好的 wiki 只是一个文件夹,和普通的文件夹没有什么区别) 在建好的 wiki 目录中,默认情况下有三个 wiki 页面。其中有一个 ID 为 FrontPage 的页面,为目录的首页。(在 plone 中,每个目录中以 FrontPage 为 ID 的页面均自动变成此目录的首页。) 二、 新建页面 在 wiki 中,要新建一个页面,有两种方法:(1)、由具有管理员权限的用户到 ZMI 中的 wiki 目录下添加 wiki 页面。 这种情况下的好处: 可以添加顶层页面。 坏处,只有管理员可以执行此操作。 (2)、在 Plone 界面下,每个登录用户都可以添加新页面。 在一个存在的 wiki 页面的最下方,可以添加此页面的子 topic 页面。如果想 要添加一个和些 wiki 页面同层的 wiki 页面,则要跳到此 wiki 页面的父 topic 层添加。 如果要添加顶层 wiki 页面,即和 FrontPage 页面同层的页面,则需要 Wiki 目录的父目录文件夹内容wiki 文件夹添加新内容
ZWiki:RemoteWikiLink http://bare/url <a href="http://some/where">html link</a> "Structured Text link":http://some/where [1] (structured text footnote) 4. 用空行划分段落 5. 单行段落会变成标题,如果此段落下面紧接的是缩进更多的段落。一 个缩进更多的标题会变成子标题。 6. 一个以-或*或一个数字开始,并且后面紧跟着一个空格的段落,显示 为列表。缩进更多的列表项就成子列表。 7. HTML tags 如果用得着的话也可以加到文本中来,能正常解析。也 可以使用 DTML。 8. 引用文本:避免到文本进行上面几种情况的处理,可以使用::后面 加空格,然后是空行。例如: parent paragraph:: This is the only reliable way to quote WikiLinks, <HTML tags> and &dtml-code; or preserve fixed-width formatting. Use this eg when posting zope tracebacks.
Zwiki adds linking and some fixes to standard STX. 1. 不要搞那种想要学习所有格式规则的麻烦事。 就模仿你身边的例子就 可以了。如果 STX 显示的和你所想的不一样时,就随便修改直到看 起来对了为止。注意:一般情况下,STX 不支持非拉丁字符。如果 需要请参见: 2. 文本强调 用**包起ቤተ መጻሕፍቲ ባይዱ的为斜体,如: *斜体* 斜体 用**xxx**包起来的为粗体,如**bold** bold 用_xxx_包起来的为下划线,_underlined_, underlined 用’xxx’包起来的为灰色背景,'monospaced' monospaced 3. 链接: WikiName [bracketed free-form name]

For editing content in non-ascii encodings with Zwiki and RST you will have to set the rest-input-encoding and rest-output-encoding to utf-8 in your instance's zope.conf config file.。
添加当前 topic 的子 topic:
在文本框中填入 topic 的标题,然后点击 create,则新建一个此 topic 的所有 子 topic。 三、 对 wiki 页面进行管理 这里的管理是指对 wiki 进行页面层级的管理。
更改 wiki 页面的 ID(标题): 在文本框中填入想要修改的标题, 然后点击 rename。 更改 wiki 页面的父 topic:在文本框中填入新的父 topic 的标题,然后点击 reparent。 删除 wiki 页面:将文本框留空,点击 delete!(删除本页面) 删除 wiki 页面:在文本框中添加标题,点击 delete!(删除标题页面) 注意:wiki 的 ID 和标题必须一致,即最好不要在 ZMI 中修改一个 wiki 页面 的标题,否则会导致 wiki 内部结构紊乱。 四、 调整页面间的关联关系