perl-modperl-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From rich...@hyperreal.org
Subject cvs commit: modperl-site embperl.html
Date Tue, 11 Aug 1998 14:07:58 GMT
richter     98/08/11 07:07:58

  Modified:    .        embperl.html
  Log:
  New Embperl website
  
  Revision  Changes    Path
  1.3       +3 -200    modperl-site/embperl.html
  
  Index: embperl.html
  ===================================================================
  RCS file: /export/home/cvs/modperl-site/embperl.html,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- embperl.html	1998/07/17 19:26:09	1.2
  +++ embperl.html	1998/08/11 14:07:57	1.3
  @@ -6,213 +6,16 @@
   <meta http-equiv="Content-Type"
   content="text/html; charset=iso-8859-1">
   <title>Embperl - Embeding Perl Code in HTML</title>
  -<!-- Changed by: Gerald Richter, 17-June-1998 -->
  +<!-- Changed by: Gerald Richter, 11-Aug-1998 -->
   </head>
   
   <body bgcolor="#FFFFFF">
   
   <h1>Embperl - Embeding Perl Code in HTML</h1>
   
  -<h4>Embeding Perl Code </h4>
  +The page has been moved, please visit
   
  -<p>Embperl is a module, which allows you to embed perl code in
  -your html documents. You can use everything what's allowed in a
  -normal perl program. So there are a lot of perl modules available
  -all around the world. Embperl escapes the output of your embed
  -perl code (i.e. '&lt;' will be translated to &amp;lt; '' will
  -become &amp;auml; etc.), so you don't have to care about html
  -conformision. </p>
  +<a href="http://perl.apache.org/embperl">http://perl.apache.org/embperl</a>
   
  -<h4>How to write Embperl documents </h4>
  -
  -<p>The design goal was (and is) the easy creation of active
  -server contents (such like database queries). You can write your
  -html documents in your favorite (WYSIWYG) Editor, Embperl keeps
  -track of escaping/unescaping your text to conform to the html
  -specification, removes/translates html tags which are created
  -from your html editor in the middle of the perl code. Just insert
  -your code as text, you don't have to matter how your editor put
  -it in the html document, Embperl does this for you. </p>
  -
  -<h4>Metacommands for control of programflow </h4>
  -
  -<p>To control what is really send to the browser Embperl has
  -metacommands, which lets you conditional process your document
  -and create loops within it. For example you can vary the output
  -depending of the input of a form field or the result of a
  -database query. </p>
  -
  -<h4>Dynamic Tables/Lists/Menus </h4>
  -
  -<p>Embperl not only executes your embbeded perl code, it also
  -looks at the html code and does special processing of some html
  -tags. It can create dynamic tables/lists/menus. Simply write one
  -row/column of your table, Embperl expand it as necessary for you.
  -This can, for example, used to display a database query, which
  -returns a unknown number of records. </p>
  -
  -<h4>Formdata and Inputfields </h4>
  -
  -<p>Embperl helps you when processing form fields. All input which
  -is posted (from another form) to your document, is available in
  -one hash and a array (to keep the field order). (Even if one key
  -occurs multiple times). When processing your html document the
  -content of the hash is &quot;bound&quot; to the corresponding
  -input fields in your document. This works with text fields,
  -textarea (multiline) fields and checkboxes/radiobuttons. So to
  -display the result of one database record for further editing in
  -a html form, simply put the recorddata in this hash, the rest is
  -done by Embperl. </p>
  -
  -<h4>Databases </h4>
  -
  -<p>As mentioned above, you can use every available perl module to
  -access your favorite database. If you run Embperl under mod_perl
  -you can use Apache::DBI to archive persistent database connection
  -i.e. the database will be kept open between multiple
  -requests/queries, which could save a lot of time. Further more 
  -I have created special database module for Embperl, which
  -makes it even easier to access any database, for which a DBD
  -driver is available. (<a href="ftp://ftp.dev.ecos.de/pub/perl/dbi">
  -DBIx::Recordset</a>) </p>
  -
  -<h4>Security </h4>
  -
  -<p>For situation where a high security is necessary, Embperl
  -supports safe namespaces. You can configure your web server, so
  -that different documents run under different namespaces, so they
  -can't disturb each other. More over the Safe.pm module of perl,
  -which Embperl uses, allows you a disable or enable every perl
  -operation separately.</p>
  -
  -<h4>How can Embperl run? </h4>
  -
  -<p>Embperl can run offline, as cgi-script or under control of
  -mod_perl from apache httpd. If you have documents which are
  -rarely accessed, the best is to use cgi-scripts, since they only
  -require memory while they run, but if you have documents which
  -are used very often, the most powerful way to run Embperl is to
  -use mod_perl in conjunction with the apache web server. The
  -advantages of the mod_perl mode are, that all the modules you use
  -are only compiled once, when they first used. This safes a lot of
  -compiling time (and cpu-power) for every request. Also you can
  -maintain persistent connection to databases or files, which saves
  -you the time of opening them for every request. </p>
  -
  -<h4>Example 1</h4>
  -
  -<p><br>
  -&lt;html&gt;<br>
  -&lt;head&gt;<br>
  -&lt;title&gt;While Metacommand in Embperl&lt;/title&gt;<br>
  -&lt;/head&gt;<br>
  -<br>
  -This is a example of using the while metacommand in embperl to
  -show the environement&lt;P&gt;<br>
  -<br>
  -<em>This is embeded perl code which does not generate any output</em><br>
  -<font color="#FF0000"><strong>[- $i = 0; @k = keys %ENV -]</strong></font><br>
  -<em>This is the while metacommand (you can write &amp;lt; or &lt;
  -as operator, this doesn't matter<br>
  -</em><font color="#FF0000"><strong>[$ while ($i &amp;lt; $#k) $]</strong></font><br>
  -<em>The output of the experssion between [+ and +] will be
  -inserted in the html output</em><font color="#FF0000"><em><strong><br>
  -</strong></em><strong>[+ $k[$i] +]</strong></font> = <font
  -color="#FF0000"><strong>[+ $ENV{$k[$i]} +]</strong></font>&lt;BR&gt;<br>
  -<font color="#FF0000"><strong>[- $i++ -]</strong></font><br>
  -<font color="#FF0000"><strong>[$ endwhile $]</strong></font><br>
  -<br>
  -&lt;/body&gt;<br>
  -&lt;/html&gt;<br>
  -</p>
  -
  -<h4>Example 2</h4>
  -
  -<p><br>
  -&lt;html&gt;<br>
  -&lt;head&gt;<br>
  -&lt;title&gt;HTML table tag in Embperl&lt;/title&gt;<br>
  -&lt;/head&gt;<br>
  -<br>
  -&lt;P&gt;This is a example of using the table tag in embperl to
  -show the environement&lt;P&gt;<br>
  -<br>
  -<font color="#FF0000"><strong>[- @k = keys %ENV -]</strong></font><br>
  -<br>
  -&lt;table&gt;<br>
  -&lt;tr&gt;<br>
  -<em>Embperl will automatic generate as muchs rows as necessary to
  -display the whole environement (this also work for two
  -dimmensional arrays)<br>
  -</em>&lt;td&gt;<font color="#FF0000"><strong>[+ $i=$row +]</strong></font>
  -&lt;/td&gt; &lt;td&gt;[<font color="#FF0000"><strong>+ $k[$row]
  -+]</strong></font> &lt;/td&gt; &lt;td&gt;<font color="#FF0000"><strong>[+
  -$ENV{$k[$i]} +]</strong></font> &lt;/td&gt;<br>
  -&lt;/tr&gt; <br>
  -&lt;/table&gt;<br>
  -<br>
  -&lt;/body&gt;<br>
  -&lt;/html&gt;<br>
  -</p>
  -
  -<h4>More Informations </h4>
  -
  -<table border="0">
  -    <tr>
  -        <td>Embperl source</td>
  -        <td><a href="ftp://ftp.dev.ecos.de/pub/perl/embperl">ftp://ftp.dev.ecos.de/pub/perl/embperl</a></td>
  -    </tr>
  -    <tr>
  -        <td>Embperl source from CPAN </td>
  -        <td><a
  -        href="http://www.perl.com/CPAN/modules/by-module/Apache/">http://www.perl.com/CPAN/modules/by-module/Apache</a></td>
  -    </tr>
  -    <tr>
  -        <td>mod_perl</td>
  -        <td><a href="http://perl.apache.org/">http://perl.apache.org</a></td>
  -    </tr>
  -    <tr>
  -        <td>apache</td>
  -        <td><a href="http://www.apache.org">http://www.apache.org</a></td>
  -    </tr>
  -    <tr>
  -        <td>DBI</td>
  -        <td><a href="http://www.hermetica.com/technologia/DBI/">http://www.hermetica.com/technologia/DBI</a></td>
  -    </tr>
  -    <tr>
  -        <td>Apache::DBI</td>
  -        <td><a
  -        href="http://www.perl.com/CPAN/modules/by-module/Apache/">http://www.perl.com/CPAN/modules/by-module/Apache</a></td>
  -    </tr>
  -    <tr>
  -	<td>DBIx::Recordset</td>
  -	<td><a href="ftp://ftp.dev.ecos.de/pub/perl/dbi">
  -		ftp://ftp.dev.ecos.de/pub/perl/dbi
  -	</a></td>
  -    </tr>
  -</table>
  -
  -<h4>See Also</h4>
  -
  -<p>Apache::ePerl from Ralf Engelschall. Thats another module for
  -embeding perl code in HTML (or other ascii files)</p>
  -
  -<table border="0">
  -    <tr>
  -        <td>Apache::ePerl </td>
  -        <td><a href="http://www.engelschall.com/sw/eperl/">http://www.engelschall.com/sw/eperl</a></td>
  -    </tr>
  -</table>
  -
  -<h4>Support </h4>
  -
  -<p>Support for Embperl is available via the <a
  -href="http://perl.apache.org/#more">mod_perl mailing
  -list</a> </p>
  -
  -<h4>Author </h4>
  -
  -<p>Gerald Richter / ECOS <a href="mailto:richter@dev.ecos.de">richter@dev.ecos.de</a>
  -</p>
   </body>
   </html>
  
  
  

Mime
View raw message