dokuwiki安装使用教程（支持中文、editor.md、粘贴上传图片）

最新推荐文章于 2024-09-10 16:00:16 发布
最新推荐文章于 2024-09-10 16:00:16 发布
阅读量4.5w 收藏 31
点赞数 5
分类专栏： WEB技术 软件工程
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/mergerly/article/details/79629562
版权

一、安装

  1. 到官网下载合适的版本https://www.dokuwiki.org/
  2. 在网站一栏输入:http://你的ip地址/Dokuwiki/install.php 在右上角选好语言，简体中文zh
  3. 然后会弹出这样的安装示意图，启用ACL(推荐)
  4. 根据上示意图，填写信息。分别填写超级用户，全名，E-mail，密码等信息。
  5. 安装结束后，为了安全，要删除install.php文件，然后再用刚才设置的用户名密码登陆。
  6. 关于安全： http://你的ip地址/data/pages/wiki/dokuwiki.txt
  7. 访问http://你的ip地址/dokuwiki/doku.php

二、配置

  1. 点击admin处的管理 按钮，然后出现页面
  2. 可分别根据用户管理、访问控制列表等来进行设置管理。

三、中文文件名的乱码问题

  1. 在服务器机子上 D:\phpStudy\WWW\dokuwiki\conf\local.php
    在最后一行加上： 
$conf['fnencode']='gb2312'; #注意分号不能少。
  1. 在服务器机子上 D:\phpStudy\WWW\dokuwiki\Inc\pageutils.php
    修改两个函数：utf8_encodeFN函数
function utf8_encodeFN($file,$safe=true){
    global $conf;
    if($conf['fnencode'] == 'utf-8') return $file;

    if($safe && preg_match('#^[a-zA-Z0-9/_\-\.%]+$#',$file)){
        return $file;
    }

    if($conf['fnencode'] == 'safe'){
        return SafeFN::encode($file);
    }
    // 中文支持
    if ($conf['fnencode']=='gb2312'){
        return iconv('UTF-8','GB2312',$file);
    }

    $file = urlencode($file);
    $file = str_replace('%2F','/',$file);
    return $file;
}

和utf8_decodeFN函数：

function utf8_decodeFN($file){
    global $conf;
    if($conf['fnencode'] == 'utf-8') return $file;

    if($conf['fnencode'] == 'safe'){
        return SafeFN::decode($file);
    }
    // 中文支持
    if ($conf['fnencode']=='gb2312'){
        return iconv('GB2312','UTF-8',$file);
    }
    return urldecode($file);
}

四、安装插件

  1. 新增页面Add New Page插件
  2. Markdown插件PHP Markdown Extra plugin
  3. 侧边栏
    1）安装simplenavi插件
    2) 新建data\pages\sidebar.txt，内容如下：
===== 导航目录 =====
{{simplenavi>}}
===== 添加新页面 =====
{{NEWPAGE}}

五、支持editer.md

1.下载editor.md
https://github.com/pandao/editor.md/archive/v1.5.0.tar.gz

2.解压到dokuwiki\lib\editor.md\

3.替换/inc/form.php里的函数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 '<textarea name="wikitext" id="wiki__text" dir="auto" '
                 .buildAttributes($attrs,true).'>'.DOKU_LF
                 .formText($attrs['_text'])
                 .'</textarea>';
    */
    return '<div id="editormd" contenteditable="true"><textarea name="wikitext">'.DOKU_LF.formText($text)
    .'</textarea></div>';
}

4.在/inc/parser/xhtml.php里更改cdata函数

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

替换原因是:因为以前是纯字符编辑器,会将一些特殊符号进行过滤,比如:<>等等.而替换之后的xheditor本身已经做了一次过滤了,再次过滤就会导致字符<变成&lt,因此去掉这段之后,就只过滤一次

5.inc/actions.php的act_save函数

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

6.在/lib/tpl/dokuwiki/main.php添加editor.md包
head节中添加

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

