ntg-context - mailing list for ConTeXt users
 help / color / mirror / Atom feed
* DocBook in ConTeXt - any new ideas?
@ 2011-06-02  9:39 Piotr Kopszak
  2011-06-02 10:20 ` Thomas Schmitz
  2011-06-02 11:58 ` Hans Hagen
  0 siblings, 2 replies; 15+ messages in thread
From: Piotr Kopszak @ 2011-06-02  9:39 UTC (permalink / raw)
  To: mailing list for ConTeXt users

Dear list,

 I am beginning a rather tedious documentation project and will most
   probably end up with DocBook. The fact is I haven't used it for any
   serious work for about 10 years. Docbook In ConText haven't been
   updated since 2003. Does it mean it's so perfect or instead rather
   obsolete? Could you recommend other approaches which work
   out-of-the-box (or almost). Obviously I would prefer ConTeXt based
   solutions. DocBook is not mandatory in fact, I would happily learn  other
   documentation system. Main prerequisite is utf-8 output at least in
   pdf and html and sensible defaults (this time I don't want to be a
   typographer, nor I want to fiddle with structure).

   Best

   Piotr
   --
   http://okle.pl
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________


^ permalink raw reply	[flat|nested] 15+ messages in thread

* Re: DocBook in ConTeXt - any new ideas?
  2011-06-02  9:39 DocBook in ConTeXt - any new ideas? Piotr Kopszak
@ 2011-06-02 10:20 ` Thomas Schmitz
  2011-06-02 10:53   ` Piotr Kopszak
  2011-06-02 11:58 ` Hans Hagen
  1 sibling, 1 reply; 15+ messages in thread
From: Thomas Schmitz @ 2011-06-02 10:20 UTC (permalink / raw)
  To: mailing list for ConTeXt users

On Thu, 2 Jun 2011 11:39:46 +0200
  Piotr Kopszak <kopszak@gmail.com> wrote:
> Dear list,
> 
> I am beginning a rather tedious documentation project 
>and will most
>   probably end up with DocBook. The fact is I haven't 
>used it for any
>   serious work for about 10 years. Docbook In ConText 
>haven't been
>   updated since 2003. Does it mean it's so perfect or 
>instead rather
>   obsolete? Could you recommend other approaches which 
>work
>   out-of-the-box (or almost). Obviously I would prefer 
>ConTeXt based
>   solutions. DocBook is not mandatory in fact, I would 
>happily learn  other
>   documentation system. Main prerequisite is utf-8 
>output at least in
>   pdf and html and sensible defaults (this time I don't 
>want to be a
>   typographer, nor I want to fiddle with structure).
> 
>   Best
> 
>   Piotr
>   --
>   http://okle.pl

Difficult to say of course without knowing the complexity 
of your documents, but just a few thoughts: if you're 
referring to Simon Pepping's "Docbook in ConTeXt," this 
was targeted at mkii, so it will probably still work, but 
could be considered obsolete. xml support in mkiv has 
changed a lot, but is much more powerful and flexible. 
It's fairly easy to write a stylesheet to translate your 
xml for typesetting, so I would look at the relevant xml 
documentation (like xml-mkiv.pdf) and make a fresh start. 
You can always refine and elaborate things as you go, and 
if you really hit a wall, there's the list.

Thomas
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________


^ permalink raw reply	[flat|nested] 15+ messages in thread

* Re: DocBook in ConTeXt - any new ideas?
  2011-06-02 10:20 ` Thomas Schmitz
@ 2011-06-02 10:53   ` Piotr Kopszak
  2011-06-02 12:03     ` Hans Hagen
  0 siblings, 1 reply; 15+ messages in thread
From: Piotr Kopszak @ 2011-06-02 10:53 UTC (permalink / raw)
  To: mailing list for ConTeXt users

Many thanks for your reply! I would certainly go this way having a
couple of months or a year perspective. Besides I'm eager to try
finally the new way mkIV deals with xml. But realistically, preparing
and testing a mapping of  even a subset of DocBook is a question of at
least a couple of personmonths if not worse. Sadly, I'm not in a
position to that now.

Best

Piotr

