Re: software manuals using Lyx

2006-02-21 Thread Abdelrazak Younes

John Pye a écrit :

Hi Abdel,

You suggested exporting HTML then importing that to the CHM tool from
MS. That is what i would plan to do, but note that one needs various
support files for using the index feature, and for creating the
navigation hierarchy on the left hand side of the CHM window. These are
things that Lyx needs to provide.


Right, those index needs to be done by hand. It would be very handy to 
have a tool that convert lyx index file (latex or docbooc) to this CHM 
format. Did you take a look to xindy (http://xindy.sourceforge.net/) 
maybe it will do what you need.



Furthermore, I don't believe I can export using 'htlatex' if I am
working on a docbook-lyx document. I need to use docbook-lyx format in
order to support GNOME help ('yelp') output.


Right but you can change to a latex document class before exporting to 
html. That said, I am sure there are tools that convert docbook to html. 
If it is docbook-XML, I believe you could find some XSL that do this 
transformation on the oasis website.


Abdel.



Re: software manuals using Lyx

2006-02-21 Thread Abdelrazak Younes

John Pye a écrit :

Hi Abdel,

You suggested exporting HTML then importing that to the CHM tool from
MS. That is what i would plan to do, but note that one needs various
support files for using the index feature, and for creating the
navigation hierarchy on the left hand side of the CHM window. These are
things that Lyx needs to provide.


Right, those index needs to be done by hand. It would be very handy to 
have a tool that convert lyx index file (latex or docbooc) to this CHM 
format. Did you take a look to xindy (http://xindy.sourceforge.net/) 
maybe it will do what you need.



Furthermore, I don't believe I can export using 'htlatex' if I am
working on a docbook-lyx document. I need to use docbook-lyx format in
order to support GNOME help ('yelp') output.


Right but you can change to a latex document class before exporting to 
html. That said, I am sure there are tools that convert docbook to html. 
If it is docbook-XML, I believe you could find some XSL that do this 
transformation on the oasis website.


Abdel.



Re: software manuals using Lyx

2006-02-21 Thread Abdelrazak Younes

John Pye a écrit :

Hi Abdel,

You suggested exporting HTML then importing that to the CHM tool from
MS. That is what i would plan to do, but note that one needs various
support files for using the index feature, and for creating the
navigation hierarchy on the left hand side of the CHM window. These are
things that Lyx needs to provide.


Right, those index needs to be done by hand. It would be very handy to 
have a tool that convert lyx index file (latex or docbooc) to this CHM 
format. Did you take a look to xindy (http://xindy.sourceforge.net/) 
maybe it will do what you need.



Furthermore, I don't believe I can export using 'htlatex' if I am
working on a docbook-lyx document. I need to use docbook-lyx format in
order to support GNOME help ('yelp') output.


Right but you can change to a latex document class before exporting to 
html. That said, I am sure there are tools that convert docbook to html. 
If it is docbook-XML, I believe you could find some XSL that do this 
transformation on the oasis website.


Abdel.



Re: software manuals using Lyx

2006-02-20 Thread Abdelrazak Younes

Jose' Matos a écrit :

On Friday 17 February 2006 07:55, John Pye wrote:

Hi there,

Can anyone tell me if there is an up-to-date HOWTO somewhere for using
Lyx for DocBook output of software user's manuals?


  No, that has been in my TODO list for a long time. :-(


In particular, I want to be able to generate 'chm'  files for Windows,
and DocBook XML for GNOME ('yelp' help browser). Is this something that
other people on the list are doing?


  You need to find a tool that converts docbook to chm, and then use the 
traditional way of configuring lyx.


Or just export to html with htlatex and use Microsoft free chm tool.

Abdel.



  1) Add format, with its viewer
  2) Define how to convert from docbook to chm


I found this but it's 5 years old, and hopefully things have become
easier...
http://bgu.chez-alice.fr/doc/db4lyx/

If such a HOWTO /doesn't/ exist, maybe there'd be someone willing to
collaborate on putting it together?


  I can explain why lots of things are the way they are, and if 
possible/necessary fix those bugs.



Cheers
JP






Re: software manuals using Lyx

2006-02-20 Thread John Pye
Hi Abdel,

You suggested exporting HTML then importing that to the CHM tool from
MS. That is what i would plan to do, but note that one needs various
support files for using the index feature, and for creating the
navigation hierarchy on the left hand side of the CHM window. These are
things that Lyx needs to provide.

For example:
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/htmlhelp/html/vsconprjcmp.asp
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/htmlhelp/html/vsconoveridx.asp

Furthermore, I don't believe I can export using 'htlatex' if I am
working on a docbook-lyx document. I need to use docbook-lyx format in
order to support GNOME help ('yelp') output.

Cheers
JP

Abdelrazak Younes wrote:

 Jose' Matos a écrit :

 On Friday 17 February 2006 07:55, John Pye wrote:

 Hi there,

 Can anyone tell me if there is an up-to-date HOWTO somewhere for using
 Lyx for DocBook output of software user's manuals?


   No, that has been in my TODO list for a long time. :-(

 In particular, I want to be able to generate 'chm'  files for Windows,
 and DocBook XML for GNOME ('yelp' help browser). Is this something that
 other people on the list are doing?


   You need to find a tool that converts docbook to chm, and then use
 the traditional way of configuring lyx.


 Or just export to html with htlatex and use Microsoft free chm tool.

 Abdel.


   1) Add format, with its viewer
   2) Define how to convert from docbook to chm

 I found this but it's 5 years old, and hopefully things have become
 easier...
 http://bgu.chez-alice.fr/doc/db4lyx/

 If such a HOWTO /doesn't/ exist, maybe there'd be someone willing to
 collaborate on putting it together?


   I can explain why lots of things are the way they are, and if
 possible/necessary fix those bugs.

 Cheers
 JP





-- 
John Pye
School of Mechanical and Manufacturing Engineering
The University of New South Wales
Sydney  NSW 2052  Australia
t +61 2 9385 5127
f +61 2 9663 1222
mailto:john.pye_AT_student_DOT_unsw.edu.au
http://pye.dyndns.org/



Re: software manuals using Lyx

2006-02-20 Thread Abdelrazak Younes

Jose' Matos a écrit :

On Friday 17 February 2006 07:55, John Pye wrote:

Hi there,

Can anyone tell me if there is an up-to-date HOWTO somewhere for using
Lyx for DocBook output of software user's manuals?


  No, that has been in my TODO list for a long time. :-(


In particular, I want to be able to generate 'chm'  files for Windows,
and DocBook XML for GNOME ('yelp' help browser). Is this something that
other people on the list are doing?


  You need to find a tool that converts docbook to chm, and then use the 
traditional way of configuring lyx.


Or just export to html with htlatex and use Microsoft free chm tool.

Abdel.



  1) Add format, with its viewer
  2) Define how to convert from docbook to chm


