lib/Packages/HTML.pm

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