<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta content="text/html;charset=ISO-8859-1" http-equiv="Content-Type">
</head>
<body bgcolor="#ffffff" text="#000000">
Hello Sylvestre,<br>
<br>
----- Message d'origine ----- <br>
De : Sylvestre Ledru <br>
Date : 27/04/2009 10:26:
<blockquote cite="mid:1240820761.10904.15401.camel@korcula.inria.fr"
type="cite">
<pre wrap="">Hello,
Pierre and I wrote a SEP about the introduction of the sub chapters into
the documentation.
As usual, don't hesitate to comment it.
Pierre & Sylvestre
</pre>
</blockquote>
As previously discussed with Serge and you through some bugzilla &
requestzilla <br>
comments, yes, this new feature will be very great. <br>
In these discussions, a topic strongly related to sub-chaptering has
been evoked: <br>
capability to show a topic in different places in the help tree (alias
management).<br>
<br>
For instance, derivat() would deserve appearing into a "polynomials"
sub-directory,<br>
as well as into another "differential calculus" sub-directory.<br>
<br>
Does DocBook manage this feature ? Will it be possible to build the doc
with<br>
- help files with inode having more than one link ? (Linux / Unix)<br>
- shortcuts pointing to an help file ? (Windows)<br>
<br>
Suggestion & question about the SEP:<br>
- renaming CHAPTER into CHAPTER.txt (is CHAPTER mandatory to follow <br>
any DocBook convention ?)<br>
- <i>SEP Proposal section: "As in the rest of the help build process,
if help files <br>
are not available in a specific languages, the system will copy all of
them from<br>
the english one. <b>Including all the subdirectory</b>"</i><br>
<br>
Does this mean that DocBook cannot manage a partially translated
sub-directory ?<br>
What about such a processing: A list of declared files may be given in
the CHAPTER<br>
file. While building the doc, this list is parsed. If a file is missing
(from the locale directory), <br>
its en_US release is used (together with available files already
translated from en_US <br>
to the locale).<br>
<br>
Best regards<br>
Samuel<br>
<br>
PS:The wiki page <a class="moz-txt-link-freetext" href="http://wiki.scilab.org/howto/scilab_documentation_kit">http://wiki.scilab.org/howto/scilab_documentation_kit</a><br>
is nice. However, i haven't found any example in the wiki, nor of source<br>
help file to imitate, in the Scilab tree of the distributed release.
Where is it <br>
possible to find a source page example containing <br>
- a See also section with cross references, <br>
- inclusion of an image (i just know that such an inclusion is
possible since an <br>
image is included in the segs_properties page. But how to do), <br>
- other external hyperlinks<br>
- etc<br>
Users who can spend a quite appreciable amount of time to go deep
inside the<br>
<i>DocBook definitive reference Guide</i> to find these infos
(imageobject, imagedata, <br>
etc & main syntaxes and options), while they are mainly interested
by Scilab <br>
programming, are likely rare.<br>
<br>
</body>
</html>