xwiki介绍-Rendering

ゝ一世哀愁。 2022-02-22 13:14 290阅读 0赞

**作用**: 把给定语法的一些文本输入内容转换成另一种语法的输出内容

# 通用架构 #

![20190411150042604.png][]

*  **Parser**: 解析一个给定的语法的一些文本输入，并生成一个XDOM对象（一个抽象语法树）
 *  **Renderer**: 取XDOM作为输入并产生一些输出
 *  **Transformation**: 取一些XDOM并修改它生成一个修改后的XDOM

# 特性 #

*  解析器多种语法
 *  同时提供一个流API（用于渲染比较大的内容）和基于XDOM的API（产生一个中间抽象语法树用于转换）
 *  XWiki Syntax 2.0和XHTML之间往返。该特性允许，比如有一个强大的WYSIWYG编辑器，当编辑wiki页面时不会丢失的信息。另一个用例是以html导入Office文档，并将其转化XWiki Syntax 2.0不会丢失信息
 *  获得解析后结果作为抽象语法树（称为XDOM），可以用于访问解析后得到的所有结构化元素
 *  能通过Transformation改变XDOM
 *  宏支持(可用[宏列表][Link 1])。请注意，宏支持作为一个Transformation来实现
 *  支持链接标签wiki语法即使输入语法不支持
 *  能自动把任何支持的输入语法转换为XWiki Syntax 2.0或XHTML
 *  强大的解析器:
    
     *  基于语法（JavaCC）
     *  修正用户错误（标签没闭合，重叠的标记元素...）
     *  每个块元素（段落，表格单元格，列表项，表头...）可以分布在多行
     *  支持组，即能在其他内容里包含内容（相对于HTML里的DIV）
     *  所有的元素可以有相关的参数
 *  用于XWiki Enteprise有好几年了，稳定并且高性能
 *  可独立使用，因为它是独立于其他XWiki项目，如XWiki Platform, XWiki Enterprise等等

# 支持语法 #

输入语法

这意味着有一个解析器，可以用来解析此语法为XDOM对象

输出语法

这意味着有一个渲染器，可渲染xdom为这个语法

