DokuWiki安裝+集成markdown編輯器editor.md

安裝

官網(wǎng)下載安裝包https://www.dokuwiki.org/
安裝php和nginx yum install -y php70w php70w-gd php70w-xml php70w-fpm nginx
開機自啟動 systemctl enable nginx php-fpm
配置nginx

    server {
        listen       80;
        server_name  localhost;
        # Maximum file upload size is 4MB - change accordingly if needed
        client_max_body_size 4M;
        client_body_buffer_size 128k;

        root /dokuwiki;
        index doku.php;

        #Remember to comment the below out when you're installing, and uncomment it when done.
        location ~ /(conf/|bin/|inc/|install.php) { deny all; }

        #Support for X-Accel-Redirect
        location ~ ^/data/ { internal ; }

        location ~ ^/lib.*\.(js|css|gif|png|ico|jpg|jpeg)$ {
             expires 365d;
        }

        location / { try_files $uri $uri/ @dokuwiki; }

        location @dokuwiki {
            # rewrites "doku.php/" out of the URLs if you set the userwrite setting to .htaccess in dokuwiki config page
            rewrite ^/_media/(.*) /lib/exe/fetch.php?media=$1 last;
            rewrite ^/_detail/(.*) /lib/exe/detail.php?media=$1 last;
            rewrite ^/_export/([^/]+)/(.*) /doku.php?do=export_$1&id=$2 last;
            rewrite ^/(.*) /doku.php?id=$1&$args last;
        }

        location ~ \.php$ {
            try_files $uri $uri/ /doku.php;
            include fastcgi_params;
            fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
            fastcgi_param REDIRECT_STATUS 200;
            fastcgi_pass 127.0.0.1:9000;
        }
    }

啟動nginx和php-fpm systemctl start php-fpm nginx
在網(wǎng)站一欄輸入:http://你的ip地址/install.php 在右上角選好語言宏赘，簡體中文zh昏名，按照提示安裝即可印荔。如果打開頁面保存平挑，請修改conf矾瘾、data赫悄、lib目前的權限寺酪。

安裝插件

新增頁面Add New Page插件
Markdown插件Markdown Page Plugin

側邊欄

安裝Indexmenu Plugin插件
新建data\pages\sidebar.txt裸准，內(nèi)容如下：

    ===== 導航目錄 =====
    {{indexmenu>..|navbar}}
    ===== 添加新頁面 =====
    {{NEWPAGE}}

中文文件名亂碼

修改dokuwiki/conf/local.php在最后一行加上：

$conf['fnencode']='utf-8';

此處是centos系統(tǒng)（系統(tǒng)默認字符編碼utf-8）下修改亂碼梅尤，windows系統(tǒng)請參考文章末尾的原文地址柜思。

集成editor.md

下載editor.md
https://github.com/pandao/editor.md/archive/v1.5.0.tar.gz
解壓到dokuwiki\lib\editor.md\
替換/inc/form.php里的函數(shù)form_wikitext($attrs),修改return結果

    function form_wikitext($attrs) {
        // mandatory attributes
        unset($attrs['name']);
        unset($attrs['id']);
        $text = str_replace("<markdown>\n",'',$attrs['_text']);
        $text = str_replace("\n</markdown>",'',$text);
        return '<div id="editormd" contenteditable="true"><textarea name="wikitext">'.DOKU_LF.formText($text).'</textarea></div>';
    }

代碼中id="editormd"是后面editor.md實例需要的id

在/inc/parser/xhtml.php里更改cdata函數(shù)

    function cdata($text) {
        //$this->doc .= $this->_xmlEntities($text);
        return $this->doc.=$text;
    }

替換原因是:因為以前是純字符編輯器,會將一些特殊符號進行過濾,比如:<>等等.而替換之后的xheditor本身已經(jīng)做了一次過濾了,再次過濾就會導致字符<變成&lt,因此去掉這段之后,就只過濾一次

