Description

A light-weight embeddable blog implementation

Package Information

Version0.6.0-rc.3 (2017-Mar-16)
Homepage https://github.com/rejectedsoftware/vibelog
Repository https://github.com/rejectedsoftware/vibelog
LicenseAGPL-3.0
AuthorsSönke Ludwig
Registered bySönke Ludwig
Dependencies

vibe-d

stringex

diskuto

Installation

To use this package, put the following dependency into your project's dependencies section:

dub.json
dub.sdl

Readme

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 see the vibe.d blog.

Build Status

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

  1. Clone vibelog

    $ git clone git://github.com/rejectedsoftware/vibelog.git
    
    
  2. 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

  1. Create a new project:

    $ dub init my-blog
    $ cd my-blog
    
    
  2. Edit package.json and add the following entries to the "dependencies" section:

    "vibelog": ">=0.0.9"
    
    
  3. 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.

  4. 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

  1. 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.

  2. 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.

  3. 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.

  4. Now edit the blog's configuration (e.g. vibelog) and check all categories that should be listed on the blog.

  5. Start posting new articles by choosing New post from the management page.

Available versions

0.6.0-rc.3 0.6.0-rc.2 0.6.0-rc.1 0.6.0-beta.1 0.5.0-beta.4 0.5.0-beta.3 0.5.0-beta.2 0.5.0-beta.1 0.5.0-alpha.2 0.5.0-alpha.1 0.4.2 0.4.1 0.4.0 0.3.0 0.2.0 0.1.3 0.1.2 0.1.1 0.1.0 0.0.12 0.0.11 0.0.10 0.0.9 0.0.8 0.0.7 0.0.6 0.0.5 0.0.4 0.0.3 0.0.2 0.0.1 ~master