>>Subject: Creating HTML docs from LyX
>>From: Jane McKean <[EMAIL PROTECTED]>
>>To: [email protected]
>>Date: Wed, 30 Mar 2005 11:23:58 -0800
>>
>>Hi there:
>>
>>I am using LyX 1.3.5 on Fedora Core 3 to create our compiler
>>documentation set (now up to six volumes or so). I've been creating PDFs
>>from LyX as the final output (pdflatex), with included PDFs for the
>>covers (artwork from Marketing). I have figures, tables, an index, the
>>works. 
>>
>>Everyone has been very pleased with the output and the documentation
>>set. Now they want an HTML version of the docs to post on our website,
>>not just the PDFs.
>>
>>My question: Has anybody created a volume of documentation (300-500
>>pages) in LyX and converted it to HTML? Do you have any recommendations,
>>suggestions, things to avoid? 
>>
>>Are there other converters/tools/packages you might recommend? Would I
>>be better off generating from the .tex files that LyX creates? I
>>understand that tables can be problematic. 

I built a HTML version of the docs with latex2html. You must be aware that
you loose some of the features of the on-line help (when the help refers to
things which need LyX to be correctly displayed) - but this is true with the 
pdf version as well.
The reward is the ability to access individual sections with a search field,
if you take care to split the docs at maximum depth.
In that case, you may keep the lyx doc separate.

So the best combination seems on-line LyX help to navigate the docs by TOC, pdf 
doc to read at will,
and keyword search on HTML conversion (batch automated conversion, something 
like
-- tuned for french documentation:
#!/bin/sh
# export
lyx -e latex fr_Customization.lyx
# compile
latex fr_Customization
bibtex fr_Customization
makeindex -s fridx1.ist fr_Customization
latex fr_Customization
latex fr_Customization
latex fr_Customization
# convert to html
latex2html -html_version 3.2,latin1,Unicode,latin9 -image_type png \
 -auto_prefix -split 8 -link 4 \
 -t " Documentation LYX - Personnalisation" \
-address 'Documentation LYX 1.3.5 - Personnalisation<BR><a href="mailto:[EMAIL 
PROTECTED]">Admin LyX</a>' fr_Customization.tex
exit 0

Once this works, you may loop on the docs...

-- 
Jean-Pierre




Reply via email to