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
|
Pyblosxom configuration
---------------------------------------------------------------------------
Using .htaccess
(taken from pyblosxom INSTALL documentation)
Using .htaccess allows you to customise your installation so that your
URL will not look like this:
http://www.example.com/cgi-bin/pyblosxom.cgi
This does not make the site url easily accessible. You might want to
access your site with URLs like:
http://www.example.com/blog
Which looks nicer for people to type it. If you are allowed .htaccess
modifications by your hosting provider, and they allow Options
overriding, this is what you can do with your PyBlosxom installation.
Rename pyblosxom.cgi to blog (ensure that pyblosxom.cgi works first in
your normal installation).
Add these lines to your .htaccess file:
Options ExecCGI
<Files blog>
ForceType application/cgi-script
SetHandler cgi-script
</Files>
This will ensure that blog will be executed instead of viewed with
text/plain.
If you want to access blosxom as your main page, without even
accessing the /blog url, you can point blog to a directory index. This
will allow you to access your blog as:
http://www.example.com
Your blog will work as per normal. For this type of installation to
work, you need to add one more line in your .htaccess:
DirectoryIndex blog
Installing pyblosxom for single user with own configuration file
-----------------------------------------------------------------
1. Copy /usr/lib/cgi-bin/pyblosxom.cgi and /etc/pyblosxom/config.py to
your cgi-bin directory.
2. Open config.py in your favorite text editor, the config file should
be self documenting, but make shure that the datadir property is the
full path to where you will store your blog entries.
3. Test the installation by running ./pyblosxom.cgi on the commandline.
4. Open up a text file in your datadir called firstpost.txt and write
something and save. Now test the url
Personalizing/Customizing PyBlosxom
------------------------------------
After all that works you'll want to customize your blog:
1. copy flavour templates from contrib/flavour_examples into your datadir
and edit them to your liking
2. create a plugins directory to hold your PyBlosxom plugins
3. add the new plugins directory to the plugin_dirs property in your
config.py file
4. copy plugins from contrib/plugins into your plugins directory
5. for each plugin
1. open up the plugin file in any text editor and read the top of
the file
2. configure the plugin according to the directions you see there
3. add the plugin to the load_plugins property in your config.py file
6. run ./pyblosxom.cgi to verify the installation and configuration of
your blog and plugins
Plugins
-------
The contributed plugins is found in /usr/share/pyblosxom/contrib/
You can find additional plugins in the PyBlosxom plugin registry on the
http://www.planetpyblosxom.org/ site.
-- Fredrik Steen <stone@debian.org>
|
