2 ## openssl.wml -- WML Template for the www.openssl.org website
3 ## Written by Ralf S. Engelschall <rse@engelschall.com>
5 ## Usage: #use wml::openssl area=<area_name> [page=<page_name>]
14 ## The Global Page Layout
17 # start of page header
22 # insert information about the webpage
23 <info style=comment domainname="openssl.org"
24 copyright="1998-2014 The OpenSSL Project, http://www.openssl.org/">
25 <info style=meta domainname="openssl.org"
26 copyright="1998-2014 The OpenSSL Project, http://www.openssl.org/">
28 # insert overideable title container
29 <title*>OpenSSL: {#PAGE_TITLE#}</title*>
30 # predefine it to show errors
31 ..PAGE_TITLE!>>Error: Undefined Title !!<<..
33 <define-tag title endtag=required>
34 ..PAGE_TITLE>>%body<<..
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; }
57 # end of header and start of physical body
58 # (use additionally use colors here for older browsers)
60 <body link="#6666cc" alink="#6666cc" vlink="#6666cc" bgcolor="#666699" text="#000000"
61 marginheight=0 leftmargin=0 rightmargin=0 topmargin=0>
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
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"> </td>\
71 <td align=right width=50 bgcolor="#666699"> </td>\
73 # visually: the top of the white body with the subnavbar
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">\
80 <td align=right width=20><img src="$(IMG)/page-corner-tr.gif"></td>\
81 <td align=right width=50 bgcolor="#666699"> </td>\
83 # visually: the left main navigation bar and the white body
85 <td align=left valign=top width=100 bgcolor="#666699">{#PAGE_NAVBAR#}</td>\
86 <td align=left valign=top width=20 bgcolor="#ffffff"> </td>\
87 <td align=left valign=top bgcolor="#ffffff">\
89 :PAGE_HEAD][PAGE_BODY:
91 :PAGE_BODY][PAGE_FOOT:\
93 <td align=right width=20 bgcolor="#ffffff"> </td>\
94 <td align=right width=50 bgcolor="#666699"> </td>\
96 # visually: the bottom of the white body
98 <td align=left valign=top width=100 bgcolor="#666699"> </td>\
99 <td align=left width=20><img src="$(IMG)/page-corner-bl.gif"></td>\
100 <td align=left valign=top bgcolor="#ffffff"> </td>\
101 <td align=right width=20><img src="$(IMG)/page-corner-br.gif"></td>\
102 <td align=right width=50 bgcolor="#666699"> </td>\
104 # visually: the bottom of the page (only for esthetical
105 # reasons, i.e. the page doesn't end with the white body)
107 <td colspan=5 bgcolor="#666699"> </td>\
111 # the physical end of the body
117 ## The main Navigation Bar [left, vertically]
120 # define the navigation bar through a grammar
121 <navbar:define name=navbar imgstar="n:s:s"
122 imgbase="$(IMG)" urlbase="$(ROOT)">
131 <navbar:button id=title url="." txt="Home" img=page-navbar-ti-*.jpg>
132 <navbar:button id=source url=source/ txt="Download" img=page-navbar-so-*.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=FAQ url=support/faq.html txt="FAQ" img=page-navbar-fq-*.jpg>
136 <navbar:button id=docs url=docs/ txt="Documents" img=page-navbar-do-*.jpg>
137 <navbar:button id=support url=support/ txt="Support" img=page-navbar-su-*.jpg>
147 # and then immediately render it into its layout location
148 # (Hint: The top and buttom images have to be part of the table
149 # structure because only this way we can put them 0pt to the
150 # buttons without a gap)
152 <table cellspacing=0 cellpadding=0 border=0>\
153 <tr><td><img src="$(IMG)/page-navbar-top.jpg"></td></tr>
155 <navbar:render name=navbar select=$(area) $(page:+subselected)>
156 <tr><td><img src="$(IMG)/page-navbar-bot.jpg"><br><p></td></tr>
161 ## The Sub Navigation Bar (SNB) [top, horizontally]
164 # define the <snb>...</snb> container tag
165 <define-tag snb endtag=required>
166 # 1. define the navigation bar through a grammar
167 <navbar:define name=snb urlbase="$(SNB_ROOT)"
168 txtcol_normal="#666666" txtcol_select="#000000">
171 <table cellspacing=0 cellpadding=0 border=0>
174 # button prolog (normal)
176 <td><font face="Arial,Helvetica">
178 # button prolog (selected)
179 <navbar:prolog type=S>\
180 <td bgcolor="#f0f0f0"> <font face="Arial,Helvetica"><b>
182 # ...here the <snb_button> tags will occur...
184 # button epilog (normal)
186 </font> </td><td>|</td>
188 # button epilog (selected)
189 <navbar:epilog type=S>\
190 </b></font> </td><td>|</td>
192 # last button epilog (normal)
193 <navbar:epilog pos=last>\
194 </font> </td><td></td>
196 # last button epilog (selected)
197 <navbar:epilog type=S pos=last>\
198 </b></font> </td><td></td>
206 # 2. render the navigation bar and divert
207 # divert it into it's final location
209 <navbar:render name=snb select="$(page)">\
213 # define the <snb_button> tag for the <snb> container
214 # (this is for consistency with the tag names)
215 <define-tag snb_button>
216 <navbar:button %attributes>
219 # predefine the contents of the SNB location
220 # by diverting a whitespace character to it.
221 # This prevents the table to be folded.
226 # and now the final WML trick: When the page=<page_name>
227 # attribute is specified for this template, we read in the SNB
228 # spec-file which now can use the <snb>..</snb> and
229 # <snb_button> tags to actually define and render a SNB. This
230 # is accomplished by doing some sort of a conditional #include. ;-)
231 $(page:*# )$(page:+#include ")$(SNB_RC:-.wmlsnb)$(page:+")
234 ## Useful tags (for convenience purposes only)
237 # define a <item> tag for <ul>/<ol> item similar to <li> but
238 # which is nice for URL lists like the Related area where
239 # we want a special layout.
246 <set-var %attributes>
247 <li><imgdot width=1 height=18>\
248 <a href="<get-var url>"><font size=+1 face="Arial,Helvetica"><b><get-var name></b></font></a>
249 <ifeq "<get-var aio>" "" <img src="aio.gif" alt="[all-in-one]" align=absmiddle>>
251 <a href="<get-var url>"><font size=-1><get-var url></font></a><br>
252 <ifeq "<get-var info>" "" "" "<get-var info>">
259 # define a <filelist> tag which can be used to create a file listing which
260 # is optically more compact than the stuff Apache's mod_autoindex creates.
261 # Especially the current version is marked red, too.
262 <define-tag filelist>
264 <b> Bytes Timestamp Filename</b>
265 <b>________ ____________________ ____________________________</b>
268 open(FP, "<index.current");
276 my (@F, @R, $f, @S, @T);
277 @F = sort { (stat($a))[9] <=> (stat($b))[9]; } (glob($pat));
280 next if ($f =~ m|^index.*|);
287 $f = "$f/" if (-d $f);
288 @T = localtime($S[9]);
289 my @moy = ('Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun',
290 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec');
291 push(@R, sprintf("%"."8d %"."s %"."2d %"."02d:%"."02d:%"."02d %"."d %"."s\n",
292 $S[7], $moy[$T[4]], $T[3], $T[2], $T[1], $T[0], 1900+$T[5], $f));
298 next if ($l =~ m|^\s*$|);
299 $l =~ s|(\s+)(\S+[^/])(\s*\n)$|$1."<a href=\"$2\">$2</a>".$3|e;
300 $l =~ s|(\s+)(\S+/)(\s*\n)$|$1."<a href=\"$2\"><b>$2</b></a>".$3|e;
302 $l =~ s|^(.*$hi.*)$|<font color="#cc3333">$1 <b>[LATEST]</b></font>|;
303 $l =~ s|>($hi)<|><font color="#cc3333">$1</font><|;
311 <define-tag rfilelist>
313 <b> Bytes Timestamp Filename</b>
314 <b>________ ____________________ ____________________________</b>
317 open(FP, "<index.current");
322 # If line is of form "last <regex>" look for last
323 # matching filename in the list.
324 # This means "last openssl-1*.tar.gz" will automatically
325 # mark the last version of OpenSSL as the latest without
326 # the need to manually update index.current on each release.
327 if (/^\s*last\s*(\S+)\s*$/) {
328 # Get list of all file, skip betas
329 my @list = sort grep(!/beta/, glob($1));
330 my $lastfile = pop @list;
331 push(@HI, $lastfile) if (-f $lastfile);
339 my (@F, @R, $f, @S, @T);
340 @F = sort { (stat($b))[9] <=> (stat($a))[9]; } (glob($pat));
343 next if ($f =~ m|^index.*|);
350 $f = "$f/" if (-d $f);
351 @T = localtime($S[9]);
352 my @moy = ('Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun',
353 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec');
354 push(@R, sprintf("%"."8d %"."s %"."2d %"."02d:%"."02d:%"."02d %"."d %"."s\n",
355 $S[7], $moy[$T[4]], $T[3], $T[2], $T[1], $T[0], 1900+$T[5], $f));
361 next if ($l =~ m|^\s*$|);
362 if ($l =~ m|(\s+)(\S+[^/])(\s*\n)$|) {
366 my $r = "<a href=\"$f\">$f</a>";
367 if (-f "$f.md5") { $r .= " (<a href=\"$f.md5\">MD5</a>)"; }
368 if (-f "$f.sha1") { $r .= " (<a href=\"$f.sha1\">SHA1</a>)"; }
369 if (-f "$f.asc") { $r .= " (<a href=\"$f.asc\">PGP sign</a>)"; }
372 $l =~ s|(\s+)(\S+/)(\s*\n)$|$1."<a href=\"$2\"><b>$2</b></a>".$3|e;
374 $l =~ s|^(.*$hi.*)$|<font color="#cc3333">$1 <b>[LATEST]</b></font>|;
375 $l =~ s|>($hi)<|><font color="#cc3333">$1</font><|;
384 <preserve minversion>
385 <preserve maxversion>
387 <set-var %attributes>
390 my $minversion = "<get-var minversion>";
391 my $maxversion = "<get-var maxversion>";
392 my $dirname = "<get-var dirname>";
396 if ($maxversion eq "") {
397 $minversion="<get-var WML_SRC_FILENAME>";
398 $minversion =~ s/^.*-(\d+\.\d+\.\d+)-.*$/$1/;
399 $maxversion = $minversion;
405 my $dir = defined $ENV{PODSHOME} ? "$ENV{PODSHOME}/../.." : "/v/openssl/checkouts";
406 if ($dirname ne "") {
407 $file = "${dir}/$dirname/NEWS";
410 $file = "${dir}/openssl-${minversion}-stable/NEWS";
413 $file = $ENV{NEWSTEST} if defined $ENV{NEWSTEST};
414 if ($custompage == 0) {
415 my $brname = $minversion;
417 $brname = "OpenSSL_${brname}-stable";
419 <title>OpenSSL $minversion Release Notes.</title>
420 <h1>OpenSSL $minversion Branch Release notes</h1>
422 The major changes and known issues for the $minversion branch of the OpenSSL
423 toolkit are summarised below. The contents reflect the current state of the
424 <tt>NEWS</tt> file inside the git repository.
426 Additional details of changes can be found in the <a href="http://git.openssl.org/gitweb/?p=openssl.git;a=blob_plain;f=CHANGES;hb=refs/heads/$brname">ChangeLog for OpenSSL $minversion</a>.
428 A complete list of changes to OpenSSL $minversion can be found in the <a href="http://git.openssl.org/gitweb/?p=openssl.git;a=shortlog;h=refs/heads/$brname">git repository commit log</a>.
436 open(FP, "<$file") || die "Can't open $file";
438 if (/^\s*Major changes between.*(\d+\.\d+\.\d+)\D.*$/ ||
439 /^\s*Known issues in.*(\d+\.\d+\.\d+)\D.*$/) {
440 if ($1 ge $minversion && $1 le $maxversion) {
457 if (s/^\s+o\s+/<li>/ && !$in_ul) {
461 s/CVE-(\d{4}-\d{4})/<a href=vulnerabilities.html#$1>CVE-$1<\/a>/g;
475 <define-tag newsflash>
479 <set-var %attributes>
480 <table width=550 cellspacing=0 cellpadding=1 border=0>
481 <tr><td><font face="Arial,Helvetica"><b>Date</b></font></td> <td> <font face="Arial,Helvetica"><b>Newsflash</b></font></td></tr>
482 <tr><td><hr noshade size=1></td> <td><hr noshade size=1></td></tr>
484 open(FP, "< <get-var from>") || die;
485 my $max = ("<get-var max>" eq '' ? 9999 : "<get-var max>");
493 $ncol = ($ncol + 1) % 2;
495 s|="ROOT|="$(ROOT)|g;
496 if (m|^(.+?):(.+)|) {
497 print "<tr bgcolor=\"$col\">\n";
498 print " <td align=right><font face=\"Arial,Helvetica\"><b>$1:</b></font></td> <td> $2</td>\n";
502 last if ($n >= $max);
506 <ifeq "<get-var more>" "" "" <group
508 <td> </td> <td align=right><a href="<get-var more>">more...</a></td>
517 # define a <disclaimer> tag which displays the usual disclaimer stuff
518 <define-tag disclaimer>
519 <font face="Arial,Helvetica" size=-1>
520 This software package uses strong cryptography, so even if it is created,
521 maintained and distributed from liberal countries in Europe (where it is legal
522 to do this), it falls under certain export/import and/or use restrictions in
523 some other parts of the world.
525 PLEASE REMEMBER THAT EXPORT/IMPORT AND/OR USE OF STRONG CRYPTOGRAPHY
526 SOFTWARE, PROVIDING CRYPTOGRAPHY HOOKS OR EVEN JUST COMMUNICATING TECHNICAL
527 DETAILS ABOUT CRYPTOGRAPHY SOFTWARE IS ILLEGAL IN SOME PARTS OF THE WORLD.
528 SO, WHEN YOU IMPORT THIS PACKAGE TO YOUR COUNTRY, RE-DISTRIBUTE IT FROM
529 THERE OR EVEN JUST EMAIL TECHNICAL SUGGESTIONS OR EVEN SOURCE PATCHES TO THE
530 AUTHOR OR OTHER PEOPLE YOU ARE STRONGLY ADVISED TO PAY CLOSE ATTENTION TO
531 ANY EXPORT/IMPORT AND/OR USE LAWS WHICH APPLY TO YOU. THE AUTHORS OF OPENSSL
532 ARE NOT LIABLE FOR ANY VIOLATIONS YOU MAKE HERE. SO BE CAREFUL, IT
533 IS YOUR RESPONSIBILITY.
536 <font face="Arial,Helvetica" size=-1>
538 This product includes cryptographic software written by Eric Young.
539 This product includes software written by Tim Hudson (tjh@cryptsoft.com).
543 # a tag displaying the used tools
544 <define-tag website-tools>
545 <font face="Arial,Helvetica" size=-1>
547 <a href="http://www.engelschall.com/">Ralf S. Engelschall</a>
549 <a href="http://thewml.org/"><font color="#000000">
550 Website META Language</font></a> (WML).<br>
551 All markup code and graphics on this website
552 are Copyright © 1999-2014 <a href="http://www.openssl.org/">The OpenSSL Project</a>,
553 All rights reserved.<br>
554 This website is served by an
555 <a href="http://www.apache.org/"><font color="#000000">Apache</font></a>/
556 <a href="http://www.modssl.org/"><font color="#000000">mod_ssl</font></a>
557 webserver environment.<br>
561 # construct an absolute URL out of a relative URL
562 # (essential for the mirroring of the website!)
563 <define-tag absolute>
565 my ($cwd, $baseurl, $basedir, $subdir, $page, $url);
567 # determine current working directory
568 $cwd = '<get-var WML_SRC_DIRNAME>';
571 $baseurl = '<get-var BASE_URL>' || 'file://';
573 # determine base directory
574 $basedir = '<get-var BASE_DIR>' || '<get-var WML_SRC_DIRNAME>';
575 $basedir = &canonpath("$cwd/$basedir") if ($basedir !~ m|^/|);
577 # determine subdir from base dir to current working dir
578 $subdir = &relpath($basedir, $cwd);
583 # construct final URL
584 $url = "$baseurl/$subdir/$page";
585 $url = &canonurl($url);
587 # replace this tag with the constructed URL
593 ## Finally, the layout is now rendered, so divert all
594 ## following stuff (the code in the local file after the #use
595 ## for this template!) into the white body area.