Re: [GSoC] convert blends-doc from debian-sgml to xml
Hi Emmanouil,
On Sun, Sep 15, 2013 at 10:41:56PM +0300, Emmanouil Kiagias wrote:
> Hello Andreas,
>
> I checked the current blends/doc. In order to convert the current format to
> xml I used docbook5-xml. I just commited the some first converted pages.
Thanks for your effort.
> The files are under:
>
> blends-gsoc/doc/
>
> To test the files I did:
>
> xmlto html debian-blends.en.xml
I also tried
xmlto pdf debian-blends.en.xml
which endet up in
...
! Undefined control sequence.
<recently read> \AppendGraphicsExtensions
l.451 \fi
?
! Emergency stop.
<recently read> \AppendGraphicsExtensions
l.451 \fi
! ==> Fatal error occurred, no output PDF file produced!
Transcript written on tmp.log.
> Of course the output needs to be customized: section enumerations, no page
> break for each section, navigation etc. I need to investigate more for
> these cause its my first time dealing with sgml/xml documentation. I also
> tried with xsltproc (for example add an option for section enumeration
> from cmd, also its easier cause it dumps all pages into a single html file)
>
> xsltproc -o index.html --stringparam section.autolabel 1
> /usr/share/xml/docbook/stylesheet/docbook-xsl/html/docbook.xsl
> debian-blends.en.xml
>
>
> Can you check the files, is this what we need?
In principle the html output looks OK.
> If yes I will convert the
> rest of the blends-doc pages in new format and then customize the xls
> options in order to produce an output same as the the current debian-sgml
> files.
In principle yes. However, I'd like to warn you that the conversion
might be time consuming and I think if you consider any stumbling stones
it might be more reasonable to write down your documentation for GSoC in
the current format. So while I'd be really happy if we get the
conversion done but it should not have a bad effect on your timing.
Kind regards
Andreas.
--
http://fam-tille.de
Reply to: