]> git.donarmstrong.com Git - lilypond.git/commitdiff
Web: tune second navigation bar and complete i18n
authorJohn Mandereau <john.mandereau@gmail.com>
Mon, 4 Jan 2010 01:03:09 +0000 (02:03 +0100)
committerJohn Mandereau <john.mandereau@gmail.com>
Mon, 4 Jan 2010 01:09:53 +0000 (02:09 +0100)
- rename search-box.html to search-box.ihtml;
- i18n the search box and hosting thanks footer line;
- replace hard-coded section node names with hard-coded chapter file
name prefixes and numeric arrays, fixing the CSS class of second
navigation bar in translations;
- replace "(main)" with chapter name in the second navigation bar.

Documentation/contributor/doc-translation-list.itexi
Documentation/lilypond-texi2html.init
Documentation/search-box.html [deleted file]
Documentation/search-box.ihtml [new file with mode: 0644]

index e2e4ff0fac70aa3f558ba737bad86f74889ccadb..3eb28d87ce8db78ef5c8ac92fe181586616bba6b 100644 (file)
@@ -24,6 +24,7 @@ Word counts (excluding LilyPond snippets) are given for each file.
 1107  macros.itexi
 161   translations.template.html.in
 9     po/lilypond-doc.pot (translate to po/@var{MY_LANGUAGE}.po)
+0     search-box.html
 ---   lilypond-texi2html.init (section TRANSLATIONS)
 6440  total
 
index edd22bf1611317919aeebcb5385fcc6ee4dc11c7..e3b09ab1d731e71cb982cedf4770fb82fa59bfb6 100644 (file)
@@ -76,23 +76,32 @@ use Encode qw(decode);
 my $LY_LANGUAGES = {};
 $LY_LANGUAGES->{'fr'} = {
     'Back to Documentation Index' => 'Retour à l\'accueil de la documentation',
+    '<p>Thanks to ${webdev_link} for hosting ${lily_site}.' => '<p>Remerciements à ${webdev_link} pour l\'hébergement de ${lily_site}.',
 };
+
 $LY_LANGUAGES->{'es'} = {
     'Back to Documentation Index' => 'Volver al índice de la documentación',
+    '<p>Thanks to ${webdev_link} for hosting ${lily_site}.' => '',
 };
+
 $LY_LANGUAGES->{'de'} = {
     'Back to Documentation Index' => 'Zur Dokumentationsübersicht',
+    '<p>Thanks to ${webdev_link} for hosting ${lily_site}.' => '',
 };
+
 $LY_LANGUAGES->{'ja'} = {
     'Back to Documentation Index' => 'ドキュメント インデックスに戻る',
+    '<p>Thanks to ${webdev_link} for hosting ${lily_site}.' => '',
 };
 
 $LY_LANGUAGES->{'hu'} = {
     'Back to Documentation Index' => 'Vissza a dokumentációk jegyzékéhez',
+    '<p>Thanks to ${webdev_link} for hosting ${lily_site}.' => '',
 };
 
 $LY_LANGUAGES->{'it'} = {
     'Back to Documentation Index' => 'Torna all\'indice della documentazione',
+    '<p>Thanks to ${webdev_link} for hosting ${lily_site}.' => '',
 };
 
 # FIXME: request the translations below then send them to texi2html/texinfo devs
@@ -366,6 +375,7 @@ $LANGUAGES->{'hu'} = {
                        '{title_ref}' => '{title_ref}'
                      };
 
