Current version: 2.0
These pages are currently being rewritten pending the release of NextPage 2.0
Some parts of this text may apply to previous versions of NextPage and not the current version.
.
User's Guide - Table of Contents

Before using NextPage

This page discusses the next items:

1. Requirements

  • NextPage is 'platform independent' in that it works on at least the Windows and UNIX/Linux platforms
  • 300KB of free space
  • Perl 5 installed on your server
  • A cookie & JavaScript enabled web browser: although this might be any browser NextPage is known to currently only work really well with Internet Explorer 4,5 and 6. [note 1] (This is due to the fact that NextPage was developed using IE rather then it being a choice. Future versions of NextPage should be fully cross-browser)

2. Downloading NextPage

NextPage comes as a zip file (??KB approx) containing all necessary files + this manual. 
You can download it here

3. Installing NextPage

After having downloaded the .zip file, extract it using an appropriate extracting tool (WinZip for instance).

Our first goal now is to run nextpage/setup.pl.
setup.pl provides all .pl files with the proper shebang and chmod them. Next setup.pl will optionally chmod some directories and provide the data directory with an .htaccess file.

Depending on the operating system your server is running on, you may have to modify the shebang line within nextpage/setup.pl.[note 2]
If you know where Perl exists on your server, make sure the shebang matches this path. If you don't know where Perl exists on your server, find it out. (on Windows it's typically 'c:\perl\bin\perl'. On Unix/Linux like systems it's often '/usr/bin/perl' or '/usr/local/bin/perl'.

Paste or upload the complete 'nextpage' directory to any place under your server's document root. (If Perl is not installed on your server you can download it here (Unix/Linux and others) or here (Windows).)

Chmod (if necessary on your server) nextpage/setup.pl. (probably to 775) setup.pl should now be ready to be run.

4. Running setup.pl



Browse to http://your.domain.com/path/nextpage/program/pl/admin.pl
If everything goes accordinng to plan, you should now be prompted for a user name and password. NextPage comes with a default user account with user name 'nextpage' and password 'secret'. Entering these should take you to the 'administration' window from where you can navigate further through the interface.

Important: you should change at least the default password as soon as possible!
(User management >> choose user 'nextpage' >> enter new password >> click 'submit changes')

In case any of these steps lead to problems while you read the 'Installing NextPage' section carefully, it's probably time to go to the Troubleshooting page.

Notes

note 1: Browser incompatibility
Netscape 4 & 6 render the interface's layout in a terrible way while Opera (which also renders the HTML badly) appears to have problems processing some of the JavaScripts snippets NextPage uses.

note 2: shebang
The shebang is the very first line in a Perl script. It tells the server where it can find Perl.  It's required on systems such as Unix and Linux but there are also Windows servers that require it.
A shebang looks something like: 
            #!/usr/bin/perl 
or  
            #!c:\perl\bin\perl

In the first case perl.exe is in the directory '/usr/bin' (a typical Unix like path) while in the secind case (more likely on a Windows machine) perl.exe is in the directory 'c:\perl\bin'.

Note: you must not indent the shebang within Perl scripts!


This page was generated using NextPage 2.0   Edit
User's Guide - Home

Downloading NextPage

Pending NextPage 2.0
Last modified: Saturday, August 10 2002

SourceForge Logo