vibelog

A fast and simple embeddable blog for multi-site authoring

The base package comes with a default style. For an example of a custom style, check out the vibe.d blog or Aspect blog.

Main features

Multi-site configurations
Multi-user management with access restriction
Directly embeddable in vibe.d sites
RSS feed
User comments
Customizable template based layout
Heading, sub heading, header image, automatic post slug creation

Prerequisites

VibeLog needs dub and MongoDB installed.

Running a simple stand-alone blog

Clone vibelog

 $ git clone git://github.com/rejectedsoftware/vibelog.git

Compile and run
```
 $ cd vibelog
 $ dub run
```

The blog is now accessible at http://127.0.0.1:8080/.

Embedding VibeLog into your own application

Create a new project:
```
 $ dub init my-blog
 $ cd my-blog
```
Edit package.json and add the following entries to the "dependencies" section:
```
 "vibelog": ">=0.0.9"
```

Edit source/app.d:

import vibe.d;
import vibelog.vibelog;

static this()
{
	auto router = new UrlRouter;

	auto blogsettings = new VibeLogSettings;
	blogsettings.configName = "vibelog";
	blogsettings.basePath = "/";
	registerVibeLog(blogsettings, router);

	router.get("*", serveStaticFiles("./public"));
	
	auto settings = new HttpServerSettings;
	settings.port = 8080;
	listenHttp(settings, router);
}

If you want to run multiple blogs on the same database, you should choose a meaningful configuration name instead of "vibelog". Each blog should have its own configuration name.

Start the application (dub will automatically download vibelog and vibe.d as dependencies)
```
 $ dub run
```

You will probably also want to copy the views/layout.dt file to your own project and modify it to your needs (e.g. by adding a style sheet). The blog is accessible at http://127.0.0.1:8080.

Setting everything up

Go to the management page on your blog (e.g. http://127.0.0.1:8080/manage). Use username admin and password admin when logging in for the first time.
Open the user management page and create a new user. Be sure to make the new user an administrator. The admin user will be disabled afterwards.
Open the configuration management page and edit the global configuration. You should add at least one category here. Each line in the text field represents one configuration and must not contain spaces.
Now edit the blog's configuration (e.g. vibelog) and check all categories that should be listed on the blog.
Start posting new articles by choosing New post from the management page.