markdownphp

介绍

MarkdownPHP 是开源的静态站点生成器，简称 MdPHP，基于PHP语言环境和Markdown页面文件。

市面上有编译速度最快的Hugo，有语法贴近Vue的VuePress，有老牌的Jekyll。为什么不用这些现有的方案，而重新开发了MdPHP？

对比使用了以上几款流行的产品，个人心得是：Hugo绿色简洁，编译速度飞快，但是英文教程艰涩难懂，对复杂的需求难以搞定，定制开发难度很大。VuePress基于Vue语法和Node环境，但是编译速度是同类产品中最慢的，页面内容多了，编译的时间足以让你坚定做出从入门到放弃的决定。老牌的Jekyll需要额外安装Ruby环境，编译速度一般，用过Hugo后大部分人都会爱上Hugo而放弃Jekyll。Hugo之所以快，是因为它是用Go语言开发的，而且已经集成Go环境，是单文件绿色版。但是Hugo蛋疼的英文教程，极大阻碍了英文水平不好的国人去轻松地使用它，想定制开发的话，难度也是很大。所以想开发一款国产开源静态站点生成器，具有国外同类流行产品的优点，而且简单容易上手，文档教程也是中文的，可以很容易进行模板定制开发。所以MarkdownPHP应运而生，国货软件，希望大家喜欢。

说明：本人文档水平不好，有限的精力更多放在代码开发上面，所以希望有志同道合的朋友一起对这个项目做出贡献。如果您有兴趣，欢迎对文档和代码贡献您的力量！

总结MdPHP的一些优秀特性：

• 编译速度和Hugo一样快，也就是市面同类软件中最快。
• 模板语法用PHP，文档语法用Markdown，没有重新定义任何艰涩难懂的产品语法规范。
• 支持多语言
• 支持菜单排序

快速上手

启动内置服务器

命令行切换到应用根目录后，输入：

>php mdphp.php serve --port=6000 --host="127.0.0.1"

如果启动成功，会输出下面信息，并显示web目录位置。

MdPHP Development server is started at 2020-10-27 14:54:25 on http://127.0.0.1:5000/
You can exit with [CTRL-C]
Document root is: F:\workspace\interest-project\personal-project\mdphpsite\

然后你可以直接在浏览器里面访问

http://127.0.0.1:5000/