richter 00/02/11 14:33:41
Modified: . Changes.pod Embperl.pm Embperl.pod EmbperlObject.pm
Features.pod FeaturesD.pod README TODO
Embperl Mail.pm Module.pm
emacs embperl.el
Log:
- Doc updates
- 1.3b2 beta release
Revision Changes Path
1.101 +6 -5 embperl/Changes.pod
Index: Changes.pod
===================================================================
RCS file: /home/cvs/embperl/Changes.pod,v
retrieving revision 1.100
retrieving revision 1.101
diff -u -r1.100 -r1.101
--- Changes.pod 2000/01/20 20:32:10 1.100
+++ Changes.pod 2000/02/11 22:33:38 1.101
@@ -1,14 +1,15 @@
=pod
-=head1 1.3b1/1.3b2 -- That's what currently under developement
+=head1 1.3b2 (BETA) 11. Feb 2000
- Last Update: <$localtime$> (MET)
-
- NOTE: This version is only available via L<"CVS"|CVS/"INTRO">
-
- added new mod_perl handler EmbperlObject, which helps to build whole
pages out of small objects, which can be overwritten in "derived"
pages.
+ EmbperlObject allows you to define the standard layout of your site just
+ once and includes the neccessary components based on the uri. Your HTML
+ documents just have to contain the unique stuff and not the common stuff
+ like headers/footers or navigation bars. Also these common elements can
+ be overwritten in each subdirectory.
- added EMBPERL_PATH (and path parameter to Execute), which can contain
a colon separated search path. Embperl uses it when a file, which does
not contain a path, is executed.
1.81 +3 -2 embperl/Embperl.pm
Index: Embperl.pm
===================================================================
RCS file: /home/cvs/embperl/Embperl.pm,v
retrieving revision 1.80
retrieving revision 1.81
diff -u -r1.80 -r1.81
--- Embperl.pm 2000/01/25 05:36:53 1.80
+++ Embperl.pm 2000/02/11 22:33:38 1.81
@@ -10,7 +10,7 @@
# IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
# WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
#
-# $Id: Embperl.pm,v 1.80 2000/01/25 05:36:53 richter Exp $
+# $Id: Embperl.pm,v 1.81 2000/02/11 22:33:38 richter Exp $
#
###################################################################################
@@ -77,7 +77,7 @@
@ISA = qw(Exporter DynaLoader);
-$VERSION = '1.3b2_dev';
+$VERSION = '1.3b2';
# HTML::Embperl cannot be bootstrapped in nonlazy mode except
@@ -1175,6 +1175,7 @@
$req{'uri'} = $req_rec -> Apache::uri ;
+ #warn "1 uri = $req{'uri'}\n" ;
if (exists $ENV{EMBPERL_FILESMATCH} &&
!($req{'uri'} =~ m{$ENV{EMBPERL_FILESMATCH}}))
{
@@ -1186,7 +1187,7 @@
$req{'inputfile'} = $ENV{PATH_TRANSLATED} = $req_rec -> filename ;
- #print LOG "i = $req{'inputfile'}\n" ;
+ #warn "ok inputfile = $req{'inputfile'}\n" ;
$req{'cleanup'} = -1 if (($req{'options'} & optDisableVarCleanup)) ;
$req{'options'} |= optSendHttpHeader ;
1.41 +10 -2 embperl/Embperl.pod
Index: Embperl.pod
===================================================================
RCS file: /home/cvs/embperl/Embperl.pod,v
retrieving revision 1.40
retrieving revision 1.41
diff -u -r1.40 -r1.41
--- Embperl.pod 2000/01/06 08:32:59 1.40
+++ Embperl.pod 2000/02/11 22:33:39 1.41
@@ -156,9 +156,13 @@
B<NOTE>: When mod_perl is compiled as loadable module (i.e. with USE_DSO) you
B<must not> load Embperl at server startup time!
+B<See also>: L<"perldoc EmbperlObject"|"EmbperlObject.pod"> to see how to setup
I<Embperl> in a way to
+create your site out of small overwriteable objects.
+
=head2 By calling HTML::Embperl::Execute (\%param)
+
Execute can be used to call Embperl from your own modules/scripts (for example
from a Apache::Registry or CGI script) or from within another Embperl page (only
1.2b1
or higher) to nest multiple Embperl pages (for example to store a common header or
@@ -172,6 +176,10 @@
(See B<eg/x/Excute.pl> for more detailed examples)
+B<See also>: L<"perldoc EmbperlObject"|"EmbperlObject.pod"> to see how to setup
I<Embperl> in a way to
+create your site out of small overwriteable objects and L<"perldoc
HTML::Embperl::Mail"|"Mail.pod"> how
+to use I<Embperl> to send email.
+
Execute($filename, $p1, $p2, $pn) ;
@@ -1066,7 +1074,7 @@
[- $a=1 -] Set the variable $a to one.
No output will be generated.
- [- use SomeModule -] You can use other modules.
+ [- use SomeModule ; -] You can use other modules. NOTE the semikolon!
[- $i=0; while ($i<5) {$i++} -] Even more complex
statements or multiple
@@ -1089,7 +1097,7 @@
=head2 [* Perl code *]
-(only version 1.2b2 or higher)
+(only version 1.2b2 or higher) B<EXPERIMENTAL!>
This is similar to [- Perl Code -], the main difference is, while [- Perl Code -],
has
always it's own scope, all [* Perl code *] blocks runs in the same scope.
1.5 +114 -2 embperl/EmbperlObject.pm
Index: EmbperlObject.pm
===================================================================
RCS file: /home/cvs/embperl/EmbperlObject.pm,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- EmbperlObject.pm 2000/01/25 05:36:54 1.4
+++ EmbperlObject.pm 2000/02/11 22:33:39 1.5
@@ -10,7 +10,7 @@
# IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
# WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
#
-# $Id: EmbperlObject.pm,v 1.4 2000/01/25 05:36:54 richter Exp $
+# $Id: EmbperlObject.pm,v 1.5 2000/02/11 22:33:39 richter Exp $
#
###################################################################################
@@ -159,6 +159,7 @@
}
+ $r -> log_error ("EmbperlObject searched '$searchpath'" . ($addpath?" and
'$addpath' ":'')) ;
return &NOT_FOUND ;
}
@@ -176,7 +177,7 @@
<Location /foo>
- PerlSetEnv EMBPERL_OBJECT_BASE bar.htm
+ PerlSetEnv EMBPERL_OBJECT_BASE base.htm
PerlSetEnv EMBPERL_FILESMATCH "\.htm.?|\.epl$"
SetHandler perl-script
PerlHandler HTML::EmbperlObject
@@ -199,7 +200,7 @@
This frame page can now include other pages, using the C<HTML::Embperl::Execute>
method.
Because the search path is set by I<EmbperlObject> the included files are searched
in
-the directories starting at the directory of the original request walking thru the
directory
+the directories starting at the directory of the original request walking up thru
the directory
which contains the base page. This means that you can have common files, like
header, footer etc.
in the base directory and override them as necessary in the subdirectory.
@@ -232,6 +233,117 @@
Additional directories where to search for pages
+
+=head1 Example
+
+
+With the following setup:
+
+
+ <Location /foo>
+ PerlSetEnv EMBPERL_OBJECT_BASE base.htm
+ PerlSetEnv EMBPERL_FILESMATCH "\.htm.?|\.epl$"
+ SetHandler perl-script
+ PerlHandler HTML::EmbperlObject
+ Options ExecCGI
+ </Location>
+
+
+B<Directory Layout:>
+
+ /foo/base.htm
+ /foo/head.htm
+ /foo/foot.htm
+ /foo/page1.htm
+ /foo/sub/head.htm
+ /foo/sub/page2.htm
+
+B</foo/base.htm:>
+
+ <html>
+ <head>
+ <title>Example</title>
+ </head>
+ <body>
+ [- Execute ('head.htm') -]
+ [- Execute ('*') -]
+ [- Execute ('foot.htm') -]
+ </body>
+ </html>
+
+B</foo/head.htm:>
+
+ <h1>head from foo</h1>
+
+B</foo/sub/head.htm:>
+
+ <h1>another head from sub</h1>
+
+B</foo/foot.htm:>
+
+ <hr> Footer <hr>
+
+
+B</foo/page1.htm:>
+
+ PAGE 1
+
+B</foo/sub/page2.htm:>
+
+ PAGE 2
+
+B</foo/sub/index.htm:>
+
+ Index of /foo/sub
+
+
+
+If you now request B<http://host/foo/page1.htm> you will get the following page
+
+
+ <html>
+ <head>
+ <title>Example</title>
+ </head>
+ <body>
+ <h1>head from foo</h1>
+ PAGE 1
+ <hr> Footer <hr>
+ </body>
+ </html>
+
+
+If you now request B<http://host/foo/sub/page2.htm> you will get the following page
+
+
+ <html>
+ <head>
+ <title>Example</title>
+ </head>
+ <body>
+ <h1>another head from sub</h1>
+ PAGE 2
+ <hr> Footer <hr>
+ </body>
+ </html>
+
+
+If you now request B<http://host/foo/sub/> you will get the following page
+
+
+ <html>
+ <head>
+ <title>Example</title>
+ </head>
+ <body>
+ <h1>another head from sub</h1>
+ Index of /foo/sub
+ <hr> Footer <hr>
+ </body>
+ </html>
+
+
+
=head1 Author
1.2 +14 -1 embperl/Features.pod
Index: Features.pod
===================================================================
RCS file: /home/cvs/embperl/Features.pod,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- Features.pod 1999/09/08 05:21:15 1.1
+++ Features.pod 2000/02/11 22:33:39 1.2
@@ -1,6 +1,6 @@
=pod
-=head1 Main features of HTML::Embperl 1.2
+=head1 Main features of HTML::Embperl 1.3
=over 4
@@ -50,6 +50,14 @@
=item *
+I<EmbperlObject> allows you to define the standard layout of your site just
+once and includes the neccessary components based on the uri. Your HTML
+documents just have to contain the unique stuff and not the common stuff
+like headers/footers or navigation bars. Also these common elements can
+be overwritten in each subdirectory.
+
+=item *
+
Gives you the possibility to build libraries with a set of frequently used
Elements or components, and make them available to the whole web-site in the
same way as Perl modules are - well, modularized.
@@ -84,6 +92,11 @@
If you are concerned about security you can configure Embperl to use
Safe.pm. This way, your documents can run in a safe namespace which
can allow or disallow certain Perl opcodes.
+
+=item *
+
+I<HTML::Embperl::Mail> gives you the possibility to send the result directly
+to a email address
=back
1.2 +15 -1 embperl/FeaturesD.pod
Index: FeaturesD.pod
===================================================================
RCS file: /home/cvs/embperl/FeaturesD.pod,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- FeaturesD.pod 1999/09/08 05:11:31 1.1
+++ FeaturesD.pod 2000/02/11 22:33:39 1.2
@@ -1,6 +1,6 @@
=pod
-=head1 Wesentliche Features von HTML::Embperl 1.2
+=head1 Wesentliche Features von HTML::Embperl 1.3
=over 4
@@ -49,6 +49,15 @@
=item *
+I<EmbperlObject> erlaubt es das standart Layout einer Website lediglich einmal
+zu definieren und I<EmbperlObject> sorgt daf�r das die passenden Komoponeten
+an die entsprechenden Stellen eingef�gt werden. Die eigentlichen Seiten
+enthalten nur noch den tats�chlichen Inhalt und nicht gemeinsamme Elemente wie
+Kopf- und Fu�bereich oder Navigationsleisten. Diese gemeinsammen Bereiche
+k�nnen weiterhin je Unterverzeichnis �berschrieben werden.
+
+=item *
+
Erlaubt Bibliotheken mit oft benutzten Elementen zu erstellen und diese der
ganzen Website, wie normale Perlmodule, zur Verf�gung zu stellen .
@@ -85,6 +94,11 @@
Wenn Sicherheit ein Problem darstellt, ist es m�glich Embperl so zu
konfigurieren, da� es Safe.pm nutzt. Dadurch entstehen sichere
Namensr�ume und einzelne Perl Opcode k�nnen gesperrt werden.
+
+=item *
+
+I<HTML::Embperl::Mail> erm�glicht es das Ergebnis direkt an eine E-Mail
+Adresse zu versenden.
=back
1.14 +10 -0 embperl/README
Index: README
===================================================================
RCS file: /home/cvs/embperl/README,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- README 2000/01/06 11:02:17 1.13
+++ README 2000/02/11 22:33:39 1.14
@@ -86,6 +86,12 @@
* Allows you to build your web-site out of components. Frequently used elements
can be defined once and included in every page.
+* EmbperlObject allows you to define the standard layout of your site just
+ once and includes the neccessary components based on the uri. Your HTML
+ documents just have to contain the unique stuff and not the common stuff
+ like headers/footers or navigation bars. Also these common element can
+ be overwritten in each subdirectory.
+
* Gives you the possibility to build libraries with a set of frequently used
Elements or components, and make them available to the whole web-site in the
same way as Perl modules are - well, modularized.
@@ -108,6 +114,10 @@
* If you are concerned about security you can configure Embperl to use
Safe.pm. This way, your documents can run in a safe namespace which
can allow or disallow certain Perl opcodes.
+
+* I<HTML::Embperl::Mail> gives you the possibility to send the result directly
+ to a email address
+
COMPATIBILITY
1.82 +9 -0 embperl/TODO
Index: TODO
===================================================================
RCS file: /home/cvs/embperl/TODO,v
retrieving revision 1.81
retrieving revision 1.82
diff -u -r1.81 -r1.82
--- TODO 2000/01/25 05:36:54 1.81
+++ TODO 2000/02/11 22:33:39 1.82
@@ -53,6 +53,10 @@
- move default logfile to a safer place then /tmp [Christain Gilmore 20.01.00]
+- last, next for Embperl loops [Christian Gilmore 4.2.2000]
+
+- return custom error code to Apache [Alan Gutierrez 11.2.00]
+
Test
----
- test FORBIDDEN
@@ -93,3 +97,8 @@
- restrict number of iterations in search
- make [+ +] configurable [ Christian Gilmore 16.10.99]
+
+2.0
+__
+
+- Parse Posted XML data [Alex Schmelkin 4.2.2000]
1.4 +2 -2 embperl/Embperl/Mail.pm
Index: Mail.pm
===================================================================
RCS file: /home/cvs/embperl/Embperl/Mail.pm,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- Mail.pm 2000/01/25 05:36:55 1.3
+++ Mail.pm 2000/02/11 22:33:40 1.4
@@ -9,7 +9,7 @@
# IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
# WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
#
-# $Id: Mail.pm,v 1.3 2000/01/25 05:36:55 richter Exp $
+# $Id: Mail.pm,v 1.4 2000/02/11 22:33:40 richter Exp $
#
###################################################################################
@@ -151,7 +151,7 @@
=head1 DESCRIPTION
I<HTML::Embperl::Mail> uses I<HTML::Embperl> to process a page template and send
-the result out via EMail. Currently only plain test mails are supported. A later
+the result out via EMail. Currently only plain text mails are supported. A later
version may add support for HTML mails. Because of that fact, normal I<Embperl>
HTML processing is disabled per Default (see L<options> below).
@@ -207,7 +207,7 @@
=item options
If no C<options> are given the following are used per default:
-C<optDisableHtmlScan>, C<optRawInput>, C<optKeepSpaces>, C<optReturnError>
+B<optDisableHtmlScan>, B<optRawInput>, B<optKeepSpaces>, B<optReturnError>
=item escmode
1.5 +0 -0 embperl/Embperl/Module.pm
Index: Module.pm
===================================================================
RCS file: /home/cvs/embperl/Embperl/Module.pm,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- Module.pm 2000/01/25 05:36:55 1.4
+++ Module.pm 2000/02/11 22:33:40 1.5
@@ -9,7 +9,7 @@
# IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
# WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
#
-# $Id: Module.pm,v 1.4 2000/01/25 05:36:55 richter Exp $
+# $Id: Module.pm,v 1.5 2000/02/11 22:33:40 richter Exp $
#
###################################################################################
@@ -25,7 +25,7 @@
# IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
# WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
#
-# $Id: Module.pm,v 1.4 2000/01/25 05:36:55 richter Exp $
+# $Id: Module.pm,v 1.5 2000/02/11 22:33:40 richter Exp $
#
###################################################################################
1.73 +0 -0 embperl/emacs/embperl.el
Index: embperl.el
===================================================================
RCS file: /home/cvs/embperl/emacs/embperl.el,v
retrieving revision 1.72
retrieving revision 1.73
diff -u -r1.72 -r1.73
--- embperl.el 2000/01/25 05:36:55 1.72
+++ embperl.el 2000/02/11 22:33:41 1.73
@@ -19,9 +19,9 @@
;; Author : Erik Arneson ([EMAIL PROTECTED])
;; Created On : Wed Jul 22 17:16:39 PDT 1998
;; Last Modified By: Erik Arneson
-;; Last Modified On: $Date: 2000/01/25 05:36:55 $
+;; Last Modified On: $Date: 2000/02/11 22:33:41 $
;; Version : 1.00
-;; $Id: embperl.el,v 1.72 2000/01/25 05:36:55 richter Exp $
+;; $Id: embperl.el,v 1.73 2000/02/11 22:33:41 richter Exp $
;;
;; Please note that this software is very beta and rather broken. I
;; don't know how useful it will be, although I definitely plan on
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
