/[refeed]/trunk/INSTALL.html
This is repository of my old source code which isn't updated any more. Go to git.rot13.org for current projects!
ViewVC logotype

Annotation of /trunk/INSTALL.html

Parent Directory Parent Directory | Revision Log Revision Log


Revision 2 - (hide annotations)
Wed Jul 5 00:27:49 2006 UTC (17 years, 11 months ago) by dpavlin
File MIME type: text/html
File size: 6343 byte(s)
make working copy of trunk
1 dpavlin 2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
2     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3     <html xmlns="http://www.w3.org/1999/xhtml">
4     <head>
5     <title>Reblog Installation</title>
6     <link rel="stylesheet" href="softwarestyle.css" type="text/css" />
7     </head>
8     <body>
9     <h1>Reblog Installation</h1>
10     <p>$Revision: 1.15 $</p>
11     <div id="contents">
12     <ol>
13     <li>
14     <p>
15     Copy the file <code>config.php.default</code> to <code>config.php</code>, and add your local configuration information (note: most of these settings are further documented in the <code>config.php.default</code> file).
16     </p>
17     <p>
18     <strong>Database settings:</strong>
19     </p>
20     <dl>
21     <dt><code>REBLOG_DSN</code></dt>
22     <dd>Database connection information, like <code>mysql://username:password@hostname/database</code>.
23     <br />
24     <strong>During installation</strong>, be sure that the database user you set up has <code>create</code>, <code>drop</code> and <code>alter</code> privileges on the Reblog database so that tables may be created.
25     <strong>After</strong> installation, normal use requires <code>select</code>, <code>insert</code>, <code>update</code> and <code>delete</code> privileges.</dd>
26     <dt><code>REBLOG_*_TABLE</code></dt>
27     <dd>If you want to change what your database tables are called, there are four.</dd>
28     </dl>
29     <p>
30     <strong>Other settings:</strong>
31     </p>
32     <dl>
33     <dt><code>REBLOG_TIMEZONE</code></dt>
34     <dd>Your local timezone, if different from the server's.
35     Choose a value from the collection at <a href="http://www.php.net/manual/en/timezones.php">http://www.php.net/manual/en/timezones.php</a>.</dd>
36     <dt><code>REBLOG_USE_KEYBOARD</code></dt>
37     <dd>Yes/no: Use the keyboard-sensitive navigation and functionality?</dd>
38     <dt><code>REBLOG_AUTH_TYPE</code></dt>
39     <dd>How do we authenticate the user, and manage user accounts
40     (values = <code>RF</code> or <code>MT</code> or <code>WP</code>).
41     See <a href="ACCOUNTS.html">ACCOUNTS.html</a> for more info, but if you just want one
42     user you can leave the default <code>RF</code> and forget about it.</dd>
43     <dt><code>REBLOG_HTTPAUTH_NAME</code>, <code>REBLOG_HTTPAUTH_PASS</code></dt>
44     <dd>User name and password for HTTP authentication.
45     If set, you will be prompted forthis information when you attempt to use the parts of Reblog that change the database.</dd>
46     <dt><code>REBLOG_AUTHOR_NAME</code></dt>
47     <dd>Author name for your outgoing feed.</dd>
48     <dt><code>REBLOG_FEED_TITLE</code></dt>
49     <dd>Title of your outgoing feed.</dd>
50     <dt><code>REBLOG_FEED_DESCRIPTION</code></dt>
51     <dd>Description of your outgoing feed.</dd>
52     <dt><code>REBLOG_LINK_NEW_WINDOWS</code></dt>
53     <dd>Yes/no: should links open in new windows?</dd>
54     <dt><code>REBLOG_HOWMANY</code></dt>
55     <dd>Number of items to show in a listing, by default.</dd>
56     <dt><code>REBLOG_KEEP_DAYS</code></dt>
57     <dd>Number of days to keep items. Archived items older than this are pruned.</dd>
58     <dt><code>REBLOG_KEEP_UNREAD</code></dt>
59     <dd>Yes/no: Also prune unread items after <code>REBLOG_KEEP_DAYS</code> days.</dd>
60     <dt><code>REBLOG_GUID_PREFIX</code></dt>
61     <dd>Globally unique identifying prefix for items in your outgoing feed. If you don't know what this is, odds are you don't need to change it.</dd>
62     <dt><code>REBLOG_ADMIN_FEEDS</code></dt>
63     <dd>Yes/no: Is the user allowed to modify the feeds list?</dd>
64     <dt><code>REBLOG_UPDATE_FEEDS</code></dt>
65     <dd>Yes/no: Is the user allowed to update the feeds?</dd>
66     <dt><code>REBLOG_POST_NEW</code></dt>
67     <dd>Yes/no: Is the user allowed to post new items?</dd>
68     </dl>
69     </li>
70     <li>
71     <p>
72     Upload the entire tree to wherever on your server you want Reblog to live.
73     </p>
74     </li>
75     <li>
76     <p>
77     Create a directory called <code>cache</code> inside your Reblog directory, and make it world-writeable (<code>chmod a+rwX cache</code>).
78     </p>
79     </li>
80     <li>
81     <p>
82     Load the page <code>http://{your server}/{wherever you put Reblog}/install.php</code>. The installer will first check that it can connect to your DB, and then attempt to create your database tables.
83     </p>
84     </li>
85     <li>
86     <p>
87     Play around and figure out how it works. It's pretty straightforward. Or see the <a href="guide/index.html">Users' Guide</a>.
88     </p>
89     </li>
90     <li>
91     <p>
92     Optionally setup a <a href="http://en.wikipedia.org/wiki/Crontab">cron job</a> to perform feed updates on your behalf. Add a call to <code>GET</code>, <code>wget</code> or <code>curl</code> to your crontab, and have it request <code>http://{your server}/{wherever you put Reblog}/update-quiet.php</code>.
93     </p>
94     <p>
95     Example:
96     </p>
97     <p>
98     <code>
99     # Update all feeds once per hour
100     <br />
101     0 * * * * /usr/bin/curl -I "http://example.com/reblog/update-quiet.php"
102     </code>
103     </p>
104     </li>
105     </ol>
106     </div>
107     </body>
108     </html>

  ViewVC Help
Powered by ViewVC 1.1.26