I found this but it's 5 years old, and hopefully things have become
easier...
http://bgu.chez-alice.fr/doc/db4lyx/

If such a HOWTO /doesn't/ exist, maybe there'd be someone willing to
collaborate on putting it together?


  I can explain why lots of things are the way they are, and if 
possible/necessary fix those bugs.



Cheers
JP






Re: software manuals using Lyx

2006-02-20 Thread John Pye
Hi Abdel,

You suggested exporting HTML then importing that to the CHM tool from
MS. That is what i would plan to do, but note that one needs various
support files for using the index feature, and for creating the
navigation hierarchy on the left hand side of the CHM window. These are
things that Lyx needs to provide.

For example:
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/htmlhelp/html/vsconprjcmp.asp
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/htmlhelp/html/vsconoveridx.asp

Furthermore, I don't believe I can export using 'htlatex' if I am
working on a docbook-lyx document. I need to use docbook-lyx format in
order to support GNOME help ('yelp') output.

Cheers
JP

Abdelrazak Younes wrote:

 Jose' Matos a écrit :

 On Friday 17 February 2006 07:55, John Pye wrote:

 Hi there,

 Can anyone tell me if there is an up-to-date HOWTO somewhere for using
 Lyx for DocBook output of software user's manuals?


   No, that has been in my TODO list for a long time. :-(

 In particular, I want to be able to generate 'chm'  files for Windows,
 and DocBook XML for GNOME ('yelp' help browser). Is this something that
 other people on the list are doing?


   You need to find a tool that converts docbook to chm, and then use
 the traditional way of configuring lyx.


 Or just export to html with htlatex and use Microsoft free chm tool.

 Abdel.


   1) Add format, with its viewer
   2) Define how to convert from docbook to chm

 I found this but it's 5 years old, and hopefully things have become
 easier...
 http://bgu.chez-alice.fr/doc/db4lyx/

 If such a HOWTO /doesn't/ exist, maybe there'd be someone willing to
 collaborate on putting it together?


   I can explain why lots of things are the way they are, and if
 possible/necessary fix those bugs.

 Cheers
 JP