inc/Action/Save.php的

    saveWikiText($ID,con($PRE,$TEXT,$SUF,true),$SUM,$INPUT->bool('minor')); //use pretty mode for con
    替換成
    saveWikiText($ID,con($PRE,"<markdown>\n".$TEXT."\n</markdown>",$SUF,true),$SUM,$INPUT->bool('minor')); //use pretty mode for con

lib/tpl/dokuwiki/main.php添加editor.md包

head節(jié)中添加

<link rel="stylesheet" href="<?php echo DOKU_BASE;?>lib/editor.md/css/editormd.min.css" />

body節(jié)中添加

    <script src="<?php echo DOKU_BASE;?>lib/editor.md/editormd.js"></script>
    <script type="text/javascript">
    $ = jQuery
        var testEditor;
        $(function(md) {
        if (document.getElementById("editormd")) {
            testEditor = editormd("editormd", {
                width: "100%",
                height: 740,
                path: '<?php echo DOKU_BASE;?>lib/editor.md/lib/',
                syncScrolling : "single",
                imageUpload: true,
                imageFormats: ["jpg", "jpeg", "gif", "png", "bmp", "webp"],
                imageUploadURL: "<?php echo DOKU_BASE;?>uploadimg.php",
                onload: function() {}
            });
        }
        });

        window.onload = function() {
            //document.getElementById("editormd").addEventListener('paste', function (event) {
            $("#editormd").on('paste', function(event) {
                //console.log(event);
                var items = (event.clipboardData || event.originalEvent.clipboardData).items;
                for (var index in items) {
                    var item = items[index];
                    //console.log(item);
                    if (item.kind === 'file') {
                        var blob = item.getAsFile();                        
                        var reader = new FileReader();
                        reader.onload = function(event) {                            
                            var base64 = event.target.result;
                            console.log(base64);
                            //ajax上傳圖片
                            $.post("<?php echo DOKU_BASE;?>uploadimg.php", {
                                screenshots: base64
                            }, function(rets) {
                                ret = JSON.parse(rets);
                                //layer.msg(ret.msg);
                                console.log(ret);
                                if (ret.success === 1) {
                                    //新一行的圖片顯示
                                    testEditor.insertValue("\n![](" + ret.url + ")");
                                } else {
                                    alert("截圖上傳失敗：" + ret.message);
                                }
                            });
                        };
                        reader.readAsDataURL(blob);
                    }
                }
            });
        }
    </script>

圖片上傳支持
將如下代碼保存到uploadimg.php文件巷燥，放到dokuwiki根目錄下

<?php
if(!defined('DOKU_INC')) define('DOKU_INC', dirname(__FILE__).'/');
require_once(DOKU_INC.'inc/init.php');

$INFO = pageinfo();
$hostpath=getBaseURL(false);
$attachDir='/data/media/editor/';//上傳文件保存路徑赡盘，結尾不要帶/
$maxAttachSize = 2*1024*1024;  //最大上傳大小，默認是2M

