Re: [Jmol-users] Jmol documentation

2005-06-10 Thread Nicolas Vervelle



Egon Willighagen wrote:


On Wednesday 8 June 2005 20:31, Bob Hanson wrote:
 


If you look carefully at the bottom of that documentation page, you will
see an "xml" link. Click on that, and it comes back in XML.

http://www.stolaf.edu/people/hansonr/jmol/docs

Maybe something can be done with that. (We're not just talking about making
a PDF file, right? I mean, that's just printing the HTML document, I would
think. Is there a need for that. I'm assuming we are talking here about
translation to another language.)
   



Hi all,

I hope I'm not too late with my comment.
 


Not at all, I won't work on it before July.
I am just gathering ideas on how to do it, to decide how it will be done 
before I find the time.


Currently there is a XSLT stylesheet in CVS that converts the above XML format 
into DocBook XML, which is too in CVS.
 


I didn't see it at first, but I finally found it.

I'm not sure how well gettext works with XML files in general, but I would 
prefer to have gettext translate the XML created with the XML directly from 
the XSL+js, as Bob created for me...
 


That sounds good.
In fact, it seems that the framework is already in place (I think 
Jmol/doc/source/po contains what is needed for the translation).
What still needs to be done is finish the i18n framework (working on 
windows, )


Nicolas


Egon

 





---
This SF.Net email is sponsored by: NEC IT Guy Games.  How far can you shotput
a projector? How fast can you ride your desk chair down the office luge track?
If you want to score the big prize, get to know the little guy.  
Play to win an NEC 61" plasma display: http://www.necitguy.com/?r=20

___
Jmol-users mailing list
Jmol-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/jmol-users


Re: [Jmol-users] Jmol documentation

2005-06-10 Thread Egon Willighagen
On Wednesday 8 June 2005 20:31, Bob Hanson wrote:
> If you look carefully at the bottom of that documentation page, you will
> see an "xml" link. Click on that, and it comes back in XML.
>
> http://www.stolaf.edu/people/hansonr/jmol/docs
>
> Maybe something can be done with that. (We're not just talking about making
> a PDF file, right? I mean, that's just printing the HTML document, I would
> think. Is there a need for that. I'm assuming we are talking here about
> translation to another language.)

Hi all,

I hope I'm not too late with my comment.

Currently there is a XSLT stylesheet in CVS that converts the above XML format 
into DocBook XML, which is too in CVS.

I'm not sure how well gettext works with XML files in general, but I would 
prefer to have gettext translate the XML created with the XML directly from 
the XSL+js, as Bob created for me...

Egon

-- 
[EMAIL PROTECTED]
PhD student on Molecular Representation in Chemometrics
Radboud University Nijmegen
http://www.cac.science.ru.nl/people/egonw/
GPG: 1024D/D6336BA6


---
This SF.Net email is sponsored by: NEC IT Guy Games.  How far can you shotput
a projector? How fast can you ride your desk chair down the office luge track?
If you want to score the big prize, get to know the little guy.  
Play to win an NEC 61" plasma display: http://www.necitguy.com/?r=20
___
Jmol-users mailing list
Jmol-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/jmol-users


Re: [Jmol-users] Jmol documentation

2005-06-09 Thread Bob Hanson



Nicolas Vervelle wrote:


It depends on how the generation is currently done.
Is it working this way ? :



- EXCEL file is edited manually
- XML files are generated automatically from EXCEL file
- HTML pages are generated automatically from XML files


not quite

it's:

EXCEL file is edited manually
JS code is generated automatically from XML files
HTML pages are generated automatically by JS
XML files are generated automatically by JS

However, the active pages you see are not XML. They are JavaScript.

Bob



If it's working this way, then it shouldn't be too difficult to help 
maintaining the translations.
Gettext tools could then be used to convert from XML to PO files (and 
backward)

PO files are dedicated for translating and help maintain the translation.
(Maybe Daniel can be more specific about this part or have better ideas)

If it is possible, I will probably work on this during summer time.


super.

It seems to me a translation involves two issues: Content and Headings.
Heading translation is static and easy, I think. Just define the replacement 
words. Content could be easy. Honestly, one wouldn't expect a whole lot of 
maintenance. My recommendation would be to augment the EXCEL spreadsheet --


All of this could be done in Excel. It's just a separate column for the language 
of choice. What do you think?




Nicolas




---
This SF.Net email is sponsored by: NEC IT Guy Games.  How far can you 
shotput
a projector? How fast can you ride your desk chair down the office luge 
track?
If you want to score the big prize, get to know the little guy.  Play to 
win an NEC 61" plasma display: http://www.necitguy.com/?r=20

___
Jmol-users mailing list
Jmol-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/jmol-users


--

