-
Notifications
You must be signed in to change notification settings - Fork 21
/
Copy pathREADME
120 lines (82 loc) · 3.55 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
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
2. 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.