function upEditorImg(){
    global $hostpath, $attachDir, $maxAttachSize;
    //獲取文件的大小
    $file_size=$_FILES['editormd-image-file']['size'];
    //echo "$file_size $maxAttachSize";
    if($file_size > $maxAttachSize) {
        echo '{"success":0,"message":"不能上傳大于2M的文件"}';
        return false;
    }

    //獲取文件類型
    $file_type=$_FILES['editormd-image-file']['type'];
    if($file_type!="image/jpeg" && $file_type!='image/pjpeg' && $file_type!="image/png") {
        echo '{"success":0,"message":"圖片格式異常"}';
        return false;
    }

    //判斷是否上傳成功（是否使用post方式上傳）
    if(is_uploaded_file($_FILES['editormd-image-file']['tmp_name'])) {
        //把文件轉存到你希望的目錄（不要使用copy函數(shù)）
        $uploaded_file=$_FILES['editormd-image-file']['tmp_name'];

        //我們給每個用戶動態(tài)的創(chuàng)建一個文件夾
        $save_path=$_SERVER['DOCUMENT_ROOT'].$hostpath.$attachDir;
        //判斷該用戶文件夾是否已經(jīng)有這個文件夾
        if(!file_exists($save_path)) {
            mkdir($save_path);
        }

        //$move_to_file=$save_path."/".$_FILES['editormd-image-file']['name'];
        $file_true_name=$_FILES['editormd-image-file']['name'];
        $move_file_name=time().rand(1,1000).substr($file_true_name,strrpos($file_true_name,"."));
        $move_to_file=$save_path.$move_file_name;
        //echo "$uploaded_file   $move_to_file";
        if(move_uploaded_file($uploaded_file,iconv("utf-8","gb2312",$move_to_file))) {
            //echo $_FILES['editormd-image-file']['name']."上傳成功";
            //echo '{"success":1,"message":"上傳成功", "url":"'.$hostpath.$attachDir.$move_file_name.'"}';
            $result=array(
              'success'=> 1,
              'message'=>'上傳成功',
              'url'=>'editor:'.$move_file_name
            );
            echo json_encode($result);
        } else {
            //echo "上傳失敗";
            echo '{"success":0,"message":"服務器保存文件失敗"}';
        }
    } else {
        //echo "上傳失敗";
        echo '{"success":0,"message":"上傳失敗"}';
        return false;
    }
}

//$_POST= [screenshots] => data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAI0AAACcCAYAAABC1CibAAAL6UlEQVR4Ae2dbUiU6RrH...
function upEditorScreenshots(){
    global $hostpath, $attachDir, $maxAttachSize;

    $content = $_POST['screenshots'];

    if (preg_match('/^data:image\/(\w+);base64,(\S+)/', $content, $result)) {
        $file_type = $result[1];
        $base64data = $result[2];

        //echo "$file_type $base64data";
        $save_path = $_SERVER['DOCUMENT_ROOT'].$hostpath.$attachDir;
        if (!is_dir($save_path)) {
            mkdir($save_path, 0777);
        }

        $filedata = base64_decode($base64data);
        $filename = time().rand(1,1000).".".$file_type;
        if (!file_put_contents($save_path . $filename, $filedata)) {
            echo '{"success":0,"message":"服務器保存文件失敗"}';
            return false;
        }
        unset($filedata);

        echo '{"success":1,"message":"上傳成功", "url":"editor:'.$move_file_name.$filename.'"}';
        return true;
    } else {
        echo '{"success":0,"message":"圖片格式異常"}';
        return false;
    }
}

//print_r($_POST);
//print_r($_FILES);

if(isset($_FILES['editormd-image-file'])){
    global $INFO;
    if($INFO['writable'] && !$INFO['locked']) {
        upEditorImg();
    } else {
    echo '{"success":0,"message":"沒有權限"}';
    }
    exit();
}

if(isset($_POST['screenshots'])){
    global $INFO;
    if($INFO['writable'] && !$INFO['locked']) {
        upEditorScreenshots();
    } else  {
    echo '{"success":0,"message":"缰揪，沒有權限"}';
    }
    exit();
}
?>

代碼中添加了權限校驗和兼容dokuwiki獲取圖片url

修改圖片加載地址
修改lib/editor.md/lib/marked.min.js文件中img標簽生成的方法陨享，在

    var out='<img src="'+href+'" alt="'+text+'"';

代碼前添加

    if(href.indexOf(':')>0&&href.indexOf("/")<0){href='/lib/exe/fetch.php?cache=&media='+href;}

總結

在原來參考文章基礎上添加了未登錄用戶不能通過editor上傳圖片
針對Markdown Page Plugin插件，修改了圖片顯示問題（dokuwiki的圖片資源是統(tǒng)一通過lib/exe/fetch.php文件獲取的钝腺，需要傳入特殊的參數(shù)namespace:文件名稱）
markdown的插件會出現(xiàn)排版不正確問題
dokuwiki對中文分詞支持不太好抛姑，集成中文分詞見DokuWiki集成中文分詞SCWS

參考鏈接

dokuwiki安裝使用教程（支持中文、editor.md艳狐、粘貼上傳圖片）