2011/6/2 Thomas Schmitz <tschmit1@uni-bonn.de>:
> On Thu, 2 Jun 2011 11:39:46 +0200
>  Piotr Kopszak <kopszak@gmail.com> wrote:
>>
>> Dear list,
>>
>> I am beginning a rather tedious documentation project and will most
>>  probably end up with DocBook. The fact is I haven't used it for any
>>  serious work for about 10 years. Docbook In ConText haven't been
>>  updated since 2003. Does it mean it's so perfect or instead rather
>>  obsolete? Could you recommend other approaches which work
>>  out-of-the-box (or almost). Obviously I would prefer ConTeXt based
>>  solutions. DocBook is not mandatory in fact, I would happily learn  other
>>  documentation system. Main prerequisite is utf-8 output at least in
>>  pdf and html and sensible defaults (this time I don't want to be a
>>  typographer, nor I want to fiddle with structure).
>>
>>  Best
>>
>>  Piotr
>>  --
>>  http://okle.pl
>
> Difficult to say of course without knowing the complexity of your documents,
> but just a few thoughts: if you're referring to Simon Pepping's "Docbook in
> ConTeXt," this was targeted at mkii, so it will probably still work, but
> could be considered obsolete. xml support in mkiv has changed a lot, but is
> much more powerful and flexible. It's fairly easy to write a stylesheet to
> translate your xml for typesetting, so I would look at the relevant xml
> documentation (like xml-mkiv.pdf) and make a fresh start. You can always
> refine and elaborate things as you go, and if you really hit a wall, there's
> the list.
>
> Thomas
> ___________________________________________________________________________________
> If your question is of interest to others as well, please add an entry to
> the Wiki!
>
> maillist : ntg-context@ntg.nl /
> http://www.ntg.nl/mailman/listinfo/ntg-context
> webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
> archive  : http://foundry.supelec.fr/projects/contextrev/
> wiki     : http://contextgarden.net
> ___________________________________________________________________________________
>



-- 
http://okle.pl
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________

^ permalink raw reply	[flat|nested] 15+ messages in thread

* Re: DocBook in ConTeXt - any new ideas?
  2011-06-02  9:39 DocBook in ConTeXt - any new ideas? Piotr Kopszak
  2011-06-02 10:20 ` Thomas Schmitz
@ 2011-06-02 11:58 ` Hans Hagen
  1 sibling, 0 replies; 15+ messages in thread
From: Hans Hagen @ 2011-06-02 11:58 UTC (permalink / raw)
  To: mailing list for ConTeXt users

On 2-6-2011 11:39, Piotr Kopszak wrote:
> Dear list,
>
>   I am beginning a rather tedious documentation project and will most
>     probably end up with DocBook. The fact is I haven't used it for any
>     serious work for about 10 years. Docbook In ConText haven't been
>     updated since 2003. Does it mean it's so perfect or instead rather
>     obsolete? Could you recommend other approaches which work

it was never something official (afaik it even hacked core macros) but 
an experiment by a user

Hans

-----------------------------------------------------------------
                                           Hans Hagen | PRAGMA ADE
               Ridderstraat 27 | 8061 GH Hasselt | The Netherlands
     tel: 038 477 53 69 | voip: 087 875 68 74 | www.pragma-ade.com
                                              | www.pragma-pod.nl
-----------------------------------------------------------------
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________


^ permalink raw reply	[flat|nested] 15+ messages in thread

* Re: DocBook in ConTeXt - any new ideas?
  2011-06-02 10:53   ` Piotr Kopszak
@ 2011-06-02 12:03     ` Hans Hagen
  2011-06-02 17:17       ` Bruce
  0 siblings, 1 reply; 15+ messages in thread
From: Hans Hagen @ 2011-06-02 12:03 UTC (permalink / raw)
  To: mailing list for ConTeXt users

On 2-6-2011 12:53, Piotr Kopszak wrote:
> Many thanks for your reply! I would certainly go this way having a
> couple of months or a year perspective. Besides I'm eager to try
> finally the new way mkIV deals with xml. But realistically, preparing
> and testing a mapping of  even a subset of DocBook is a question of at
> least a couple of personmonths if not worse. Sadly, I'm not in a
> position to that now.

Months? I never had a reason for doing a docbook mapping but a couple of 
hours should get you a start. Th eonly reason why I'd look into docbook 
is if I'd need in in a project. (I'd happily spent a few well paid 
months on it then.)

You probably don't need all of docbook, so you could start with some 
simple tests. The mkii docbook stuff you mentioned definitely is doing a 
small subset.

Hans

-----------------------------------------------------------------
                                           Hans Hagen | PRAGMA ADE
               Ridderstraat 27 | 8061 GH Hasselt | The Netherlands
     tel: 038 477 53 69 | voip: 087 875 68 74 | www.pragma-ade.com
                                              | www.pragma-pod.nl
-----------------------------------------------------------------
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________


^ permalink raw reply	[flat|nested] 15+ messages in thread

* Re: DocBook in ConTeXt - any new ideas?
  2011-06-02 12:03     ` Hans Hagen