-- 
John Pye
School of Mechanical and Manufacturing Engineering
The University of New South Wales
Sydney  NSW 2052  Australia
t +61 2 9385 5127
f +61 2 9663 1222
mailto:john.pye_AT_student_DOT_unsw.edu.au
http://pye.dyndns.org/



Re: software manuals using Lyx

2006-02-20 Thread Abdelrazak Younes

Jose' Matos a écrit :

On Friday 17 February 2006 07:55, John Pye wrote:

Hi there,

Can anyone tell me if there is an up-to-date HOWTO somewhere for using
Lyx for DocBook output of software user's manuals?


  No, that has been in my TODO list for a long time. :-(


In particular, I want to be able to generate 'chm'  files for Windows,
and DocBook XML for GNOME ('yelp' help browser). Is this something that
other people on the list are doing?


  You need to find a tool that converts docbook to chm, and then use the 
traditional way of configuring lyx.


Or just export to html with htlatex and use Microsoft free chm tool.

Abdel.



  1) Add format, with its viewer
  2) Define how to convert from docbook to chm


I found this but it's 5 years old, and hopefully things have become
easier...
http://bgu.chez-alice.fr/doc/db4lyx/

If such a HOWTO /doesn't/ exist, maybe there'd be someone willing to
collaborate on putting it together?


  I can explain why lots of things are the way they are, and if 
possible/necessary fix those bugs.



Cheers
JP






Re: software manuals using Lyx

2006-02-20 Thread John Pye
Hi Abdel,

You suggested exporting HTML then importing that to the CHM tool from
MS. That is what i would plan to do, but note that one needs various
support files for using the index feature, and for creating the
navigation hierarchy on the left hand side of the CHM window. These are
things that Lyx needs to provide.

For example:
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/htmlhelp/html/vsconprjcmp.asp
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/htmlhelp/html/vsconoveridx.asp

Furthermore, I don't believe I can export using 'htlatex' if I am
working on a docbook-lyx document. I need to use docbook-lyx format in
order to support GNOME help ('yelp') output.

Cheers
JP

Abdelrazak Younes wrote:

> Jose' Matos a écrit :
>
>> On Friday 17 February 2006 07:55, John Pye wrote:
>>
>>> Hi there,
>>>
>>> Can anyone tell me if there is an up-to-date HOWTO somewhere for using
>>> Lyx for DocBook output of software user's manuals?
>>
>>
>>   No, that has been in my TODO list for a long time. :-(
>>
>>> In particular, I want to be able to generate 'chm'  files for Windows,
>>> and DocBook XML for GNOME ('yelp' help browser). Is this something that
>>> other people on the list are doing?
>>
>>
>>   You need to find a tool that converts docbook to chm, and then use
>> the traditional way of configuring lyx.
>
>
> Or just export to html with htlatex and use Microsoft free chm tool.
>
> Abdel.
>
>>
>>   1) Add format, with its viewer
>>   2) Define how to convert from docbook to chm
>>
>>> I found this but it's 5 years old, and hopefully things have become
>>> easier...
>>> http://bgu.chez-alice.fr/doc/db4lyx/
>>>
>>> If such a HOWTO /doesn't/ exist, maybe there'd be someone willing to
>>> collaborate on putting it together?
>>
>>
>>   I can explain why lots of things are the way they are, and if
>> possible/necessary fix those bugs.
>>
>>> Cheers
>>> JP
>>
>>
>
>

