搭建Markdown文档库 - Wiki.PHP

献给Markdown爱好者

Markdown是一种轻量标记语言，易读易写，而无需考虑排版。只需要按照一定CSS格式（通常编辑器会提供多种漂亮的渲染），便可导出为PDF/WORD/HTML等，甚至可以直接做PPT。

但在导出之前，Markdown文件本身（.md）却需要专门的软件去打开/预览，不利于向小伙伴分享。于是，这样一款在线的Markdown文档库就诞生了！

wikiphp列表界面

可以读取根目录的.md文件以及文件夹，并以列表形式展示。

wikiphp文章界面

点击文件名称即可预览，渲染格式十分美观，并且会自动生成索引目录，方便阅读。

!> 不支持在线编辑、在线协同。

安装

名称：Wikiphp

作者：cmxiaocai
Github：https://github.com/cmxiaocai/wiki.php

1.下载安装包

点击下载或直接去Github页面下载。

2.将安装包上传至网站目录

如果使用宝塔面板或其他可视化面板，只需要添加网站，然后将安装包解压到网站目录即可。
或者通过命令行：

cd /home/wwwroot/网站路径
git clone https://github.com/cmxiaocai/wiki.php.git

3.访问网站或域名

目录结构：

-_includes                       项目类文件
    ├─ bootstrap.php             用于引如其他文件
    ├─ make_lists.class.php      生成列表页
    ├─ make_posts.class.php      生成内容页
    ├─ match_title.class.php     Markdown中匹配标题索引
    ├─ parse_config.class.php    解析内容中配置属性
    ├─ parse_filetype.class.php  解析文件类型
    ├─ Parsedown.php             Markdown转换html
    └─ simple_html_dom.php       dom解析
-_posts                          你的Markdown文件存放在这里
    ├─ .conf                     用于配置列表页面的示例文件
    └─ demo.md                   Markdown示例文件
-_theme                          样式风格
    ├─ +images                   图片资源
    ├─ +sass                     模板样式
    ├─ lists.html                默认列表模板
    └─ post.html                 默认内容页模板
-_uploads
composer.json
index.php                          入口文件

可以通过检索、替换的方式，自定义自己的网站标题、LOGO等。

4.配合FTP工具

通过宝塔面板，或FTP工具，将.md上传至网站目录即可。