Skip to content
一款基于MarkDown生成的博客系统(markdown blog system),且无需数据库(可做笔记本、电子书、教学课件等)。A blog system based on MarkDown.md,支持微信、支付宝二维码打赏功能,百度联盟,淘宝联盟,谷歌广告联盟推广Google Adsense,百度统计,畅言评论等模块。
JavaScript CSS PHP HTML
Branch: master
Clone or download

README.md

md-Blog

licenses apache nginx php size release download

欢迎使用 md-Blog,本博客系统可以将 MarkDown 文件生成一个全静态页面的站点blog,且不需要数据库的依赖。注:本博客系统不提供 MarkDown编辑器 功能。

演示(Demo)

demo https://www.ycmbcd.com

特色

  1. 支持文章付款码、二维码打赏功能(例:微信支付宝);
  2. 整合谷歌广告联盟 Google Adsense 投放;
  3. 整合社会化评论 畅言 评论模块;
  4. 整合 百度统计
  5. 支持文章 置顶
  6. 多种 代码高亮 样式自定义(需要点击全站静态生成重新生成页面);
  7. 代码块 一键复制
  8. 支持 数学公式($a_n+1=a_{n+1}+\sqrt{n}+\frac{1}{n}$);
  9. Blog 主色调修改(需要点击全站静态生成重新生成页面);
  10. 每页条数自定义(需要点击全站静态生成重新生成页面);
  11. Fork me on GitHubGitHub 彩带功能;
  12. 多种列表、页码 动画效果
  13. 段落 开头对齐 设置;
  14. 备案号 选填。

配置需求

apache nginx php

Apache / Nginx PHP 5 以上

安装

  1. 配置修改后,如无效,请清空浏览器缓存,点击 全站静态生成
  2. 上传文件夹到站点根目录;
  3. 输入网址登录,初次使用会提示密码设置。

使用

ssl认证 的网站浏览器访问:https://您的域名/set/ssl认证 的网站浏览器访问:http://您的域名/set/ 进行博客参数配置及页面生成,参照图: IMAGE

将你本地的 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 ... (可选)如模板自定义,请保留

Tips

  • 目录名不要出现空格,否则图片会挂;
  • .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 文件即可。

二次开发

  1. 您可以在 /tpl,/static 目录中对博客模板样式进行开发;
  2. 集成 JQuery,/static/lib/jquery-3.3.1.min.js
  3. 集成 Font-Awesome 图标库, /static/lib/font-awesome-4.7.0/css/font-awesome.min.css
  4. 响应式 UI 集成 snack, /static/lib/snack.min.css 参考:https://nzbin.github.io/snack/。

鸣谢

License

联系我

ycmbcd@foxmail.com

感谢您的支持与厚爱

IMAGE

You can’t perform that action at this time.