A single Bash script to create blogs.
Forked from https://github.com/cfenollosa/bashblog by removing non-free stuff like Disqus, Twitter, Google.
- Mastodon crossposting support
- Maybe other AcivityPub-based services
You can see a sample here: read the initial blog post. That page was 100% generated using bashblog, no additional tweaking.
Check out other bashblog users
Download the code and copy bb.sh into a public folder (for example,
$HOME/public_html/blog) and run
This will show the available commands. If the file is not executable, type
chmod +x bb.sh and retry.
Before creating your first post, you may want to configure the blog settings (title, author, etc). Read the Configuration section below for more information
To create your first post, just run:
It will try to use Markdown, if installed. To force HTML:
./bb.sh post -html
The script will handle the rest.
When you're done, access the public URL for that folder (e.g.
and you should see the index file and a new page for that post!
- Ultra simple usage: Just type a post with your favorite editor and the script does the rest. No templating.
- No installation required. Download
bb.shand start blogging.
- Zero dependencies. It runs just on base utils (
- GNU/Linux, BSD and OSX compatible out of the box, no need for GNU
coreutilson a Mac. It does some magic to autodetect which command switches it needs to run depending on your system.
- All content is static. You only need shell access to a machine with a public web folder.
Tip: advanced users could mount a remote public folder via
ftpfsand run this script locally
- Allows drafts, includes a simple but clean stylesheet, generates the RSS file automatically.
- Support for tags/categories
- Everything stored in a single ~1k lines bash script, how cool is that?! ;)
Configuration is not required for a test drive, but if you plan on running your blog with bashblog, you will want to change the default titles, author names, etc, to match your own.
There are two ways to configure the blog strings:
bb.shand modify the variables in the
- Create a
.configfile with your configuration values -- useful if you don't want to touch the script and be able to update it regularly with git
The software will load the values in the script first, then overwrite them with the values in the
This means that you don't need to define all variables in the config file, only those which you need to override
from the defaults.
The format of the
.config file is just one
variablename="value" per line, just like in the
function. Please remember: quote the values, do not declare a variable with the dollar sign, do not use
spaces around the equal sign.
bashblog uses the
$EDITOR environment value to open the text editor.
- A simple but nice and readable design, with nothing but the blog posts
- NEW on 2.0 Markdown support via a third-party library.
The easiest method is to download Gruber's Markdown.pl
- Post preview
- Save posts as drafts and resume editing later
- HTML page for each post, using its title as the URL
- Configurable number of posts on the front page
- Automatic generation of an RSS file, feedburner support
- Additional page containing an index of all posts
- Automatically generates pages for each tag
- Rebuild all files while keeping the original data
- Contains its own CSS so that everything is reasonably styled by default
- Headers, footers, and in general everything that a well-structured html file needs
- Support to add extra content on top of every page (e.g. banners, images, etc)
- xhtml validation, CSS validation, RSS validation by the w3c
- Automatic backup of the site every time you post (stored as
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.