Sophie

Sophie

distrib > Mageia > 5 > i586 > media > core-release > by-pkgid > 2046c0127bacbf33c5fb22c054051ae6 > files > 10

ht2html-2.0-18.mga5.noarch.rpm

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<!-- THIS PAGE IS AUTOMATICALLY GENERATED.  DO NOT EDIT. -->
<!-- Fri Apr  5 00:56:18 2002 -->
<!-- USING HT2HTML 2.0 -->
<!-- SEE http://ht2html.sf.net -->
<!-- User-specified headers:
Title: ht2html.py -- A web page template processor

-->

<head>
<title>ht2html.py -- A web page template processor</title>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<meta name="generator" content="HT2HTML/2.0">
<style type="text/css">
body { margin: 0px; }
</style>
</head>
<body bgcolor="#ffffff" text="#000000"
      marginwidth="0" marginheight="0"
      link="#0000bb"  vlink="#551a8b"
      alink="#ff0000">
<!-- start of page table -->
<table width="100%" border="0" cellspacing="0" cellpadding="0">
<!-- start of banner row -->
<tr>
<!-- start of corner cells -->
<td width="150" valign="middle" bgcolor="#4fa445" class="corner">

<center>
    <a href="index.html">
    <img alt="ht2html" border="0"
         src="ht2html.png"></a></center> </td>
<td width="15" bgcolor="#89aaaa">&nbsp;&nbsp;</td><!--spacer-->
<!-- end of corner cells -->
<!-- start of banner -->
<td width="90%" bgcolor="#89aaaa" class="banner">
<!-- start of site links table -->
<table width="100%" border="0"
cellspacing="0" cellpadding="0"
       bgcolor="#ffffff">
<tr>
    <td bgcolor="#89aaaa">
<b>Home</b>
    </td>
    <td bgcolor="#89aaaa">
<a href="http://www.python.org/">Python.Org</a>
    </td>
    <td bgcolor="#89aaaa">
<a href="http://barry.wooz.org/">Barry's home page</a>
    </td>
    <td bgcolor="#89aaaa">
<a href="http://sf.net/projects/ht2html">ht2html @ SourceForge</a>
    </td>
</tr>
</table><!-- end of site links table -->

</td><!-- end of banner -->
</tr><!-- end of banner row -->
<tr><!-- start of sidebar/body row -->
<!-- start of sidebar cells -->
<td width="150" valign="top" bgcolor="#89aaaa" class="sidebar">
<!-- start of sidebar table -->
<table width="100%" border="0" cellspacing="0" cellpadding="3"
       bgcolor="#ffffff">
<tr><td bgcolor="#238e68"><b><font color="#ffffff">
Subsections
</font></b></td></tr>
<tr><td bgcolor="#89aaaa">
<b>Introduction</b>
</td></tr>
<tr><td bgcolor="#89aaaa">
<a href="components.html">Web&nbsp;page&nbsp;components</a>
</td></tr>
<tr><td bgcolor="#89aaaa">
<a href="bugs.html">Bugs&nbsp;and&nbsp;Peculiarities</a>
</td></tr>
<tr><td bgcolor="#89aaaa">
<a href="docstring.html">Usage</a>
</td></tr>
<tr><td bgcolor="#89aaaa">
<a href="style.html">Using Stylesheets</a>
</td></tr>
<tr><td bgcolor="#89aaaa">
<a href="examples.html">Examples</a>
</td></tr>
<tr><td bgcolor="#89aaaa">&nbsp;
<tr><td bgcolor="#238e68"><b><font color="#ffffff">
ht2html sites
</font></b></td></tr>
<tr><td bgcolor="#89aaaa">
<a href="http://barry.wooz.org/">Barry's&nbsp;home&nbsp;page</a>
</td></tr>
<tr><td bgcolor="#89aaaa">
<a href="http://www.python.org/">Python.Org</a>
</td></tr>
<tr><td bgcolor="#89aaaa">
<a href="http://www.jython.org/">Jython.Org</a>
</td></tr>
<tr><td bgcolor="#89aaaa">
<a href="http://www.list.org/">GNU&nbsp;Mailman</a>
</td></tr>
<tr><td bgcolor="#89aaaa">
<a href="http://tmda.sf.net/">TMDA</a>
</td></tr>
<tr><td bgcolor="#89aaaa">
<a href="http://acvalbonne.online.fr/">Cycling&nbsp;Club</a>
</td></tr>
<tr><td bgcolor="#89aaaa">&nbsp;
<tr><td bgcolor="#238e68"><b><font color="#ffffff">
Email me
</font></b></td></tr>
<tr><td bgcolor="#89aaaa">
<a href="mailto:barry@python.org">Barry A. Warsaw</a>
</td></tr>
<tr><td bgcolor="#89aaaa">
&nbsp;
</td></tr>
<tr><td bgcolor="#89aaaa">
<a href="http://www.python.org/">
<center>
    <img alt="[Python Powered]" border="0"
         src="PythonPoweredSmall.png"></center>
