[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

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



Reply to: