On 04/02/2013 07:41 PM, Ulrich Pegelow wrote: > Am 02.04.2013 19:27, schrieb Togan Muftuoglu: >> Hi, >> >> I have been working on getting the docbook sources into shape. Although >> I manage to get them into a shape that they are now validating, I am >> having difficulty understanding the intention of the author who made >> markup. >> >> For example why there is a need to create an informaltable for the >> module (for the sake of argument let's say chromatic abberrations) >> >> the first column is the explanation and the second column is the graphic >> >> Why not just put the explanation in a para element and then place the >> image below. >> > > Hi Togan, > > although I also only inherited the structure as it is currently, I > strongly recommend to not make structural changes right now. We are just > ahead of darktable 1.2, including the new manual, and we should try to > get things settled.
Well first of all without making some changes to the structure, the current situation is chaos, as the document is not valid. To see it for your self run the following xmllint --xinclude --noout --postvalid darktable.xml It is just luck that the pdf output is generated from this garbage. > > After 1.2 we can certainly discuss the pros and cons of all the details, > including formatting. We might even discuss if docbook is the right > format for us to continue with... Well docbook is almost industry standard and from the simple markup html, man page, epub, pdf are doable. And if one wants to go to the extreme even using latex backend (dblatex) is possible I understand the concern about 1.2 on the doorway, but with current way of editing and structure nothing that sort is doable. Hence I am slowing down on fixing the docbook sources and fixing xsl stylesheets. Togan ------------------------------------------------------------------------------ Minimize network downtime and maximize team effectiveness. Reduce network management and security costs.Learn how to hire the most talented Cisco Certified professionals. Visit the Employer Resources Portal http://www.cisco.com/web/learning/employer_resources/index.html _______________________________________________ darktable-devel mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/darktable-devel
