欢迎使用 md-Blog,本博客系统可以将 MarkDown 文件生成一个全静态页面的站点blog,且不需要数据库的依赖。注:本博客系统不提供 MarkDown编辑器 功能。
具体安装配置教程可参考此文档: https://www.ycmbcd.com/wiki/
- 支持文章付款码、二维码打赏功能(例:
微信
、支付宝
); - 整合谷歌广告联盟
Google Adsense
投放; - 支持视频、音频插入播放功能(例:
mp4
、mp3
)。 - 整合社会化评论
畅言
评论模块; - 整合
百度统计
; - 支持文章
置顶
; - 多种
代码高亮
样式自定义(需要点击全站静态生成
重新生成页面); - 代码块
一键复制
; - 支持
数学公式
($a_n+1=a_{n+1}+\sqrt{n}+\frac{1}{n}$); - Blog 主色调修改(需要点击
全站静态生成
重新生成页面); - 每页条数自定义(需要点击
全站静态生成
重新生成页面); Fork me on GitHub
及GitHub 彩带
功能;- 多种列表、页码
动画效果
; - 段落
开头对齐
设置; 备案号
选填。
Apache / Nginx PHP 5 以上
- 配置修改后,如无效,请清空浏览器缓存,点击
全站静态生成
; - 上传文件夹到站点根目录;
- 输入网址登录,初次使用会提示密码设置。
有 ssl认证
的网站浏览器访问:https://您的域名/set/
无 ssl认证
的网站浏览器访问:http://您的域名/set/
进行博客参数配置及页面生成,参照图:
将你本地的 MarkDown
目录上传至网站根目录 /md
目录下
注意:本博客只支持一级栏目划分,请参照下列结构:
/md
/md/西游记
/md/西游记/第一章.md
/md/西游记/第二章.md
...
/md/红楼梦
/md/红楼梦/第一回.md
/md/红楼梦/第二回.md
...
放入后点击 全站静态生成
按钮,拿起茶杯的功夫,系统便自动生成好了您的博客。
- /blog ... 存放博客网页文件
- /data ... 存放系统生成的站点数据
- /index ... 由系统生成的index列表
- /md ... 用户 MarkDown 文件放置文件夹
- /set ... 站点配置
- /set/api ... 系统功能
- /static ... 层叠样式表、JavaScript及第三方依赖
- /tpl ... 模板目录
- /favicon.ico ... 博客图标
- /index.html ... 系统生成的博客主页
保留以下目录,更新其他目录即可。
- /data ... 参数配置及站点数据文件夹
- /md ... 您的 MarkDown 文件夹
- /tpl ... (可选)如模板自定义,请保留
- /static ... (可选)如模板自定义,请保留
- 目录名不要出现空格,否则图片会挂;
- .md 文件中的空格用
代替; - 图片格式:
![图片名](图片地址)
,图片地址使用相对路径的图片,请保存在该.md
文件夹内新建的文件夹中,如:/md/demo/test.md
,图片可以保存在/md/demo/images/pic.jpg
,请不要与文件同文件夹,否则会生成为一个博客,上传后的/md
文件夹及其图片文件夹请保留,博客图片路径为原图片路径(为节约服务器容量及管理方便);
![IMAGE](images/pic.jpg)
- 对于Windows用户,无法生成以中文开头的文档和栏目的,请修改 /set/api/目录下:read_md.php、read_item.php。 两个文件,将注释切换为中文。默认是 Linux系统;
setlocale(LC_ALL, 'zh_CN.GBK'); // windows
setlocale(LC_ALL, 'zh_CN.UTF8'); // linux
- 如无法生成页面,请将目录赋予Apache来执行;
chown -R apache:apache * #在站点根目录执行
- 忘记密码或者修改密码,直接删除
/data/blog.lock
文件即可。
- 您可以在
/tpl
,/static
目录中对博客模板样式进行开发; - 集成 JQuery,
/static/lib/jquery-3.3.1.min.js
; - 集成 Font-Awesome 图标库,
/static/lib/font-awesome-4.7.0/css/font-awesome.min.css
; - 响应式 UI 集成 snack,
/static/lib/snack.min.css
参考:https://nzbin.github.io/snack/。
- SegmentFault Team https://segmentfault.com/
- MathJax https://www.mathjax.org/
- Clipboard.js https://github.com/zenorocha/clipboard.js/
- Font-awesome https://github.com/FortAwesome/Font-Awesome/
- Hover.css https://github.com/IanLunn/Hover/
- Highlight.js https://github.com/highlightjs/highlight.js/
- Snack https://github.com/nzbin/snack