# -*-perl-*- #+############################################################################## # # chm.pm: convert to chm intermediate formats hhp, hhc, hhk and html files # # Copyright 2004, 2006, 2009, 2011, 2012, 2013 Free Software # Foundation, Inc. # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; either version 3 of the License, # or (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with this program. If not, see . # # Originally written by Patrice Dumas. # #-############################################################################## use strict; use File::Spec; main::set_global_format('html'); set_from_init_file('TOP_NODE_FILE', undef); set_from_init_file('TOP_FILE', undef); #$SECTION_NAVIGATION = 0; # to avoid headers in normal elements set_from_init_file('SHOW_MENU', 0); set_from_init_file('SPLIT', 'node'); set_from_init_file('contents', 1); #set_from_init_file('SPLIT_INDEX', undef); set_from_init_file('DEFAULT_RULE', ''); set_from_init_file('BIG_RULE', ''); set_from_init_file('HEADERS', 0); set_from_init_file('footnotestyle', 'end'); #FIXME remove that later? set_from_init_file('USE_NODES', 0); use vars qw(%commands_formatting); texinfo_register_formatting_function('end_file', \&chm_end_file); texinfo_register_formatting_function('navigation_header', \&chm_noop); texinfo_register_formatting_function('navigation_header_panel', \&chm_noop); my %chm_languages = ( 'en' => '0x409 English (United States)', 'sq' => '0x041c Albanian', # 'ar' => '0x1401 Arabic (ALGERIA)', # 'es' => '0x2c0a Spanish (ARGENTINA)', # 'en' => '0x0c09 English (AUSTRALIA)', # 'de' => '0x0c07 German (AUSTRIA)', # 'ar' => '0x3c01 Arabic (BAHRAIN)', 'be' => '0x0423 Byelorussian', # 'fr' => '0x080c French (BELGIUM)', # 'en' => '0x2809 English (BELIZE)', # 'es' => '0x400a Spanish (BOLIVIA)', # 'pt' => '0x0416 Portuguese (BRAZIL)', # 'ms' => '0x083e Malay (BRUNEI DARUSSALAM)', 'bg' => '0x0402 Bulgarian', # 'fr' => '0x0c0c French (CANADA)', # 'es' => '0x340a Spanish (CHILE)', 'zh' => '0x0804 Chinese (CHINA)', # 'es' => '0x240a Spanish (COLOMBIA)', # 'es' => '0x140a Spanish (COSTA RICA)', 'hr' => '0x041a Croatian', 'cs' => '0x0405 Czech', 'da' => '0x0406 Danish', # 'es' => '0x1c0a Spanish (DOMINICAN REPUBLIC)', # 'es' => '0x300a Spanish (ECUADOR)', # 'ar' => '0x0c01 Arabic (EGYPT)', # 'es' => '0x440a Spanish (EL SALVADOR)', 'et' => '0x0425 Estonian', 'fo' => '0x0438 Faeroese', 'fi' => '0x040b Finnish', 'fr' => '0x040c French (FRANCE)', 'de' => '0x0407 German (GERMANY)', 'el' => '0x0408 Greek', # 'es' => '0x100a Spanish (GUATEMALA)', # 'es' => '0x480a Spanish (HONDURAS)', # 'zh' => '0x0c04 Chinese (HONG KONG)', 'hu' => '0x040e Hungarian', 'is' => '0x040f Icelandic', 'hi' => '0x0439 Hindi', 'in' => '0x04', 'fa' => '0x0429 Farsi', # 'ar' => '0x0801 Arabic (IRAQ)', # 'en' => '0x1809 English (IRELAND)', 'iw' => '0x04', 'it' => '0x0410 Italian', # 'en' => '0x2009 English (JAMAICA)', 'ja' => '0x0411 Japanese', # 'ar' => '0x2c01 Arabic (JORDAN)', 'sw' => '0x0441 Swahili', 'ko' => '0x0412 Korean', # 'ar' => '0x3401 Arabic (KUWAIT)', 'al' => '0x0426 Latvian (Lettish)', # 'ar' => '0x3001 Arabic (LEBANON)', # 'ar' => '0x1001 Arabic (LIBYAN ARAB JAMAHIRIYA)', # 'de' => '0x1407 German (LIECHTENSTEIN)', 'lt' => '0x0427 Lithuanian', # 'de' => '0x1007 German (LUXEMBOURG)', # 'zh' => '0x1404 Chinese (MACAU)', 'mk' => '0x042f Macedonian', # 'ms' => '0x043e Malay (MALAYSIA)', # 'es' => '0x080a Spanish (MEXICO)', # 'fr' => '0x180c French (MONACO)', # 'ar' => '0x1801 Arabic (MOROCCO)', 'nl' => '0x0413 Dutch', # 'en' => '0x1409 English (NEW ZEALAND)', # 'es' => '0x4c0a Spanish (NICARAGUA)', 'no' => '0x0414 Norwegian', # 'ar' => '0x2001 Arabic (OMAN)', 'ur' => '0x0420 Urdu', # 'es' => '0x180a Spanish (PANAMA)', # 'es' => '0x3c0a Spanish (PARAGUAY)', # 'es' => '0x280a Spanish (PERU)', # 'en' => '0x3409 English (PHILIPPINES)', 'pl' => '0x0415 Polish', 'pt' => '0x0816 Portuguese (PORTUGAL)', # 'es' => '0x500a Spanish (PUERTO RICO)', # 'ar' => '0x4001 Arabic (QATAR)', 'ro' => '0x0418 Romanian', 'ru' => '0x0419 Russian', 'ar' => '0x0401 Arabic (SAUDI ARABIA)', # 'zh' => '0x1004 Chinese (SINGAPORE)', 'sk' => '0x041b Slovak', 'sl' => '0x0424 Slovenian', 'af' => '0x0436 Afrikaans', 'ca' => '0x0403 Catalan', 'sv' => '0x041d Swedish', # 'de' => '0x0807 German (SWITZERLAND)', # 'ar' => '0x2801 Arabic (SYRIAN ARAB REPUBLIC)', # 'zh' => '0x0404 Chinese (TAIWAN, PROVINCE OF CHINA)', 'th' => '0x041e Thai', # 'en' => '0x2c09 English (TRINIDAD AND TOBAGO)', # 'ar' => '0x1c01 Arabic (TUNISIA)', 'tr' => '0x041f Turkish', 'uk' => '0x0422 Ukrainian', # 'ar' => '0x3801 Arabic (UNITED ARAB EMIRATES)', # 'en' => '0x0809 English (UNITED KINGDOM)', # 'en' => '0x0409 English (UNITED STATES)', # 'es' => '0x380a Spanish (URUGUAY)', # 'es' => '0x200a Spanish (VENEZUELA)', 'vi' => '0x242a Vietnamese', # 'ar' => '0x2401 Arabic (YEMEN)', # 'en' => '0x3009 English (ZIMBABWE)', #'' => '', ); my %hhk_global_property = ( 'ImageType' => 'Folder', ); my %hhc_global_property = ( 'ImageType' => 'Folder', ); # at least kchmviewer has trouble with the corresponding textual entities foreach my $thing ('OE', 'oe', 'euro') { $commands_formatting{'normal'}->{$thing} = $Texinfo::Convert::Unicode::unicode_entities{$thing}; } sub chm_end_file($) { my $self = shift; my $pre_body_close = $self->get_conf('PRE_BODY_CLOSE'); $pre_body_close = '' if (!defined($pre_body_close)); return "

$pre_body_close

"; } sub chm_noop($$) { return ''; } sub convert_tree ($$;$) { my $converter = shift; my $tree = shift; my $options = shift; $options = {} if (!defined($options)); return $converter->protect_text( Texinfo::Convert::Text::convert($tree, {Texinfo::Common::_convert_text_options($converter), %$options})); } sub chm_init($) { my $self = shift; return if (defined($self->get_conf('OUTFILE')) and $Texinfo::Common::null_device_file{$self->get_conf('OUTFILE')}); my $document_name = $self->{'document_name'}; my $outdir = $self->{'destination_directory'}; $outdir = File::Spec->curdir() if ($outdir eq ''); my $hhk_filename = $document_name . ".hhk"; my $hhk_file = File::Spec->catfile($outdir, $hhk_filename); my $hhk_fh = Texinfo::Common::open_out($self, $hhk_file); if (!defined($hhk_fh)) { $self->document_error(sprintf($self->__("chm.pm: could not open %s for writing: %s\n"), $hhk_file, $!)); return 0; } print STDERR "# writing HTML Help index in $hhk_file...\n" if ($self->get_conf('VERBOSE')); print $hhk_fh "\n\n"; print $hhk_fh "\nget_conf('PROGRAM') ."\">\n"; print $hhk_fh "\n\n\n"; print $hhk_fh "\n"; foreach my $property (sort(keys(%hhk_global_property))) { print $hhk_fh "\n"; } print $hhk_fh "\n"; my $index_entries = Texinfo::Structuring::sort_indices($self, $self->{'index_entries'}, $self->{'index_names'}); if ($index_entries) { foreach my $index_name (sort(keys(%$index_entries))) { foreach my $index_entry_ref (@{$index_entries->{$index_name}}) { my $file = $self->command_filename($index_entry_ref->{'command'}); # happens for things in @titlepage when it is not output if (!defined($file)) { if ($self->{'elements'} and $self->{'elements'}->[0] and defined($self->{'elements'}->[0]->{'filename'})) { # In that case use the first page. $file = $self->{'elements'}->[0]->{'filename'}; } else { $file = ''; } } my $anchor = $self->command_target($index_entry_ref->{'command'}); my $origin_href = "$file#$anchor"; my $entry = convert_tree($self, {'contents' => $index_entry_ref->{'content'}}, {'code' => $index_entry_ref->{'in_code'}}); print $hhk_fh "
  • \n\n\n
  • \n" if ($entry =~ /\S/); } } } print $hhk_fh "\n\n"; delete $self->{'unclosed_files'}->{$hhk_file}; if (!close ($hhk_fh)) { $self->document_error(sprintf($self->__("chm.pm: error on closing %s: %s"), $hhk_file, $!)); return 0; } my $hhc_filename = $document_name . ".hhc"; my $hhc_file = File::Spec->catfile($outdir, $hhc_filename); my $hhc_fh = Texinfo::Common::open_out($self, $hhc_file); # Not sure $! is still valid if (!defined($hhc_fh)) { $self->document_error(sprintf($self->__("chm.pm: could not open %s for writing: %s\n"), $hhc_file, $!)); return 0; } print STDERR "# writing HTML Help project in $hhc_file...\n" if ($self->get_conf('VERBOSE')); print $hhc_fh "\n\n"; print $hhc_fh "\nget_conf('PROGRAM') ."\">\n"; print $hhc_fh "\n\n\n"; print $hhc_fh "\n"; foreach my $property (sort(keys(%hhc_global_property))) { print $hhc_fh "\n"; } print $hhc_fh "\n"; if ($self->{'structuring'} and $self->{'structuring'}->{'sectioning_root'}) { my $section_root = $self->{'structuring'}->{'sectioning_root'}; my $upper_level = $section_root->{'section_childs'}->[0]->{'level'}; foreach my $top_section(@{$section_root->{'section_childs'}}) { $upper_level = $top_section->{'level'} if ($top_section->{'level'} < $upper_level); } $upper_level = 1 if ($upper_level <= 0); my $root_level = $upper_level - 1; my $level = $root_level; foreach my $section (@{$self->{'structuring'}->{'sections_list'}}) { next if ($section->{'cmdname'} eq 'part'); my $section_level = $section->{'level'}; $section_level = 1 if ($section_level == 0); if ($level < $section_level) { while ($level < $section_level) { print $hhc_fh "\n"; $level--; } } my $text = convert_tree($self, {'contents' => $section->{'extra'}->{'misc_content'}}); $text = $self->Texinfo::Common::numbered_heading($section, $text, $self->get_conf('NUMBER_SECTIONS')); my $file = $self->command_filename($section); my $anchor = $self->command_target($section); my $origin_href = "$file#$anchor"; print $hhc_fh "
  • \n\n\n
  • \n"; } while ($level > $root_level) { print $hhc_fh "\n"; $level--; } } print $hhc_fh "\n\n"; delete $self->{'unclosed_files'}->{$hhc_file}; if (!close ($hhc_fh)) { $self->document_error(sprintf($self->__("chm.pm: error on closing %s: %s"), $hhc_file, $!)); return 0; } my $hhp_filename = $document_name . ".hhp"; my $hhp_file = File::Spec->catfile($outdir, $hhp_filename); my $hhp_fh = Texinfo::Common::open_out($self, $hhp_file); # Not sure $! is still valid if (!defined($hhp_fh)) { $self->document_error(sprintf($self->__("chm.pm: could not open %s for writing: %s\n"), $hhp_file, $!)); return 0; } print STDERR "# writing HTML Help project in $hhp_file...\n" if ($self->get_conf('VERBOSE')); my $language = $chm_languages{'en'}; my $documentlanguage = $self->get_conf('documentlanguage'); $documentlanguage =~ s/_.*//; if (exists ($chm_languages{$documentlanguage})) { $language = $chm_languages{$documentlanguage}; } my $title = convert_tree($self, $self->{'title_tree'}); my $top_file = ''; my $top_element = $self->global_element('Top'); if ($top_element and $top_element->{'extra'}->{'element_command'}) { $top_file = $self->command_filename($top_element->{'extra'}->{'element_command'}); } print $hhp_fh <{'elements'}) { foreach my $element (@{$self->{'elements'}}) { if (!$chm_files{$element->{'filename'}}) { print $hhp_fh "$element->{'filename'}\n"; $chm_files{$element->{'filename'}} = 1; } } } delete $self->{'unclosed_files'}->{$hhp_file}; if (!close ($hhp_fh)) { $self->document_error(sprintf($self->__("chm.pm: error on closing %s: %s"), $hhp_file, $!)); return 0; } return 1; } texinfo_register_handler('init', \&chm_init); 1;