ftw_new_app - create a new File::Tabular::Web application
cp some/data.txt /path/to/http/htdocs/some/data.txt perl ftw_new_app.pl -m field1 -m field2 -e \ -f "|" /path/to/http/htdocs/some/data.txt
This script creates a skeleton for a Web application around a tabular datafile. The concepts and basic setup instructions are described in File::Tabular::Web. After having created the skeleton, you can navigate to URL
The script will create the following files, in the same directory as the data file :
The application configuration file (also used as URL).
General wrapper template for the application, including the search form.
Template for displaying result sets (short display of each record).
Template for displaying detailed view of a single record.
HTML form for modifying a record.
Template for displaying a message (for example confirmation of an update operation).
All templates may be later be moved out of the
htdocs tree, to a more appropriate location : you just have to specify the new location in the configuration file (
dir variable in the
Options may be abbreviated to the first letter, i.e.
-m field1 -f "|"
-menu field1 -fieldSep "|"
Help to using this script.
For each specified field, will inspect all values currently in the data file, and creates an simple menu, like a spreadsheet "automatic filter". However, this is currently merely static, so if the data changes, menus will not be updated accordingly --- it will improve in a future release.
Specifies which character is the field separator in the data file. Default is
Forces creation of the files, overriding previous files of the same names.
Writes into the configuration file that the data is editable by the specified usernames. Usernames must correspond to names returned by your Apache authentication layer. If no username is given, the default value is
*, which means "editable by all".