黑猫

搭建Markdown文档库 - Wiki.PHP
献给Markdown爱好者Markdown是一种轻量标记语言,易读易写,而无需考虑排版。只需要按照一定CSS格式(...
扫描右侧二维码阅读全文
29
2018/09

搭建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上传至网站目录即可。

Last modification:October 8th, 2018 at 11:20 am
If you think my article is useful to you, please feel free to appreciate

Leave a Comment