Bkzxp

使用Wiki后的总结

  • 使用Wiki后的总结
    • 说明
      • 在Redmine中使用Wiki编辑文档后，我想整理下在编写过程中所遇到的Wiki知识。后来在网上搜了搜，了解了更多的wiki知识，以我自己的理解，写下这篇文章。望对wiki理解深刻的TX围观、留言。
    • Wiki知识
      • 我的探索过程
        • 在了解Redmine中的wiki时，发现了这篇文章“Redmine wiki的文本格式”，其中提到“Redmine默认使用Textile作为wiki的文本格式过滤器, 当然你也可以下载其他文本格式过滤器插件(Markdown, reST等),以下介绍的语法都是基于Textile的语法”。等一等，难道Wiki自己没有语法吗？他的意思是Redmine也可以使用Markdown来作为Wiki的文本格式过滤器吗？我们知道Markdown是有自己的语法的，那么Wiki到底是个什么？
      • 什么是wiki？
        • Wiki是软件、系统？是语法概念？还是一种语言？刚接触wiki的时候搞不明白它到底是什么，我们看看
          • 维基百科给出的解释：Wiki 是一种在网络上开放且可供多人协同创作的超文本系统，由沃德·坎宁安于1995年首先开发。沃德·坎宁安将Wiki定义为“一种允许一群用户利用简单的描述来创建和连接一组网页的社会计算系统”。
          • 百度百科的说法：Wiki指一种超文本系统，这种超文本系统支持面向社群的协作式写作，同时也包括一组支持这种写作的辅助工具。
      • wiki语法？wiki到底有没有语法？
        • 还在纠结wiki是否有语法吗？
        • 维基百科在词条Wiki的特征中提到：沃德·坎宁安和波·路夫（Bo Leuf）在《The Wiki Way: Quick Collaboration on the Web》一书中描述了Wiki概念的几个本质特征：
          • Wiki允许任何用户在Wiki网站内剪辑任何页面或新建页面，不需要任何额外的附加组件，只需通过普通的网页浏览器即可。
          • Wiki中用户使用很多方式来编辑。通常需要通过文本标记语言。
        • 终于发现了，编辑Wiki是需要其他语言来实现的（如Markdown、Textile）。So,Wiki不是一种语言，其实也就没有所谓的Wiki语法，通常说的Wiki的语法就是指编辑维基百科的Wiki时用的语法，而维基百科是用“MediaWiki”的语法。
        • Wiki是一种技术。
      • 认识Textile、markdown等
        • 他们是“轻量级的标记语言”，可以在wiki中使用
      • mediawiki、Dokuwiki等是什么
    • Textile 语法
    • 编辑Redmine中Wiki
      • 增加Wiki
        • http://您的IP地址:您的端口/projects/项目标识/wiki/新建的wiki的名称。也可以这样说，当你打开Wiki后，直接在地址栏的“***/wiki/”后面写上你准备新建的wiki的名称，回车即完成了新建过程。
      • 编辑Wiki
        • 引用
          • 对同目录的其他wiki文件的引用，使用： 两个左向花括号代替include(projectname:Foo)两个右向花括号代替
        • 表格
          • 通常使用
            • |_.UserID|_.Name|_.Group|：下划线以及点号，表明了该行是表格表头行；把下划线以及点号去掉，就是普通行。另外一种也可以，就是使用*号，如
              |*NO* |*接口名称* |*用途说明*|
          • 单元格单行横向合并
            • |\3=.IT|：3表示合并的单元格的个数，英文标点点号与管道符之间的文字为该单元格的内容
          • 单元格单列纵向合并
            • |5|张三|/2.Users|
              |6|李四|               2表示纵向合并的个数
          • 臆想
            • 纵向横向一起合并，我摸索了半天，没弄出来，用户手册也没有给出方法
        • 文字样式
          • 标题

            • h1. 一级标题

              h2. 二级标题

              h3. 三级标题

          • 文字颜色
          • 缩进
            • 用户手册中并没有讲如何缩进，使用半角空白字符是不起作用的，使用全角的空格字符倒是可以实现缩进。
        • 图片
          • !{width:300px}image_url! 设置图片的显示宽度
    • 备注
      • 不完全相同的语法
        • 标记语言间
          • 毫无疑问，不同语言间的语法本来就不一样，但是因为他们隶属于轻量级的标记语言，所以在语法的形式上体现出一定的相似性
        • Wiki引擎间
          • DokuWiki的删除线格式是“<del>删除线</del>”，MediaWiki的则是“<strike>删除线</strike>,<s>简易删除线</s>”
        • 这就解释了：为什么我最初把mediawiki生成表格的示例贴到textile(Redmine的Wiki)中，不能生成表格
      • 是谁确定了wiki引擎的基本语法？
        • 如：不同wiki引擎，*，**，***，#，##，###等表示的意思大体都是一样的
      • Redmine中的Textile的语法还是比较简单的，相比mediawiki、Dokuwiki引擎
      • 比较Wiki引擎
blog comments powered by Disqus

Published

11 April 2013

Tags