@ 2011-06-02 17:17       ` Bruce
  2011-06-02 20:20         ` Hans Hagen
  0 siblings, 1 reply; 15+ messages in thread
From: Bruce @ 2011-06-02 17:17 UTC (permalink / raw)
  To: ntg-context

Hans Hagen <pragma <at> wxs.nl> writes:

> 
> On 2-6-2011 12:53, Piotr Kopszak wrote:
> > Many thanks for your reply! I would certainly go this way having a
> > couple of months or a year perspective. Besides I'm eager to try
> > finally the new way mkIV deals with xml. But realistically, preparing
> > and testing a mapping of  even a subset of DocBook is a question of at
> > least a couple of personmonths if not worse. Sadly, I'm not in a
> > position to that now.
> 
> Months? I never had a reason for doing a docbook mapping but a couple of 
> hours should get you a start. Th eonly reason why I'd look into docbook 
> is if I'd need in in a project. (I'd happily spent a few well paid 
> months on it then.)
> 
> You probably don't need all of docbook, so you could start with some 
> simple tests. The mkii docbook stuff you mentioned definitely is doing a 
> small subset.

I never understand why you would try to typeset XML directly in ConTeXt? 
Why not just convert the DocBook to ConTeXt source using XSLT (or if the 
docs are simpler, use markdown with pandoc and you can easily get ConTeXt 
and HTML from the same source)?

Bruce

___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________


^ permalink raw reply	[flat|nested] 15+ messages in thread

* Re: DocBook in ConTeXt - any new ideas?
  2011-06-02 17:17       ` Bruce
@ 2011-06-02 20:20         ` Hans Hagen
  2011-06-03 15:43           ` R. Ermers
  0 siblings, 1 reply; 15+ messages in thread
From: Hans Hagen @ 2011-06-02 20:20 UTC (permalink / raw)
  To: mailing list for ConTeXt users; +Cc: Bruce

On 2-6-2011 7:17, Bruce wrote:
> Hans Hagen<pragma<at>  wxs.nl>  writes:
>
>>
>> On 2-6-2011 12:53, Piotr Kopszak wrote:
>>> Many thanks for your reply! I would certainly go this way having a
>>> couple of months or a year perspective. Besides I'm eager to try
>>> finally the new way mkIV deals with xml. But realistically, preparing
>>> and testing a mapping of  even a subset of DocBook is a question of at
>>> least a couple of personmonths if not worse. Sadly, I'm not in a
>>> position to that now.
>>
>> Months? I never had a reason for doing a docbook mapping but a couple of
>> hours should get you a start. Th eonly reason why I'd look into docbook
>> is if I'd need in in a project. (I'd happily spent a few well paid
>> months on it then.)
>>
>> You probably don't need all of docbook, so you could start with some
>> simple tests. The mkii docbook stuff you mentioned definitely is doing a
>> small subset.
>
> I never understand why you would try to typeset XML directly in ConTeXt?
> Why not just convert the DocBook to ConTeXt source using XSLT (or if the
> docs are simpler, use markdown with pandoc and you can easily get ConTeXt
> and HTML from the same source)?

(1) because xslt mappings can become pretty unreadable
(2) because you still need to make a file (and define environments)
(3) because it then create another depencency and intermediate 
processing stage
(4) because sometimes it makes sense to let the typesetting engine make 
decisions
(5) because in mkiv one can apply lua functions to xml content
(6) ...

anyhow, the whole idea of xml is that it can be processed by whatever 
machinery (and using xslt and/or xsl-fo for everything kin dof 
contradicts that)

Hans

-----------------------------------------------------------------
                                           Hans Hagen | PRAGMA ADE
               Ridderstraat 27 | 8061 GH Hasselt | The Netherlands
     tel: 038 477 53 69 | voip: 087 875 68 74 | www.pragma-ade.com
                                              | www.pragma-pod.nl
-----------------------------------------------------------------
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________


^ permalink raw reply	[flat|nested] 15+ messages in thread

* Re: DocBook in ConTeXt - any new ideas?
  2011-06-02 20:20         ` Hans Hagen