Robert M. Hanson, [EMAIL PROTECTED], 507-646-3107
Professor of Chemistry, St. Olaf College
1520 St. Olaf Ave., Northfield, MN 55057
mailto:[EMAIL PROTECTED]
http://www.stolaf.edu/people/hansonr

"Imagination is more important than knowledge."  - Albert Einstein


---
This SF.Net email is sponsored by: NEC IT Guy Games.  How far can you shotput
a projector? How fast can you ride your desk chair down the office luge track?
If you want to score the big prize, get to know the little guy.  
Play to win an NEC 61" plasma display: http://www.necitguy.com/?r=20

___
Jmol-users mailing list
Jmol-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/jmol-users


Re: [Jmol-users] Jmol documentation

2005-06-09 Thread Nicolas Vervelle



Bob Hanson wrote:


Thanks, Nicolas,

If you look carefully at the bottom of that documentation page, you 
will see

an "xml" link. Click on that, and it comes back in XML.

http://www.stolaf.edu/people/hansonr/jmol/docs

Maybe something can be done with that. (We're not just talking about 
making a PDF file, right? I mean, that's just printing the HTML 
document, I would think. Is there a need for that. I'm assuming we are 
talking here about translation to another language.)


Yes, I was talking about translation to French :) (or other languages if 
people are interested to do them)



Anyway, the source file is at

http://www.stolaf.edu/people/hansonr/jmol/docs/scripts.xls

What we do for the docbook version is I change the EXCEL and then Egon 
(I think) uses the XML link to create XML from it.


I reserve the right to change the XLS, though. So how does 
"translation" in that sort of situation work? How would it be 
maintained? Are there automatic ways of doing that?


It depends on how the generation is currently done.
Is it working this way ? :
- EXCEL file is edited manually
- XML files are generated automatically from EXCEL file
- HTML pages are generated automatically from XML files

If it's working this way, then it shouldn't be too difficult to help 
maintaining the translations.
Gettext tools could then be used to convert from XML to PO files (and 
backward)

PO files are dedicated for translating and help maintain the translation.
(Maybe Daniel can be more specific about this part or have better ideas)

If it is possible, I will probably work on this during summer time.

Nicolas




---
This SF.Net email is sponsored by: NEC IT Guy Games.  How far can you shotput
a projector? How fast can you ride your desk chair down the office luge track?
If you want to score the big prize, get to know the little guy.  
Play to win an NEC 61" plasma display: http://www.necitguy.com/?r=20

___
Jmol-users mailing list
Jmol-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/jmol-users


Re: [Jmol-users] Jmol documentation

2005-06-08 Thread Bob Hanson

Thanks, Nicolas,

If you look carefully at the bottom of that documentation page, you will see
an "xml" link. Click on that, and it comes back in XML.

http://www.stolaf.edu/people/hansonr/jmol/docs

Maybe something can be done with that. (We're not just talking about making a 
PDF file, right? I mean, that's just printing the HTML document, I would think. 
Is there a need for that. I'm assuming we are talking here about translation to 
another language.)


Anyway, the source file is at

http://www.stolaf.edu/people/hansonr/jmol/docs/scripts.xls

What we do for the docbook version is I change the EXCEL and then Egon (I think) 
uses the XML link to create XML from it.


I reserve the right to change the XLS, though. So how does "translation" in that 
sort of situation work? How would it be maintained? Are there automatic ways of 
doing that?


Bob



Nicolas Vervelle wrote:


Hi Daniel,

Daniel Leidert wrote:

Concerning the scripting part, I don't know how it is build but it 
will probably be more difficult since there are some examples with 
the applet.
  


I'm not sure if I understand: The Docbook XML file can be translated in
a gettext-like way (as I currently do using xml2po). So it's not a
problem to update .pot and .po files (the translation) when the
script-documentation changes.
 

I was just talking about the fact that the scripting doc contains 
interactive parts (applet, ...).
I don't see how it can go well in a PDF document (static unless I am 
mistaken)


Otherwise, the script-doc made by Bob Hanson (great job :) ) is not in 
docbook format.

Apparently it is done with Excel and JavaScript files.
Would it be possible to use gettext tools for this kind of files ?

Nicolas



---
This SF.Net email is sponsored by: NEC IT Guy Games.  How far can you 
shotput
a projector? How fast can you ride your desk chair down the office luge 
track?
If you want to score the big prize, get to know the little guy.  Play to 
win an NEC 61" plasma display: http://www.necitguy.com/?r=20

___
Jmol-users mailing list
Jmol-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/jmol-users


--

Robert M. Hanson, [EMAIL PROTECTED], 507-646-3107
Professor of Chemistry, St. Olaf College
1520 St. Olaf Ave., Northfield, MN 55057
mailto:[EMAIL PROTECTED]
http://www.stolaf.edu/people/hansonr

"Imagination is more important than knowledge."  - Albert Einstein


