]> git.deb.at Git - deb/packages.git/blob - lib/Packages/HTML.pm
8d43b3be56d4cbf5e37851f5a88aa0da24e164e6
[deb/packages.git] / lib / Packages / HTML.pm
1 package Packages::HTML;
2
3 use strict;
4 use warnings;
5
6 use URI::Escape;
7 use HTML::Entities;
8
9 use Packages::CGI;
10 use Packages::Search qw( read_entry_simple );
11 use Packages::Config qw( :all );
12
13 #use Packages::Util;
14 #use Packages::I18N::Locale;
15 #use Packages::I18N::Languages;
16 #use Packages::I18N::LanguageNames;
17 #use Generated::Strings qw( gettext dgettext );
18
19 # dummy routines
20 sub get_charset { return "utf-8" };
21 sub gettext { return $_[0]; };
22
23 our @ISA = qw( Exporter );
24 our @EXPORT = qw( header title trailer file_changed time_stamp
25                   read_md5_hash write_md5_hash simple_menu
26                   ds_begin ds_item ds_end note title marker pdesc
27                   pdeplegend pkg_list pmoreinfo print_deps print_src_deps );
28
29 our $CHANGELOG_URL = '/changelogs';
30
31 sub img {
32     my ( $root, $url, $src, $alt, %attr ) = @_; 
33     my @attr;
34
35     foreach my $a ( keys %attr ) {
36         push @attr, "$a=\"$attr{$a}\"";
37     }
38
39     return "<a href=\"$root$url\"><img src=\"$root$src\" alt=\"$alt\" @attr></a>";
40 }
41
42 sub simple_menu {
43     my $str = "";
44     foreach my $entry (@_) {
45         $str .= "[&nbsp;$entry->[0] <a title=\"$entry->[1]\" href=\"$entry->[2]\">$entry->[3]</a>&nbsp;]\n";
46     }
47     return $str;
48 }
49
50 sub title {
51     return "<h1>$_[0]</h1>\n";
52 }
53
54 sub marker {
55     return "[<span class=\"pred\">$_[0]</span>]";
56 }
57
58 sub pdesc {
59     my ( $short_desc, $long_desc ) = @_;
60     my $str = "";
61
62     $str .= "<div id=\"pdesc\">\n";
63     $str .= "<h2>$short_desc</h2>\n";
64
65     $str .= "<p>$long_desc\n";
66     $str .= "</div> <!-- end pdesc -->\n";
67
68     return $str;
69 }
70
71 sub pdeplegend {
72     my $str = "<table border=\"1\" summary=\"legend\"><tr>\n";
73
74     foreach my $entry (@_) {
75         $str .= "<td><img src=\"$ROOT/Pics/$entry->[0].gif\" alt=\"[$entry->[0]]\" width=\"16\" height=\"16\">= $entry->[1]</td>";
76     }
77
78     $str .= "\n</tr></table>\n";
79     return $str;
80 }
81
82 sub pkg_list {
83     my ( $packages, $opts, $pkgs, $lang ) = @_;
84
85     my $str = "";
86     foreach my $p ( @$pkgs ) {
87
88         my $short_desc = (read_entry_simple( $packages, $p, $opts->{h_archives}, $opts->{suite}))->[-1];
89
90         if ( $short_desc ) {
91             $str .= "<dt><a href=\"$ROOT/$opts->{suite}/$p\">$p</a></dt>\n".
92                     "\t<dd>$short_desc</dd>\n";
93         } else {
94             $str .= "<dt>$p</dt>\n\t<dd>".gettext("Not available")."</dd>\n";
95         }
96     }
97     if ($str) {
98         $str = "<dl>$str</dl>\n";
99     }
100
101     return $str;
102 }
103
104 sub pmoreinfo {
105     my %info = @_;
106     
107     my $name = $info{name} or return;
108     my $env = $info{env} or return;
109     my $opts = $info{opts} or return;
110     my $page = $info{data} or return;
111     my $is_source = $info{is_source};
112
113     my $str = "<div id=\"pmoreinfo\">";
114     $str .= sprintf( "<h2>".gettext( "More Information on %s" )."</h2>",
115                      $name );
116     
117     if ($info{bugreports}) {
118         my $bug_url = $is_source ? $SRC_BUG_URL : $BUG_URL; 
119         $str .= "<p>\n".sprintf( gettext( "Check for <a href=\"%s\">Bug Reports</a> about %s." )."<br>\n",
120                          $bug_url.$name, $name );
121     }
122         
123     my $source = $page->get_src( 'package' );
124     my $source_version = $page->get_src( 'version' );
125     my $src_dir = $page->get_src('directory');
126     if ($info{sourcedownload}) {
127         my $files = $page->get_src( 'files' );
128         my $path = (@{$opts->{archive}} >1) ?
129             $opts->{suite} :
130             "$opts->{suite}/$opts->{archive}[0]";
131         $str .= gettext( "Source Package:" );
132         $str .= " <a href=\"/$path/source/$source\">$source</a>, ".
133             gettext( "Download" ).":\n";
134
135         unless (defined($files) and @$files) {
136             $str .= gettext( "Not found" );
137         } else {
138             foreach( @$files ) {
139                 my ($src_file_md5, $src_file_size, $src_file_name) = split /\s/o, $_;
140                 for ($page->get_newest('archive')) {
141                     /security/o && do {
142                         $str .= "<a href=\"$env->{security}/$src_dir/$src_file_name\">["; last };
143                     /volatile/o && do {
144                         $str .= "<a href=\"$env->{volatile}/$src_dir/$src_file_name\">["; last };
145                     /backports/o && do {
146                         $str .= "<a href=\"$env->{backports}/$src_dir/$src_file_name\">["; last };
147                     /non-us/io && do {
148                         $str .= "<a href=\"$env->{nonus_site}/$src_dir/$src_file_name\">["; last };
149                     $str .= "<a href=\"$env->{us}/$src_dir/$src_file_name\">[";
150                 }
151                 if ($src_file_name =~ /dsc$/) {
152                     $str .= "dsc";
153                 } else {
154                     $str .= $src_file_name;
155                 }
156                 $str .= "]</a>\n";
157             }
158         }
159 #           $package_page .= sprintf( gettext( " (These sources are for version %s)\n" ), $src_version )
160 #               if ($src_version ne $version) && !$src_version_given_in_control;
161     }
162
163     if ($info{changesandcopy}) {
164         if ( $src_dir ) {
165             (my $src_basename = $source_version) =~ s,^\d+:,,; # strip epoche
166             $src_basename = "${source}_$src_basename";
167             $src_dir =~ s,pool/updates,pool,o;
168             $src_dir =~ s,pool/non-US,pool,o;
169             $str .= "<br>".sprintf( gettext( "View the <a href=\"%s\">Debian changelog</a>" ),
170                                     "$CHANGELOG_URL/$src_dir/$src_basename/changelog" )."<br>\n";
171             my $copyright_url = "$CHANGELOG_URL/$src_dir/$src_basename/";
172             $copyright_url .= ( $is_source ? 'copyright' : "$name.copyright" );
173
174             $str .= sprintf( gettext( "View the <a href=\"%s\">copyright file</a>" ),
175                              $copyright_url )."</p>";
176         }
177    }
178
179     if ($info{maintainers}) {
180         my $uploaders = $page->get_src( 'uploaders' );
181         if ($uploaders && @$uploaders) {
182             foreach (@$uploaders) {
183                 $_->[0] = encode_entities( $_->[0], '&<>' );
184             }
185             my ($maint_name, $maint_mail) = @{shift @$uploaders}; 
186             unless (@$uploaders) {
187                 $str .= "<p>\n".sprintf( gettext( "%s is responsible for this Debian package." ).
188                                          "\n",
189                                          "<a href=\"mailto:$maint_mail\">$maint_name</a>" 
190                                          );
191             } else {
192                 my $up_str = "<a href=\"mailto:$maint_mail\">$maint_name</a>";
193                 my @uploaders_str;
194                 foreach (@$uploaders) {
195                     push @uploaders_str, "<a href=\"mailto:$_->[1]\">$_->[0]</a>";
196                 }
197                 my $last_up = pop @uploaders_str;
198                 $up_str .= ", ".join ", ", @uploaders_str if @uploaders_str;
199                 $up_str .= sprintf( gettext( " and %s are responsible for this Debian package." ), $last_up );
200                 $str .= "<p>\n$up_str ";
201             }
202         }
203
204         $str .= sprintf( gettext( "See the <a href=\"%s\">developer information for %s</a>." )."</p>", $QA_URL.$source, $name ) if $source;
205     }
206
207     if ($info{search}) {
208         my $encodedname = uri_escape( $name );
209         my $search_url = $is_source ? $SRC_SEARCH_URL : $SEARCH_URL;
210         $str .= "<p>".sprintf( gettext( "Search for <a href=\"%s\">other versions of %s</a>" ), $search_url.$encodedname, $name )."</p>\n";
211     }
212
213     $str .= "</div> <!-- end pmoreinfo -->\n";
214     return $str;
215 }
216
217 sub dep_item {
218     my ( $link, $name, $info, $desc ) = @_;
219     my $post_link = '';
220     if ($link) {
221         $link = "<a href=\"$link\">";
222         $post_link = '</a>';
223     } else {
224         $link = '';
225     }
226     if ($info) {
227         $info = " $info";
228     } else {
229         $info = '';
230     }
231     if ($desc) {
232         $desc = "</dt><dd>$desc</dd>";
233     } else {
234         $desc = '</dt>';
235     }
236
237     return "$link$name$post_link$info$desc";
238 } # end dep_item
239
240 sub print_deps {
241     my ( $packages, $opts, $pkg, $relations, $type) = @_;
242     my %dep_type = ('depends' => 'dep', 'recommends' => 'rec', 
243                     'suggests' => 'sug');
244     my $res = "<ul class=\"ul$dep_type{$type}\">\n";
245     my $first = 1;
246
247 #    use Data::Dumper;
248 #    debug( "print_deps called:\n".Dumper( $pkg, $relations, \$type ), 3 );
249
250     foreach my $rel (@$relations) {
251         my $is_old_pkgs = $rel->[0];
252         my @res_pkgs = ();
253
254         if ($is_old_pkgs)  {
255             $res .= "<dt>";
256         } else {
257             if ($first) {
258                 $res .= "<li>";
259                 $first = 0;
260             } else {
261                 $res .= "</dl></li>\n<li>";
262             }
263             $res .= "<dl><dt><img class=\"hidecss\" src=\"$ROOT/Pics/$dep_type{$type}.gif\" alt=\"[$dep_type{$type}]\"> ";
264         }
265
266         foreach my $rel_alt ( @$rel ) {
267             next unless ref($rel_alt);
268             my ( $p_name, $pkg_version, $arch_neg,
269                  $arch_str, $subsection, $available ) = @$rel_alt;
270
271             if ($arch_str) {
272                 if ($arch_neg) {
273                     $arch_str = " [".gettext("not")." $arch_str]";
274                 } else {
275                     $arch_str = " [$arch_str]";
276                 }
277             }
278             $pkg_version = "($pkg_version)" if $pkg_version;
279             
280             my @results;
281             my %short_descs;
282             my $short_desc = $short_descs{$p_name} ||
283                 (read_entry_simple( $packages, $p_name, $opts->{h_archives}, $opts->{suite}))->[-1];
284             if ( $short_desc ) {
285                 if ( $is_old_pkgs ) {
286                     push @res_pkgs, dep_item( "/$opts->{suite}/$p_name",
287                                               $p_name, "$pkg_version$arch_str" );
288                 } else {
289                     $short_descs{$p_name} ||= $short_desc;
290                     $short_desc = encode_entities( $short_desc, "<>&\"" );
291                     push @res_pkgs, dep_item( "/$opts->{suite}/$p_name",
292                                               $p_name, "$pkg_version$arch_str", $short_desc );
293                 }
294             } elsif ( $is_old_pkgs ) {
295                 push @res_pkgs, dep_item( undef, $p_name, "$pkg_version$arch_str" );
296             } else {
297                 my $short_desc = gettext( "Package not available" );
298                 push @res_pkgs, dep_item( undef, $p_name, "$pkg_version$arch_str", $short_desc );
299             }
300             
301         }
302         
303         $res .= "\n".join( "<dt>".gettext( "or" )." ", @res_pkgs )."\n";
304     }
305     if (@$relations) {
306         $res .= "</dl></li>\n";
307         $res .= "</ul>\n";
308     } else {
309         $res = "";
310     }
311     return $res;
312 } # end print_deps
313
314 sub print_src_deps {
315     my ( $packages, $opts, $pkg, $relations, $type) = @_;
316     my %dep_type = ('build-depends' => 'adep', 'build-depends-indep' => 'idep' );
317     my $res = "<ul class=\"ul$dep_type{$type}\">\n";
318     foreach my $dep (@$relations) {
319         my @res_pkgs;
320         $res .= "<li><dl><dt><img class=\"hidecss\" src=\"$ROOT/Pics/$dep_type{$type}.gif\" alt=\"[$dep_type{$type}]\"> ";
321         foreach my $or_dep ( @$dep ) {
322             my $p_name = $or_dep->[0];
323             my $p_version = $or_dep->[1] ? "(".encode_entities( $or_dep->[1] ).
324                 " $or_dep->[2]) " : "";
325             my $not = gettext( "not" );
326             my $arch_str = '';
327             if ($or_dep->[3] && @{$or_dep->[3]}) {
328                 # as either all or no archs have to be prepended with
329                 # exlamation marks, convert the first and delete the others
330                 if ($or_dep->[3][0] =~ /^!/) {
331                     $arch_str = "$not ";
332                     foreach (@{$or_dep->[3]}) {
333                         $_ =~ s/^!//go;
334                     }
335                 }
336                 $arch_str = " [${arch_str}@{$or_dep->[3]}]";
337             }
338             my $short_desc = (read_entry_simple( $packages, $p_name, $opts->{h_archives}, $opts->{suite}))->[-1];
339             if ( $short_desc ) {
340                 $short_desc = encode_entities( $short_desc, "<>&\"" );
341                 push @res_pkgs, dep_item( "/$opts->{suite}/$p_name", $p_name, "$p_version$arch_str", $short_desc );
342             } else {
343                 $short_desc = gettext( "Package not available" );
344                 push @res_pkgs, dep_item( undef, $p_name, "$p_version$arch_str", $short_desc );
345             }
346         }
347         $res .= "\n".join( "<dt>\n".gettext( "or" )." ", @res_pkgs )."</dl></li>\n";
348     }
349     if (@$relations) {
350         $res .= "\n</ul>";
351     } else {
352         $res = "";
353     }
354         return $res;
355 } # end print_src_deps
356
357
358 my $ds_begin = '<dl>';
359 my $ds_item_desc  = '<dt>';
360 my $ds_item = ':</dt><dd>';
361 my $ds_item_end = '</dd>';
362 my $ds_end = '</dl>';
363 #           my $ds_begin = '<table><tbody>';
364 #           my $ds_item_desc  = '<tr><td>';
365 #           my $ds_item = '</td><td>';
366 #           my $ds_item_end = '</td></tr>';
367 #           my $ds_end = '</tbody></table>';
368
369 sub ds_begin {
370     return $ds_begin;
371 }
372 sub ds_item {
373     return "$ds_item_desc$_[0]$ds_item$_[1]$ds_item_end\n";
374 }
375 sub ds_end {
376     return $ds_end;
377 }
378
379 sub header {
380     my (%params) = @_;
381
382     my $DESC_LINE;
383     if (defined $params{desc}) {
384         $DESC_LINE = "<meta name=\"Description\" content=\"$params{desc}\">";
385     }
386     else {
387         $DESC_LINE = '';
388     }
389
390     my $title_keywords = $params{title_keywords} || $params{title} || '';
391     my $title_tag = $params{title_tag} || $params{title} || '';
392     my $title_in_header = $params{page_title} || $params{title} || '';
393     my $page_title = $params{page_title} || $params{title} || '';
394     my $meta = $params{meta} || '';
395
396     if ($params{print_title_above}) {
397         $title_in_header = "<h1>$title_in_header</h1>";
398     } else {
399         $title_in_header = '';
400     }
401
402     my $search_in_header = '';
403     $params{print_search_field} ||= "";
404     if ($params{print_search_field} eq 'packages') {
405         my %values = %{$params{search_field_values}};
406         my %checked_searchon = ( names => "",
407                                  all => "",
408                                  sourcenames => "", );
409         $checked_searchon{$values{searchon}} = "checked=\"checked\"";
410         $search_in_header = <<MENU;
411 <form method="GET" action="$SEARCH_CGI">
412 <div id="hpacketsearch">
413 <input type="hidden" name="debug" value="$values{debug}">
414 <input type="hidden" name="suite" value="$values{suite}">
415 <input type="hidden" name="subword" value="$values{subword}">
416 <input type="hidden" name="exact" value="$values{exact}">
417 <input type="hidden" name="arch" value="$values{arch}">
418 <input type="hidden" name="section" value="$values{section}">
419 <input type="hidden" name="case" value="$values{case}">
420 <input type="text" size="30" name="keywords" value="$values{keywords}" id="kw">
421 <input type="submit" value="Search">
422 <span style="font-size: 60%"><a href="$SEARCH_PAGE#search_packages">Full options</a></span>
423 <br>
424 <div style="font-size: 80%">Search on:
425 <input type="radio" name="searchon" value="names" id="onlynames" $checked_searchon{names}>
426 <label for="onlynames">Package names only</label>&nbsp;&nbsp;
427 <input type="radio" name="searchon" value="all" id="descs" $checked_searchon{all}>
428 <label for="descs">Descriptions</label>
429 <br>
430 <input type="radio" name="searchon" value="sourcenames" id="src" $checked_searchon{sourcenames}>
431 <label for="src">Source package names</label>
432 </div>
433 </div> <!-- end hpacketsearch -->
434 </form>
435 MENU
436 ;
437     } elsif ($params{print_search_field} eq 'contents') {
438         my %values = %{$params{search_field_values}};
439         my %checked_searchmode = ( searchfiles => "",
440                                    searchfilesanddirs => "",
441                                    searchword => "",
442                                    filelist => "", );
443         $checked_searchmode{$values{searchmode}} = "checked=\"checked\"";
444         $search_in_header = <<MENU;
445 <form method="GET" action="$CONTENTS_SEARCH_CGI">
446 <div id="hpacketsearch">
447 <input type="hidden" name="debug" value="$values{debug}" />
448 <input type="hidden" name="version" value="$values{version}" />
449 <input type="hidden" name="arch" value="$values{arch}" />
450 <input type="hidden" name="case" value="$values{case}" />
451 <input type="text" size="30" name="word" id="keyword" value="$values{keyword}">&nbsp;
452 <input type="submit" value="Search">
453 <span style="font-size: 60%"><a href="$SEARCH_PAGE#search_contents">Full options</a></span>
454 <br>
455 <div style="font-size: 80%">Display:
456 <input type=radio name="searchmode" value="searchfiles" id="searchfiles" $checked_searchmode{searchfiles}>
457 <label for="searchfiles">files</label>
458 <input type=radio name="searchmode" value="searchfilesanddirs" id="searchfilesanddirs" $checked_searchmode{searchfilesanddirs}>
459 <label for="searchfilesanddirs">files &amp; directories</label>
460 <br>
461 <input type=radio name="searchmode" value="searchword" id="searchword" $checked_searchmode{searchword}>
462 <label for="searchword">subword matching</label>
463 <input type=radio name="searchmode" value="filelist" id="filelist" $checked_searchmode{filelist}>
464 <label for="filelist">content list</label>
465 </div>
466 </div> <!-- end hpacketsearch -->
467 </form>
468 MENU
469 ;
470     }
471
472     my $keywords = $params{keywords} || '';
473     my $KEYWORDS_LINE = "<meta name=\"Keywords\" content=\"debian, $keywords $title_keywords\">";
474     
475     my $LANG = $params{lang};
476     my $charset = get_charset($LANG);
477     my $txt = <<HEAD;
478 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
479 <html lang="$LANG">
480 <head>
481 <title>Debian -- $title_tag</title>
482 <link rev="made" href="mailto:$WEBMASTER_MAIL">
483 <meta http-equiv="Content-Type" content="text/html; charset=$charset">
484 <meta name="Author" content="Debian Webmaster, $WEBMASTER_MAIL">
485 $KEYWORDS_LINE
486 $DESC_LINE
487 $meta
488 <link href="$ROOT/debian.css" rel="stylesheet" type="text/css" media="all">
489 </head>
490 <body>
491 <div id="header">
492    <div id="upperheader">
493    <div id="logo">
494   <a href="$HOME/"><img src="$HOME/logos/openlogo-nd-50.png" alt="" /></a>
495 HEAD
496 ;
497
498     $txt .= img( "$HOME/", "", "Pics/debian.png", gettext( "Debian Project" ),
499                  width => 179, height => 61 );
500     $txt .= <<HEADEND;
501
502 </div> <!-- end logo -->
503 HEADEND
504 ;
505
506     $txt .= <<NAVBEGIN;
507 $search_in_header
508 </div> <!-- end upperheader -->
509
510 NAVBEGIN
511 ;
512 # $title_in_header
513     $txt .= "<p class=\"hidecss\"><a href=\"\#inner\">" . gettext("Skip Site Navigation")."</a></p>\n";
514     $txt .= "<div id=\"navbar\">\n<ul>".
515         "<li><a href=\"$HOME/intro/about\">".gettext( "About&nbsp;Debian" )."</a></li>\n".
516         "<li><a href=\"$HOME/News/\">".gettext( "News" )."</a></li>\n".
517         "<li><a href=\"$HOME/distrib/\">".gettext( "Getting&nbsp;Debian" )."</a></li>\n".
518         "<li><a href=\"$HOME/support\">".gettext( "Support" )."</a></li>\n".
519         "<li><a href=\"$HOME/devel/\">".gettext( "Development" )."</a></li>\n".
520         "<li><a href=\"$HOME/sitemap\">".gettext( "Site map" )."</a></li>\n".
521         "<li><a href=\"http://search.debian.org/\">".gettext( "Search" )."</a></li>\n";
522     $txt .= "</ul>\n";
523     $txt .= <<ENDNAV;
524 </div> <!-- end navbar -->
525 </div> <!-- end header -->
526 ENDNAV
527 ;
528     $txt .= <<BEGINCONTENT;
529 <div id="outer">
530 <div id="inner">
531
532 BEGINCONTENT
533 ;
534     if ($params{print_title_above}) {
535         $txt .= "<h1>$page_title</h1>\n";
536     }
537     if ($params{print_title_below}) {
538         $txt .= "<h1>$page_title</h1>\n";
539     }
540
541     return $txt;
542 }
543
544 sub trailer {
545     my ($ROOT, $NAME, $LANG, @USED_LANGS) = @_;
546     my $txt = "</div> <!-- end inner -->\n<div id=\"footer\">\n";
547     my $langs = languages( $NAME, $LANG, @USED_LANGS );
548     my $bl_class = $langs ? ' class="bordertop"' : "";
549     $txt .=
550         $langs.
551         "\n<hr class=\"hidecss\">\n" .
552         "<p$bl_class>".
553         sprintf( gettext( "Back to: <a href=\"%s/\">Debian Project homepage</a> || <a href=\"%s/\">Packages search page</a>" ), $HOME, $ROOT ).
554         "</p>\n<hr class=\"hidecss\">\n".
555         "<div id=\"fineprint\" class=\"bordertop\"><p>".
556         sprintf( gettext( "To report a problem with the web site, e-mail <a href=\"mailto:%s\">%s</a>. For other contact information, see the Debian <a href=\"%s/contact\">contact page</a>." ), $CONTACT_MAIL, $CONTACT_MAIL, $HOME).
557         "</p>\n".
558         "<p>". gettext( "Last Modified: " ). "LAST_MODIFIED_DATE".
559         "<br>\n".
560         sprintf( gettext( "Copyright &copy; 1997-2005 <a href=\"http://www.spi-inc.org\">SPI</a>; See <a href=\"%s/license\">license terms</a>." ), "$HOME/" )."<br>\n".
561         gettext( "Debian is a registered trademark of Software in the Public Interest, Inc." ).
562         "</div> <!-- end fineprint -->\n".
563         "</div> <!-- end footer -->\n".
564         "</div> <!-- end outer -->\n".
565         "</body>\n</html>\n";
566
567     return $txt;
568 }
569
570 sub languages {
571     my ( $name, $lang, @used_langs ) = @_;
572     
573     my $str = "";
574     
575     if (@used_langs) {
576         $str .= "<hr class=\"hidecss\">\n";
577         $str .= "<!--UdmComment-->\n<p>\n";
578         $str .= gettext( "This page is also available in the following languages:\n" );
579         $str .= "</p><p class=\"navpara\">\n";
580         
581         my @printed_langs = ();
582         foreach (@used_langs) {
583             next if $_ eq $lang; # Never print the current language
584             unless (get_selfname($_)) { warn "missing language $_"; next } #DEBUG
585             push @printed_langs, $_;
586         }
587         return "" unless scalar @printed_langs;
588         # Sort on uppercase to work with languages which use lowercase initial
589         # letters.
590         foreach my $cur_lang (sort langcmp @printed_langs) {
591             my $tooltip = dgettext( "langs", get_language_name($cur_lang) );
592             $str .= "<a href=\"$name.$cur_lang.html\" title=\"$tooltip\" hreflang=\"$cur_lang\" lang=\"$cur_lang\" rel=\"alternate\">".get_selfname($cur_lang);
593             $str .= " (".get_transliteration($cur_lang).")" if defined get_transliteration($cur_lang);
594             $str .= "</a>\n";
595         }
596         $str .= "\n</p><p>\n";
597         $str .= sprintf( gettext( "How to set <a href=\"%s\">the default document language</a></p>" ), $CN_HELP_URL );
598         $str .= "\n<!--/UdmComment-->\n";
599     }
600     
601     return $str;
602 }
603
604 1;