minimalist-dong/INSTALL

43 lines
1.8 KiB
Text

Unpack the archive so that index.php3 is in a directory that your web
server can see, and you preserve the directory structure of the archive.
Rename dong.conf.default to dong.conf. How's that? Oh, I'm assuming you've
got PHP working (version 3 is fine, should work with 4) first.
Edit the files in mindong/content - these are the blog entries. Read the
ones that are there first, they form the majority of the documentation right
now.
Edit mindong/sidebar/links - These are the links down the right-hand side
of the page. Just look at the file. It should be obvious.
Now turn your attention to dong.conf - the fields there should be pretty
obvious. Make your changes.
One non-obvious part of dong.conf may be the fields of the <weblog> tag.
I'm going to have to write a full DTD one day, but for now ...
<weblog name="froglog" main="true">
"name" and "main" are the only supported fields right now.
"name" is a short name for your blog content. This is used as the name of the
directory to look in for your content. In this case, 'blog entries will be
searched for in froglog/content, sidebar stuff in froglog/sidebar.
"main" indicates that this entry is the default. If you only have one
<weblog> section, you can safely omit it. If you have multiple <weblog>
sections, one of them should be nominated as default. If no entries are
default, the first entry in the file will be used when no specific content
is requested via the URL.
To specify a particular set of content, use the "name" field from the
<weblog> section in the request URL like so;
http://www.grouse.net.au/~mike/index.php3?page=personal
The above URL will look for a weblog definition with the name "personal"
and content directories as subdirectories of a "personal" directory.
That's really badly described, isn't it? Play around with it. I don't
think I've been TOO obscure.