/[debian]/nanobloggertrackback/branches/upstream/current/README
ViewVC logotype

Contents of /nanobloggertrackback/branches/upstream/current/README

Parent Directory Parent Directory | Revision Log Revision Log


Revision 164 - (show annotations)
Sat Feb 25 18:13:56 2006 UTC (15 years, 6 months ago) by gregoa
File size: 4031 byte(s)
[svn-inject] Installing original source of nanobloggertrackback
1 nanobloggertrackback - adding trackback functionality to nanoblogger
2 ====================================================================
3
4 Copyright: gregor herrmann <gregor+debian@comodo.priv.at>, 2005
5 License: Released under the GNU GPL (cf. COPYING)
6
7 Purpose
8 -------
9
10 nanobloggertrackback adds active and passive trackback functionality to
11 nanoblogger, i.e. it let's the user (automatically or manually) send
12 trackback pings to referenced blog entries and receive trackback pings from
13 other sites.
14 Additionally it shows received trackbacks in the blog pages and offers the
15 possibility to delete them.
16
17 Installation
18 ------------
19
20 a) Automatic
21 ------------
22
23 nb_tb-setup should automagically copy and patch all necessary files.
24 If it breaks something: Don't get nervous, it creates a backup of your
25 $BLOG_DIR in $HOME/nb.bak.
26 It does _not_ copy the nanoblogger plugins though (they are supposed to be
27 used systemwide, and nb_tb-setup just adjust one specific blog). - See
28 below under "Manual".
29
30 b) Manual
31 ---------
32
33 * Create the following directories:
34 $BLOG_DIR/tb
35 $BLOG_DIR/tb/data
36 $BLOG_DIR/tb/rss
37 $BLOG_DIR/tb/pings
38
39 ./data and ./rss must be writeable for the user under which the webserver
40 is running!
41
42 * Change the beginning of tb.cgi:
43 Replace BLOGDIR, PASSWORD, and EMAIL with meaningful values
44
45 * Copy tb.cgi to your webserver's cgi-bin directory or somewhere else, where
46 the webserver can execute it.
47
48 * You may want to add the contents of nb_tb.css to your currently used
49 nanoblogger css file.
50
51 * Copy header.txt and footer.txt to $BLOG_DIR/tb.
52
53 * Change $BLOGDIR/templates/entry.htm
54 Use the patch in entry.diff or add the required lines manually:
55
56 | <a href="${TB_PATH}?__mode=list&amp;tb_id=$NB_EntryID" onclick="window.open(this.href, 'trackback', 'width=480,height=480,scrollbars=yes,status=yes'); return false">TrackBack</a>
57
58 e.g. between the categories and the comments line
59
60 <div class="tb">
61 $NB_TrackBacks
62 </div>
63
64 e.g. after the comments line, if you want to see the trackbacks directly
65 under each entry.
66
67 <!--
68 <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
69 xmlns:dc="http://purl.org/dc/elements/1.1/"
70 xmlns:trackback="http://madskills.com/public/xml/rss/module/trackback/">
71 <rdf:Description
72 rdf:about="${ARCHIVES_PATH}$NB_EntryPermalink"
73 dc:title="$NB_EntryTitle"
74 dc:identifier="${ARCHIVES_PATH}$NB_EntryPermalink" />
75 trackback:ping="${TB_PATH}/$NB_EntryID"
76 </rdf:RDF>
77
78 at the end of entry.htm
79
80 * In order to activate the whole stuff you have to add two lines to your
81 blog.conf:
82 TB_PATH="$CGIURL/tb.cgi"
83 where $CGIURL is the full URL to tb.cgi, e.g. http://www.example.com/cgi-bin
84 SEND_TRACKBACK_PING="1"
85 if you want nanoblogger to send trackback pings automatically to each
86 URL found in a modified entry.
87 Absolute links have to be turned on in blog.conf:
88 ABSOLUTE_LINKS="1"
89
90 * If nobody on your system has done this already: Copy trackbacklist.sh and
91 trackbackping.sh to nanobloggers plugins/entry/mod/ directory.
92
93 Usage
94 -----
95
96 a) Receiving trackback pings
97 ----------------------------
98
99 If everything is set up correctly other bloggers can send you trackback
100 pings, either manually (the trackback URL can be found now in each entry of
101 your blog) or automatically (that's what the RDF stuff in entry.htm is for).
102 You can view trackbacks from others either directly under each entry or by
103 clicking on the Trackbacks link; there you can (after logging in) also
104 delete trackbacks.
105 You are informed by a short email if someone else sends a trackback ping to
106 one of your posts.
107 (Now you know what the $PASSWORD and $EMAIL variables are for ;-).)
108
109 b) Sending trackback pings
110 --------------------------
111
112 If you want to send a trackback ping manually go to
113 $CGIURL/tb.cgi?__mode=send_form
114 If you turn on SEND_TRACKBACK_PING in blog.conf trackback pings are sent
115 automatically to each referenced URL in a modified blog entry (but only
116 once; a list is kept in $BLOG_DIR/tb/pings).

  ViewVC Help
Powered by ViewVC 1.1.26