README
1# Last modified: 2008-09-11T22:14:32-04:00
2
3NanoBlogger is a small weblog engine written in Bash for the command
4line. It uses common UNIX tools such as cat, grep, and sed to create
5static HTML content.
6
7Installing NanoBlogger
8----------------------
9
101. download gzipped tarball:
11 http://nanoblogger.sourceforge.net/downloads/nanoblogger-xx.tar.gz
122. decompress gzipped tarball: tar xzf nanoblogger-xx.tar.gz
133. Modify shell's path to include the installation path.[1]
14
15 NOTE: this step will be taken care for you when you install through a
16 package manager, like apt-get.
17
18Generic Upgrade Instructions
19----------------------------
20
21Follow these three steps:
22
231. create a new weblog directory using nanoblogger (skip the
24 configuration):
25 nb --interactive 0 -b [new-blog-dir] add weblog
26
272. copy the old data directory over to the new weblog directory:
28 cp -r [old-blog-dir]/data [new-blog-dir]
29
303. edit the new blog.conf to your likings and rebuild
31 the weblog:
32 nb -b [new-blog-dir] configure update all
33
34Upgrade Notes
35-------------
36
37### Style Sheets & Templates ###
38
39In addition to your *old* data directory, you will probably want to also
40copy over your styles and templates directory. If you decide to do this,
41you may find that your style sheets or templates no longer work as
42expected. In which case some adjustments will have to be made before
43they work properly with the new version. A side-by-side comparison
44between the old and new version will be your best recourse. Consider
45this a small trade-off for the ability to fully customize the weblog's
46appearance.
47
48### Configuration ###
49
50Similarly, you will probably want to keep many settings from your old
51blog.conf. In which case, I suggest you do a side-by-side comparison of
52your old blog.conf and the new blog.conf. Then manually migrate your
53settings over to the new blog.conf.
54
55### Plugins ###
56
57If you created your own plugins, please take into account any changes to
58variables, settings, etc., that your plugins may depend on.
59
60Final Notes
61-----------
62
63For more in depth documentation please see the
64[NanoBlogger User Manual](nanoblogger.html) which should've been
65included with your copy of NanoBlogger.
66
67Project Page: http://nanoblogger.sourceforge.net
68Mailing List: http://groups.yahoo.com/group/nanoblogger
69