Rethoth 0.4.2 (2017)
Rehoth is a simple to understand, run and maintain Ruby blogging engine
Rethoth (previously known as Thoth) is written in Ruby and is based on the Ramaze web framework and the Sequel database toolkit. Rethoth 0.4.x is a modern port, to 2017, of the original Thoth created by @ryangrove.
Try Rethoth now!
For a quick start using SQLite3 as a database:
gem install rethoth
gem install sqlite3
thoth --create test_project
cd test_project
thoth --migrate
thoth
Then, point your browser to http://localhost:7000/admin and use 'thoth' as your username and password.
If you want to run or migrate in development mode use the --devel
switch
e.g.,
thoth --devel --migrate
thoth --devel
Note that the name of the executable is still thoth
.
Why Rethoth?
Simple
The purpose of Rethoth is to be a simple to understand, run and maintain blogging engine
See the Wiki
Fully featured
Rethoth has the features you need to run a blog without the hassle:
- Textile format support.
- Pages and blog post URL names can be specified by the author.
- You can upload files and link to them from sensible URLs.
- Post and pages can be previewed.
- Posts and pages can be saved as draft.
- Page and post names are automatically validated for uniqueness.
- Tags are supported.
- Tags are suggested as you type when creating or editing a blog post.
- Tag statistics are supported.
- Blog posts provide Atom feeds for recent comments.
- Tag pages provide Atom feeds for posts with that tag.
- Comments can be enabled/disabled per post.
- New comments require an email address.
- Deleted comments remain in the database but are hidden from view
- Comments are sanitised for safe HTML.
- Multiple comments may be deleted at once.
- Gravatar support.
- Flickr plugin.
- Delicious plugin.
- Memcache support.
- Minification of CSS and JS files.
- All admin forms validate a session-specific form token on submission to prevent cross-site request forgery attacks.
- Auto-generates an XML sitemap at http://yourblog.com/sitemap.
Educational
Rethoth demonstrates how to easily build a useful MVC-style app in Ruby without having to deal directly with meta-programming and DSL magic.
No Rails needed
Rethoth is an example of how to build a web application in Ruby without the need to learn Rails and ActiveRecord.
Feels very familiar to non-Rubyists
Rethoth is also ideal for newcomers to Ruby who have experience with other web frameworks and want to quickly appreciate the language and become productive with it.
Installation
gem install rethoth
Rethoth depends on:
- Ruby >= 2.3.0
- Ramaze 2012.12.08
- Innate 2015.10.28
- Sequel >=4.42.0
- Rake 12.0.0
You will also have to install a database driver such as sqlite3 or mysql2. e.g.,
gem install sqlite3
Rethoth for developers
Building the gem
rake install
Customizing Rethoth
See the Wiki pages
API Reference
TBD
Tests
TBD
Describe and show how to run the tests with code examples.
Contributors
Thoth was resurrected, updated and brought to 2017 by John Pagonis (@pagojo). It was originally developed between 2008 and 2012 by Ryan Grove (@rgrove). Thank you Ryan! Steven Bedrick (@stevenbedrick) has also contributed.
We had to rename the project to Rethoth due to project name clashes on the Rubygems site.
History
This file was created by John Pagonis (@pagojo).
You can read more about Thoth's 2008--2012 history here.
License
Rethoth uses the 'BSD 3 Clause' licence.
Rethoth uses icons from the gorgeous Silk icon set by famfamfam, which is licensed under the Creative Commons Attribution 2.5 license.