openssl.wml

   1 ##
   2 ##  openssl.wml -- WML Template for the www.openssl.org website
   3 ##  Written by Ralf S. Engelschall <rse@engelschall.com>
   4 ##
   5 ##  Usage: #use wml::openssl area=<area_name> [page=<page_name>]
   6 ##
   7
   8 #use wml::std::tags
   9 #use wml::std::info
  10 #use wml::des::navbar
  11 #use wml::des::space
  12
  13 ##
  14 ##  The Global Page Layout
  15 ##
  16
  17 #   start of page header
  18 [PAGE_HEAD:\
  19 <html>
  20 <head>
  21
  22 #   insert information about the webpage
  23 <info style=comment domainname="openssl.org"
  24       copyright="1998-2000 The OpenSSL Project, http://www.openssl.org/">
  25 <info style=meta domainname="openssl.org"
  26       copyright="1998-2000 The OpenSSL Project, http://www.openssl.org/">
  27
  28 #   insert overideable title container
  29 <title*>OpenSSL: {#PAGE_TITLE#}</title*>
  30 #   predefine it to show errors
  31 ..PAGE_TITLE!>>Error: Undefined Title !!<<..
  32 #   define override tag
  33 <define-tag title endtag=required>
  34 ..PAGE_TITLE>>%body<<..
  35 </define-tag>
  36
  37 #   define a style-sheet for adjusting some HTML layouting things
  38 #   to conform to some typographically stronger conventions.
  39 <style type="text/css"><!--
  40 BODY      { position: absolute; left: 0px; top: 0px; background: #666699; }
  41 A         { text-decoration: none; font-weight: bold; }
  42 A:link    { text-decoration: none; font-weight: bold; color: #666699; }
  43 A:visited { text-decoration: none; font-weight: bold; color: #666699; }
  44 A:hover   { text-decoration: none; font-weight: bold; color: #666699; text-decoration: underline; }
  45 \#red { color: #cc3333; }
  46 \#sf  { font-family: arial,helvetica; font-variant: normal; font-style: normal; }
  47 \#sfl { font-weight: bold; font-family: arial,helvetica; font-size: 16pt; \
  48         line-height: 16pt; font-variant: normal; font-style: normal; }
  49 H1    { font-weight: bold; font-size: 18pt; line-height: 18pt; \
  50         font-family: arial,helvetica; font-variant: normal; font-style: normal; }
  51 H2    { font-weight: bold; font-size: 14pt; line-height: 14pt; \
  52         font-family: arial,helvetica; font-variant: normal; font-style: normal; }
  53 H3    { font-weight: bold; font-size: 12pt; line-height: 12pt; \
  54         font-family: arial,helvetica; font-variant: normal; font-style: normal; }
  55 --></style>
  56
  57 #   end of header and start of physical body
  58 #   (use additionally use colors here for older browsers)
  59 </head>
  60 <body link="#6666cc" alink="#6666cc" vlink="#6666cc" bgcolor="#666699" text="#000000"
  61       marginheight=0 leftmargin=0 rightmargin=0 topmargin=0>
  62
  63 #   now define the page layout by a nested table
  64 #   structure consisting of a 5x5 cell grid.
  65 <table width=100% cellspacing=0 cellpadding=0 border=0>
  66   #   visually: the top line of the page
  67   <tr>\
  68     <td align=left width=100 bgcolor="#666699"><img src="$(IMG)/page-head-tl.jpg" alt="OpenSSL"></td>\
  69     <td align=left colspan=2 width=600 bgcolor="#666699"><img src="$(IMG)/page-head-tm.jpg" alt=""></td>\
  70     <td align=right width=20 bgcolor="#666699">&nbsp;&nbsp;&nbsp;</td>\
  71     <td align=right width=50 bgcolor="#666699">&nbsp;</td>\
  72   </tr>
  73   #   visually: the top of the white body with the subnavbar
  74   <tr>\
  75     <td align=left width=100><img src="$(IMG)/page-head-bl.jpg"></td>\
  76     <td align=left width=20><img src="$(IMG)/page-head-bm.jpg"></td>\
  77     <td align=left width=100% bgcolor="#ffffff">\
  78         {#PAGE_SUBNAVBAR#}\
  79     </td>\
  80     <td align=right width=20><img src="$(IMG)/page-corner-tr.gif"></td>\
  81     <td align=right width=50 bgcolor="#666699">&nbsp;</td>\
  82   </tr>
  83   #   visually: the left main navigation bar and the white body
  84   <tr>\
  85     <td align=left valign=top width=100 bgcolor="#666699">{#PAGE_NAVBAR#}</td>\
  86     <td align=left valign=top width=20  bgcolor="#ffffff">&nbsp;</td>\
  87     <td align=left valign=top bgcolor="#ffffff">\
  88         <br>
  89         :PAGE_HEAD][PAGE_BODY:
  90         {#PAGE_BODY#}
  91         :PAGE_BODY][PAGE_FOOT:\
  92     </td>\
  93     <td align=right width=20 bgcolor="#ffffff">&nbsp;&nbsp;&nbsp;</td>\
  94     <td align=right width=50 bgcolor="#666699">&nbsp;</td>\
  95   </tr>
  96   #   visually: the bottom of the white body
  97   <tr>\
  98     <td align=left valign=top width=100 bgcolor="#666699">&nbsp;</td>\
  99     <td align=left width=20><img src="$(IMG)/page-corner-bl.gif"></td>\
 100     <td align=left valign=top bgcolor="#ffffff">&nbsp;</td>\
 101     <td align=right width=20><img src="$(IMG)/page-corner-br.gif"></td>\
 102     <td align=right width=50 bgcolor="#666699">&nbsp;</td>\
 103   </tr>
 104   #   visually: the bottom of the page (only for esthetical
 105   #   reasons, i.e. the page doesn't end with the white body)
 106   <tr>\
 107     <td colspan=5 bgcolor="#666699">&nbsp;</td>\
 108   </tr>
 109 </table>
 110
 111 #   the physical end of the body
 112 </body>
 113 </html>
 114 :PAGE_FOOT]
 115
 116 ##
 117 ##  The main Navigation Bar [left, vertically]
 118 ##
 119
 120 #   define the navigation bar through a grammar
 121 <navbar:define name=navbar imgstar="n:s:s"
 122                imgbase="$(IMG)" urlbase="$(ROOT)">
 123   #   bar header
 124   <navbar:header>
 125   </navbar:header>
 126   #   button prolog
 127   <navbar:prolog>
 128     <tr><td>
 129   </navbar:prolog>
 130   #   the buttons itself
 131   <navbar:button id=title    url="."      txt="Title"        img=page-navbar-ti-*.jpg>
 132   <navbar:button id=FAQ      url=support/faq.html   txt="FAQ"          img=page-navbar-fq-*.jpg>
 133   <navbar:button id=about    url=about/   txt="About"        img=page-navbar-ab-*.jpg>
 134   <navbar:button id=news     url=news/    txt="News"         img=page-navbar-ne-*.jpg>
 135   <navbar:button id=docs     url=docs/    txt="Documents"    img=page-navbar-do-*.jpg>
 136   <navbar:button id=source   url=source/  txt="Source"       img=page-navbar-so-*.jpg>
 137   <navbar:button id=contrib  url=contrib/ txt="Contribution" img=page-navbar-co-*.jpg>
 138   <navbar:button id=support  url=support/ txt="Support"      img=page-navbar-su-*.jpg>
 139   <navbar:button id=related  url=related/ txt="Related"      img=page-navbar-re-*.jpg>
 140   #   button epilog
 141   <navbar:epilog>
 142     </td></tr>
 143   </navbar:epilog>
 144   #   bar footer
 145   <navbar:footer>
 146   </navbar:footer>
 147 </navbar:define>
 148
 149 #   and then immediately render it into its layout location
 150 #   (Hint: The top and buttom images have to be part of the table
 151 #   structure because only this way we can put them 0pt to the
 152 #   buttons without a gap)
 153 ..PAGE_NAVBAR>>\
 154   <table cellspacing=0 cellpadding=0 border=0>\
 155     <tr><td><img src="$(IMG)/page-navbar-top.jpg"></td></tr>
 156     #   render it!
 157     <navbar:render name=navbar select=$(area) $(page:+subselected)>
 158     <tr><td><img src="$(IMG)/page-navbar-bot.jpg"><br><p></td></tr>
 159   </table>
 160 <<..
 161
 162 ##
 163 ##  The Sub Navigation Bar (SNB) [top, horizontally]
 164 ##
 165
 166 #   define the <snb>...</snb> container tag
 167 <define-tag snb endtag=required>
 168   #   1. define the navigation bar through a grammar
 169   <navbar:define name=snb urlbase="$(SNB_ROOT)"
 170                  txtcol_normal="#666666" txtcol_select="#000000">
 171     #   bar header
 172     <navbar:header>\
 173       <table cellspacing=0 cellpadding=0 border=0>
 174         <tr>
 175     </navbar:header>
 176     #   button prolog (normal)
 177     <navbar:prolog>\
 178           <td><font face="Arial,Helvetica">&nbsp;
 179     </navbar:prolog>
 180     #   button prolog (selected)
 181     <navbar:prolog type=S>\
 182           <td bgcolor="#f0f0f0">&nbsp;<font face="Arial,Helvetica"><b>
 183     </navbar:prolog>
 184     #   ...here the <snb_button> tags will occur...
 185     %body
 186     #   button epilog (normal)
 187     <navbar:epilog>\
 188           </font>&nbsp;</td><td>|</td>
 189     </navbar:epilog>
 190     #   button epilog (selected)
 191     <navbar:epilog type=S>\
 192           </b></font>&nbsp;</td><td>|</td>
 193     </navbar:epilog>
 194     #   last button epilog (normal)
 195     <navbar:epilog pos=last>\
 196           </font>&nbsp;</td><td></td>
 197     </navbar:epilog>
 198     #   last button epilog (selected)
 199     <navbar:epilog type=S pos=last>\
 200           </b></font>&nbsp;</td><td></td>
 201     </navbar:epilog>
 202     #   bar footer
 203     <navbar:footer>\
 204         </tr>
 205       </table>
 206     </navbar:footer>
 207   </navbar:define>
 208   #   2. render the navigation bar and divert
 209   #      divert it into it's final location
 210   ..PAGE_SUBNAVBAR>>\
 211   <navbar:render name=snb select="$(page)">\
 212   <<..
 213 </define-tag>
 214
 215 #   define the <snb_button> tag for the <snb> container
 216 #   (this is for consistency with the tag names)
 217 <define-tag snb_button>
 218   <navbar:button %attributes>
 219 </define-tag>
 220
 221 #   predefine the contents of the SNB location
 222 #   by diverting a whitespace character to it.
 223 #   This prevents the table to be folded.
 224 ..PAGE_SUBNAVBAR!>>
 225 &nbsp;
 226 <<..
 227
 228 #   and now the final WML trick: When the page=<page_name>
 229 #   attribute is specified for this template, we read in the SNB
 230 #   spec-file which now can use the <snb>..</snb> and
 231 #   <snb_button> tags to actually define and render a SNB. This
 232 #   is accomplished by doing some sort of a conditional #include. ;-)
 233 $(page:*# )$(page:+#include ")$(SNB_RC:-.wmlsnb)$(page:+")
 234
 235 ##
 236 ##  Useful tags (for convenience purposes only)
 237 ##
 238
 239 #   define a <item> tag for <ul>/<ol> item similar to <li> but
 240 #   which is nice for URL lists like the Related area where
 241 #   we want a special layout.
 242 <define-tag item>
 243 <preserve name>
 244 <preserve url>
 245 <preserve aio>
 246 <preserve info>
 247 <set-var aio=*>
 248 <set-var %attributes>
 249 <li><imgdot width=1 height=18>\
 250     <a href="<get-var url>"><font size=+1 face="Arial,Helvetica"><b><get-var name></b></font></a>
 251     <ifeq "<get-var aio>" "" <img src="aio.gif" alt="[all-in-one]" align=absmiddle>>
 252     <br>
 253     <a href="<get-var url>"><font size=-1><get-var url></font></a><br>
 254     <ifeq "<get-var info>" "" "" "<get-var info>">
 255 <restore info>
 256 <restore aio>
 257 <restore url>
 258 <restore name>
 259 </define-tag>
 260
 261 #   define a <filelist> tag which can be used to create a file listing which
 262 #   is optically more compact than the stuff Apache's mod_autoindex creates.
 263 #   Especially the current version is marked red, too.
 264 <define-tag filelist>
 265 <pre>
 266 <b>   Bytes      Timestamp       Filename</b>
 267 <b>________ ____________________ ____________________________</b>
 268 <:
 269 @HI = ();
 270 open(FP, "<index.current");
 271 while (<FP>) {
 272    s|\s*\n$||;
 273    push(@HI, $_);
 274 }
 275 close(FP);
 276 sub ls {
 277     my ($pat) = @_;
 278     my (@F, @R, $f, @S, @T);
 279     @F = sort { (stat($a))[9] <=> (stat($b))[9]; } (glob($pat));
 280     @R = ();
 281     foreach $f (@F) {
 282         next if ($f =~ m|^index.*|);
 283         if ('%1' ne '') {
 284             if (! %1 $f) {
 285                 next;
 286             }
 287         }
 288         @S = stat($f);
 289         $f = "$f/" if (-d $f);
 290         @T = localtime($S[9]);
 291         my @moy = ('Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun',
 292                    'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec');
 293         push(@R, sprintf("%"."8d %"."s %"."2d %"."02d:%"."02d:%"."02d %"."d %"."s\n",
 294              $S[7], $moy[$T[4]], $T[3], $T[2], $T[1], $T[0], 1900+$T[5], $f));
 295     }
 296     return @R;
 297 }
 298 @L = &ls("%0");
 299 foreach $l (@L) {
 300     next if ($l =~ m|^\s*$|);
 301     $l =~ s|(\s+)(\S+[^/])(\s*\n)$|$1."<a href=\"$2\">$2</a>".$3|e;
 302     $l =~ s|(\s+)(\S+/)(\s*\n)$|$1."<a href=\"$2\"><b>$2</b></a>".$3|e;
 303     foreach $hi (@HI) {
 304         $l =~ s|^(.*$hi.*)$|<font color="#cc3333">$1&nbsp;&nbsp;<b>[LATEST]</b></font>|;
 305         $l =~ s|>($hi)<|><font color="#cc3333">$1</font><|;
 306     }
 307     print $l;
 308 }
 309 :>
 310 </pre>
 311 </define-tag>
 312
 313 <define-tag rfilelist>
 314 <pre>
 315 <b>   Bytes      Timestamp       Filename</b>
 316 <b>________ ____________________ ____________________________</b>
 317 <:
 318 @HI = ();
 319 open(FP, "<index.current");
 320 while (<FP>) {
 321    s|\s*\n$||;
 322    push(@HI, $_);
 323 }
 324 close(FP);
 325 sub ls {
 326     my ($pat) = @_;
 327     my (@F, @R, $f, @S, @T);
 328     @F = sort { (stat($b))[9] <=> (stat($a))[9]; } (glob($pat));
 329     @R = ();
 330     foreach $f (@F) {
 331         next if ($f =~ m|^index.*|);
 332         if ('%1' ne '') {
 333             if (! %1 $f) {
 334                 next;
 335             }
 336         }
 337         @S = stat($f);
 338         $f = "$f/" if (-d $f);
 339         @T = localtime($S[9]);
 340         my @moy = ('Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun',
 341                    'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec');
 342         push(@R, sprintf("%"."8d %"."s %"."2d %"."02d:%"."02d:%"."02d %"."d %"."s\n",
 343              $S[7], $moy[$T[4]], $T[3], $T[2], $T[1], $T[0], 1900+$T[5], $f));
 344     }
 345     return @R;
 346 }
 347 @L = &ls("%0");
 348 foreach $l (@L) {
 349     next if ($l =~ m|^\s*$|);
 350     if ($l =~ m|(\s+)(\S+[^/])(\s*\n)$|) {
 351         my $h = $`.$1;
 352         my $f = $2;
 353         my $t = $3;
 354         my $r = "<a href=\"$f\">$f</a>";
 355         if (-f "$f.md5") { $r .= " (<a href=\"$f.md5\">MD5</a>)"; }
 356         if (-f "$f.sha1") { $r .= " (<a href=\"$f.sha1\">SHA1</a>)"; }
 357         if (-f "$f.asc") { $r .= " (<a href=\"$f.asc\">PGP sign</a>)"; }
 358         $l = $h.$r.$t;
 359     }
 360     $l =~ s|(\s+)(\S+/)(\s*\n)$|$1."<a href=\"$2\"><b>$2</b></a>".$3|e;
 361     foreach $hi (@HI) {
 362         $l =~ s|^(.*$hi.*)$|<font color="#cc3333">$1&nbsp;&nbsp;<b>[LATEST]</b></font>|;
 363         $l =~ s|>($hi)<|><font color="#cc3333">$1</font><|;
 364     }
 365     print $l;
 366 }
 367 :>
 368 </pre>
 369 </define-tag>
 370
 371 #   define a <cvs> container which can be used to reference
 372 #   files within the CVS repository similar to <a>.
 373 <define-tag cvs endtag=required>
 374 <preserve href>\
 375 <set-var %attributes>\
 376   <a href="$(ROOT)/source/exp/<get-var href>"><get-var href></a>\
 377 <restore href>\
 378 </define-tag>
 379
 380 #
 381 <define-tag newsflash>
 382 <preserve from>
 383 <preserve max>
 384 <preserve more>
 385 <set-var %attributes>
 386 <table width=550 cellspacing=0 cellpadding=1 border=0>
 387 <tr><td><font face="Arial,Helvetica"><b>Date</b></font></td> <td>&nbsp;&nbsp;&nbsp;<font face="Arial,Helvetica"><b>Newsflash</b></font></td></tr>
 388 <tr><td><hr noshade size=1></td> <td><hr noshade size=1></td></tr>
 389 <:
 390     open(FP, "< <get-var from>") || die;
 391     my $max = ("<get-var max>" eq '' ? 9999 : "<get-var max>");
 392     @COL = (
 393         '#ffffff',
 394         '#f0f0f0',
 395     );
 396     $ncol = 1;
 397     $n = 0;
 398     while (<FP>) {
 399         $ncol = ($ncol + 1) % 2;
 400         $col  = $COL[$ncol];
 401         s|="ROOT|="$(ROOT)|g;
 402         s|="CVS|="$(ROOT)/source/exp/|g;
 403         if (m|^(.+?):(.+)|) {
 404             print "<tr bgcolor=\"$col\">\n";
 405             print "  <td align=right><font face=\"Arial,Helvetica\"><b>$1:</b></font></td> <td>&nbsp;&nbsp;$2</td>\n";
 406             print "</tr>\n";
 407         }
 408         $n++;
 409         last if ($n >= $max);
 410     }
 411     close(FP);
 412 :>
 413 <ifeq "<get-var more>" "" "" <group
 414 <tr>
 415   <td>&nbsp;</td> <td align=right><a href="<get-var more>">more...</a></td>
 416 </tr>
 417 >>
 418 </table>
 419 <restore more>
 420 <restore max>
 421 <restore from>
 422 </define-tag>
 423
 424 #   define a <disclaimer> tag which displays the usual disclaimer stuff
 425 <define-tag disclaimer>
 426 <font face="Arial,Helvetica" size=-1>
 427 This software package uses strong cryptography, so even if it is created,
 428 maintained and distributed from liberal countries in Europe (where it is legal
 429 to do this), it falls under certain export/import and/or use restrictions in
 430 some other parts of the world.
 431 <p>
 432 PLEASE REMEMBER THAT EXPORT/IMPORT AND/OR USE OF STRONG CRYPTOGRAPHY
 433 SOFTWARE, PROVIDING CRYPTOGRAPHY HOOKS OR EVEN JUST COMMUNICATING TECHNICAL
 434 DETAILS ABOUT CRYPTOGRAPHY SOFTWARE IS ILLEGAL IN SOME PARTS OF THE WORLD.
 435 SO, WHEN YOU IMPORT THIS PACKAGE TO YOUR COUNTRY, RE-DISTRIBUTE IT FROM
 436 THERE OR EVEN JUST EMAIL TECHNICAL SUGGESTIONS OR EVEN SOURCE PATCHES TO THE
 437 AUTHOR OR OTHER PEOPLE YOU ARE STRONGLY ADVISED TO PAY CLOSE ATTENTION TO
 438 ANY EXPORT/IMPORT AND/OR USE LAWS WHICH APPLY TO YOU. THE AUTHORS OF OPENSSL
 439 ARE NOT LIABLE FOR ANY VIOLATIONS YOU MAKE HERE. SO BE CAREFUL, IT
 440 IS YOUR RESPONSIBILITY.
 441 </font>
 442 <p>
 443 <font face="Arial,Helvetica" size=-1>
 444 CREDIT INFORMATION:
 445 This product includes cryptographic software written by Eric A. Young
 446 (eay@cryptsoft.com).  This product includes software written by Tim J.  Hudson
 447 (tjh@cryptsoft.com).
 448 </font>
 449 </define-tag>
 450
 451 #  a tag displaying the used tools
 452 <define-tag website-tools>
 453 <font face="Arial,Helvetica" size=-1>
 454 Website designed by
 455 <a href="http://www.engelschall.com/">Ralf S. Engelschall</a>
 456 and generated with
 457 <a href="http://thewml.org/"><font color="#000000">
 458 Website META Language</font></a> (WML).<br>
 459 All markup code and graphics on this website
 460 are Copyright &copy; 1999-2005 <a href="http://www.openssl.org/">The OpenSSL Project</a>,
 461 All rights reserved.<br>
 462 This website is served by an
 463 <a href="http://www.apache.org/"><font color="#000000">Apache</font></a>/
 464 <a href="http://www.modssl.org/"><font color="#000000">mod_ssl</font></a>
 465 webserver environment.<br>
 466 Hardware and bandwidth provided by
 467 <a href="http://www.space.net/"><font color="#000000">
 468 SpaceNet AG</font></a>.
 469 </font>
 470 </define-tag>
 471
 472 #  construct an absolute URL out of a relative URL
 473 #  (essential for the mirroring of the website!)
 474 <define-tag absolute>
 475 <:{
 476     my ($cwd, $baseurl, $basedir, $subdir, $page, $url);
 477
 478     #   determine current working directory
 479     $cwd = '<get-var WML_SRC_DIRNAME>';
 480
 481     #   determine base URL
 482     $baseurl = '<get-var BASE_URL>' || 'file://';
 483
 484     #   determine base directory
 485     $basedir = '<get-var BASE_DIR>' || '<get-var WML_SRC_DIRNAME>';
 486     $basedir = &canonpath("$cwd/$basedir") if ($basedir !~ m|^/|);
 487
 488     #   determine subdir from base dir to current working dir
 489     $subdir = &relpath($basedir, $cwd);
 490
 491     #   determine document
 492     $page = '%0';
 493
 494     #   construct final URL
 495     $url = "$baseurl/$subdir/$page";
 496     $url = &canonurl($url);
 497
 498     #   replace this tag with the constructed URL
 499     print $url;
 500 }:>
 501 </define-tag>
 502
 503 ##
 504 ##  Finally, the layout is now rendered, so divert all
 505 ##  following stuff (the code in the local file after the #use
 506 ##  for this template!) into the white body area.
 507 ##
 508
 509 ..PAGE_BODY>>
 510