body节中添加

    <script src="<?php echo DOKU_BASE;?>lib/editor.md/examples/js/jquery.min.js"></script>
    <script src="<?php echo DOKU_BASE;?>lib/editor.md/editormd.js"></script>
    <script type="text/javascript">
        var testEditor;
        $(function(md) {
            testEditor = editormd("editormd", {
                width: "100%",
                height: 740,

                path: '<?php echo DOKU_BASE;?>lib/editor.md/lib/',
                theme: "dark",
                /*
                previewTheme : "dark",
                editorTheme : "pastel-on-dark",
                markdown : md,
                */
                codeFold: true,
                syncScrolling: "single",

                saveHTMLToTextarea: true, // 保存 HTML 到 Textarea
                searchReplace: true,
                //watch : false,                                // 关闭实时预览
                htmlDecode: "style,script,iframe|on*", // 开启 HTML 标签解析，为了安全性，默认不开启
                //toolbar    : false,                         //关闭工具栏
                //previewCodeHighlight : false, // 关闭预览 HTML 的代码块高亮，默认开启
                emoji: true,
                taskList: true,
                tocm: true, // Using [TOCM]
                tex: true, // 开启科学公式TeX语言支持，默认关闭
                flowChart: true, // 开启流程图支持，默认关闭
                sequenceDiagram: true, // 开启时序/序列图支持，默认关闭,
                //dialogLockScreen : false,     // 设置弹出层对话框不锁屏，全局通用，默认为true
                //dialogShowMask : false,         // 设置弹出层对话框显示透明遮罩层，全局通用，默认为true
                //dialogDraggable : false,        // 设置弹出层对话框不可拖动，全局通用，默认为true
                //dialogMaskOpacity : 0.4,        // 设置透明遮罩层的透明度，全局通用，默认值为0.1
                //dialogMaskBgColor : "#000", // 设置透明遮罩层的背景颜色，全局通用，默认为#fff
                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>

7.粘贴图片自动上传支持
修改文件data/.htaccess中的Deny from all改为allow from all
上传图片保存代码：

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

$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函数）
        $uploaded_file=$_FILES['editormd-image-file']['tmp_name'];

        //我们给每个用户动态的创建一个文件夹
        $save_path=$_SERVER['DOCUMENT_ROOT'].$hostpath.$attachDir;
        //判断该用户文件夹是否已经有这个文件夹
        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'=>$hostpath.$attachDir.$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":"'.$hostpath.$attachDir.$filename.'"}';
        return true;
    } else {
        echo '{"success":0,"message":"图片格式异常"}';
        return false;
    }
}

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

if(isset($_FILES['editormd-image-file'])){
    upEditorImg();
    exit();
}

if(isset($_POST['screenshots'])){
    upEditorScreenshots();
    exit();
}
?>

也可以直接下载已经修改好的源码：
https://github.com/mergerly/dokuwiki/tree/stable

mergerly
关注
专栏目录
dokuwiki with editor.md
05-29
修改 dokuwiki（适合开发类的最好的wiki） 支持 editor.md（国人做的最好的markdown）编辑
dokuwiki 支持editor.md编辑器编辑
09-11
dokuwiki 支持editor.md编辑器编辑 使用MarkDown 编辑文档， 实时预览编辑内容 ， 支持复制粘贴图片，
如何在DOKUWIKI里面集成百度的开源富文本编辑器UEDITOR
最新发布
weixin_52041354的博客
09-10 1427
编辑器：百度ueditor前端：vue2,vue3,vue-cli,html5需求：复制粘贴word内容图片，word图片转存交互,导入pdf,导入PowerPoint(PPT)要求：开源，免费，技术支持用户体验：Ctrl+V快捷键操作该说不说，最近这块应该也是挻火的，今天早上又有网友加我微信私聊，说是想了解一下这块的技术和方案。实际我的微信号之前就已经在网上公开了，但是很多网友还是说找不到，这个可真有点难度了。
DokuWiki 安装与使用教程
gitblog_00695的博客
08-08 669
DokuWiki 安装与使用教程 dokuwikiThe DokuWiki Open Source Wiki Engine项目地址:https://gitcode.com/gh_mirrors/do/dokuwiki 本文将指导您了解并设置开源项目DokuWiki。 1. 项目目录结构及介绍 以下是DokuWiki项目的基本目录结构： . ├── _test # 测试目录 ...
dokuwiki粘帖图片
weixin_45525177的博客
03-03 271
/在ctrl+c word中的文字或者图片之后会返回1种(image/png)或者4种type(text/plain,text/html,text/rtf,image/png)类型的对象。//如下代码：e.originalEvent.clipboardData.items获得剪贴板的内容。//如果有文字的话不做任何的处理，如果只粘贴图片的话文本一定是空的，包括复制的桌面图片或者截图的图片。//当粘贴了文本之后text是不为空的，同时也会返回当前文本的图片类型。//为了兼容4种格式的情况，做了如下的判断。
dokuwiki 安装指南 (基于 Debian 9 和 php 7.0)
羽空间
11-27 561
文章目录1、安装 nginx （若已安装则跳过）2、安装 php （若已安装则跳过）3、下载 dokuwiki 源码4、增加 nginx 配置5、启动 nginx6、安装7、禁止再次安装 1、安装 nginx （若已安装则跳过） 运行命令: sudo apt-get install nginx 编辑 /etc/nginx/nginx.conf 文件，把 server_tokens off 前的注...
dokuwiki使用教程，搭建自己的wiki网站
热门推荐
linxinfa的专栏
11-15 3万+
1 dokuwiki下载 https://download.dokuwiki.org/ 2 搭建 1 使用phpstudy启动web server服务（Apache或Nginx） 检测网站端口，比如我这里设置的是8082 2 进入网站根目录（WWW目录） 3 把dokuwiki拷贝到WWW目录中解压 进入dokuwiki目录可以看到有一个install.php 4 在浏览器中访问loc...
DokuWiki 使用教程
gitblog_01000的博客
09-04 871
DokuWiki 使用教程 dokuwikiThe DokuWiki Open Source Wiki Engine项目地址:https://gitcode.com/gh_mirrors/dok/dokuwiki 1、项目介绍 DokuWiki 是一个易于使用且高度灵活的开源维基软件，不需要数据库支持。它因其简洁和可读的语法而受到用户的喜爱。维护、备份和集成的便利性使其成为管理员的首选。内置的访...
dokuwiki 的管理和使用
车子（chezi）
10-06 6868
文章目录版本控制页面间互相引用插件 indexmenu增加页面删除页面上传文档页面里引用文件文档管理用户管理权限管理 dokuwiki 很适合作为中小团队的知识库，在公司内网部署。考虑到我所在公司的现状，我认为 dokuwiki 要有以下的功能： 知识管理。用于知识的沉淀和分享，每个人都可以创建页面，也可以多人协同编辑页面；历史版本可追溯，可恢复。页面之间可以互相引用。 树形结构。 阳志平老师在他的博文中提到： 我提过多次的 MIT 认知科学家 Joshua B. Tenenbaum 发表在 PN
Dokuwiki 安装
Rob-Code
07-20 593
作者：felix。
dokuwiki的安装
biaoxin3079的博客
07-16 519
安装dokuwiki 安装dokuwiki需要有Apache和PHP7.01.先下载Apache yum install -y httpd 查看Apache的运行状态 systemctl status httpd 运行Apache，再查看一下他的进程看他是否正在运行 systemctl start httpd 修改他的默认端口，成功后他下面会出现success irewall-cmd --add-...
集成editor.md的dokuwiki（支持markdown）
08-10
**集成editor.md的dokuwiki（支持markdown）** 在IT领域，DokuWiki是一个流行的开源wiki软件，主要用于创建和管理文档。它以其简洁的界面、易于编辑和强大的文本格式化能力而受到喜爱。然而，原生的DokuWiki支持的...
dokuwiki安装与配置[归纳].pdf
10-11
dokuwiki安装与配置 dokuwiki是一个功能强大且灵活的Wiki软件，能够帮助用户快速创建和管理知识库。下面是关于dokuwiki的安装和配置的知识点： 1. 安装dokuwiki 在Ubuntu系统上安装dokuwiki，首先需要下载doku...
dokuwiki 插件.zip
06-30
在DokuWiki环境中，XHEditor可以替换默认的文本编辑界面，提供更丰富的格式化选项，如字体、颜色、图片上传、链接插入等。这使得非技术用户也能轻松地编辑和排版wiki页面，提升用户体验。 3. SimpleNavi插件： 由...
使用dokuwiki部署一个美观的知识库（可能是全网最完善的）
u014650965的博客
03-13 1万+
dokuwiki
DokuWiki
ak47mig的网志（自家用，谢绝无聊斗鸡）
08-15 4635
DokuWiki天下维客，你可以修改的网络知识库跳转到: 导航, 搜索wiki程序 wiki程序主条目 wiki程序的流行度 asp的wiki程序 企业用wiki程序 常见中文wiki程序： MediaWiki是最流行的Wiki程序，支持多语种。用它做的网站数以十万计。 MoinMoin平实稳
Dokuwiki安装手册
xulong5000的专栏
07-15 936
版本号 Dokuwiki：Release 2020-07-29 “Hogfather” Docker：1.13.1 Docker-compose：1.18.0 配置docker环境 1:安装docker yum install -y docker 2:安装docker-compose yum install -y docker-compose 3:启动docker systemctl start docker 参数配置及启动 拉取Dokuwiki的d...
dokuwiki教程 php,dokuwiki之使用与教程
weixin_34569101的博客
04-02 586
dokuwiki是个很好的WIKI，不用数据库，用文本存储数据，转移方便。今天再次使用Dokuwiki搭建一个wiki,用于介绍法格产品,专门摆放法格锅具、法格电器、法格橱柜的信息。发现很多用法已经忘记了，特此记录，博客一可用来表达心情，二可用来记录dokuwiki的安装1，用了纯粹空间的unzip.php但是没成功，不知道怎么回事，少的数目文件能解压，多文件就不能解压，难道dreamhost做了...
dokuwiki中文linux,linux 下面 dokuwiki安装 - Dokuwiki 中文教程
weixin_42392689的博客
05-08 418
最简过程：1)下载最新dokuwiki下载网址：http://www.splitbrain.org/projects/dokuwiki这里我下载的是：dokuwiki-2009-12-25c.tgz2)解压文件dokuwiki-2009-12-25c.tgz：$tar -xzvf dokuwiki-2009-12-25c.tgz3)配置安装环境：3.1)sudo apt-get install a...
dokuwiki使用教程
12-20
dokuwiki是一个开源的wiki引擎程序，用于搭建文档库或项目知识库。它具有小巧轻量、灵活强大、安装简单、插件丰富和权限控制强大等特点。下面是使用dokuwiki的简要教程： 1. 下载dokuwiki：你可以从dokuwiki的官方网站下载最新版本的dokuwiki。 2. 解压dokuwiki：将下载的dokuwiki文件解压到你的WWW目录中。 3. 安装dokuwiki：在浏览器中访问localhost:8082/dokuwiki/install.php，填写账号信息。你可以在网页右上角切换为中文环境。填写完信息后，你就可以进入dokuwiki的主页了。 4. 创建和编辑页面：在dokuwiki的主页上，你可以创建新的页面或编辑已有的页面。你可以使用dokuwiki的语法来格式化页面内容，例如使用标题、列表、链接等。 5. 添加插件：dokuwiki有丰富的插件可供使用，你可以根据自己的需求选择并安装插件。插件可以增加各种功能，如图表、代码高亮、文件上传等。 6. 设置权限：dokuwiki提供了强大的权限控制功能，你可以设置不同用户或用户组的访问权限。这样可以确保只有授权的用户才能查看或编辑特定的页面。 7. 多语言支持：dokuwiki支持多种语言，你可以在设置中选择你需要的语言环境。 8. 主题定制：dokuwiki允许你自定义主题，以适应你的品牌或个人喜好。你可以选择现有的主题或创建自己的主题。 9. 维护和备份：定期进行维护和备份是保持dokuwiki运行良好的重要步骤。你可以使用dokuwiki提供的工具来进行维护和备份操作。 希望这个简要教程能帮助你开始使用dokuwiki。如果你有任何进一步的问题，请随时提问。
评论 2
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值