Name

xmltojar — converts xml Scilab help files to javaHelp format

Calling Sequence

xmltojar(dirs [,titles [,dir_language [default_language]]]]])

Parameters

dirs

vector of strings: a set of directory paths for which html manuals are to be generated or []

titles

vector of strings: titles associated to directory paths or []

dir_language

vector of strings: languages associated to directory paths or []

default_language

vector of strings: default languages associated to directory paths or []. If an XML file is missing in the dir_language, it's copied from the default_language.

Description

converts xml Scilab help files contained in a set of directories into jar files.

Examples

 
// example_1/
// `-- help
//     |-- en_US
//     |   |-- example_1_function_1.xml
//     |   |-- example_1_function_2.xml
//     |   `-- example_1_function_3.xml
//     `-- fr_FR
//         |-- example_1_function_1.xml
//         |-- example_1_function_2.xml
//         `-- example_1_function_3.xml
//     `-- zh_TW
//         |-- example_1_function_1.xml
//         |-- example_1_function_2.xml
//         `-- example_1_function_3.xml

my_module_path = pathconvert(SCI+'/modules/helptools/examples/example_1',%f,%f)

// Build the french help
// =============================================================================
my_french_help_dir    =  my_module_path+'/help/fr_FR';
my_french_help_title  =  'Example 1 [fr_FR]';
xmltojar(my_french_help_dir,my_french_help_title,'fr_FR');

// Build the english help
// =============================================================================
my_english_help_dir   =  my_module_path+'/help/en_US';
my_english_help_title =  'Example 1 [en_US]';
xmltojar(my_english_help_dir,my_english_help_title,'en_US');

// Build the chinese help
// =============================================================================
my_chinese_help_dir   =  my_module_path+'/help/zh_TW';
my_chinese_help_title =  'Example 1 [zh_TW]';
xmltojar(my_chinese_help_dir,my_chinese_help_title,'zh_TW');

// Add french, english or chinese help chapters
// =============================================================================

if getlanguage() == 'fr_FR' then
  add_help_chapter(my_french_help_title,my_module_path+"/jar");

elseif getlanguage() == 'zh_TW' then
  add_help_chapter(my_chinese_help_title,my_module_path+"/jar");

else
  add_help_chapter(my_english_help_title,my_module_path+"/jar");
end

// See the result in the help browser
// =============================================================================
help();

// Del french and english help chapters
// =============================================================================
if getlanguage() == 'fr_FR' then
  del_help_chapter(my_french_help_title);
else
  del_help_chapter(my_english_help_title);
end
 

See Also

help , add_help_chapter