Re: Migrating documentation from HTML files

by Lukas Theussl-4 :: Rate this Message:

doxia doesn't have a latex parser (I'd like to have one too!),
latex2html is the only solution I can think of (there exist other latex
translators though but that's the only one I know). I am not sure what
kind of output latex2html produces, however, the difference HTML - xhtml
shouldn't matter here. What kind of exceptions do you get? Maybe you
could attach an example file at jira [1] with a snippet of your code so
we can try to reproce the problem?

-Lukas

[1] http://jira.codehaus.org/browse/DOXIA

krycho fandino wrote:

> Thanks for your help, however my HTML files isn't XHTML and XhtmlParser
> throws a lot of exceptions. Perhaps, I should convert these HTML files to
> XHTML format, but I've a lot of pages and should be a hard task.
>
> Really, I has generated these HTML files using latex2html conversion tool. I
> don't know how I could transform latex files to some markup languages
> supported by doxia (apt or xdoc). Could you give me some advice?
>
>
> 2008/3/2, Lukas Theussl <ltheussl@...>:
>
>>If you use the current development branch of doxia (beta-1-SNAPSHOT)
>>then this should work rather well for simple html files. However, you
>>will probably loose a lot of information if you have anything fancy (eg
>>special layout, tables, figures are not well supported), don't expect it
>>to be perfect. In particular if you have figures you might try to
>>translate to xdoc instead of apt (use XdocSink), that should work better.
>>
>>Cheers,
>>
>>-Lukas
>>
>>
>>
>>Vincent Siveton wrote:
>>
>>>Hi,
>>>
>>>Frankly, I never test your use case.
>>>
>>>But I guess that you need to have an XHTML file in input with no
>>>header, footer or navbar something to the div bodyColumn in [1].
>>>
>>>The snippet should be something like the following:
>>>
>>>File f = new File( "blabla.html" );
>>>XhtmlParser parser = new XhtmlParser();
>>>StringWriter output = new StringWriter();
>>>Sink sink = new AptSink( output );
>>>parser.parse( new FileReader( f ), output );
>>>
>>>Output will contain APT declaration.
>>>
>>>HTH,
>>>
>>>Vincent
>>>
>>>[1] http://maven.apache.org/doxia/
>>>
>>>2008/3/1, krycho fandino <cristobalft@...>:
>>>
>>>
>>>>I'm a newbie using doxia. I've a lot of documentation in HTML format an
>>
>>I'd
>>
>>>>like convert these files to apt format. Is there some way to transform
>>>>easily? I want to create a maven site for my project and, right now, I
>>
>>only
>>
>>>>have this documentation in HTML format without css styles nor menu.
>>>>
>>>>Could you help me? Very thanks
>>>>Cristóbal
>>>
>>
>

« Return to Thread: Migrating documentation from HTML files