Skip to content

Latest commit

 

History

History
84 lines (60 loc) · 2.25 KB

README.md

File metadata and controls

84 lines (60 loc) · 2.25 KB
Raw

Yuggoth

Yuggoth logo

"Yuggoth... is a strange dark orb at the very rim of our solar system... There are mighty cities on Yuggoth—great tiers of terraced towers built of black stone... The sun shines there no brighter than a star, but the beings need no light. They have other subtler senses, and put no windows in their great houses and temples..."

— H. P. Lovecraft, "The Whisperer in Darkness"

Yuggoth is a blog engine which powers my site at http://yogthos.net and allows me to experiment with using Noir.

Features

  • content caching
  • RSS feed
  • tags
  • markdown in posts and comments with preview
  • syntax highlighting using syntax highlighter
  • file uploads and management through web UI
  • custom CSS styles
  • captchas for comments
  • latest comments view
  • toggle post visibility

Usage

First, setup postgreSQL and update the configuration in src/config.clj to point to it. To enable SSL set ssl to true and optionally change the port to the one you're using, default is 443.

(def blog-config  
 {;;db config
  :host "localhost"
  :schema "blogdb"
  :user "user"
  :pass "pass"       
  
  ;;SSL config
  :ssl false
  :ssl-port 443})

The blog will automatically create the necessary tables for you. When you navigate to the blog on the first run it will present the setup wizard wich will allow you to configure the administrator and the blog title. Further configuration can be done on the profile page.

If you use cake, substitute 'lein' with 'cake' below. Everything should work fine.

lein deps
lein run

to run as standalone

lein uberjar
java -jar yuggoth-0.4.0-SNAPSHOT-standalone.jar

valid options for running standalone

  • -mode dev or prod
  • -port integer

to make a deployable WAR

lein ring uberwar

see markdown-clj for supported syntax in posts, any valid HTML will work as well

License

Distributed under the Eclipse Public License, the same as Clojure.

Copyright (C) 2012 Yogthos