Dokuwiki编辑器问题
1:Dokuwiki环境搭建
1.1:Dokuwiki自带安装文件
安装文件入口:/install.php
界面安装很方便
1.2:Dokuwiki自带zh-cn包
2:直接拷贝图片到编辑器
2.1:自带编辑器介绍
自带编辑器不支持所见所得,依靠一些标签来建立目录和页面排榜,尽管标签很强大,但是对于初学者或者不熟悉的人来说,比较麻烦.
2.2:更换流程及需求分析思考
思考: 要将编辑器改为所见所得,那么就两种方法,修改原先的编辑器或者更换编辑器.
流程:
2.2.1:去网上插件模板找找,是否存在这样的编辑器
2.2.2:更换为其他编辑器
2.2.3:修改原先的编辑器
总结:
我去网上找了,界面的插件倒确实不少,甚至有把FCK作为插件整合进来的,但是依然缺少一个功能就是将图片拷贝到编辑器里.
如果是自己编写这样的编辑器,显然代价太高最终决定是更换编辑器
2.3:更换编辑器为xheditor
2.3.1:将xheditor下载下来,并放入dokuwiki目录下的/lib文件夹下,新建一个目录叫xheditor-1.1.14(目前最新版本为1.1.14)
2.3.2:替换/inc/form.php里的函数form_wikitext(attrs)
源程序:
[php] view plain copy
- <span style=”font-size:14px;”>function form_wikitext($attrs) {
- // mandatory attributes
- unset($attrs[‘name’]);
- unset($attrs[‘id’]);
- return ‘<textarea name=”wikitext” id=”wiki__text” ‘
- .buildAttributes($attrs,true).’>’.DOKU_LF
- .formText($attrs[‘_text’])
- .'</textarea>’;
- }</span>
替换程序:
[php] view plain copy
- function form_wikitext($attrs) {
- // mandatory attributes
- unset($attrs[‘name’]);
- unset($attrs[‘id’]);
- return ‘<textarea id=”elm1″ rows=”15″ cols=”80″ style=”width:100%” name=”wikitext”>’.DOKU_LF
- .formText($attrs[‘_text’])
- .'</textarea>’;
- }
即:采用xheditor编辑器.
2.3.3:在/lib/tpl/dokuwiki/main.PHP添加xheditor包
[html] view plain copy
- <script type=”text/javascript” src=”<?php echo DOKU_BASE;?>lib/xheditor-1.1.14/xheditor-1.1.14-zh-cn.min.js”></script>
2.3.4.在/inc/parser/xhtml.php里更改cdata函数
源程序:
[php] view plain copy
- function cdata($text) {
- $this->doc .= $this->_xmlEntities($text);
- }
替换程序:
[php] view plain copy
- function cdata($text) {
- $this->doc.=$text;
- }
替换原因是:因为以前是纯字符编辑器,会将一些特殊符号进行过滤,比如:<>等等.而替换之后的xheditor本身已经做了一次过滤了,再次过滤就会导致字符<变成<,因此去掉这段之后,就只过滤一次
2.3.5.添加js代码
[php] view plain copy
- $(function(){
- $(‘#elm1’).xheditor({
- localUrlTest:/^https?:\/\/[^\/]*?(xheditor\.com)\//i,
- remoteImgSaveUrl:'<?php echo DOKU_BASE;?>lib/xheditor1-saveremoteimg.php?prefix=<?php echo DOKU_BASE;?>’
- });
- });
配置php后台上传路径
2.3.6:配置php截图上传代码:
/lib/xheditor-1.1.14/demos/saveremoteimg.php.在文件底部修改代码:
源程序:
[php] view plain copy
- for($i=0;$i<$urlCount;$i++){
- $localUrl=saveRemoteImg($arrUrls[$i]);
- if($localUrl)$arrUrls[$i]=$localUrl;
- }
- echo implode(‘|’,$arrUrls);
替换程序:
[php] view plain copy
- for($i=0;$i<$urlCount;$i++){
- $localUrl=saveRemoteImg($arrUrls[$i]);
- if($localUrl)$arrUrls[$i]=$localUrl;
- }
- foreach($arrUrls as $key=>$vo){
- $arrUrls[$key]=$_GET[‘prefix’].’lib/xheditor-1.1.14/demos/’.$vo;
- }
- echo implode(‘|’,$arrUrls);
2.3.7:将上传的图片去掉多余的”符号
图片上传,发布之后.在调用图片时,会多一个中文”符号,需要修改语言包/inc/lang/zh/lang.php
源程序:
[php] view plain copy
- $lang[‘doublequoteopening’] = ‘“’;
- $lang[‘doublequoteclosing’] = ‘”’;
替换程序:
[php] view plain copy
- $lang[‘doublequoteopening’] = ”;
- $lang[‘doublequoteclosing’] = ”;
3:编辑器新加插入代码功能
3.1:/lib/tpl/dokuwiki/main.php更新js代码
同之前的上传整合起来:
新增程序:
[javascript] view plain copy
- <script type=”text/javascript”>
- var editor;
- jQuery(pageInit);
- function pageInit()
- {
- var allPlugin={
- Code:{c:’btnCode’,t:’插入代码’,h:1,e:function(){
- var _this=this;
- var htmlCode='<div><select id=”xheCodeType”><option value=”html”>HTML/XML</option><option value=”js”>Javascript</option><option value=”css”>CSS</option><option value=”php”>PHP</option><option value=”java”>Java</option><option value=”py”>Python</option><option value=”pl”>Perl</option><option value=”rb”>Ruby</option><option value=”cs”>C#</option><option value=”c”>C++/C</option><option value=”vb”>VB/ASP</option><option value=””>其它</option></select></div><div><textarea id=”xheCodeValue” wrap=”soft” spellcheck=”false” style=”width:300px;height:100px;” /></div><div style=”text-align:right;”><input type=”button” id=”xheSave” value=”确定” /></div>’;
- var jCode=jQuery(htmlCode),jType=jQuery(‘#xheCodeType’,jCode),jValue=jQuery(‘#xheCodeValue’,jCode),jSave=jQuery(‘#xheSave’,jCode);
- jSave.click(function(){
- _this.loadBookmark();
- _this.pasteHTML(‘<pre class=”prettyprint lang-‘+jType.val()+'”>’+_this.domEncode(jValue.val())+'</pre>’);
- _this.hidePanel();
- return false;
- });
- _this.saveBookmark();
- _this.showDialog(jCode);
- }}
- };
- editor=jQuery(‘#elm1’).xheditor({
- plugins:allPlugin,
- tools:’Cut,Copy,Paste,Pastetext,|,Blocktag,Fontface,FontSize,Bold,Italic,Underline,Strikethrough,FontColor,BackColor,SelectAll,Removeformat,|,Align,List,Outdent,Indent,|,Link,Unlink,Anchor,Img,Flash,Media,Hr,Emot,Table,|,Source,Print,Fullscreen,Code’,
- loadCSS:'<style>pre{margin-left:2em;border-left:3px solid #CCC;padding:0 1em;}</style>’,
- localUrlTest:/^https?:\/\/[^\/]*?(xheditor\.com)\//i,
- remoteImgSaveUrl:’lib/xheditor-1.1.14/demos/saveremoteimg.php?prefix=<?php echo DOKU_BASE;?>’,
- upLinkUrl:”<?php echo DOKU_BASE;?>lib/xheditor-1.1.14/demos/upload.php?immediate=1&prefix=<?php echo DOKU_BASE;?>”,
- upLinkExt:”zip,rar,txt”,
- upImgUrl:”<?php echo DOKU_BASE;?>lib/xheditor-1.1.14/demos/upload.php?immediate=1&prefix=<?php echo DOKU_BASE;?>”,
- upImgExt:”jpg,jpeg,gif,png”,
- upFlashUrl:”<?php echo DOKU_BASE;?>lib/xheditor-1.1.14/demos/upload.php?immediate=1&prefix=<?php echo DOKU_BASE;?>”,
- upFlashExt:”swf”,
- upMediaUrl:”<?php echo DOKU_BASE;?>lib/xheditor-1.1.14/demos/upload.php?immediate=1&prefix=<?php echo DOKU_BASE;?>”,
- upMediaExt:”wmv,avi,wma,mp3,mid”
- });
- }
- </script>
3.2加入css和图片
3.2.1:css因为只有一句话,只是为了新增”插入代码”功能的一个小图标而来,因此,可以选择把这个css插入其他css里,而不必新建一个文件.我选择插入的css是:/lib/ style/screen.css:新增css:
[css] view plain copy
- .btnCode {
- background:transparent url(../images/code.gif) no-repeat 16px 16px;
- background-position:2px 2px;}
3.2.2:将小图标 按照css添加路径放入对应css同级目录下的images文件夹内,作为插件插入代码的小图标.
4:编辑器代码高亮功能
4.1:引入google插件prettify.js插件
在/lib/tpl/dokuwiki/main.php里引入prettify.js和对应的css
[html] view plain copy
- <script type=”text/javascript” src=”<?php echo DOKU_BASE;?>lib/xheditor-1.1.14/demos/prettify/prettify.js”></script>
- <link href=”<?php echo DOKU_BASE;?>lib/xheditor-1.1.14/demos/prettify/prettify.css” type=”text/css” rel=”stylesheet”>
4.2:调用prettify.js
这里需要注意,调用prettify.js需要放在xheditor编辑器textarea的后面,放前面会无效.
新增js代码:
[php] view plain copy
- <?php tpl_content() ?>
- <script type=”text/javascript”>prettyPrint();</script>
4.3:修改css文件
引入代码高亮插件后,<pre>标签在dokuwiki下,会嵌套,导致样式会出现两个边框.
在prettify.css最后面,新增css
新增css文件:
[css] view plain copy
- pre pre{box-shadow:none;border:0px;margin:0;padding:0;}
- span{font-style:normal;}
4.4:修改”/”符号出现
原本的dokuwiki里,文本会过滤掉/符号(这个我试过了,即便是最原始的安装好dokuwiki后,在编辑器里只要存在”/”符号,都会被过滤掉.根据wiki语法文档,/会被认为是字体斜体的标志)
而我们的代码里,经常会出现”//”代表注释,因此,需要修改dokuwiki代码.
修改文件/inc/parser/lexer.php:
源程序:
[php] view plain copy
- function split($subject, &$split) {
- if (count($this->_patterns) == 0) {
- return false;
- }
- if (! preg_match($this->_getCompoundedRegex(), $subject, $matches)) {
- if(function_exists(‘preg_last_error’)){
- $err = preg_last_error();
- switch($err){
- case PREG_BACKTRACK_LIMIT_ERROR:
- msg(‘A PCRE backtrack error occured. Try to increase the pcre.backtrack_limit in php.ini’,-1);
- break;
- case PREG_RECURSION_LIMIT_ERROR:
- msg(‘A PCRE recursion error occured. Try to increase the pcre.recursion_limit in php.ini’,-1);
- break;
- case PREG_BAD_UTF8_ERROR:
- msg(‘A PCRE UTF-8 error occured. This might be caused by a faulty plugin’,-1);
- break;
- case PREG_INTERNAL_ERROR:
- msg(‘A PCRE internal error occured. This might be caused by a faulty plugin’,-1);
- break;
- }
- }
- $split = array($subject, “”, “”);
- return false;
- }
- $idx = count($matches)-2;
- list($pre, $post) = preg_split($this->_patterns[$idx].$this->_getPerlMatchingFlags(), $subject, 2);
- $split = array($pre, $matches[0], $post);
- return isset($this->_labels[$idx]) ? $this->_labels[$idx] : true;
- }
替换程序:
[php] view plain copy
- function split($subject, &$split) {
- if (count($this->_patterns) == 0) {
- return false;
- }
- if (! preg_match($this->_getCompoundedRegex(), $subject, $matches)) {
- if(function_exists(‘preg_last_error’)){
- $err = preg_last_error();
- switch($err){
- case PREG_BACKTRACK_LIMIT_ERROR:
- msg(‘A PCRE backtrack error occured. Try to increase the pcre.backtrack_limit in php.ini’,-1);
- break;
- case PREG_RECURSION_LIMIT_ERROR:
- msg(‘A PCRE recursion error occured. Try to increase the pcre.recursion_limit in php.ini’,-1);
- break;
- case PREG_BAD_UTF8_ERROR:
- msg(‘A PCRE UTF-8 error occured. This might be caused by a faulty plugin’,-1);
- break;
- case PREG_INTERNAL_ERROR:
- msg(‘A PCRE internal error occured. This might be caused by a faulty plugin’,-1);
- break;
- }
- }
- $split = array($subject, “”, “”);
- return false;
- }
- $idx = count($matches)-2;
- list($pre, $post) = preg_split($this->_patterns[$idx].$this->_getPerlMatchingFlags(), $subject, 2);
- if(substr($this->_patterns[$idx].$this->_getPerlMatchingFlags(),0,5)=='(\/\/’){
- $pre=’//’.$pre;
- }
- $split = array($pre, $matches[0], $post);
- return isset($this->_labels[$idx]) ? $this->_labels[$idx] : true;
- }
这一步只是会把/不解析,但是仍然会转换为斜体,在修改文件/Inc/parser/xhtml.php:
源程序:
[php] view plain copy
- function emphasis_open() {
- $this->doc .= ‘<em>’;
- }
- function emphasis_close() {
- $this->doc .= ‘</em>’;
- }
替换程序:
[php] view plain copy
- function emphasis_open() {
- //$this->doc .= ‘<em>’;
- }
- function emphasis_close() {
- //$this->doc .= ‘</em>’;
- }
这个<em>标签就是斜体,会默认将/和/之间的字符都带上这个,把这个给注释掉.OK.解决
5:效果显示图:
4.1:插入代码:
4.1.1:插入界面
4.1.2:插入整体效果图
4.1.3:发布之后效果图
4.2:截图拷贝:
4.2.1:随意截图
4.2.2:发布效果
5:总结:
5.1:一款好的内容查询是多么的重要,因为有的时候是使用call_user_func,或者那个调用的函数就是一个变量,根本无法按ctrl+追踪,只能在调用那个方法的时候把这个变量输出,然后在用zend自带的内容查询遍历文件夹
5.2:编辑器中文界面是原本就有的,只需要选择对应语言包就可以了
5.3:遗憾的是,我感觉自己并没有很完美的修改它的程序,尽管我的确只是单单修改了斜体这个功能,而没有影响其他功能.但是我原本是想直接修改传入正则那段,因为去掉了匹配斜体那段正则,我觉得才是比较完美的作法.因为Doku_LexerParallelRegex类是比较独立的,正则都是传入的.但是当我打印正则时,实在是太庞大了,所以最终我还是放弃了这个思路.
5.3.1:图片插入那块,也是全靠编辑器的功劳,我至今也不理解他能把内存的图片拷贝到编辑器的原理(尽管官网说他是漏洞,庆亮说是一个对象操作,我查查资料研究下.
5.3.2:代码高亮那块是采用Google的prettify.js,那块实际上是用js来修改源代码,在一些关键字的地方加上一些标签和css属性,于是就产生了高亮,关于这块,我是比较担心兼容性问题的(单个页面不担心,但是wiki也引入一堆js,但是目前看来,我测试了几次,都没什么问题,那应该不会出现了)