---
This SF.Net email is sponsored by: NEC IT Guy Games.  How far can you shotput
a projector? How fast can you ride your desk chair down the office luge track?
If you want to score the big prize, get to know the little guy.  
Play to win an NEC 61" plasma display: http://www.necitguy.com/?r=20

___
Jmol-users mailing list
Jmol-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/jmol-users


Re: [Jmol-users] Jmol documentation

2005-06-07 Thread Nicolas Vervelle

Hi Daniel,

Daniel Leidert wrote:

Concerning the scripting part, I don't know how it is build but it will 
probably be more difficult since there are some examples with the applet.
   


I'm not sure if I understand: The Docbook XML file can be translated in
a gettext-like way (as I currently do using xml2po). So it's not a
problem to update .pot and .po files (the translation) when the
script-documentation changes.
 

I was just talking about the fact that the scripting doc contains 
interactive parts (applet, ...).
I don't see how it can go well in a PDF document (static unless I am 
mistaken)


Otherwise, the script-doc made by Bob Hanson (great job :) ) is not in 
docbook format.

Apparently it is done with Excel and JavaScript files.
Would it be possible to use gettext tools for this kind of files ?

Nicolas



---
This SF.Net email is sponsored by: NEC IT Guy Games.  How far can you shotput
a projector? How fast can you ride your desk chair down the office luge track?
If you want to score the big prize, get to know the little guy.  
Play to win an NEC 61" plasma display: http://www.necitguy.com/?r=20

___
Jmol-users mailing list
Jmol-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/jmol-users


Re: [Jmol-users] Jmol documentation

2005-06-07 Thread Nicolas Vervelle

Hi Bob,

Bob Hanson wrote:


Nicolas Vervelle wrote:


I was also wondering if the scripting part can be internationalized ?
I am willing to make the french translation if it is possible ;)


I don't know what that means unless it means you translate it.
I can give you the XLS and JS files and you can see what you can do, but
then if it gets changed, how do you then update yours?


I was meaning that the translation was easy to do and to *maintain*.
Yes, please, send me the files, I will see what I can do with them.
Not sure if it will be in the near future, because I don't have much 
free time right now.


Nicolas



---
This SF.Net email is sponsored by: NEC IT Guy Games.  How far can you shotput
a projector? How fast can you ride your desk chair down the office luge track?
If you want to score the big prize, get to know the little guy.  
Play to win an NEC 61" plasma display: http://www.necitguy.com/?r=20

___
Jmol-users mailing list
Jmol-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/jmol-users


Re: [Jmol-users] Jmol documentation

2005-06-07 Thread Daniel Leidert
Am Dienstag, den 07.06.2005, 22:32 +0200 schrieb Nicolas Vervelle:
> 
> Daniel Leidert wrote:
> 
> >>Tjaart de Beer wrote:
> >>
> >>
> >>>Are the Jmol documentation available as PDF (the scripting as well as 
> >>>the development docs)?
> >>>  
> >>>
> >It shouldn't be that hard to add XSLT stylesheets to produce PDFs from
> >docbook XML. I guess, the standard stylesheets from inside the
> >docbook-xsl archive are a good starting point. I can also customize them
> >at the next opportunity.
> >
> That would be good to have the documentation in a clean / printable 
> format as PFD :)

I will add basic XSL files soon.

> Concerning the scripting part, I don't know how it is build but it will 
> probably be more difficult since there are some examples with the applet.

I'm not sure if I understand: The Docbook XML file can be translated in
a gettext-like way (as I currently do using xml2po). So it's not a
problem to update .pot and .po files (the translation) when the
script-documentation changes.

> I was also wondering if the scripting part can be internationalized ?

If you mean the internationalisation of Javascript, then I have no idea.
Maybe this works: http://jibbering.com/faq/#FAQ2_10

Regards, Daniel



---
This SF.Net email is sponsored by: NEC IT Guy Games.  How far can you shotput
a projector? How fast can you ride your desk chair down the office luge track?
If you want to score the big prize, get to know the little guy.  
Play to win an NEC 61" plasma display: http://www.necitguy.com/?r=20
___
Jmol-users mailing list
Jmol-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/jmol-users


Re: [Jmol-users] Jmol documentation

2005-06-07 Thread Bob Hanson



Nicolas Vervelle wrote:



I was also wondering if the scripting part can be internationalized ?
I am willing to make the french translation if it is possible ;)


I don't know what that means unless it means you translate it.
I can give you the XLS and JS files and you can see what you can do, but
then if it gets changed, how do you then update yours?

Bob

--

Robert M. Hanson, [EMAIL PROTECTED], 507-646-3107
Professor of Chemistry, St. Olaf College
1520 St. Olaf Ave., Northfield, MN 55057
mailto:[EMAIL PROTECTED]
http://www.stolaf.edu/people/hansonr

