Skip to content
/ mdbl0g Public

A simple, file-based, markdown-driven blog engine *with* web interface.

Notifications You must be signed in to change notification settings

phistep/mdbl0g

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

72 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

mdbl0g

A simple, file-based, markdown-driven blog engine with web interface.

Features

  • light-weight
  • beautiful, minimalistic, HTML5 responsive default layout
  • file based, no data base needed
  • create, edit and delete in the web interface or upload files manually
  • web interface with live preview
  • no comments, no categories, no tags - just text*
  • markdown formatting
  • full text search
  • RSS feed
  • opt-out prettified URLs
  • English and German localization
  • simple and quick installer

*Customize with Plugins

You can easily add features to your mdbl0g by installing plugins. Just download one and drop it into the plugins/ directory. There are already some available at the mdbl0g Plugin Directory.

If you want to develop your own plugins, have a look at the Plugin API.

Installation

Requirements

You need at least PHP version 5.1.0, Apache mod_auth_basic for HTTP Basic Auth (Admin Interface) and optionally Apache mod_rewrite for Pretty URLs. Or any other web server that uses Apache configuration files and implements mod_auth_basic and mod_rewrite. You don't need any sort of database, because mdbl0g is a file based blog engine.

If you have no clue what all this means -- it will probably work ;) Just give it a shot!

Installation process

Download the mdbl0g files from GitHub and upload them to your server. You can also check out the repository with git which makes updating easier:

git clone git://github.com/Ps0ke/mdbl0g.git

Now point your browser to http://YOURDOMAIN.com/mdbl0g/install/ or where ever you uploaded the files. The installer will guide you through the simple installation process. When told to do so, delete the install/ directory and you are ready to go.

Import

Since the file format is very simple, you can easily export your existing blog to use the posts with mdbl0g. Here is a small script to import from Wordpress.

FAQ

Q: Isn't a file based blog really slow?

A: No. Network latency is a way bigger problem for performance as disc I/O. At least if you deal with a (for a blog) reasonable amount of data. I even tested the limits of mdbl0g, you can read about it at my (mdbl0g-driven) blog.

License

The MIT License:

Copyright (c) 2012 Philipp Stephan

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Powered by

About

A simple, file-based, markdown-driven blog engine *with* web interface.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published