<table> 
 <tbody> 
  <tr> 
   <th>名字</th> 
   <th>Id</th> 
   <th>输入语法?</th> 
   <th>输出语法?</th> 
   <th>描述</th> 
  </tr> 
  <tr> 
   <td>XWiki 2.0</td> 
   <td>xwiki/2.0</td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150109392.png" width="16"></td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150109392.png" width="16"></td> 
   <td>&nbsp;</td> 
  </tr> 
  <tr> 
   <td>XWiki 2.1</td> 
   <td>xwiki/2.1</td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150109392.png" width="16"></td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150109392.png" width="16"></td> 
   <td>&nbsp;</td> 
  </tr> 
  <tr> 
   <td>XHTML 1.0</td> 
   <td>xhtml/1.0</td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150109392.png" width="16"></td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150109392.png" width="16"></td> 
   <td>&nbsp;</td> 
  </tr> 
  <tr> 
   <td>HTML 5.0</td> 
   <td>html/5.0</td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150243661.png" width="16"></td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150109392.png" width="16"></td> 
   <td>XWiki Rendering 6.4+ 可用</td> 
  </tr> 
  <tr> 
   <td>HTML 4.01</td> 
   <td>html/4.01</td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150109392.png" width="16"></td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150109392.png" width="16"></td> 
   <td>&nbsp;</td> 
  </tr> 
  <tr> 
   <td>Plain Text</td> 
   <td>plain/1.0</td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150109392.png" width="16"></td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150109392.png" width="16"></td> 
   <td>&nbsp;</td> 
  </tr> 
  <tr> 
   <td><a href="http://www.docbook.org/specs/cd-docbook-docbook-4.4.html" rel="nofollow">DocBook 4.4</a></td> 
   <td>docbook/4.4</td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150109392.png" width="16"></td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150109392.png" width="16"></td> 
   <td>XWiki Rendering 3.2+ 可用</td> 
  </tr> 
  <tr> 
   <td>XDOM XML Current</td> 
   <td>xdom+xml/curent</td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150109392.png" width="16"></td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150109392.png" width="16"></td> 
   <td>XWiki Rendering 3.3+ 可用</td> 
  </tr> 
  <tr> 
   <td>XDOM XML 1.0</td> 
   <td>xdom+xml/1.0</td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150109392.png" width="16"></td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150109392.png" width="16"></td> 
   <td>XWiki Rendering 3.3+ 可用&nbsp;</td> 
  </tr> 
  <tr> 
   <td>XWiki 1.0</td> 
   <td>xwiki/1.0</td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150109392.png" width="16"></td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150243661.png" width="16"></td> 
   <td>&nbsp;</td> 
  </tr> 
  <tr> 
   <td>Confluence</td> 
   <td>confluence/1.0</td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150109392.png" width="16"></td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150243661.png" width="16"></td> 
   <td>&nbsp;</td> 
  </tr> 
  <tr> 
   <td>Confluence XHTML</td> 
   <td>confluence+xhtml/1.0</td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150109392.png" width="16"></td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150243661.png" width="16"></td> 
   <td>&nbsp;</td> 
  </tr> 
  <tr> 
   <td>JSPWiki</td> 
   <td>jspwiki/1.0</td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150109392.png" width="16"></td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150243661.png" width="16"></td> 
   <td>&nbsp;</td> 
  </tr> 
  <tr> 
   <td>TWiki</td> 
   <td>twiki/1.0</td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150109392.png" width="16"></td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150243661.png" width="16"></td> 
   <td>&nbsp;</td> 
  </tr> 
  <tr> 
   <td>MediaWiki</td> 
   <td>mediawiki/1.0</td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150109392.png" width="16"></td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150243661.png" width="16"></td> 
   <td>&nbsp;</td> 
  </tr> 
  <tr> 
   <td>Creole 1.0</td> 
   <td>creole/1.0</td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150109392.png" width="16"></td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150243661.png" width="16"></td> 
   <td>&nbsp;</td> 
  </tr> 
  <tr> 
   <td><a href="https://github.com/sirthias/pegdown" rel="nofollow">Markdown 1.0</a></td> 
   <td>markdown/1.0</td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150109392.png" width="16"></td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150243661.png" width="16"></td> 
   <td>XWiki Rendering 3.4+ 可用</td> 
  </tr> 
  <tr> 
   <td>Markdown 1.1</td> 
   <td>markdown/1.1</td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150109392.png" width="16"></td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150243661.png" width="16"></td> 
   <td>XWiki Rendering 5.2+ 可用</td> 
  </tr> 
  <tr> 
   <td><a href="http://maven.apache.org/doxia/references/apt-format.html" rel="nofollow">APT</a></td> 
   <td>apt/1.0</td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150109392.png" width="16"></td> 
   <td><img alt="" height="16" src="https://img-blog.csdnimg.cn/20190411150109392.png" width="16"></td> 
   <td>XWiki Rendering 4.3+ 可用</td> 
  </tr> 
 </tbody> 
</table>

# 使用XWiki Rendering的项目 #

*  XWiki Enterprise：肯定了...
 *  [eXo Platform][]： 在eXo工具里使用XWiki Rendering和XWiki WYSIWYG Editor来提供简单wiki功能
 *  [Wikbook][]： 使用XWiki Rendering把用wiki语法编写的内容生成DocBook
 *  [Jahia][]： 在["Jahia Wiki 模块"][Jahia Wiki]使用XWiki Rendering
 *  [Grail XWiki Rendering Plugin][]：Grails plugin 允许使用XWiki Rendering 转换文本

[20190411150042604.png]: /images/20220222/752eb5ad0a10482b89f171d8791b71e0.png
[Link 1]: http://rendering.xwiki.org/xwiki/bin/view/Main/Macros
[eXo Platform]: http://www.exoplatform.com/company/en/home
[Wikbook]: http://code.google.com/p/wikbook/
[Jahia]: http://www.jahia.com/cms/home.html
[Jahia Wiki]: http://www.jahia.com/community/documentation/jahiapedia/jahia-modules/wiki/wiki.html
[Grail XWiki Rendering Plugin]: https://github.com/literalice/grails-xwiki-rendering