"Imagination is more important than knowledge."  - Albert Einstein


---
This SF.Net email is sponsored by: NEC IT Guy Games.  How far can you shotput
a projector? How fast can you ride your desk chair down the office luge track?
If you want to score the big prize, get to know the little guy.  
Play to win an NEC 61" plasma display: http://www.necitguy.com/?r=20

___
Jmol-users mailing list
Jmol-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/jmol-users


Re: [Jmol-users] Jmol documentation

2005-06-07 Thread Nicolas Vervelle



Daniel Leidert wrote:


Tjaart de Beer wrote:
   

Are the Jmol documentation available as PDF (the scripting as well as 
the development docs)?
 


It shouldn't be that hard to add XSLT stylesheets to produce PDFs from
docbook XML. I guess, the standard stylesheets from inside the
docbook-xsl archive are a good starting point. I can also customize them
at the next opportunity.

That would be good to have the documentation in a clean / printable 
format as PFD :)


Concerning the scripting part, I don't know how it is build but it will 
probably be more difficult since there are some examples with the applet.


I was also wondering if the scripting part can be internationalized ?
I am willing to make the french translation if it is possible ;)

Nicolas




---
This SF.Net email is sponsored by: NEC IT Guy Games.  How far can you shotput
a projector? How fast can you ride your desk chair down the office luge track?
If you want to score the big prize, get to know the little guy.  
Play to win an NEC 61" plasma display: http://www.necitguy.com/?r=20

___
Jmol-users mailing list
Jmol-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/jmol-users


Re: [Jmol-users] Jmol documentation

2005-06-07 Thread Daniel Leidert
Am Dienstag, den 07.06.2005, 05:38 -0500 schrieb Bob Hanson:
> Tjaart de Beer wrote:
> 
> > Are the Jmol documentation available as PDF (the scripting as well as 
> > the development docs)?
> > 
> 
> If you like, I can produce PDF from
> 
> http://www.stolaf.edu/people/hansonr/jmol/docs
> 
> by printing the web page to a PDF writer.
> Would there be some advantage to that?

It shouldn't be that hard to add XSLT stylesheets to produce PDFs from
docbook XML. I guess, the standard stylesheets from inside the
docbook-xsl archive are a good starting point. I can also customize them
at the next opportunity.

Regards, Daniel





---
This SF.Net email is sponsored by: NEC IT Guy Games.  How far can you shotput
a projector? How fast can you ride your desk chair down the office luge track?
If you want to score the big prize, get to know the little guy.  
Play to win an NEC 61" plasma display: http://www.necitguy.com/?r=20
___
Jmol-users mailing list
Jmol-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/jmol-users


Re: [Jmol-users] Jmol documentation

2005-06-07 Thread Bob Hanson

If you like, I can produce PDF from

http://www.stolaf.edu/people/hansonr/jmol/docs

by printing the web page to a PDF writer.
Would there be some advantage to that?

Tjaart de Beer wrote:


Hi

Are the Jmol documentation available as PDF (the scripting as well as 
the development docs)?


Thanks!!


--
Robert M. Hanson, [EMAIL PROTECTED], 507-646-3107
Professor of Chemistry, St. Olaf College 1520 St. Olaf Ave., Northfield, MN 
55057
mailto:[EMAIL PROTECTED] http://www.stolaf.edu/people/hansonr



---
This SF.Net email is sponsored by: NEC IT Guy Games.  How far can you shotput
a projector? How fast can you ride your desk chair down the office luge track?
If you want to score the big prize, get to know the little guy.  
Play to win an NEC 61" plasma display: http://www.necitguy.com/?r=20

___
Jmol-users mailing list
Jmol-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/jmol-users


[Jmol-users] Jmol documentation

2005-06-07 Thread Tjaart de Beer

Hi

Are the Jmol documentation available as PDF (the scripting as well as 
the development docs)?


Thanks!!
--
Tjaart de Beer
Bioinformatics and Computational Biology Unit
Department Biochemistry
FABI Square/Bioinformatics building
Faculty of Natural Sciences
University of Pretoria
Lynwood rd
Pretoria
South Africa
0001

Tel:+27 12 420 5802
Cell:   +27 83 504 7914
Fax:+27 12 420 5800
Email:  [EMAIL PROTECTED]
[EMAIL PROTECTED]
[EMAIL PROTECTED]

-
The software required "Windows XP or better" ... so I installed Linux


---
This SF.Net email is sponsored by: NEC IT Guy Games.  How far can you shotput
a projector? How fast can you ride your desk chair down the office luge track?
If you want to score the big prize, get to know the little guy.  
Play to win an NEC 61" plasma display: http://www.necitguy.com/?r=20

___
Jmol-users mailing list
Jmol-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/jmol-users