Bumble is a blogging engine a bit similar to tumblr, but with the ability to create pages and sub-blogs within those pages. It is licensed under the GPLv2 licence. Other licencing terms available on request.
First off, these docs are almost certainly not as complete and helpful as they could me. Feel free to drop me a line if you are struggling with setup or have suggestions for improving the docs.
This version of Bumble was developed against Python 3.5 and Django 1.11.
A server with Apache, Python 3 (and the ability to install Python packages) and a database. SQLite will do in a pinch. Git is a plus. We've done some installs on Webfaction, but anyplace that satisfies the above requirements will do.
python3 -m venv venv && source venv/bin/activatepip install -r requirements.txtexport DJANGO_SETTINGS_MODULE=bumble.local_settingsexport PYTHONPATH=$PYTHONPATH:<path-to-bumble-install>django-admin migrate to create the databasedjango-admin createsuperuser to create the admin, entering a username and password when prompteddjango-admin runserver to start the serverpip install -r requirements.txt."<webroot-path>/static/", e.g "/var/www/static/""<webroot-path>/static/media/", e.g "/var/www/static/media/"export DJANGO_SETTINGS_MODULE=bumble.local_settingsexport PYTHONPATH=$PYTHONPATH:<path-to-bumble-install>django-admin migrate to create the databasedjango-admin createsuperuser to create the admin, entering a username and password when promptedOnce you have set things up correctly, you should be greeted by a 404 page. This is because you haven't defined a root page. In your browser, visit <your bumble install>/admin/ to log into the admin system with the username and password you've set. Once there, create a new Entry. Fill in the title of your site, but leave the slug field blank. Also fill in the lead field to contain whatever you want to appear at the top of the site. Once you've done that, hit save, and the 404 page should change to that front page on reload.
You can now make a second entry, for example a blog post saying "I just set up Bumble!". To do this, create another Entry in the admin system. This time, the entry must have a slug, and its parent must be the front page entry you just created - otherwise it won't show up. All entries except the front page must have a slug and a parent, and the front page must have neither.
Bumble sites are a tree of Entries. An entry can be a blog post or a whole sub-site with sub-entries. Each entry has a slug which is its part of the URL. For example, an entry kittens in animals_i_like would have the URL of <your bumble install>/animals_i_like/kittens.
Since the site is a tree structure, all entries except for the front page have a parent. Top-level entries have the front page as a parent.
Each entry is displayed as a number of sections:
The descendant entries are each listed with their title and lead. Note that this means that sub-sub and sub-sub-...-sub entries of an entry are also displayed in this list. So the front page gives an account of everything that's happening on the site, whereas a sub-page will only show the sub-site news.
You can write Bumble content in HTML or in markdown, or a mixture of the two. HTML is the default, and you can enclose any markdown in triple asterisks ***.
Each entry has a CSS section which is included both in the entry and in its descendants. This means that if you want to create a sub-site out of an entry, you can radically change the styling of that entry and all entries below it will have the same styling.
There is also a "Local CSS" field for CSS that pertains only to this entry and should not percolate down.
In addition, there is a "section content" field, which contains HTML / markdown that you want included in all descendant pages. This is useful especially for Javascript snippets like Google Analytics.
You can upload files to Bumble by creating Files in the admin interface. To refer to a file in HTML or markdown, use the syntax {{f:name_of_file}}, which is automatically substituted with the full path of the file. So you can upload a file called "kittens.jpg" as "kittens" and use <img src="https://github.com/Zarkonnen/bumble/raw/master/{{f:kittens}}"> to display it.
You can create tags and add entries to them, allowing people to browse your site by tags. In HTML or markdown, use the syntax {{tagslist}} to insert a list of tags sorted by popularity.
Each bumble entry and tag page links to an appropriate RSS feed to follow that topic.
Finally, Bumble also has (somewhat rudimentary) Twitter card support. To activate this, use the Twitter Card Validator. (Note that this activation is not instantaneous nor retroactive - earlier tweets to Bumble links will not acquire Twitter cards.)