@ 2011-06-03 15:43           ` R. Ermers
  2011-06-03 16:28             ` Hans Hagen
  0 siblings, 1 reply; 15+ messages in thread
From: R. Ermers @ 2011-06-03 15:43 UTC (permalink / raw)
  To: mailing list for ConTeXt users

I tried typesetting docbook with Context, it can be done, I but got stuck on the cals tables and some other things. Cals tables can be processed, albeit as separate documents only - not as part of the docbook file - and then imported as pdf files. This was too cumbersome for me, and does not agree with the tex philosophy. I therefore gave up.

For some reason finetuning of, for example, the positioning of graphics, and headers as widows is more difficult than in a context document, at least I got this impression.

Robert


Op 2 jun 2011, om 22:20 heeft Hans Hagen het volgende geschreven:

> On 2-6-2011 7:17, Bruce wrote:
>> Hans Hagen<pragma<at>  wxs.nl>  writes:
>> 
>>> 
>>> On 2-6-2011 12:53, Piotr Kopszak wrote:
>>>> Many thanks for your reply! I would certainly go this way having a
>>>> couple of months or a year perspective. Besides I'm eager to try
>>>> finally the new way mkIV deals with xml. But realistically, preparing
>>>> and testing a mapping of  even a subset of DocBook is a question of at
>>>> least a couple of personmonths if not worse. Sadly, I'm not in a
>>>> position to that now.
>>> 
>>> Months? I never had a reason for doing a docbook mapping but a couple of
>>> hours should get you a start. Th eonly reason why I'd look into docbook
>>> is if I'd need in in a project. (I'd happily spent a few well paid
>>> months on it then.)
>>> 
>>> You probably don't need all of docbook, so you could start with some
>>> simple tests. The mkii docbook stuff you mentioned definitely is doing a
>>> small subset.
>> 
>> I never understand why you would try to typeset XML directly in ConTeXt?
>> Why not just convert the DocBook to ConTeXt source using XSLT (or if the
>> docs are simpler, use markdown with pandoc and you can easily get ConTeXt
>> and HTML from the same source)?
> 
> (1) because xslt mappings can become pretty unreadable
> (2) because you still need to make a file (and define environments)
> (3) because it then create another depencency and intermediate processing stage
> (4) because sometimes it makes sense to let the typesetting engine make decisions
> (5) because in mkiv one can apply lua functions to xml content
> (6) ...
> 
> anyhow, the whole idea of xml is that it can be processed by whatever machinery (and using xslt and/or xsl-fo for everything kin dof contradicts that)
> 
> Hans
> 
> -----------------------------------------------------------------
>                                          Hans Hagen | PRAGMA ADE
>              Ridderstraat 27 | 8061 GH Hasselt | The Netherlands
>    tel: 038 477 53 69 | voip: 087 875 68 74 | www.pragma-ade.com
>                                             | www.pragma-pod.nl
> -----------------------------------------------------------------
> ___________________________________________________________________________________
> If your question is of interest to others as well, please add an entry to the Wiki!
> 
> maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
> webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
> archive  : http://foundry.supelec.fr/projects/contextrev/
> wiki     : http://contextgarden.net
> ___________________________________________________________________________________

___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________


^ permalink raw reply	[flat|nested] 15+ messages in thread

