add CDATA + role in the helptools module
[scilab.git] / scilab / modules / helptools / help / en_US / xmltojar.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!--
3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4  * Copyright (C) 2008 - INRIA
5  * 
6  * This file must be used under the terms of the CeCILL.
7  * This source file is licensed as described in the file COPYING, which
8  * you should have received as part of this distribution.  The terms
9  * are also available at
10  * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
11  *
12  -->
13 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns4="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" version="5.0-subset Scilab" xml:id="xmltojar" xml:lang="en">
14   <info>
15     <pubdate>$LastChangedDate: 2008-03-14 11:58:09 +0100 (ven, 14 mar 2008)
16     $</pubdate>
17   </info>
18   <refnamediv>
19     <refname>xmltojar</refname>
20     <refpurpose>converts xml Scilab help files to javaHelp format</refpurpose>
21   </refnamediv>
22   <refsynopsisdiv>
23     <title>Calling Sequence</title>
24     <synopsis>xmltojar(dirs [,titles [,dir_language [default_language]]]]])</synopsis>
25   </refsynopsisdiv>
26   <refsection>
27     <title>Parameters</title>
28     <variablelist>
29       <varlistentry>
30         <term>dirs</term>
31         <listitem>
32           <para>vector of strings: a set of directory paths for which html
33           manuals are to be generated or <literal>[] </literal></para>
34         </listitem>
35       </varlistentry>
36       <varlistentry>
37         <term>titles</term>
38         <listitem>
39           <para>vector of strings: titles associated to directory paths or
40           []</para>
41         </listitem>
42       </varlistentry>
43       <varlistentry>
44         <term>dir_language</term>
45         <listitem>
46           <para>vector of strings: languages associated to directory paths or
47           []</para>
48         </listitem>
49       </varlistentry>
50       <varlistentry>
51         <term>default_language</term>
52         <listitem>
53           <para>vector of strings: default languages associated to directory
54               paths or []. If an XML file is missing in the dir_language, it's
55               copied from the default_language.</para>
56         </listitem>
57       </varlistentry>
58     </variablelist>
59   </refsection>
60   <refsection>
61     <title>Description</title>
62     <para>converts xml Scilab help files contained in a set of directories
63     into jar files.</para>
64   </refsection>
65   <refsection>
66     <title>Examples</title>
67     <programlisting role="example"><![CDATA[ 
68 // example_1/
69 // `-- help
70 //     |-- en_US
71 //     |   |-- example_1_function_1.xml
72 //     |   |-- example_1_function_2.xml
73 //     |   `-- example_1_function_3.xml
74 //     `-- fr_FR
75 //         |-- example_1_function_1.xml
76 //         |-- example_1_function_2.xml
77 //         `-- example_1_function_3.xml
78 //     `-- zh_TW
79 //         |-- example_1_function_1.xml
80 //         |-- example_1_function_2.xml
81 //         `-- example_1_function_3.xml
82
83 my_module_path = pathconvert(SCI+'/modules/helptools/examples/example_1',%f,%f)
84
85 // Build the french help
86 // =============================================================================
87 my_french_help_dir    =  my_module_path+'/help/fr_FR';
88 my_french_help_title  =  'Example 1 [fr_FR]';
89 xmltojar(my_french_help_dir,my_french_help_title,'fr_FR');
90
91 // Build the english help
92 // =============================================================================
93 my_english_help_dir   =  my_module_path+'/help/en_US';
94 my_english_help_title =  'Example 1 [en_US]';
95 xmltojar(my_english_help_dir,my_english_help_title,'en_US');
96
97 // Build the chinese help
98 // =============================================================================
99 my_chinese_help_dir   =  my_module_path+'/help/zh_TW';
100 my_chinese_help_title =  'Example 1 [zh_TW]';
101 xmltojar(my_chinese_help_dir,my_chinese_help_title,'zh_TW');
102
103 // Add french, english or chinese help chapters
104 // =============================================================================
105
106 if getlanguage() == 'fr_FR' then
107   add_help_chapter(my_french_help_title,my_module_path+"/jar");
108
109 elseif getlanguage() == 'zh_TW' then
110   add_help_chapter(my_chinese_help_title,my_module_path+"/jar");
111
112 else
113   add_help_chapter(my_english_help_title,my_module_path+"/jar");
114 end
115
116 // See the result in the help browser
117 // =============================================================================
118 help();
119
120 // Del french and english help chapters
121 // =============================================================================
122 if getlanguage() == 'fr_FR' then
123   del_help_chapter(my_french_help_title);
124 else
125   del_help_chapter(my_english_help_title);
126 end
127  ]]></programlisting>
128   </refsection>
129   <refsection>
130     <title>See Also</title>
131     <simplelist type="inline">
132       <member>
133         <link linkend="help">help</link>
134       </member>
135       <member>
136         <link linkend="add_help_chapter">add_help_chapter</link>
137       </member>
138     </simplelist>
139   </refsection>
140 </refentry>