Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/hackergrrl/ipfs-blog

:globe_with_meridians: Host a blog ..without the hosting!
https://github.com/hackergrrl/ipfs-blog

Last synced: 14 days ago
JSON representation

:globe_with_meridians: Host a blog ..without the hosting!

Awesome Lists containing this project

README

        

# ipfs-blog

> opinionated ipfs-powered blog

## Background

Wouldn't it be nice to have a simple static HTML blog that you didn't need to
worry about hosting?

## Prerequisites

You'll need [IPFS](https://ipfs.io) installed, at least
[0.4.0](http://dist.ipfs.io/#go-ipfs).

## Usage

```sh
$ npm install -g ipfs-blog

$ cd /tmp

$ cat > article.md
# Hello world!

This is my very first blog entry to the permanent web! Huzzah!
^D

$ ipfs-blog --title "My Permanent Blarg"
wrote article.md
https://ipfs.io/ipfs/QmR8kn6CQzBADU6BvHPnvnkpXKykkJVwjJVujPqZz3nWDj
```

![](https://raw.githubusercontent.com/noffle/ipfs-blog/master/static/screenshot.png)

Note that you'll need a local [IPFS daemon](https://dist.ipfs.io/#go-ipfs)
running in order to publish.

## CLI

All markdown files (`*.markdown`, `*.md`) in the current directory will be
published.

Each article will use its `mtime` (last modified time) as its publish date. You
can use e.g. `touch` to fudge this to a custom time if you'd like: `touch -d
"Fri Sep 23 17:44:32 PDT 2016" article.md`.

You can pass `-t | --title` with a string to specify the name of the blog.

## Customization

All flavour text is hard-coded for now. PRs that better facilitate user
customization (color scheme, etc) are very welcome!

## License

ISC