* Re: DocBook in ConTeXt - any new ideas?
  2011-06-03 15:43           ` R. Ermers
@ 2011-06-03 16:28             ` Hans Hagen
  2011-06-04  8:21               ` R. Ermers
  0 siblings, 1 reply; 15+ messages in thread
From: Hans Hagen @ 2011-06-03 16:28 UTC (permalink / raw)
  To: mailing list for ConTeXt users; +Cc: R. Ermers

On 3-6-2011 5:43, R. Ermers wrote:

> I tried typesetting docbook with Context, it can be done, I but got stuck on the cals tables and some other things. Cals tables can be processed, albeit as separate documents only - not as part of the docbook file - and then imported as pdf files. This was too cumbersome for me, and does not agree with the tex philosophy. I therefore gave up.

we process docs with cals tables here

> For some reason finetuning of, for example, the positioning of graphics, and headers as widows is more difficult than in a context document, at least I got this impression.

the same renderer is used so it should be the same

Hans


-----------------------------------------------------------------
                                           Hans Hagen | PRAGMA ADE
               Ridderstraat 27 | 8061 GH Hasselt | The Netherlands
     tel: 038 477 53 69 | voip: 087 875 68 74 | www.pragma-ade.com
                                              | www.pragma-pod.nl
-----------------------------------------------------------------
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________


^ permalink raw reply	[flat|nested] 15+ messages in thread

* Re: DocBook in ConTeXt - any new ideas?
  2011-06-03 16:28             ` Hans Hagen
@ 2011-06-04  8:21               ` R. Ermers
  2011-06-04  9:06                 ` Hans Hagen
  0 siblings, 1 reply; 15+ messages in thread
From: R. Ermers @ 2011-06-04  8:21 UTC (permalink / raw)
  To: mailing list for ConTeXt users