-- 
John Pye
School of Mechanical and Manufacturing Engineering
The University of New South Wales
Sydney  NSW 2052  Australia
t +61 2 9385 5127
f +61 2 9663 1222
mailto:john.pye_AT_student_DOT_unsw.edu.au
http://pye.dyndns.org/



Re: software manuals using Lyx

2006-02-18 Thread Jose' Matos
On Friday 17 February 2006 07:55, John Pye wrote:
 Hi there,

 Can anyone tell me if there is an up-to-date HOWTO somewhere for using
 Lyx for DocBook output of software user's manuals?

  No, that has been in my TODO list for a long time. :-(

 In particular, I want to be able to generate 'chm'  files for Windows,
 and DocBook XML for GNOME ('yelp' help browser). Is this something that
 other people on the list are doing?

  You need to find a tool that converts docbook to chm, and then use the 
traditional way of configuring lyx.

  1) Add format, with its viewer
  2) Define how to convert from docbook to chm

 I found this but it's 5 years old, and hopefully things have become
 easier...
 http://bgu.chez-alice.fr/doc/db4lyx/

 If such a HOWTO /doesn't/ exist, maybe there'd be someone willing to
 collaborate on putting it together?

  I can explain why lots of things are the way they are, and if 
possible/necessary fix those bugs.

 Cheers
 JP

-- 
José Abílio


Re: software manuals using Lyx

2006-02-18 Thread Jose' Matos
On Friday 17 February 2006 07:55, John Pye wrote:
 Hi there,

 Can anyone tell me if there is an up-to-date HOWTO somewhere for using
 Lyx for DocBook output of software user's manuals?

  No, that has been in my TODO list for a long time. :-(

 In particular, I want to be able to generate 'chm'  files for Windows,
 and DocBook XML for GNOME ('yelp' help browser). Is this something that
 other people on the list are doing?

  You need to find a tool that converts docbook to chm, and then use the 
traditional way of configuring lyx.

  1) Add format, with its viewer
  2) Define how to convert from docbook to chm

 I found this but it's 5 years old, and hopefully things have become
 easier...
 http://bgu.chez-alice.fr/doc/db4lyx/

 If such a HOWTO /doesn't/ exist, maybe there'd be someone willing to
 collaborate on putting it together?

  I can explain why lots of things are the way they are, and if 
possible/necessary fix those bugs.

 Cheers
 JP

-- 
José Abílio


Re: software manuals using Lyx

2006-02-18 Thread Jose' Matos
On Friday 17 February 2006 07:55, John Pye wrote:
> Hi there,
>
> Can anyone tell me if there is an up-to-date HOWTO somewhere for using
> Lyx for DocBook output of software user's manuals?

  No, that has been in my TODO list for a long time. :-(

> In particular, I want to be able to generate 'chm'  files for Windows,
> and DocBook XML for GNOME ('yelp' help browser). Is this something that
> other people on the list are doing?

  You need to find a tool that converts docbook to chm, and then use the 
traditional way of configuring lyx.

  1) Add format, with its viewer
  2) Define how to convert from docbook to chm

> I found this but it's 5 years old, and hopefully things have become
> easier...
> http://bgu.chez-alice.fr/doc/db4lyx/
>
> If such a HOWTO /doesn't/ exist, maybe there'd be someone willing to
> collaborate on putting it together?

  I can explain why lots of things are the way they are, and if 
possible/necessary fix those bugs.

> Cheers
> JP

-- 
José Abílio


Re: software manuals using Lyx

