blo is a simple blogging system: no database required, just plain old HTML files.
Install it via npm:
npm install connect blo
Or clone this repository.
blo works as a connect middleware. It takes one parameter, which is your blog directory.
You can create a demo blog with the blo utility:
$ node node_modules/blo/bin/blo skel
$ npm install .
Here is my app.js file:
var connect = require('connect'),
blo = require('blo');
var server = connect(
connect.favicon(__dirname + '/public/favicon.ico'),
connect.logger(),
connect.static(__dirname + '/public'),
blo(__dirname)
).listen(3000);
You need to create two directories and one file:
The articles directory contain the articles, which just need to end with .html.
Article can be valid HTML files with doctype, or just an HTML fragment.
Be sure to fill somewhere the date, and the title of your articles. Choose the format you want, really.
Examples:
<!doctype html>
<meta charset="utf-8">
<title>My article</title>
<h1>My article</h1>
<time>2011-04-11</time>
<p>Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.</p>
<p>Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo.</p>
<h1>My article</h1>
<time>Wednesday 4th May 2011</time>
<p>Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.</p>
<p>Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo.</p>
The skin directory contain the templates. Templates are based on dust.
Two templates: home.html and article.html.
Examples:
<!doctype html>
<html>
<head>
<meta charset="utf-8" />
<title>{blogName}</title>
</head>
<body>
<header role="banner">
<h1><a href="/">{blogName}</a></h1>
</header>
<section>
<h1>Articles</h1>
<ul>{#articles}
<li><a href="/{permalink}">{metas.title}</a></li>{/articles}
</ul>
</section>
</body>
</html>
<!doctype html>
<html>
<head>
<meta charset="utf-8" />
<title>{article.metas.title} | {blogName}</title>
</head>
<body>
<header role="banner">
<h1><a href="/">{blogName}</a></h1>
</header>
<section id="article">
<h1>{article.metas.title}</h1>
{article.content|s}
</section>
</body>
</html>
This file contains the configuration file of your project.
It should be a valid Node module which exports a configuration object.
Example:
module.exports = {
articlesDir: __dirname + '/articles', // Articles directory
skinDir: __dirname + '/skin', // Skin (templates) directory
blogName: "My blog", // Blog name
lang: "FR-fr", // Language
/* Do what you want with window here, but call `callback`
* with an object containing `title` (String) and `date` (Date) keys.
* You can add other keys, they will be available in your templates.
*/
readMetas: function(window, callback) {
var dateText = window.document.getElementsByTagName("time")[0].textContent,
dateSplit = dateText.split("-");
callback(null, {
title: window.document.getElementsByTagName("title")[0].textContent,
date: new Date(dateSplit[0]-0, dateSplit[1]-1, dateSplit[2]-0)
});
},
/* Again, do what you want, but call `callback` with a string
* containing your article. In this example, I remove tags I don’t want.
*/
readArticle: function(window, callback) {
var eltsToRemove = ["title", "h1", "time", "meta"],
i = eltsToRemove.length;
while (i--) {
var elt = window.document.getElementsByTagName(eltsToRemove[i])[0];
elt.parentNode.removeChild(elt);
}
callback(null, window.document.body.innerHTML);
}
};
FAQs
blo is a small and fast library to generate Ethereum identicons.
The npm package blo receives a total of 3,983 weekly downloads. As such, blo popularity was classified as popular.
We found that blo demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Security News
Socket researchers uncover a malicious npm package posing as a tool for detecting vulnerabilities in Etherium smart contracts.
Security News
Research
A supply chain attack on Rspack's npm packages injected cryptomining malware, potentially impacting thousands of developers.
Research
Security News
Socket researchers discovered a malware campaign on npm delivering the Skuld infostealer via typosquatted packages, exposing sensitive data.