ext-blog

https://github.com/kevinlynx/ext-blog.git

git clone 'https://github.com/kevinlynx/ext-blog.git'

(ql:quickload :ext-blog)

---

ext-blog 0.9.1 1.9.2012 updated

ABOUT

ext-blog is a common lisp blog engine. It supports custom theme and you can port a WordPress theme for it.

A sample ext-blog powered website can be found at my personal blog site:

http://codemacro.com

FEATURES

• Basic blog engine features including: post an entry, display an entry, post a comment
• Support admin manage page so that you can manage your blog online
• Support custom themes
• Support RSS feed, only full export
• Support metaweblog API, only post/edit new entry
• Some basic themes ported by author

The more is coming.

LICENSE

See doc/LICENSE

PLATFORMS

ext-blog do not use any compiler specific APIs, so it can run in most Common Lisp compilers in theory. But it still need to test. Currently ext-blog has been tested on those compilers:

• SBCL
• Clozure CL

These compilers are not well tested now:

• ABCL
• Allegro CL
• CLISP, I have tried this compiler, but failed with hunchentoot:start which hangs the interpreter. After some google, I suppose it's because of CLISP thread support.
• CMUCL, some dependent libraries can not be compiled, i.e, parenscript
• ECL
• LispWorks
• Scieneer CL

INSTALL

You can use quicklisp to install ext-blog now (since 1.7.2012). So you can install ext-blog by :

(ql:quickload 'ext-blog)

After that, you can run ext-blog now, i.e:

(ext-blog:start)

ext-blog will launch a web server using hunchentoot at port 8080. So you can visit it to test:

http://localhost:8080

If you're the first time to run ext-blog, there's no data files for your blog, so you will be redirected to initializing page to setup your blog. The setup page only needs admin user name and password.

After that, everytime you want to launch ext-blog, you can only load it in SBCL and start it, i.e:

(ql:quickload 'ext-blog)
(ext-blog:start)

NOTE: if you install ext-blog by quicklisp, it maybe not the latest version, so something will no work described in this document. You can get the latest version from Github.

Configuration

ext-blog has some path relative configuration like data store path, log path etc. You can config these path by modifying src/specials.lisp.

In src/specials.lisp:

data-root: The root path for all data files, the default is currently path where you launched lisp compiler. entry-static-path: Store the uploaded images by metaweblog API. store-path: Store the blog data like posts, comments etc. font-path: the font file used to generate verify picture. log-path: The log file path. enable-log: t or nil, to enable/disable log.

Reporting Bugs

ext-blog is not well tested currently. If you find any bug or problems you can send me an email, and I will try to help you out. Feel free to send email to me kevinlynx at gmail dot com.

FAQ

1. The font in verify code picuture is too small?

You can find a pcf font file make the font much more bigger. Just put the font file in ./font and named it wenquanyi_12ptb.pcf. You can download this font file from: https://github.com/kevinlynx/ext-blog-data/blob/master/font/wenquanyi_12ptb.pcf

1. When I visit localhost:8080 I got an error something like:

Recursive lock attempt #S(SB-THREAD:MUTEX :NAME “global-message-log-lock” :%OWNER #<SB-THREAD:THREAD “hunchentoot-worker-127.0.0.1:58031” RUNNING {B166361}> :STATE 1).

Actually this is a misleading error message. Just rm log and store directory in your data-root path which default in your current path.