+
 sub ly_get_string () {
     my $lang = $Texi2HTML::THISDOC{current_lang};
     my $string = shift;
@@ -917,15 +927,15 @@ push @Texi2HTML::Config::command_handler_process, \&lilypond_init_toc_depth;
 # -) the parent is a numbered element at top-level toplevel (i.e. show numbered
 #    and unnumbered 2nd-level children of numbered nodes)
 # -) the child element is a numbered node below level maxlevel
-sub generate_ly_toc_entries($$$)
+sub generate_ly_toc_entries($$$$)
 {
   my $element = shift;
   my $element_path = shift;
+  my $maxlevel = shift;
   if ($web_manual) {
-    my $maxlevel = 1;
-  } else {
-    my $maxlevel = shift;
+    $maxlevel = 1;
   }
+  my $child_count = shift;
   # Skip undefined sections, plus all sections generated by index splitting
   return() if (not defined($element) or exists($element->{'index_page'}));
   my @result = ();
@@ -939,54 +949,22 @@ sub generate_ly_toc_entries($$$)
     $this_css_class = "";
   }
   $this_css_class .= $is_parent_of_current ? " toc_current" : "";
-# HORRIBLE HACK
-  my @color_1 = (
-        "Learning", "Glossary", "Essay",
-        "Contact", "Tiny examples", "Bug reports"
-       );
-  my @color_2 = (
-        "Features", "Examples", "Freedom", "Background",
-       "Unix", "MacOS X", "Windows",
-        "Notation", "Usage", "Snippets",
-        "Help us", "Development", "Authors"
-       );
-  my @color_3 = (
-        "Productions", "Testimonials",
-       "Source", "Old downloads",
-        "Web", "FAQ", "Changes", "Extend", "Internals",
-        "Publications", "Old news"
-        );
-  my @color_4 = (
-        "Text input", "Easier editing",
-        "GPL",
-        "Translated", "All", "FDL"
-        );
 
+  # color indices for the second navigation bar on the website
+  my %color_maps = (
+      'introduction' => [2, 2, 2, 2, 3, 3, 4, 4],
+      'download' => [2, 2, 2, 3, 3, 4],
+      'manuals' => [1, 1, 1, 2, 2, 2, 3, 3, 3, 3, 3, 4, 4, 4],
+      'community' => [1, 1, 1, 2, 2, 2, 3, 3],
+  );
   my $addColor = " colorDefault";
-  foreach $color (@color_1) {
-    if ($element->{'text'} eq $color) {
-      $addColor = " color1";
-    }
-  }
-  foreach $color (@color_2) {
-    if ($element->{'text'} eq $color) {
-      $addColor = " color2";
-    }
-  }
-  foreach $color (@color_3) {
-    if ($element->{'text'} eq $color) {
-      $addColor = " color3";
-    }
-  }
-  foreach $color (@color_4) {
-    if ($element->{'text'} eq $color) {
-      $addColor = " color4";
-    }
+  while (($top_section, $color_indices) = each %color_maps) {
+      if (index ($element->{'sectionup'}->{'file'}, $top_section) >= 0) {
+         $addColor = " color" . $color_indices->[$child_count];
+      }
   }
-
   $this_css_class .= $addColor . "\"";
 
-
   my $entry = "$ind<li$this_css_class>" . &$anchor ($element->{'tocid'}, "$element->{'file'}#$element->{'target'}",$element->{'text'});
 
   push (@result, $entry);
@@ -994,12 +972,14 @@ sub generate_ly_toc_entries($$$)
   if (defined($children) and (ref($children) eq "ARRAY")) {
     my $force_children = $is_parent_of_current or ($level == 1 and $element->{'number'});
     my @child_result = ();
+    my $sub_child_count = 0;
     foreach my $c (@$children) {
       my $is_numbered_child = defined ($c->{'number'});
       my $below_maxlevel = $c->{'toc_level'} le $maxlevel;
       if ($force_children or ($is_numbered_child and $below_maxlevel)) {
-        my @child_res = generate_ly_toc_entries($c, $element_path, $maxlevel);
+        my @child_res = generate_ly_toc_entries($c, $element_path, $maxlevel, $sub_child_count);
         push (@child_result, @child_res);
+       $sub_child_count += 1;
       }
     }
     # if no child nodes were generated, e.g. for the index, where expanded pages
@@ -1007,7 +987,7 @@ sub generate_ly_toc_entries($$$)
     if (@child_result) {
       push (@result, "\n$ind<ul$NO_BULLET_LIST_ATTRIBUTE>\n");
       if ($web_manual) {
-        push (@result, "$ind<li$this_css_class>" . &$anchor ($element->{'tocid'}, "$element->{'file'}#$element->{'target'}","(main)"));
+        push (@result, "$ind<li$this_css_class>" . &$anchor ($element->{'tocid'}, "$element->{'file'}#$element->{'target'}", $element->{'text'}));
       }
       push (@result, @child_result);
       push (@result, "$ind</ul>\n");
@@ -1057,12 +1037,15 @@ sub lilypond_generate_page_toc_body($)
     }
     my $children = $current_element->{'section_childs'};
     foreach ( @$children ) {
-      push (@toc_entries, generate_ly_toc_entries($_, \%parentelements, $page_toc_depth));
+      push (@toc_entries, generate_ly_toc_entries($_, \%parentelements, $page_toc_depth, 0));
     }
     # search box
     local $/=undef;
-    my $name = "search-box.html";
-    open FILE, "$ENV{TOP_SRC_DIR}/Documentation/$name" or die "no such file: $name: $!";
+    my $name = "search-box";
+    $lang = $Texi2HTML::THISDOC{current_lang};
+    open FILE, "$ENV{TOP_SRC_DIR}/Documentation/$lang/$name.ihtml" or
+       open FILE, "$ENV{TOP_SRC_DIR}/Documentation/$name.ihtml"  or
+       die "no such file: $name.ihtml: $!";
     my $search_string = <FILE>;
     $search_string = "<li>\n" . $search_string . "</li>\n";
     push (@toc_entries, $search_string);
@@ -1167,14 +1150,18 @@ sub print_lilypond_page_foot($)
 #   print $fh "<p><font size='-1'>$program_string</font><br>$PRE_BODY_CLOSE</p>\n";
   print $fh "<!-- FOOTER -->\n\n";
   print $fh "<!-- end div#main here -->\n</div>\n\n";
-
   if ($web_manual) {
     # FIXME: This div and p#languages need to be in div#footer.
     #        Should we move this div to postprocess_html.py ?
     print $fh "<div id=\"verifier_texinfo\">\n";
     print $fh "<h3>Validation</h3>\n";
-    print $fh "<p>Thanks to <a href=\"http://www.webdev.nl/\">webdev.nl</a>";
-    print $fh " for hosting <code>lilypond.org</code>.\n";
+    # FIXME: inlined text substitution, move to ly_get_string as soon as another case is needed
+    my $webdev_link = "<a href=\"http://www.webdev.nl/\">webdev.nl</a>";
+    my $lily_site = "<code>lilypond.org</code>";
+    my $hosting_thanks = &ly_get_string ('<p>Thanks to ${webdev_link} for hosting ${lily_site}.');
+    # this does the variable substitution ("quoting" in Perlish) after the localization
+    $hosting_thanks =~ s/(\$\{\w+\})/$1/eeg;
+    print $fh $hosting_thanks . "\n";
     print $fh "<a href=\"http://validator.w3.org/check?uri=referer\">\n";
     print $fh "<img src=\"http://www.w3.org/Icons/valid-html401\"\n";
     print $fh "     alt=\"Valid HTML 4.01 Transitional\"\n";
diff --git a/Documentation/search-box.html b/Documentation/search-box.html
deleted file mode 100644 (file)
index 961b6af..0000000
+++ /dev/null
@@ -1,13 +0,0 @@
-<form action="http://google.com/search"
-      method="get"
-      name="search"
-      onSubmit="search.q.value='site:lilypond.org +v2.12 '
-               + search.brute_query.value"
-      onMouseMove="search.q.value='site:lilypond.org +v2.12 '
-                  + search.brute_query.value"
-      onKeyUp="search.q.value='site:lilypond.org +v2.12 '
-              + search.brute_query.value">
-  <input type="hidden" name="btnG" value="Google Search">
-  <input type="text" name="brute_query" onfocus="this.value=''" value="Search">
-  <input type="hidden" name="q" value="">
-</form>
diff --git a/Documentation/search-box.ihtml b/Documentation/search-box.ihtml
new file mode 100644 (file)
index 0000000..961b6af
--- /dev/null
@@ -0,0 +1,13 @@
+<form action="http://google.com/search"
+      method="get"
+      name="search"
+      onSubmit="search.q.value='site:lilypond.org +v2.12 '
+               + search.brute_query.value"
+      onMouseMove="search.q.value='site:lilypond.org +v2.12 '
+                  + search.brute_query.value"
+      onKeyUp="search.q.value='site:lilypond.org +v2.12 '
+              + search.brute_query.value">
+  <input type="hidden" name="btnG" value="Google Search">
+  <input type="text" name="brute_query" onfocus="this.value=''" value="Search">
+  <input type="hidden" name="q" value="">
+</form>