[-- Attachment #1.1: Type: text/plain, Size: 2738 bytes --]


Op 3 jun 2011, om 18:28 heeft Hans Hagen het volgende geschreven:

> On 3-6-2011 5:43, R. Ermers wrote:
> 
>> I tried typesetting docbook with Context, it can be done, I but got stuck on the cals tables and some other things. Cals tables can be processed, albeit as separate documents only - not as part of the docbook file - and then imported as pdf files. This was too cumbersome for me, and does not agree with the tex philosophy. I therefore gave up.
> 
> we process docs with cals tables here

Yes, you surely do.

Adding the prefix cals: to the tag names (thus making the file invalid, which is contrary to the docbook philosophy), using the cals table module and the directives is not enough, at least the cals tables in my valid xml docbook document were never typeset. 

With help from Aditya I managed to typeset a document which contains merely a cals table. I then thought this was going to be the first step to processing my xml file which contains a number of tables. But alas ...

The tables in my document were skipped like any other unknown xml tag. I must have done something wrong. But what? There were no replies to my postings. In the end I felt silly for daring to posing a problem other people apparently had no problems with whatsoever.

So, if you should embark on this track, be aware that typesetting xml is more complicated than a ConTeXt document, that the knowledge about it is not widespread yet, that you rely on the happy few who do know, and it may take a lot of time to find out things yourself.

Robert

>> For some reason finetuning of, for example, the positioning of graphics, and headers as widows is more difficult than in a context document, at least I got this impression.
> 
> the same renderer is used so it should be the same
> 
> Hans
> 
> 
> -----------------------------------------------------------------
>                                          Hans Hagen | PRAGMA ADE
>              Ridderstraat 27 | 8061 GH Hasselt | The Netherlands
>    tel: 038 477 53 69 | voip: 087 875 68 74 | www.pragma-ade.com
>                                             | www.pragma-pod.nl
> -----------------------------------------------------------------
> ___________________________________________________________________________________
> If your question is of interest to others as well, please add an entry to the Wiki!
> 
> maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
> webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
> archive  : http://foundry.supelec.fr/projects/contextrev/
> wiki     : http://contextgarden.net
> ___________________________________________________________________________________


[-- Attachment #1.2: Type: text/html, Size: 4339 bytes --]

[-- Attachment #2: Type: text/plain, Size: 485 bytes --]

___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________

^ permalink raw reply	[flat|nested] 15+ messages in thread

* Re: DocBook in ConTeXt - any new ideas?
  2011-06-04  8:21               ` R. Ermers
@ 2011-06-04  9:06                 ` Hans Hagen
  2011-06-04  9:57                   ` R. Ermers
  2011-06-04 12:24                   ` Aditya Mahajan
  0 siblings, 2 replies; 15+ messages in thread
From: Hans Hagen @ 2011-06-04  9:06 UTC (permalink / raw)
  To: mailing list for ConTeXt users; +Cc: R. Ermers

On 4-6-2011 10:21, R. Ermers wrote:

> Adding the prefix cals: to the tag names (thus making the file invalid, which is contrary to the docbook philosophy), using the cals table module and the directives is not enough, at least the cals tables in my valid xml docbook document were never typeset.

can be any prefix (namespace) ... the code that implements it uses a 
namespace in order to avoid a mixup

> With help from Aditya I managed to typeset a document which contains merely a cals table. I then thought this was going to be the first step to processing my xml file which contains a number of tables. But alas ....
>
> The tables in my document were skipped like any other unknown xml tag. I must have done something wrong. But what? There were no replies to my postings. In the end I felt silly for daring to posing a problem other people apparently had no problems with whatsoever.

well, providing solutions for specific user cases depends on available 
time etc ... even making a simple example ...

> So, if you should embark on this track, be aware that typesetting xml is more complicated than a ConTeXt document, that the knowledge about it is not widespread yet, that you rely on the happy few who do know, and it may take a lot of time to find out things yourself.

sure, and eventually it will be covered by manuals (or test files in the 
test suite -- actually there are some xml ones in there) ... there's 
only so much you can expect for a free system so some patience is needed

ps. although a lot of help can be gotten from this list, the wiki etc, 
users who want to do complex things (or workflows) cannot expect all 
their problems to be solved here as we all have jobs to fulfill ... it 
might help to make wiki pages and let others fill in the gaps

Hans


-----------------------------------------------------------------
                                           Hans Hagen | PRAGMA ADE
               Ridderstraat 27 | 8061 GH Hasselt | The Netherlands
     tel: 038 477 53 69 | voip: 087 875 68 74 | www.pragma-ade.com
                                              | www.pragma-pod.nl
-----------------------------------------------------------------
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________


^ permalink raw reply	[flat|nested] 15+ messages in thread

* Re: DocBook in ConTeXt - any new ideas?
  2011-06-04  9:06                 ` Hans Hagen
@ 2011-06-04  9:57                   ` R. Ermers
  2011-06-04 12:24                   ` Aditya Mahajan
  1 sibling, 0 replies; 15+ messages in thread
From: R. Ermers @ 2011-06-04  9:57 UTC (permalink / raw)
  To: mailing list for ConTeXt users


[-- Attachment #1.1: Type: text/plain, Size: 3724 bytes --]


Op 4 jun 2011, om 11:06 heeft Hans Hagen het volgende geschreven:

> On 4-6-2011 10:21, R. Ermers wrote:
> 
>> Adding the prefix cals: to the tag names (thus making the file invalid, which is contrary to the docbook philosophy), using the cals table module and the directives is not enough, at least the cals tables in my valid xml docbook document were never typeset.
> 
> can be any prefix (namespace) ... the code that implements it uses a namespace in order to avoid a mixup
> 
>> With help from Aditya I managed to typeset a document which contains merely a cals table. I then thought this was going to be the first step to processing my xml file which contains a number of tables. But alas ....
>> 
>> The tables in my document were skipped like any other unknown xml tag. I must have done something wrong. But what? There were no replies to my postings. In the end I felt silly for daring to posing a problem other people apparently had no problems with whatsoever.
> 
> well, providing solutions for specific user cases depends on available time etc ... even making a simple example ...
> 
>> So, if you should embark on this track, be aware that typesetting xml is more complicated than a ConTeXt document, that the knowledge about it is not widespread yet, that you rely on the happy few who do know, and it may take a lot of time to find out things yourself.
> 
> sure, and eventually it will be covered by manuals (or test files in the test suite -- actually there are some xml ones in there) ... there's only so much you can expect for a free system so some patience is needed
> 
> ps. although a lot of help can be gotten from this list, the wiki etc, users who want to do complex things (or workflows) cannot expect all their problems to be solved here as we all have jobs to fulfill ... it might help to make wiki pages and let others fill in the gaps
> 

Of course, I agree that typesetting a xml docbook in itself is a complex matter. And yes, I read every single letter of the complex xml manuals.

I also agree that people no doubt have many other things to do, including myself. Anybody working with Context and TeX must bear in mind that his problems will not be solved immediately, that knowledgeable people will voluntarily look into questions and problems, depending on their time and their interest in specific problems.

However, on the other hand since docbook is a very well known and therefore attractive standard, and most problems in xml can be described quite straightforward. As a result the problem of typesetting cals tables cannot be depicted as a 'specific user case'. After all, there is a module cals tables, and it is expected to work.

The problem was: how can I typeset a cals table with a minimal installation? Comparable to: how do I typeset a header? What settings are needed apart from the module? This should not be a 'complex' problem.

My conclusion remains that the knowledge on xml is not widespread, that those who possess the knowledge do not always have time to help, and as a result my problem was not solved.

For the record: note that my problem was not of the type: how to discard the nth line of a cals table? How to color the header of a cals table? Or how to only typeset cals tables with id="abc".

Robert


> 
> -----------------------------------------------------------------
>                                          Hans Hagen | PRAGMA ADE
>              Ridderstraat 27 | 8061 GH Hasselt | The Netherlands
>    tel: 038 477 53 69 | voip: 087 875 68 74 | www.pragma-ade.com
>                                             | www.pragma-pod.nl
> -----------------------------------------------------------------


[-- Attachment #1.2: Type: text/html, Size: 5110 bytes --]

[-- Attachment #2: Type: text/plain, Size: 485 bytes --]

___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________

^ permalink raw reply	[flat|nested] 15+ messages in thread

* Re: DocBook in ConTeXt - any new ideas?
  2011-06-04  9:06                 ` Hans Hagen
  2011-06-04  9:57                   ` R. Ermers
@ 2011-06-04 12:24                   ` Aditya Mahajan
  2011-06-04 13:25                     ` R. Ermers
  2011-06-05 10:46                     ` Hans Hagen
  1 sibling, 2 replies; 15+ messages in thread
From: Aditya Mahajan @ 2011-06-04 12:24 UTC (permalink / raw)
  To: mailing list for ConTeXt users


On Jun 4, 2011, at 5:06 AM, Hans Hagen <pragma@wxs.nl> wrote:

> On 4-6-2011 10:21, R. Ermers wrote:
> 
>> Adding the prefix cals: to the tag names (thus making the file invalid, which is contrary to the docbook philosophy), using the cals table module and the directives is not enough, at least the cals tables in my valid xml docbook document were never typeset.
> 
> can be any prefix (namespace) ... the code that implements it uses a namespace in order to avoid a mixup

IIRC, the namespace was hardcoded in the parser (or the call to the parser). Robert's trouble with the cals table could have been resolved if there were a user option to set (or disable) the cals namespace. 

Aditya
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________


^ permalink raw reply	[flat|nested] 15+ messages in thread

* Re: DocBook in ConTeXt - any new ideas?
  2011-06-04 12:24                   ` Aditya Mahajan
@ 2011-06-04 13:25                     ` R. Ermers
  2011-06-05 10:46                     ` Hans Hagen
  1 sibling, 0 replies; 15+ messages in thread
From: R. Ermers @ 2011-06-04 13:25 UTC (permalink / raw)
  To: mailing list for ConTeXt users


Op 4 jun 2011, om 14:24 heeft Aditya Mahajan het volgende geschreven:

> 
> On Jun 4, 2011, at 5:06 AM, Hans Hagen <pragma@wxs.nl> wrote:
> 
>> On 4-6-2011 10:21, R. Ermers wrote:
>> 
>>> Adding the prefix cals: to the tag names (thus making the file invalid, which is contrary to the docbook philosophy), using the cals table module and the directives is not enough, at least the cals tables in my valid xml docbook document were never typeset.
>> 
>> can be any prefix (namespace) ... the code that implements it uses a namespace in order to avoid a mixup
> 
> IIRC, the namespace was hardcoded in the parser (or the call to the parser). Robert's trouble with the cals table could have been resolved if there were a user option to set (or disable) the cals namespace.
> 

Well, I added "cals:" to all tags for ConteXt purposes (<tbody>, <entry> become <cals:tbody>, <cals:entry>, etc.). I examined what Hans' example tables look like.

After the changes, the structure was still that of a cals table, the word cals had been added to each tag, but after this adapation to some particular ConTeXt requirements, the tables in fact could not be called cals tables anymore. The file did no longer comply with the docbook dtd. I didn't mind that much.

Predictably, though, my docbook editing software started complaining. The tables were not rendered in the preview anymore. This was a relatively minor problem.

I don't know whether Aditya's suggestion would have helped.

Robert


> Aditya
> ___________________________________________________________________________________
> If your question is of interest to others as well, please add an entry to the Wiki!
> 
> maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
> webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
> archive  : http://foundry.supelec.fr/projects/contextrev/
> wiki     : http://contextgarden.net
> ___________________________________________________________________________________

___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________


^ permalink raw reply	[flat|nested] 15+ messages in thread

* Re: DocBook in ConTeXt - any new ideas?
  2011-06-04 12:24                   ` Aditya Mahajan
  2011-06-04 13:25                     ` R. Ermers
@ 2011-06-05 10:46                     ` Hans Hagen
  1 sibling, 0 replies; 15+ messages in thread
From: Hans Hagen @ 2011-06-05 10:46 UTC (permalink / raw)
  To: mailing list for ConTeXt users

On 4-6-2011 2:24, Aditya Mahajan wrote:
>
> On Jun 4, 2011, at 5:06 AM, Hans Hagen<pragma@wxs.nl>  wrote:
>
>> On 4-6-2011 10:21, R. Ermers wrote:
>>
>>> Adding the prefix cals: to the tag names (thus making the file invalid, which is contrary to the docbook philosophy), using the cals table module and the directives is not enough, at least the cals tables in my valid xml docbook document were never typeset.
>>
>> can be any prefix (namespace) ... the code that implements it uses a namespace in order to avoid a mixup
>
> IIRC, the namespace was hardcoded in the parser (or the call to the parser). Robert's trouble with the cals table could have been resolved if there were a user option to set (or disable) the cals namespace.

No, the namespace is just used to isolate code so 'cals' is an 
abstraction. However, the assumption is indeed is that when used in an 
xml file there is a namespace (afaiks in docbook they embed the cals 
model, so it's not used as an independent definition).

When in x-cals.lua the following is used in line 128

     local prefix = namespace and namespace ~= "" and (namespace .. ":") 
or ""

one can do this then:

\startxmlsetups xml:cals:nonamespace
     \xmlsetfunction {main} {table} {moduledata.cals.table}
\stopxmlsetups

\xmlregistersetup{xml:cals:nonamespace}

(I need to check such a change for side effects.)

(BTW, x-cals-test.xml in the testsuite shows all kind of namespace 
remapping / usage)

Hans

-----------------------------------------------------------------
                                           Hans Hagen | PRAGMA ADE
               Ridderstraat 27 | 8061 GH Hasselt | The Netherlands
     tel: 038 477 53 69 | voip: 087 875 68 74 | www.pragma-ade.com
                                              | www.pragma-pod.nl
-----------------------------------------------------------------
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________


^ permalink raw reply	[flat|nested] 15+ messages in thread

end of thread, other threads:[~2011-06-05 10:46 UTC | newest]

Thread overview: 15+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2011-06-02  9:39 DocBook in ConTeXt - any new ideas? Piotr Kopszak
2011-06-02 10:20 ` Thomas Schmitz
2011-06-02 10:53   ` Piotr Kopszak
2011-06-02 12:03     ` Hans Hagen
2011-06-02 17:17       ` Bruce
2011-06-02 20:20         ` Hans Hagen
2011-06-03 15:43           ` R. Ermers
2011-06-03 16:28             ` Hans Hagen
2011-06-04  8:21               ` R. Ermers
2011-06-04  9:06                 ` Hans Hagen
2011-06-04  9:57                   ` R. Ermers
2011-06-04 12:24                   ` Aditya Mahajan
2011-06-04 13:25                     ` R. Ermers
2011-06-05 10:46                     ` Hans Hagen
2011-06-02 11:58 ` Hans Hagen

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).