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

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

Parent Directory Parent Directory | Revision Log Revision Log


Revision 181 - (show annotations)
Tue Mar 21 16:14:16 2006 UTC (15 years, 6 months ago) by gregoa
File size: 4394 byte(s)
Load /tmp/tmp.Qx79BG/nanobloggertrackback-0.2.1 into
debian/nanobloggertrackback/branches/upstream/current.

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

  ViewVC Help
Powered by ViewVC 1.1.26