D3E-HyperNews User Guide
HyperNews is one of the open source web discussion systems that we have customised for D3, selectable from within the D3E Publisher's Toolkit.
Please note that you need to understand web server administration to install this properly. Problems may be sent to D3E-HyperNews' developer, Mike Wright <email@example.com>, who will deal as best as he can (he has a day job!)
See the Journal of Interactive Media in Education for an example of D3E-HyperNews in use (for online journal peer review).D3E-HyperNews requirements in brief:
Software: known to run on Apache and Netscape web servers; written in Perl
Hardware Platform: Unix or Linux (it makes use of unix directory file structures; no Windows port available; see D3E-Phorum for a Windows-based web server discussion environment)
As D3E is a research project, the modifications we make are specific to our needs. Anyone who wishes to use our version may do so, but should bear in mind that some things may not work the way expected or in the way they do in the general HyperNews release. The current version is a customisation of HyperNews v1.9.5.
Before using the modified version, we advise you to review the documents held on the HyperNews site to become familiar with the general "look" of HyperNews, and with it's installation and use instructions. After that, you should look at a use in the D3E project such as the journal JIME. Go to one of the papers and select a "comment-bubble" to get to the debate section.
As part of the design of JIME, we required HyperNews to "look" and "act" in specific ways - hence our modifying HyperNews. When using HyperNews in a project similar to JIME, we strongly advise you to think what structure you want, and what the URL's to those structures should be before configuring a HyperNews installation. This will make it easier to set up a maintainable structure.
Once HyperNews is installed and being used along side a set of documents on a Web Server in a closely integrated manner, it is hard to reconfigure the integration for such things as a directory restructuring.
The details we give below on using the modified version assume you have looked over the documentation at the HyperNews home site and looked at our examples. Please read through this page before proceeding. When you get to the configuration of the modified HyperNews, the on-line configuration form has further details to help you with that stage.
You can download D3E-Hypernews (version 1.9.5) from here.
Place the source archive file into this directory and do:
We run a number of hypernews discussions. This is because we want to change the interface and some configuration details for different projects, and different projects have differing levels of access, e.g. some allow anyone to read and post discussion comments, others are restricted to groups or domains. To allow this type of configuration, one installation of HyperNews will be needed for each configuration variation required.
To run a number of HyperNews installations, we set up a common directory to hold the scripts. We then link the scripts of each hypernews installation against the common set. If you don't want to have a common directory, ignore these steps:
To use HyperNews, you access it via a URL that takes the format:
This CGI directory will also need access set up for it in the access.conf file:
<Directory /directory_path/cgi-hn>You will now need to have the web server re-load it's configuration files.
AllowOverride AuthConfig Limit
Note 1: We keep the HyperNews archive (the discussion contributions and lists of discussion members) outside the document tree of the Web Server for ease of administration and security and so don't need a configuration section for it in the Web Server configuration files.
Note 2: If you use the HyperNews installation under a "virtual server" (easily set up using the Apache Web Server,) have the virtual server running and the CGI stuff set up before configuring HyperNews (the next section.) Configure the installation of HyperNews through the virtual server you want it to work with (next section.)
The "Admin" directory is for administrators to use. It was set up by the make install process. After configuration, access to this directory will be restricted to administrators (defined in configuration.) Any "clone" installation will have the same restrictions until re-configured.
When the form is up, please read the instructions and further details to help you configure the particular version of HyperNews to your needs.
A copy of this page is included in the distribution from D3E in the .scripts directory (instructions-d3e.html).
As the modifications have included our own "buttons", these are included in the "Icons" directory of the distribution. The original HypreNews icons are available in the "Icons-HN" directory. Similarly, we have tailored icons-table-dist (the original is icons-table-dist.orig.) We have left the original distribution HTML files in place.
HyperNews is at a later version number. We don't plan to update our version to that version at present as our current version does what we need. We will monitor the state of HyperNews, and we may upgrade if time, resources and needs permit.
May 11, 1998.