The ListGarden program is written in the Perl computer language. In order to run, it requires a copy of the Perl language system which is usually installed on computers running Mac OS X. This page tells you how to run it as a normal Perl program under OS X. You run it using the Terminal program that gives access to a Unix "shell" window. This method of operation is oriented towards users with technical experience who are comfortable downloading a program file and running programs from the command line in the Terminal program. It only requires minimal experience with Unix.
Once started, you interact with the program through a web browser.
The system requirements are: Mac OS X version 10.3 (it may run on other versions, but these instructions only cover 10.3), Apple Safari web browser or equivalent (Internet Explorer sometimes has problems), Internet connection if uploading by FTP, 200KB+ disk space, Perl language system that includes the library modules: LWP::UserAgent, Net::FTP, and Time::Local (see below for installing the packages).
Follow these instructions to install and run this version:
- Make sure that you have Perl and that you have the correct packages installed.
See Mac OS X 10.3 Setup page for step-by-step instructions.
Once you have Perl installed, then you can run Perl programs from the command line in a Terminal program window by executing "perl programname" (or just by executing the ".pl" program directly if the file permissions include "execute").
- Download and install the Generic Perl Version of ListGarden.
Follow the instructions for "local execution".
Run the program in a Terminal window. Access with Safari or a similar browser.
There are known problems with Internet Explorer on the Mac. Sometimes it will stop when accessing the local HTTP serving done by ListGarden, displaying an error such as "The attempt to load 'Accessing URL: http://127.0.0.1:6555' failed." You can dismiss the error message with "OK" and click again on the button or link that brought up the error to continue.
If the program displays an error message in the Terminal window when run complaining about a missing module, such as LWP, or LWP::UserAgent, see the Mac Perl Setup page for documentation about getting the correct Perl packages.
To make it easier to run the program, you can create a shell script to execute it and invoke that. For example, the script could contain:
cd directory with program and files perl listgarden.pl
Run the script by double-clicking on it or set it up to run whenever you restart the computer (for example, by having the script in your System Preferences / Accounts / Startup Items list).
To uninstall the program:
- Delete the files you downloaded and extracted.
Documentation is listed on the Documentation page.
A detailed tutorial about how to add an RSS feed to a business or organization website is in "Adding an RSS feed to a normal website".
A detailed tutorial about how to use ListGarden for podcasting is in "Setting Up an RSS Feed for Podcasting Using ListGarden".
Using ListGarden for a simple online list, and customizing the HTML file, is described in "Example Of A Simple Online List".