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=FAQ url=support/faq.html txt="FAQ" img=page-navbar-fq-*.jpg>
134 <navbar:button id=about url=about/ txt="About" img=page-navbar-ab-*.jpg>
135 <navbar:button id=news url=news/ txt="News" img=page-navbar-ne-*.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>
138 <navbar:button id=security url=news/vulnerabilities.html txt="Security" img=page-navbar-se-*.jpg>
148 # and then immediately render it into its layout location
149 # (Hint: The top and buttom images have to be part of the table
150 # structure because only this way we can put them 0pt to the
151 # buttons without a gap)
153 <table cellspacing=0 cellpadding=0 border=0>\
154 <tr><td><img src="$(IMG)/page-navbar-top.jpg"></td></tr>
156 <navbar:render name=navbar select=$(area) $(page:+subselected)>
157 <tr><td><img src="$(IMG)/page-navbar-bot.jpg"><br><p></td></tr>
162 ## The Sub Navigation Bar (SNB) [top, horizontally]
165 # define the <snb>...</snb> container tag
166 <define-tag snb endtag=required>
167 # 1. define the navigation bar through a grammar
168 <navbar:define name=snb urlbase="$(SNB_ROOT)"
169 txtcol_normal="#666666" txtcol_select="#000000">
172 <table cellspacing=0 cellpadding=0 border=0>
175 # button prolog (normal)
177 <td><font face="Arial,Helvetica">
179 # button prolog (selected)
180 <navbar:prolog type=S>\
181 <td bgcolor="#f0f0f0"> <font face="Arial,Helvetica"><b>
183 # ...here the <snb_button> tags will occur...
185 # button epilog (normal)
187 </font> </td><td>|</td>
189 # button epilog (selected)
190 <navbar:epilog type=S>\
191 </b></font> </td><td>|</td>
193 # last button epilog (normal)
194 <navbar:epilog pos=last>\
195 </font> </td><td></td>
197 # last button epilog (selected)
198 <navbar:epilog type=S pos=last>\
199 </b></font> </td><td></td>
207 # 2. render the navigation bar and divert
208 # divert it into it's final location
210 <navbar:render name=snb select="$(page)">\
214 # define the <snb_button> tag for the <snb> container
215 # (this is for consistency with the tag names)
216 <define-tag snb_button>
217 <navbar:button %attributes>
220 # predefine the contents of the SNB location
221 # by diverting a whitespace character to it.
222 # This prevents the table to be folded.
227 # and now the final WML trick: When the page=<page_name>
228 # attribute is specified for this template, we read in the SNB
229 # spec-file which now can use the <snb>..</snb> and
230 # <snb_button> tags to actually define and render a SNB. This
231 # is accomplished by doing some sort of a conditional #include. ;-)
232 $(page:*# )$(page:+#include ")$(SNB_RC:-.wmlsnb)$(page:+")
235 ## Useful tags (for convenience purposes only)
238 # define a <item> tag for <ul>/<ol> item similar to <li> but
239 # which is nice for URL lists like the Related area where
240 # we want a special layout.
247 <set-var %attributes>
248 <li><imgdot width=1 height=18>\
249 <a href="<get-var url>"><font size=+1 face="Arial,Helvetica"><b><get-var name></b></font></a>
250 <ifeq "<get-var aio>" "" <img src="aio.gif" alt="[all-in-one]" align=absmiddle>>
252 <a href="<get-var url>"><font size=-1><get-var url></font></a><br>
253 <ifeq "<get-var info>" "" "" "<get-var info>">
260 # define a <filelist> tag which can be used to create a file listing which
261 # is optically more compact than the stuff Apache's mod_autoindex creates.
262 # Especially the current version is marked red, too.
263 <define-tag filelist>
265 <b> Bytes Timestamp Filename</b>
266 <b>________ ____________________ ____________________________</b>
269 open(FP, "<index.current");
277 my (@F, @R, $f, @S, @T);
278 @F = sort { (stat($a))[9] <=> (stat($b))[9]; } (glob($pat));
281 next if ($f =~ m|^index.*|);
288 $f = "$f/" if (-d $f);
289 @T = localtime($S[9]);
290 my @moy = ('Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun',
291 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec');
292 push(@R, sprintf("%"."8d %"."s %"."2d %"."02d:%"."02d:%"."02d %"."d %"."s\n",
293 $S[7], $moy[$T[4]], $T[3], $T[2], $T[1], $T[0], 1900+$T[5], $f));
299 next if ($l =~ m|^\s*$|);
300 $l =~ s|(\s+)(\S+[^/])(\s*\n)$|$1."<a href=\"$2\">$2</a>".$3|e;
301 $l =~ s|(\s+)(\S+/)(\s*\n)$|$1."<a href=\"$2\"><b>$2</b></a>".$3|e;
303 $l =~ s|^(.*$hi.*)$|<font color="#cc3333">$1 <b>[LATEST]</b></font>|;
304 $l =~ s|>($hi)<|><font color="#cc3333">$1</font><|;
312 <define-tag rfilelist>
314 <b> Bytes Timestamp Filename</b>
315 <b>________ ____________________ ____________________________</b>
318 open(FP, "<index.current");
323 # If line is of form "last <regex>" look for last
324 # matching filename in the list.
325 # This means "last openssl-1*.tar.gz" will automatically
326 # mark the last version of OpenSSL as the latest without
327 # the need to manually update index.current on each release.
328 if (/^\s*last\s*(\S+)\s*$/) {
329 # Get list of all file, skip betas
330 my @list = sort grep(!/beta/, glob($1));
331 my $lastfile = pop @list;
332 push(@HI, $lastfile) if (-f $lastfile);
340 my (@F, @R, $f, @S, @T);
341 @F = sort { (stat($b))[9] <=> (stat($a))[9]; } (glob($pat));
344 next if ($f =~ m|^index.*|);
351 $f = "$f/" if (-d $f);
352 @T = localtime($S[9]);
353 my @moy = ('Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun',
354 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec');
355 push(@R, sprintf("%"."8d %"."s %"."2d %"."02d:%"."02d:%"."02d %"."d %"."s\n",
356 $S[7], $moy[$T[4]], $T[3], $T[2], $T[1], $T[0], 1900+$T[5], $f));
362 next if ($l =~ m|^\s*$|);
363 if ($l =~ m|(\s+)(\S+[^/])(\s*\n)$|) {
367 my $r = "<a href=\"$f\">$f</a>";
368 if (-f "$f.md5") { $r .= " (<a href=\"$f.md5\">MD5</a>)"; }
369 if (-f "$f.sha1") { $r .= " (<a href=\"$f.sha1\">SHA1</a>)"; }
370 if (-f "$f.asc") { $r .= " (<a href=\"$f.asc\">PGP sign</a>)"; }
373 $l =~ s|(\s+)(\S+/)(\s*\n)$|$1."<a href=\"$2\"><b>$2</b></a>".$3|e;
375 $l =~ s|^(.*$hi.*)$|<font color="#cc3333">$1 <b>[LATEST]</b></font>|;
376 $l =~ s|>($hi)<|><font color="#cc3333">$1</font><|;
385 <preserve minversion>
386 <preserve maxversion>
388 <set-var %attributes>
391 my $minversion = "<get-var minversion>";
392 my $maxversion = "<get-var maxversion>";
393 my $dirname = "<get-var dirname>";
397 if ($maxversion eq "") {
398 $minversion="<get-var WML_SRC_FILENAME>";
399 $minversion =~ s/^.*-(\d+\.\d+\.\d+)-.*$/$1/;
400 $maxversion = $minversion;
406 my $dir = defined $ENV{PODSHOME} ? "$ENV{PODSHOME}/../.." : "/v/openssl/checkouts";
407 if ($dirname ne "") {
408 $file = "${dir}/$dirname/NEWS";
411 $file = "${dir}/openssl-${minversion}-stable/NEWS";
414 $file = $ENV{NEWSTEST} if defined $ENV{NEWSTEST};
415 if ($custompage == 0) {
416 my $brname = $minversion;
418 $brname = "OpenSSL_${brname}-stable";
420 <title>OpenSSL $minversion Release Notes.</title>
421 <h1>OpenSSL $minversion Branch Release notes</h1>
423 The major changes and known issues for the $minversion branch of the OpenSSL
424 toolkit are summarised below. The contents reflect the current state of the
425 <tt>NEWS</tt> file inside the git repository.
427 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>.
429 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>.
437 open(FP, "<$file") || die "Can't open $file";
439 if (/^\s*Major changes between.*(\d+\.\d+\.\d+)\D.*$/ ||
440 /^\s*Known issues in.*(\d+\.\d+\.\d+)\D.*$/) {
441 if ($1 ge $minversion && $1 le $maxversion) {
458 if (s/^\s+o\s+/<li>/ && !$in_ul) {
462 s/CVE-(\d{4}-\d{4})/<a href=vulnerabilities.html#$1>CVE-$1<\/a>/g;
476 <define-tag newsflash>
480 <set-var %attributes>
481 <table width=550 cellspacing=0 cellpadding=1 border=0>
482 <tr><td><font face="Arial,Helvetica"><b>Date</b></font></td> <td> <font face="Arial,Helvetica"><b>Newsflash</b></font></td></tr>
483 <tr><td><hr noshade size=1></td> <td><hr noshade size=1></td></tr>
485 open(FP, "< <get-var from>") || die;
486 my $max = ("<get-var max>" eq '' ? 9999 : "<get-var max>");
494 $ncol = ($ncol + 1) % 2;
496 s|="ROOT|="$(ROOT)|g;
497 if (m|^(.+?):(.+)|) {
498 print "<tr bgcolor=\"$col\">\n";
499 print " <td align=right><font face=\"Arial,Helvetica\"><b>$1:</b></font></td> <td> $2</td>\n";
503 last if ($n >= $max);
507 <ifeq "<get-var more>" "" "" <group
509 <td> </td> <td align=right><a href="<get-var more>">more...</a></td>
518 # define a <disclaimer> tag which displays the usual disclaimer stuff
519 <define-tag disclaimer>
520 <font face="Arial,Helvetica" size=-1>
521 This software package uses strong cryptography, so even if it is created,
522 maintained and distributed from liberal countries in Europe (where it is legal
523 to do this), it falls under certain export/import and/or use restrictions in
524 some other parts of the world.
526 PLEASE REMEMBER THAT EXPORT/IMPORT AND/OR USE OF STRONG CRYPTOGRAPHY
527 SOFTWARE, PROVIDING CRYPTOGRAPHY HOOKS OR EVEN JUST COMMUNICATING TECHNICAL
528 DETAILS ABOUT CRYPTOGRAPHY SOFTWARE IS ILLEGAL IN SOME PARTS OF THE WORLD.
529 SO, WHEN YOU IMPORT THIS PACKAGE TO YOUR COUNTRY, RE-DISTRIBUTE IT FROM
530 THERE OR EVEN JUST EMAIL TECHNICAL SUGGESTIONS OR EVEN SOURCE PATCHES TO THE
531 AUTHOR OR OTHER PEOPLE YOU ARE STRONGLY ADVISED TO PAY CLOSE ATTENTION TO
532 ANY EXPORT/IMPORT AND/OR USE LAWS WHICH APPLY TO YOU. THE AUTHORS OF OPENSSL
533 ARE NOT LIABLE FOR ANY VIOLATIONS YOU MAKE HERE. SO BE CAREFUL, IT
534 IS YOUR RESPONSIBILITY.
537 <font face="Arial,Helvetica" size=-1>
539 This product includes cryptographic software written by Eric Young.
540 This product includes software written by Tim Hudson (tjh@cryptsoft.com).
544 # a tag displaying the used tools
545 <define-tag website-tools>
546 <font face="Arial,Helvetica" size=-1>
548 <a href="http://www.engelschall.com/">Ralf S. Engelschall</a>
550 <a href="http://thewml.org/"><font color="#000000">
551 Website META Language</font></a> (WML).<br>
552 All markup code and graphics on this website
553 are Copyright © 1999-2014 <a href="http://www.openssl.org/">The OpenSSL Project</a>,
554 All rights reserved.<br>
555 This website is served by an
556 <a href="http://www.apache.org/"><font color="#000000">Apache</font></a>/
557 <a href="http://www.modssl.org/"><font color="#000000">mod_ssl</font></a>
558 webserver environment.<br>
562 # construct an absolute URL out of a relative URL
563 # (essential for the mirroring of the website!)
564 <define-tag absolute>
566 my ($cwd, $baseurl, $basedir, $subdir, $page, $url);
568 # determine current working directory
569 $cwd = '<get-var WML_SRC_DIRNAME>';
572 $baseurl = '<get-var BASE_URL>' || 'file://';
574 # determine base directory
575 $basedir = '<get-var BASE_DIR>' || '<get-var WML_SRC_DIRNAME>';
576 $basedir = &canonpath("$cwd/$basedir") if ($basedir !~ m|^/|);
578 # determine subdir from base dir to current working dir
579 $subdir = &relpath($basedir, $cwd);
584 # construct final URL
585 $url = "$baseurl/$subdir/$page";
586 $url = &canonurl($url);
588 # replace this tag with the constructed URL
594 ## Finally, the layout is now rendered, so divert all
595 ## following stuff (the code in the local file after the #use
596 ## for this template!) into the white body area.