2006-02-17 Thread Bo Peng
 Can anyone tell me if there is an up-to-date HOWTO somewhere for using
 Lyx for DocBook output of software user's manuals?

Personally I am using python/manual.cls and an adapted layout file.
This works reasonably well but there is no chm output and other fancy
stuff.

I tried the lyx/docbook before, following the same kinds of tutorials,
but none of them worked. This may be because I am not familiar with
XML/docbook etc but the bizarre error messages, incompatible tool
sets, limited support from lyx  really dismayed me. Maybe things have
been better now.

Cheers,
Bo


Re: software manuals using Lyx

2006-02-17 Thread John Pye
What version was it that you tried with? I think (am hoping) that 1.3.7 
and then 1.4 should be better...


Cheers
JP

Bo Peng wrote:


Can anyone tell me if there is an up-to-date HOWTO somewhere for using
Lyx for DocBook output of software user's manuals?
   



Personally I am using python/manual.cls and an adapted layout file.
This works reasonably well but there is no chm output and other fancy
stuff.

I tried the lyx/docbook before, following the same kinds of tutorials,
but none of them worked. This may be because I am not familiar with
XML/docbook etc but the bizarre error messages, incompatible tool
sets, limited support from lyx  really dismayed me. Maybe things have
been better now.

Cheers,
Bo

 



Re: software manuals using Lyx

2006-02-17 Thread Bo Peng
 Can anyone tell me if there is an up-to-date HOWTO somewhere for using
 Lyx for DocBook output of software user's manuals?

Personally I am using python/manual.cls and an adapted layout file.
This works reasonably well but there is no chm output and other fancy
stuff.

I tried the lyx/docbook before, following the same kinds of tutorials,
but none of them worked. This may be because I am not familiar with
XML/docbook etc but the bizarre error messages, incompatible tool
sets, limited support from lyx  really dismayed me. Maybe things have
been better now.

Cheers,
Bo


Re: software manuals using Lyx

2006-02-17 Thread John Pye
What version was it that you tried with? I think (am hoping) that 1.3.7 
and then 1.4 should be better...


Cheers
JP

Bo Peng wrote:


Can anyone tell me if there is an up-to-date HOWTO somewhere for using
Lyx for DocBook output of software user's manuals?
   



Personally I am using python/manual.cls and an adapted layout file.
This works reasonably well but there is no chm output and other fancy
stuff.

I tried the lyx/docbook before, following the same kinds of tutorials,
but none of them worked. This may be because I am not familiar with
XML/docbook etc but the bizarre error messages, incompatible tool
sets, limited support from lyx  really dismayed me. Maybe things have
been better now.

Cheers,
Bo

 



Re: software manuals using Lyx

2006-02-17 Thread Bo Peng
> Can anyone tell me if there is an up-to-date HOWTO somewhere for using
> Lyx for DocBook output of software user's manuals?

Personally I am using python/manual.cls and an adapted layout file.
This works reasonably well but there is no chm output and other fancy
stuff.

I tried the lyx/docbook before, following the same kinds of tutorials,
but none of them worked. This may be because I am not familiar with
XML/docbook etc but the bizarre error messages, incompatible tool
sets, limited support from lyx  really dismayed me. Maybe things have
been better now.

Cheers,
Bo


Re: software manuals using Lyx

2006-02-17 Thread John Pye
What version was it that you tried with? I think (am hoping) that 1.3.7 
and then 1.4 should be better...


Cheers
JP

Bo Peng wrote:


Can anyone tell me if there is an up-to-date HOWTO somewhere for using
Lyx for DocBook output of software user's manuals?
   



Personally I am using python/manual.cls and an adapted layout file.
This works reasonably well but there is no chm output and other fancy
stuff.

I tried the lyx/docbook before, following the same kinds of tutorials,
but none of them worked. This may be because I am not familiar with
XML/docbook etc but the bizarre error messages, incompatible tool
sets, limited support from lyx  really dismayed me. Maybe things have
been better now.

Cheers,
Bo