Debian Codegraph @

eg/web/README

raw
1
2 This directory contains the new Embperl website.
3 It uses most of the new possibilites of Embperl 2.0b6+. To take a look at it
4 just type "make start" and then request http://localhost:8531/eg/web/ .
5
6 To get it fully working you need to have libxml installed and a database.
7 (see below for database setup).
8
9
10 Here are a few notes on the included files, to make the first orientation
11 easier:
12
13 epwebapp.pl Application object, which controls the whole execution logic
14 (the controller when you think in MVC terms)
15
16 config.pl Configuration, includeing the site structure
17 messages.pl Messages in multiple languages (currently german and english)
18 base.epl The base template for the site
19 content.epl The base template for the content part (right side) of the
20 base directory
21 header.epl The header
22 footer.epl The footer
23 menuleft.epl The menu on the left
24 menulist.epl Used by some files to display a list from the menu structure
25 notfound.htm This page is display when the user enters a unkown URL
26 index.htm Home page english
27 indexD.htm Home page german
28 pod.xsl Standard XSL stylesheet for displaying POD files
29
30 pod/* This dirtory contains the index pages for POD display
31 The actual POD files for documentation and introduction
32 are taken from the Embperl main directory, to avoid duplication
33 of files. How files are mapped to URIs is described in config.pl
34
35 db/* Database related pages, to display and add information
36 db/epwebapp.pl This application object overrides the one from the base directory
37 and adds functionality for database access.
38
39
40
41 Database setup
42 --------------
43
44 Parts of the Website are database driven, so you need a
45 database to use it. To setup a database and populate it
46 with some initial content, do the following steps:
47
48 - install DBI
49
50 - install a DBD driver for your database
51
52 - install DBIx::Recordset
53
54 - create a database called 'embperl'
55 for example:
56 - for Mysql run 'mysqladmin create embperl'
57 - on Windows goto to control panel and ODBC Manager and setup a
58 datasource called "embperl"
59
60 - to create the tables run 'perl eg/webutil/setupdb.pl'
61
62 If you don't want to name your database embperl or you need set specify a
63 user name, you can configure this at the top of eg/web/config.pl.
64