### Author: Reinhold Kainhofer <reinhold@kainhofer.com>, 2008.
### Some code parts copied from texi2html and adapted. These functions
### were written mainly by Patrice Dumas
-### License: GPLv2+
+### License: GPLv3+
###
###
### Features implemented here:
### non-standard chars replaced by _xxxx (ascii char code) and forced to
### start with a letter by prepending t_g if necessary)
+package main;
+$original_normalise_node = \&normalise_node;
+
+sub t2h_default_normalise_node($)
+{
+ my $text = shift;
+ $original_normalise_node->($text);
+}
+
+*normalise_node = sub($)
+{
+ my $text = shift;
+ return &$Texi2HTML::Config::normalise_node($text);
+};
package Texi2HTML::Config;
+##$normalise_node = \&t2h_default_normalise_node;
+$normalise_node = \&lilypond_normalise_node;
+
use utf8;
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}.' => '<p>Agradecemos a ${webdev_link} el alojamiento de ${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}.' => 'Köszönet a ${webdev_link} részére a ${lily_site} tárhelyért.',
};
$LY_LANGUAGES->{'it'} = {
'Back to Documentation Index' => 'Torna all\'indice della documentazione',
+ '<p>Thanks to ${webdev_link} for hosting ${lily_site}.' => '',
+};
+
+$LY_LANGUAGES->{'nl'} = {
+ 'Back to Documentation Index' => 'Terug naar de Documentatieindex',
+ '<p>Met dank aan ${webdev_link} voor het hosten van ${lily_site}.' => '',
};
# FIXME: request the translations below then send them to texi2html/texinfo devs
'{title_ref}' => '{title_ref}'
};
+$LANGUAGES->{'ja'} = {
+ ' The buttons in the navigation panels have the following meaning:' => ' ナビゲーション パネルの中にあるボタンには以下のような意味があります:',
+ ' where the @strong{ Example } assumes that the current position is at @strong{ Subsubsection One-Two-Three } of a document of the following structure:' => ' この表で、@strong{ 行き先 } は、現在の位置が以下のような構造を持つドキュメントの @strong{ サブサブセクション 1-2-3 } であると仮定しています:',
+ ' Up ' => ' 上へ ',
+ '(outside of any element)' => '(outside of any element)',
+ '(outside of any node)' => '(outside of any node)',
+ '@b{{quotation_arg}:} ' => '@b{{quotation_arg}:} ',
+ '@cite{{book}}' => '@cite{{book}}',
+ '@{No value for `{value}\'@}' => '@{No value for `{value}\'@}',
+ 'About' => '情報',
+ 'About (help)' => '情報 (ヘルプ)',
+ 'About This Document' => 'このドキュメントについて',
+ 'April' => '4 月',
+ 'August' => '8 月',
+ 'Back' => 'Back',
+ 'Back section in previous file' => '',
+ 'Beginning of this chapter or previous chapter' => 'この章あるいは前の章の先頭',
+ 'Button' => 'ボタン',
+ 'Contents' => '目次',
+ 'Cover (top) of document' => 'ドキュメントの表紙 (先頭)',
+ 'Current' => '',
+ 'Current Position' => '現在の位置',
+ 'Current section' => '',
+ 'December' => '12 月',
+ 'FastBack' => '',
+ 'FastForward' => '',
+ 'February' => '2 月',
+ 'First' => '',
+ 'First section in reading order' => '',
+ 'Following' => '',
+ 'Following node' => '',
+ 'Footnotes' => '脚注',
+ 'Forward' => '',
+ 'Forward section in next file' => '',
+ 'From 1.2.3 go to' => '1.2.3 からの行き先',
+ 'Go to' => '行き先',
+ 'Index' => 'インデックス',
+ 'Index Entry' => 'インデックス エントリ',
+ 'January' => '1 月',
+ 'July' => '7 月',
+ 'Jump to' => '',
+ 'June' => '6月',
+ 'Last' => '',
+ 'Last section in reading order' => '',
+ 'March' => '3 月',
+ 'May' => '5 月',
+ 'Menu:' => 'メニュー',
+ 'Name' => '',
+ 'Next' => '',
+ 'Next chapter' => '次の章',
+ 'Next file' => '',
+ 'Next node' => '',
+ 'Next section in reading order' => '次のセクション',
+ 'Next section on same level' => '',
+ 'NextFile' => '',
+ 'Node following in node reading order' => '',
+ 'Node up' => '',
+ 'NodeNext' => '',
+ 'NodePrev' => '',
+ 'NodeUp' => '',
+ 'November' => '11 月',
+ 'October' => '10 月',
+ 'Overview' => '概要',
+ 'Prev' => '',
+ 'PrevFile' => '',
+ 'Previous' => '',
+ 'Previous file' => '',
+ 'Previous node' => '',
+ 'Previous section in reading order' => '前のセクション',
+ 'Previous section on same level' => '',
+ 'Section' => 'セクション',
+ 'Section One' => 'セクション 1',
+ 'See ' => '',
+ 'See @cite{{book}}' => '',
+ 'See section `@asis{}`{section_name}\'@asis{}\' in @cite{{book}}' => '',
+ 'See section `{section}\' in @cite{{book}}' => '',
+ 'See section {reference_name}' => '',
+ 'See {node_file_href}' => '',
+ 'See {node_file_href} @cite{{book}}' => '',
+ 'See {node_file_href} section `{section}\' in @cite{{book}}' => '',
+ 'See {reference_name}' => '',
+ 'See {ref}' => '',
+ 'See {title_ref}' => '',
+ 'September' => '9 月',
+ 'Short Table of Contents' => '',
+ 'Short table of contents' => '',
+ 'Subsection One-Four' => 'サブセクション 1-4',
+ 'Subsection One-One' => 'サブセクション 1-1',
+ 'Subsection One-Three' => 'サブセクション 1-3',
+ 'Subsection One-Two' => 'サブセクション 1-2',
+ 'Subsubsection One-Two-Four' => 'サブサブセクション 1-2-4',
+ 'Subsubsection One-Two-One' => 'サブサブセクション 1-2-1',
+ 'Subsubsection One-Two-Three' => 'サブサブセクション 1-2-3',
+ 'Subsubsection One-Two-Two' => 'サブサブセクション 1-2-2',
+ 'T2H_today' => '%s, %d %d',
+ 'Table of Contents' => '目次',
+ 'Table of contents' => '目次',
+ 'The node you are looking for is at {href}.' => '',
+ 'This' => '',
+ 'This document was generated on @i{{date}} using @uref{{program_homepage}, @i{{program}}}.' => 'このドキュメントは @i{{date}} に、@uref{{program_homepage}, @i{{program}}} を用いて生成されました。',
+ 'This document was generated using @uref{{program_homepage}, @emph{{program}}}.' => 'このドキュメントは @uref{{program_homepage}, @emph{{program}}} を用いて生成されました。',
+ 'Top' => 'トップ',
+ 'Untitled Document' => '',
+ 'Up' => '上',
+ 'Up node' => '',
+ 'Up section' => '上のセクション',
+ 'current' => '',
+ 'on @emph{{date}}' => '@emph{{date}} に',
+ 'section `@asis{}`{section_name}\'@asis{}\' in @cite{{book}}' => '',
+ 'section `{section}\' in @cite{{book}}' => '',
+ 'see ' => '',
+ 'see @cite{{book}}' => '',
+ 'see section `@asis{}`{section_name}\'@asis{}\' in @cite{{book}}' => '',
+ 'see section `{section}\' in @cite{{book}}' => '',
+ 'see section {reference_name}' => '',
+ 'see {node_file_href}' => '',
+ 'see {node_file_href} @cite{{book}}' => '',
+ 'see {node_file_href} section `{section}\' in @cite{{book}}' => '',
+ 'see {reference_name}' => '',
+ 'see {ref}' => '',
+ 'see {title_ref}' => '',
+ '{acronym_like} ({explanation})' => '{acronym_like} ({explanation})',
+ '{name} of {class}' => '',
+ '{name} on {class}' => '',
+ '{node_file_href}' => '',
+ '{node_file_href} @cite{{book}}' => '',
+ '{node_file_href} section `{section}\' in @cite{{book}}' => '',
+ '{reference_name}' => '',
+ '{ref}' => '{ref}',
+ '{style} {number}' => '{style} {number}',
+ '{style}: {caption_first_line}' => '{style}: {caption_first_line}',
+ '{style}: {shortcaption_first_line}' => '{style}: {shortcaption_first_line}',
+ '{title_ref}' => '{title_ref}'
+ };
+
+
sub ly_get_string () {
my $lang = $Texi2HTML::THISDOC{current_lang};
my $string = shift;
### FUNCTIONALITY FOR MAIN WEB PAGES
#############################################################################
-my $web_manual = 0;
-sub lilypond_init_web_manual ()
-{
- if (exists($main::value{'web_manual'}))
- {
- print STDERR "Initializing settings for web site\n";
- $web_manual = 1;
- web_settings();
- }
-}
-push @Texi2HTML::Config::command_handler_process, \&lilypond_init_web_manual;
+our $web_manual;
#############################################################################
### SETTINGS FOR TEXI2HTML
# Validation fix for texi2html<=1.82
$Texi2HTML::Config::DOCTYPE = '<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">';
-sub web_settings() {
- if ($web_manual) {
- @Texi2HTML::Config::CSS_REFS = (
- {FILENAME => "lilypond-web.css", TITLE => "Default style"}
- );
- } else {
- @Texi2HTML::Config::CSS_REFS = (
- {FILENAME => "lilypond-mccarty.css", TITLE => "Patrick McCarty's design"}
+@Texi2HTML::Config::CSS_REFS = (
+ {FILENAME => "lilypond-mccarty.css", TITLE => "Default style"}
);
- }
-}
@Texi2HTML::Config::ALT_CSS_REFS = (
{FILENAME => "lilypond.css", TITLE => "Andrew Hawryluk's design" },
{FILENAME => "lilypond-blue.css", TITLE => "Kurt Kroon's blue design" },
);
+
+sub web_settings() {
+ print STDERR "Initializing settings for web site: [$Texi2HTML::THISDOC{current_lang}]\n";
+ $Texi2HTML::Config::BODYTEXT = "";
+ @Texi2HTML::Config::CSS_REFS = (
+ {FILENAME => "lilypond-web.css", TITLE => "Patrick McCarty's design"}
+ );
+ @Texi2HTML::Config::ALT_CSS_REFS = (
+ {FILENAME => "lilypond-web-alt1.css", TITLE => "Alternate style 1"},
+ {FILENAME => "lilypond-web-alt2.css", TITLE => "Alternate style 2"},
+ );
+}
+
$Texi2HTML::Config::USE_ACCESSKEY = 1;
$Texi2HTML::Config::USE_LINKS = 1;
$Texi2HTML::Config::USE_REL_REV = 1;
$Texi2HTML::Config::SEPARATED_FOOTNOTES = 0; # Print footnotes on same page, not separated
if ($Texi2HTML::Config::SPLIT eq 'section' or
- $Texi2HTML::Config::SPLIT eq 'subsubsection') {
+ $Texi2HTML::Config::SPLIT eq 'node') {
$Texi2HTML::Config::element_file_name = \&lilypond_element_file_name;
}
### HELPER FUNCTIONS
#############################################################################
+# only lc() the last portion of an href
+sub lc_last($)
+{
+ my $href = shift;
+ my @hrefsplit = split('/', $href);
+ # change the last portion (the filename), if it exists
+ if ($#hrefsplit > 0) {
+ @hrefsplit[$#hrefsplit] = lc( @hrefsplit[$#hrefsplit] );
+ $href = join("/", @hrefsplit);
+ }
+ return $href;
+}
+
# Convert a given node name to its proper file name (normalization as explained
# in the texinfo manual:
# http://www.gnu.org/software/texinfo/manual/texinfo/html_node/HTML-Xref-Node-Name-Expansion.html
$result = 't_g' . $result;
}
# DONE
- return lc($result)
+ return lc_last($result)
}
# Load a file containing a nodename<=>filename map (tab-sepatared, i.e.
# Returns a ref to a hash "Node title" => ["FilenameWithoutExt", "Anchor"]
sub load_map_file ($)
{
- my $mapfile = shift;
- my $node_map = ();
-
- # For some unknown reason, Perl on my system (5.10.0 on Fedora 12)
- # refuses to open map files of translated documents with
- # '<:encoding(utf8)', but decoding from UTF-8 line by line works. -jm
- if (open(XREFFILE,'<', $mapfile)) {
- my $line;
- while ( $line = decode ('UTF-8', <XREFFILE>) ) {
- # parse the tab-separated entries and insert them into the map:
- chomp($line);
- my @entries = split(/\t/, $line);
- if (scalar (@entries) == 3) {
- $node_map->{$entries[0]} = [$entries[1], $entries[2]];
- } else {
- print STDERR "Invalid entry in the node file $mapfile: $line\n";
- }
- }
- # print STDERR %{$node_map};
- close (XREFFILE);
- } else {
- print STDERR "WARNING: Unable to load the map file $mapfile\n";
+ my $mapfile = shift;
+ my $node_map = ();
+
+ # For some unknown reason, Perl on my system (5.10.0 on Fedora 12)
+ # refuses to open map files of translated documents with
+ # '<:encoding(utf8)', but decoding from UTF-8 line by line works. -jm
+ if (open(XREFFILE,'<', $mapfile)) {
+ my $line;
+ # print STDERR "*** PRINTING MAP FILE LINES ***\n";
+ while ( $line = decode ('UTF-8', <XREFFILE>) ) {
+ # parse the tab-separated entries and insert them into the map:
+ chomp($line);
+ my @entries = split(/\t/, $line);
+ if (scalar (@entries) == 3) {
+ $node_map->{$entries[0]} = [$entries[1], $entries[2]];
+ $, = " ";
+ # print STDERR @entries;
+ # print STDERR "\n";
+ } else {
+ print STDERR "Invalid entry in the node file $mapfile: $line\n";
+ }
}
- return $node_map;
+ close (XREFFILE);
+ } else {
+ print STDERR "WARNING: Unable to load the map file $mapfile\n";
+ }
+ return $node_map;
}
# For IE, conditionally include the lilypond-ie-fixes.css style sheet
sub lilypond_css_lines ($$)
{
- my $import_lines = shift;
- my $rule_lines = shift;
- return if (defined($Texi2HTML::THISDOC{'CSS_LINES'}));
- if (@$rule_lines or @$import_lines)
- {
- $Texi2HTML::THISDOC{'CSS_LINES'} = "<style type=\"text/css\">\n<!--\n";
- $Texi2HTML::THISDOC{'CSS_LINES'} .= join('',@$import_lines) . "\n" if (@$import_lines);
- $Texi2HTML::THISDOC{'CSS_LINES'} .= join('',@$rule_lines) . "\n" if (@$rule_lines);
- $Texi2HTML::THISDOC{'CSS_LINES'} .= "-->\n</style>\n";
- }
- foreach my $ref (@CSS_REFS)
- {
- $Texi2HTML::THISDOC{'CSS_LINES'} .= "<link rel=\"stylesheet\" type=\"text/css\" title=\"$ref->{TITLE}\" href=\"$ref->{FILENAME}\">\n";
- }
- foreach my $ref (@Texi2HTML::Config::ALT_CSS_REFS)
- {
- $Texi2HTML::THISDOC{'CSS_LINES'} .= "<link rel=\"alternate stylesheet\" type=\"text/css\" href=\"$ref->{FILENAME}\" title=\"$ref->{TITLE}\">\n";
- }
- # FIXME: the website doesn't use ie7-specific fixes; do the
- # docs still need this? -gp
- $Texi2HTML::THISDOC{'CSS_LINES'} .= "<!--[if lte IE 7]>\n<link href=\"lilypond-ie-fixes.css\" rel=\"stylesheet\" type=\"text/css\">\n<![endif]-->\n";
+ my $import_lines = shift;
+ my $rule_lines = shift;
+ return if (defined($Texi2HTML::THISDOC{'CSS_LINES'}));
+ if (@$rule_lines or @$import_lines)
+ {
+ $Texi2HTML::THISDOC{'CSS_LINES'} = "<style type=\"text/css\">\n<!--\n";
+ $Texi2HTML::THISDOC{'CSS_LINES'} .= join('',@$import_lines) . "\n" if (@$import_lines);
+ $Texi2HTML::THISDOC{'CSS_LINES'} .= join('',@$rule_lines) . "\n" if (@$rule_lines);
+ $Texi2HTML::THISDOC{'CSS_LINES'} .= "-->\n</style>\n";
+ }
+ foreach my $ref (@CSS_REFS)
+ {
+ $Texi2HTML::THISDOC{'CSS_LINES'} .=
+ "<link rel=\"stylesheet\" type=\"text/css\" title=\"$ref->{TITLE}\" href=\"$ref->{FILENAME}\">\n";
+ }
+ foreach my $ref (@Texi2HTML::Config::ALT_CSS_REFS)
+ {
+ $Texi2HTML::THISDOC{'CSS_LINES'} .=
+ "<link rel=\"alternate stylesheet\" type=\"text/css\" href=\"$ref->{FILENAME}\" title=\"$ref->{TITLE}\">\n";
+ }
+ # FIXME: the website doesn't use ie7-specific fixes; do the
+ # docs still need this? -gp
+ $Texi2HTML::THISDOC{'CSS_LINES'} .=
+ "<!--[if lte IE 7]>\n<link href=\"lilypond-ie-fixes.css\" rel=\"stylesheet\" type=\"text/css\">\n<![endif]-->\n";
}
my $lastfilename;
my $docnr = 0;
my $node_to_filename_map = ();
+$source_to_translationof_map = ();
# This function makes sure that files are only generated for numbered sections,
if (exists ($node_to_filename_map->{$node_name})) {
(my $filename, my $anchor) = @{$node_to_filename_map->{$node_name}};
$filename .= ".$docu_ext" if (defined($docu_ext));
+ # don't do lc_last here, otherwise the colors are messed up!
+ $filename = lc($filename);
# unnumbered sections (except those at top-level!) always go to the same
# file as the previous numbered section
- if (not ($element->{number}) and not ($lastfilename eq '') and ($element->{level} > 1)) {
+ if (not ($web_manual) and not ($element->{number})
+ and not ($lastfilename eq '') and ($element->{level} > 1)) {
$filename = $lastfilename;
}
if (($filename eq $lastfilename)) {
$$element{doc_nr} = $docnr;
$lastfilename = $filename;
}
- # print STDERR "File name: $filename\n";
- return lc($filename);
+ #print STDERR "Output file name: $filename\n";
+ $filename = lc_last($filename);
+ return $filename;
- } elsif ($type eq "top" or $type eq "toc" or $type eq "doc" or $type eq "stoc" or $type eq "foot" or $type eq "about") {
+ } elsif ($type eq "top" or $type eq "toc" or $type eq "doc" or
+ $type eq "stoc" or $type eq "foot" or $type eq "about") {
return;
} else {
print STDERR "WARNING: Node '$node_name' was NOT found in the map\n"
}
my $filename = texinfo_file_name($node_name);
$filename .= ".$docu_ext" if (defined($docu_ext));
+ $filename = lc_last($filename);
$docnr += 1;
$$element{doc_nr} = $docnr;
$lastfilename = $filename;
print STDERR "File name: $filename\n";
- return lc($filename);
+ return $filename;
} else {
$$element{doc_nr} = $docnr;
+ $filename = lc_last($filename);
print STDERR "File name: $filename\n";
- return lc($filename);
+ return $filename;
}
}
return;
}
+sub lilypond_normalise_node($)
+{
+ my $text = shift;
+ my $norm = main::t2h_default_normalise_node($text);
+ if (exists ($source_to_translationof_map->{$text})) {
+ my $original = $source_to_translationof_map->{$text};
+ $norm = main::t2h_default_normalise_node($original);
+ }
+
+ return $norm;
+}
+
sub lilypond_element_target_name($$$)
{
my $element = shift;
}
# TODO: Once texi2html correctly prints out the target and not the id for
# the sections, change this back to ($id, $target)
- $target = lc($target);
- return ($target, $target);
+ # I don't understand this comment, so I'm reluctant to delete it -gp
+ $target = lc_last($target);
+ if ($target eq lc_last($id)) {
+ $id = "";
+ } else {
+ $id = substr($id, 0, - 2); # remove the "-1"
+ }
+ return ($id, $target);
}
my ($docu_dir, $docu_name) = split_texi_filename ($Texi2HTML::THISDOC{'input_file_name'});
my $map_filename = main::locate_include_file ("${docu_name}.$Texi2HTML::THISDOC{current_lang}.xref-map")
|| main::locate_include_file ("${docu_name}.xref-map");
- print STDERR "Map filename is: $map_filename\nDocu name is $docu_name\n";
+ #print STDERR "Map filename is: $map_filename\nDocu name is $docu_name\n";
+ if ($docu_name eq 'web') {
+ $web_manual = 1;
+ web_settings();
+ }
$node_to_filename_map = load_map_file ($map_filename);
}
push @Texi2HTML::Config::command_handler_init, \&lilypond_init_map;
my $section = shift;
my $book = shift;
my $file_node = shift;
- my $href = lc(shift);
+ my $href = shift;
+
+ $href = lc_last($href);
+
my $cross_ref = shift;
my $displaytext = '';
# python script messed up ;-)
if ($pass == 1 and $macro eq "translationof") {
if (ref($state->{'element'}) eq 'HASH') {
- $state->{'element'}->{'translationof'} = main::normalise_space($line);
+ $state->{'element'}->{'translationof'} = main::normalise_space($line);
+ my $source = main::normalise_space ($line);
+ if (ref($state->{'node_ref'}) eq 'HASH') {
+ my $translationof = $state->{'node_ref'}->{'texi'};
+ our %source_to_translationof_map;
+ $source_to_translationof_map->{$source} = $translationof;
+ }
}
return ('', 1, undef, undef);
} else {
}
-
-
my %translated_books = ();
# Construct a href to an external source of information.
# node is the node with texinfo @-commands
}
if (defined $file) {
- return &$default_external_href($node, $node_id, $node_hxmlt_id, lc($file));
+ $href = &$default_external_href($node, $node_id, $node_hxmlt_id, lc_last($file));
+ remove_unneeded_anchor($href);
+
+ # TODO: very yucky, but will be fixed in issue 1004
+ if ($web_manual) {
+ my $only_web = $ENV{ONLY_WEB};
+ if ($only_web) {
+ $href = "../../doc/v2.13/Documentation/web/".$href;
+ }
+ }
+
+ return $href;
} else {
- return &$default_external_href($node, $node_id, $node_hxmlt_id);
+ $href = &$default_external_href($node, $node_id, $node_hxmlt_id);
+ remove_unneeded_anchor($href);
+ return $href;
}
}
-
+sub remove_unneeded_anchor($)
+{
+ my $ref = shift;
+ my @hrefsplit = split("/", $href);
+ for ($i = 0; $i < @hrefsplit; $i++) {
+ $item = @hrefsplit[$i];
+ if ($item =~ /#/) {
+ @splitted = split("#", $item);
+ if (@splitted[0] == @splitted[1]) {
+ @hrefsplit[$i] = @splitted[0]
+ }
+ }
+ }
+ $href = join("/", @hrefsplit);
+ return $href
+}
# Initialize the toc_depth to 1 if the command-line option -D=short_toc is given
sub lilypond_init_toc_depth ()
{
- if (exists($main::value{'short_toc'}) and not exists($main::value{'bigpage'})) {
+ if (exists($main::value{'short_toc'}) and not exists($main::value{'bigpage'})
+ and not $web_manual) {
$page_toc_depth = 1;
}
}
-# Set the TOC-depth (depending on a texinfo variable short_toc) in a
+# Set the TOC-depth (depending on a texinfo variable short_toc) in a
# command-handler, so we have them available when creating the pages
push @Texi2HTML::Config::command_handler_process, \&lilypond_init_toc_depth;
+
# recursively generate the TOC entries for the element and its children (which
# are only shown up to maxlevel. All ancestors of the current element are also
# shown with their immediate children, irrespective of their level.
-# Unnumbered entries are only printed out if they are at top-level or 2nd level
+# Unnumbered entries are only printed out if they are at top-level or 2nd level
# or their parent element is an ancestor of the currently viewed node.
# The conditions to call this method to print the entry for a child node is:
# -) the parent is an ancestor of the current page node
-# -) the parent is a numbered element at top-level toplevel (i.e. show numbered
+# -) 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;
+ my $current_element = shift;
# Skip undefined sections, plus all sections generated by index splitting
return() if (not defined($element) or exists($element->{'index_page'}));
my @result = ();
my $level = $element->{'toc_level'};
my $is_parent_of_current = $element->{'id'} && $element_path->{$element->{'id'}};
my $ind = ' ' x $level;
- my $this_css_class;
+ my $this_css_class = " class=\"";
+ # color indices for the second navigation bar on the website
if ($web_manual) {
- $this_css_class = " class=\"";
- } else {
- $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",
- "FAQ", "Changes", "Extend", "Internals",
- "Publications", "Old news"
- );
- my @color_4 = (
- "Text input", "Alternate input",
- "GPL",
- "Translated", "All", "FDL"
- );
-
- 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";
- }
+ 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";
+ 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;
}
-
- $this_css_class .= $addColor . "\"";
-
-
- my $entry = "$ind<li$this_css_class>" . &$anchor ($element->{'tocid'}, "$element->{'file'}#$element->{'target'}",$element->{'text'});
+ $this_css_class .= $is_parent_of_current ? ' toc_current"' : '"';
+ my $entry = "$ind<li$this_css_class>" .
+ &$anchor ($element->{'tocid'},
+ "$element->{'file'}#$element->{'target'}",
+ $element->{'text'});
push (@result, $entry);
my $children = $element->{'section_childs'};
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, $current_element);
push (@child_result, @child_res);
+ $sub_child_count += 1;
}
}
# if no child nodes were generated, e.g. for the index, where expanded pages
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)"));
- } else {
- push (@result, @child_result);
+ push (@result, "$ind<li class=\"colorDefault" .
+ ($element->{'text'} eq $current_element->{'text'} ?
+ ' toc_current">' : '">') .
+ &$anchor ($element->{'tocid'},
+ "$element->{'file'}#$element->{'target'}",
+ $element->{'text'}) . "</li>\n");
}
+ push (@result, @child_result);
push (@result, "$ind</ul>\n");
}
}
# Create the toc entries recursively
my @toc_entries = "";
if ($web_manual) {
- push (@toc_entries, "<ul$NO_BULLET_LIST_ATTRIBUTE>\n");
+ @toc_entries = "<ul$NO_BULLET_LIST_ATTRIBUTE>\n";
# FIXME: add link to main page, really hackily.
if ($element->{'sectionup'}) {
# it's not the top element
push (@toc_entries, "<li><a href=\"index.html\">Main</a></li>\n");
} else {
- push (@toc_entries, "<li class=\"toc_current\"><a href=\"index.html\">Main</a></li>\n");
+ push (@toc_entries,
+ "<li class=\"toc_current\"><a href=\"index.html\">Main</a></li>\n");
}
} else {
push (@toc_entries, "<div class=\"contents\">\n");
}
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, $element));
}
# search box
+ local $/=undef;
+ 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 = decode ('UTF-8', <FILE>);
+ $search_string = "<li>\n" . $search_string . "</li>\n";
+ push (@toc_entries, $search_string);
+ close FILE;
+
+ push (@toc_entries, "</ul>\n");
if ($web_manual) {
- # WTF, perl needs 6 lines of magic to do: ' ' + open ('file-name').read ()?
- local $/=undef;
- my $name = "search-box.html";
- open FILE, "$ENV{SRC_DIR}/$name" or open FILE, "$ENV{SRC_DIR}/../$name" or die die "no such file: $name: $!";
-
- my $string = <FILE>;
- $string = "<li>\n" . $string . "</li>\n";
- push (@toc_entries, $string);
- close FILE;
+ push (@toc_entries, "\n");
+ } else {
+ push (@toc_entries, "</div>\n");
}
- push (@toc_entries, "</ul>\n");
- push (@toc_entries, "</div>\n");
return @toc_entries;
}
# use default TOC if no custom lines have been generated
@lines = @default_toc if (not @lines);
if (@lines) {
-
+
print $fh "\n\n<div id=\"tocframe\">\n";
-
+
# Remove the leading "GNU LilyPond --- " from the manual title
my $topname = $Texi2HTML::NAME{'Top'};
$topname =~ s/^GNU LilyPond(:| &[mn]dash;) //;
-
+
# construct the top-level Docs index (relative path and including language!)
my $lang = $Texi2HTML::THISDOC{current_lang};
if ($lang and $lang ne "en") {
} else {
$lang = "";
}
- my $reldir = "";
- $reldir = "../" if ($Texi2HTML::Config::SPLIT eq 'section');
- my $uplink = $reldir."web/manuals.${lang}html";
+ my $reldir = $ENV{DEPTH};
+ my $uplink = $reldir."/Documentation/web/manuals.${lang}html";
- if ($web_manual) {
- } else {
- print $fh "<p class=\"toc_uplink\"><a href=\"$uplink\"
+ if (not $web_manual) {
+ print $fh "<p class=\"toc_uplink\"><a href=\"$uplink\"
title=\"Documentation Index\"><< " .
&ly_get_string ('Back to Documentation Index') .
"</a></p>\n";
# 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";
my $text = $button->[1];
my $button_href = $button->[0];
# verify that $button_href is simple text and text is a reference
- if (defined($button_href) and !ref($button_href)
+ if (defined($button_href) and !ref($button_href)
and defined($text) and (ref($text) eq 'SCALAR') and defined($$text))
{ # use given text
if ($Texi2HTML::HREF{$button_href})
{
my $anchor_attributes = '';
- if ($USE_ACCESSKEY and (defined($BUTTONS_ACCESSKEY{$button_href})) and ($BUTTONS_ACCESSKEY{$button_href} ne ''))
+ if ($USE_ACCESSKEY and (defined($BUTTONS_ACCESSKEY{$button_href})) and
+ ($BUTTONS_ACCESSKEY{$button_href} ne ''))
{
$anchor_attributes = "accesskey=\"$BUTTONS_ACCESSKEY{$button_href}\"";
}
- if ($USE_REL_REV and (defined($BUTTONS_REL{$button_href})) and ($BUTTONS_REL{$button_href} ne ''))
+ if ($USE_REL_REV and (defined($BUTTONS_REL{$button_href})) and
+ ($BUTTONS_REL{$button_href} ne ''))
{
$anchor_attributes .= " rel=\"$BUTTONS_REL{$button_href}\"";
}
}
elsif ($button eq ' ')
{ # handle space button
- $result .=
+ $result .=
($ICONS && $ACTIVE_ICONS{' '}) ?
&$button_icon_img($BUTTONS_NAME{$button}, $ACTIVE_ICONS{' '}) :
$NAVIGATION_TEXT{' '};
{ # button is active
my $btitle = $BUTTONS_GOTO{$button} ?
'title="' . $BUTTONS_GOTO{$button} . '"' : '';
- if ($USE_ACCESSKEY and (defined($BUTTONS_ACCESSKEY{$button})) and ($BUTTONS_ACCESSKEY{$button} ne ''))
+ if ($USE_ACCESSKEY and (defined($BUTTONS_ACCESSKEY{$button})) and
+ ($BUTTONS_ACCESSKEY{$button} ne ''))
{
$btitle .= " accesskey=\"$BUTTONS_ACCESSKEY{$button}\"";
}
- if ($USE_REL_REV and (defined($BUTTONS_REL{$button})) and ($BUTTONS_REL{$button} ne ''))
+ if ($USE_REL_REV and (defined($BUTTONS_REL{$button})) and
+ ($BUTTONS_REL{$button} ne ''))
{
$btitle .= " rel=\"$BUTTONS_REL{$button}\"";
}
}
else
{ # use text
- $result .=
+ $result .=
'[' .
&$anchor('',
$Texi2HTML::HREF{$button},
}
else
{ # button is passive
- $result .=
+ $result .=
$ICONS && $PASSIVE_ICONS{$button} ?
&$button_icon_img($BUTTONS_NAME{$button},
$PASSIVE_ICONS{$button},
);
# buttons for misc stuff
-@Texi2HTML::Config::MISC_BUTTONS = ('center-aligned-cell-3', 'Top', 'Contents', 'Index', 'About');
+@Texi2HTML::Config::MISC_BUTTONS = ('center-aligned-cell-3',
+ 'Top', 'Contents', 'Index', 'About');
# buttons for chapter file footers
# (and headers but only if SECTION_NAVIGATION is false)
$from_file = $footnote_file = '';
}
- my $foot_anchor = "<sup>" . &$anchor($docid, "$footnote_file#$footid", $relative_num) . "</sup>";
- $foot_anchor = &$anchor($docid, "$footnote_file#$footid", "($relative_num)") if ($state->{'preformatted'});
+ my $foot_anchor = "<sup>" .
+ &$anchor($docid, "$footnote_file#$footid", $relative_num) . "</sup>";
+ $foot_anchor = &$anchor($docid,
+ "$footnote_file#$footid",
+ "($relative_num)") if ($state->{'preformatted'});
# unshift @$lines, "<li>";
# push @$lines, "</li>\n";
#############################################################################
# For split pages, use index.html as start page!
-if ($Texi2HTML::Config::SPLIT eq 'section') {
+if ($Texi2HTML::Config::SPLIT eq 'section' or
+ $Texi2HTML::Config::SPLIT eq 'node') {
$Texi2HTML::Config::TOP_FILE = 'index.html';
}
-if ($web_node) {
-} else {
- push @Texi2HTML::Config::command_handler_process, \&lilypond_init_toc_depth;
-}
return 1;