xref: The Static Version
(Which of course assumes you are the Webmaster of example.com and you placed
backend, who don't have access to install a script in your
cgi-bin, have a relatively
small list of targeted terms (that doesn't change often, if at all), or simply don't want or
need the extended features of the dynamic version of xref will choose to use
this static version. You can tailor a custom, static version of xref for use
on your site here. To create the script, you'll need to know which
terms you want to link to (including the URL you will link to, as well as a brief description
of the term, if you wish); as well as which options you want to invoke within the script. You
can then provide the details to our custom xref script builder,
which will generate the script according to your needs. We'll examine each of the available
options a little later in this article; but if the documentation bores you, feel free to
play with the script maker now.
xref: The Dynamic Version
Note that in this case, we've pointed to the
xref.js in our
in the static version:
We'll discuss the available parameters and their meanings on the next page. Though many of these parameters are also available for use when building the static version of the script, once that script is actually generated it will always use those features; no matter where (what page) it's called from. The dynamic version of the script instead allows you to vary the parameters on each page you install the script on, if necessary (this feature is especially helpful to affiliates, who may need to tweak the script slightly to avoid conflicts with other page constructs on their sites).
Dynamic Selection of Terms: With the dynamic version of the script, you have the potential ability to dynamically retrieve the terms that you will target for automatic linking. Since the script is in fact a Perl script running on your Web server, you can pull the terms from any location that Perl has access to; perhaps an XML file, or even a live database. You're limited only by your knowledge of Perl!
We mentioned above that several parameters are available to help you control what xref does and how it does it. On the next page, we examine these parameters in detail.