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"><span class="latest">$1</span></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}/../.." : "/var/cache/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
427 <a href="https://github.com/openssl/openssl/blob/$brname/CHANGES">
430 The complete list of changes can be found in the
431 <a href="https://github.com/openssl/openssl/commits/$brname">commit log</a>.
439 open(FP, "<$file") || die "Can't open $file";
441 if (/^\s*Major changes between.*(\d+\.\d+\.\d+)\D.*$/ ||
442 /^\s*Known issues in.*(\d+\.\d+\.\d+)\D.*$/) {
443 if ($1 ge $minversion && $1 le $maxversion) {
460 if (s/^\s+o\s+/<li>/ && !$in_ul) {
464 s/CVE-(\d{4}-\d{4})/<a href=vulnerabilities.html#$1>CVE-$1<\/a>/g;
478 <define-tag newsflash>
482 <set-var %attributes>
483 <table width=550 cellspacing=0 cellpadding=1 border=0>
484 <tr><td><font face="Arial,Helvetica"><b>Date</b></font></td> <td> <font face="Arial,Helvetica"><b>Newsflash</b></font></td></tr>
485 <tr><td><hr noshade size=1></td> <td><hr noshade size=1></td></tr>
487 open(FP, "< <get-var from>") || die;
488 my $max = ("<get-var max>" eq '' ? 9999 : "<get-var max>");
496 $ncol = ($ncol + 1) % 2;
498 s|="ROOT|="$(ROOT)|g;
499 if (m|^(.+?):(.+)|) {
500 print "<tr bgcolor=\"$col\">\n";
501 print " <td align=right><font face=\"Arial,Helvetica\"><b>$1:</b></font></td> <td> $2</td>\n";
505 last if ($n >= $max);
509 <ifeq "<get-var more>" "" "" <group
511 <td> </td> <td align=right><a href="<get-var more>">more...</a></td>
520 # define a <disclaimer> tag which displays the usual disclaimer stuff
521 <define-tag disclaimer>
522 <font face="Arial,Helvetica" size=-1>
523 This software package uses strong cryptography, so even if it is created,
524 maintained and distributed from liberal countries in Europe (where it is legal
525 to do this), it falls under certain export/import and/or use restrictions in
526 some other parts of the world.
528 PLEASE REMEMBER THAT EXPORT/IMPORT AND/OR USE OF STRONG CRYPTOGRAPHY
529 SOFTWARE, PROVIDING CRYPTOGRAPHY HOOKS OR EVEN JUST COMMUNICATING TECHNICAL
530 DETAILS ABOUT CRYPTOGRAPHY SOFTWARE IS ILLEGAL IN SOME PARTS OF THE WORLD.
531 SO, WHEN YOU IMPORT THIS PACKAGE TO YOUR COUNTRY, RE-DISTRIBUTE IT FROM
532 THERE OR EVEN JUST EMAIL TECHNICAL SUGGESTIONS OR EVEN SOURCE PATCHES TO THE
533 AUTHOR OR OTHER PEOPLE YOU ARE STRONGLY ADVISED TO PAY CLOSE ATTENTION TO
534 ANY EXPORT/IMPORT AND/OR USE LAWS WHICH APPLY TO YOU. THE AUTHORS OF OPENSSL
535 ARE NOT LIABLE FOR ANY VIOLATIONS YOU MAKE HERE. SO BE CAREFUL, IT
536 IS YOUR RESPONSIBILITY.
539 <font face="Arial,Helvetica" size=-1>
541 This product includes cryptographic software written by Eric Young.
542 This product includes software written by Tim Hudson (tjh@cryptsoft.com).
546 # a tag displaying the used tools
547 <define-tag website-tools>
548 <font face="Arial,Helvetica" size=-1>
550 <a href="http://www.engelschall.com/">Ralf S. Engelschall</a>
552 <a href="http://thewml.org/"><font color="#000000">
553 Website META Language</font></a> (WML).<br>
554 All markup code and graphics on this website
555 are Copyright © 1999-2014 <a href="http://www.openssl.org/">The OpenSSL Project</a>,
556 All rights reserved.<br>
557 This website is served by an
558 <a href="http://www.apache.org/"><font color="#000000">Apache</font></a>/
559 <a href="http://www.modssl.org/"><font color="#000000">mod_ssl</font></a>
560 webserver environment.<br>
564 # construct an absolute URL out of a relative URL
565 # (essential for the mirroring of the website!)
566 <define-tag absolute>
568 my ($cwd, $baseurl, $basedir, $subdir, $page, $url);
570 # determine current working directory
571 $cwd = '<get-var WML_SRC_DIRNAME>';
574 $baseurl = '<get-var BASE_URL>' || 'file://';
576 # determine base directory
577 $basedir = '<get-var BASE_DIR>' || '<get-var WML_SRC_DIRNAME>';
578 $basedir = &canonpath("$cwd/$basedir") if ($basedir !~ m|^/|);
580 # determine subdir from base dir to current working dir
581 $subdir = &relpath($basedir, $cwd);
586 # construct final URL
587 $url = "$baseurl/$subdir/$page";
588 $url = &canonurl($url);
590 # replace this tag with the constructed URL
596 ## Finally, the layout is now rendered, so divert all
597 ## following stuff (the code in the local file after the #use
598 ## for this template!) into the white body area.