NP_TrackBack/branches/DOM-branch/trackback/help.html

   1 <h2>Help</h2>
   2
   3
   4 <h3>Skin variables</h3>
   5
   6 <p>
   7         <code>&lt;%TrackBack(list)%&gt;</code>
   8 </p>
   9 <p>
  10         Show a list of trackbacks for the current page. Optionally it is also possible to
  11         add an additional parameter, the story id number, which makes it possible to
  12         show a list of trackbacks from a different page. The output of this variable is
  13         fully configurable in the plugin options.
  14 </p>
  15
  16 <p>
  17         <code>&lt;%TrackBack(code)%&gt;</code>
  18 </p>
  19 <p>
  20         Inserts a small piece of invisible RDF code in the page, which is used by other
  21         weblogs to auto-detect the trackback URL. If you do not include this variable in
  22         your skin for item pages, other weblogs will not be able to auto-detect that your
  23         weblog is able to accept trackbacks.
  24 </p>
  25
  26 <p>
  27         <code>&lt;%TrackBack(form)%&gt;</code>
  28 </p>
  29 <p>
  30         Insert the URL to a manual ping form. Using this form authors of other weblogs
  31         can add trackbacks to your stories, even when their software does not support
  32         trackbacks, such as Blogger. A link to this form is included in the footer of
  33         the trackback list by default. If you want to place this link somewhere else
  34         on your page, simply remove the <code>&lt;%form%&gt;</code> variable from the
  35         <em>Footer</em> field in the plugin settings and add the skinvar somewhere on
  36         your webpage.
  37 </p>
  38
  39 <p>
  40         <code>&lt;%TrackBack(url)%&gt;</code>
  41 </p>
  42 <p>
  43         Insert the Trackback Ping URL. A this URL is also included in the footer of
  44         the trackback list by default. If you want to place this link somewhere else
  45         on your page, simply remove the <code>&lt;%action%&gt;</code> variable from the
  46         <em>Footer</em> field in the plugin settings and add the skinvar somewhere on
  47         your webpage.
  48 </p>
  49
  50 <h3>Template variables</h3>
  51
  52 <p>
  53         All the skin variables documented above are also available as template variables.
  54 </p>
  55
  56 <p>
  57         <code>&lt;%TrackBack(count)%&gt;</code>
  58 </p>
  59 <p>
  60         If you want to include an indication of how many trackbacks are present for each
  61         page you can use this variable. By default this variable will show: "No Trackbacks",
  62         "1 Trackback", "2 Trackbacks", etc. This is however also fully configurable in
  63         the plugin options.
  64 </p>
  65
  66
  67 <h3>Changing the output</h3>
  68
  69 <p>
  70         It is possible to fully change the output of this plugin. You can manually change
  71         the XHTML code in the plugin options, but you can also use CSS to style the default
  72         output to your liking. Below you will find an example of what a little snippet of
  73         CSS can do.
  74 </p>
  75
  76 <pre>div.tb {
  77         border: 1px solid #000; background: #FFF;
  78 }
  79 div.tb div.head {
  80         padding: 4px;
  81         background: #000; color: #FFF;
  82         font-weight: bold; text-transform: lowercase; letter-spacing: 0.6em;
  83 }
  84 div.tb div.empty {
  85         padding: 4px;
  86         font-size: 95%;
  87 }
  88 div.tb div.item {
  89         padding: 4px;
  90 }
  91 div.tb div.item div.name {
  92         margin-bottom: 8px;
  93         font-size: 120%; font-weight: bold;
  94 }
  95 div.tb div.item div.body {
  96         font-size: 95%;
  97 }
  98 div.tb div.item div.body a {
  99         font-weight: bold;
 100 }
 101 div.tb div.item div.date {
 102         margin-bottom: 8px;
 103         color: #888;
 104         font-size: 85%; text-align: right;
 105 }
 106 div.tb div.info {
 107         padding: 4px;
 108         color: #FFF; background: #888;
 109         font-size: 85%; font-style: italic;
 110 }</pre>
 111