</a>
</td></tr>
<tr><td bgcolor="#89aaaa">
&nbsp;
</td></tr>
<tr><td bgcolor="#89aaaa">
&copy; 1999-2002
</td></tr>
<tr><td bgcolor="#89aaaa">
<a href="http://www.python.org/psf/">Python Software Foundation</a>
</td></tr>
<tr><td bgcolor="#89aaaa">
<hr>
</td></tr>
<tr><td bgcolor="#89aaaa">
<a href="index.ht">[page source]</a>
</td></tr>
</table><!-- end of sidebar table -->

</td>
<td width="15">&nbsp;&nbsp;</td><!--spacer-->
<!-- end of sidebar cell -->
<!-- start of body cell -->
<td valign="top" width="90%" class="body"><br>
<h3>ht2html.py -- A web page template processor</h3>

<p>HTML frames are cool in theory, but have severe practical problems.
The biggest problem with them is that they totally break navigation,
especially when you end up at a frame page not through the frameset
HTML.  Bookmarks are also more difficult when using frames.

<p>So the brothers Van Rossum designed the current python.org web site
to use HTML tables, providing much of the benefit of a frames oriented
table of contents, without the hassles.  Naturally, Guido had to write
a Python script to generate the <a href="http://www.python.org">python.org</a> 
style, which was really cool, except he probably didn't figure that
other people would want to generate web pages using slightly modified
versions of that style.

<p>Guido's script wasn't easily extensible or modifiable, so
<a href="http://www.amk.ca/">Andrew
Kuchling</a> did another implementation based on Digital Creation's
(now <a href="http://www.zope.com/">Zope Corporation</a>)
DocumentTemplate.
I couldn't grok Andrew's script -- which says much more about me
than his code or DocumentTemplate -- so I did what any
self-respecting hacker would do.  I reinvented a third wheel.
Hey, at least this time I mostly understand how it works.

<p>This script is called <em>ht2html</em> because it generates
<tt>.html</tt> files from <tt>.ht</tt> template files.  The format of
these <tt>.ht</tt> files is essentially normal HTML, with a set of
optional <a href="http://www.faqs.org/rfcs/rfc2822.html">RFC
2822</a>-like headers at the top of the file.  These headers specify
certain options that ht2html's various classes support.  You must
include at least one blank line between the last header and the start
of the body HTML.

<p>Read about the <a href="components.html">components</a> of a web
page, how to <a href="style.html">work with stylesheets</a> with
ht2html, the <a href="docstring.html">docstring</a> containing usage
information, and see some <a href="examples.html">examples</a> of how
to set up your own site generators.  Of course, these pages are also
created by using <em>ht2html</em> and you can see the files used as
input sources:
<ul><li><a href="index.ht">index.ht</a>
    <li><a href="components.ht">components.ht</a>
    <li><a href="style.ht">style.ht</a>
    <li><a href="bugs.ht">bugs.ht</a>
    <li><a href="docstring.ht">docstring.ht</a>
    <li><a href="examples.ht">examples.ht</a>
    <li><a href="links.h">links.h</a>
</ul>

<p><strong>Note:</strong> Python 2.0 or newer is required!

</td><!-- end of body cell -->
</tr><!-- end of sidebar/body row -->
</table><!-- end of page table -->
</body></html>