\xmldocument vs #1 in \xmlsetsetup

\xmldocument vs #1 in \xmlsetsetup

[Denis Maier via ntg-context]

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

Hi,
most examples in the mkiv-xml manual use #1 with \xmlsetsetup, e.g.

\startxmlsetups xml:demo:base
  \xmlsetsetup{#1}{document|section|p}{xml:demo:*}
\stopxmlsetups

However, in quite a few occasions I've noticed the usage of \xmldocument instead of #1.

What exactly is the difference ?

When should you prefer one over the other?

Best,
Denis


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

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

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

maillist : ntg-context@ntg.nl / https://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : https://www.pragma-ade.nl / http://context.aanhet.net
archive  : https://bitbucket.org/phg/context-mirror/commits/
wiki     : https://contextgarden.net
___________________________________________________________________________________

Re: \xmldocument vs #1 in \xmlsetsetup

[Pablo Rodriguez via ntg-context]

On 11/14/22 14:00, Denis Maier via ntg-context wrote:
> Hi,
> 
> most examples in the mkiv-xml manual use #1 with \xmlsetsetup, e.g.
> 
> \startxmlsetups xml:demo:base
>   \xmlsetsetup{#1}{document|section|p}{xml:demo:*}
> \stopxmlsetups
> 
> However, in quite a few occasions I’ve noticed the usage of \xmldocument
> instead of #1.
> 
> What exactly is the difference ?

Hi Denis,

I have just found the following explanation
(https://www.pragma-ade.com/general/manuals/xml-mkiv.pdf#search=xmlself):

  The macro \xmldocument expands to the current document id. There is
  also \xmlself which expands to the current node number (#1 in setups).

Now I think that I have abused \xmldocument too much, since I should
have used #1. But I’m afraid I haven’t got much different results.

I must also confess that a proper explanation would be helpful (to me in
order) to understsand when \xmldocument should not be used.

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

maillist : ntg-context@ntg.nl / https://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : https://www.pragma-ade.nl / http://context.aanhet.net
archive  : https://bitbucket.org/phg/context-mirror/commits/
wiki     : https://contextgarden.net
___________________________________________________________________________________

Re: \xmldocument vs #1 in \xmlsetsetup

[Hans Hagen via ntg-context]

On 11/14/2022 7:28 PM, Pablo Rodriguez via ntg-context wrote:
> On 11/14/22 14:00, Denis Maier via ntg-context wrote:
>> Hi,
>>
>> most examples in the mkiv-xml manual use #1 with \xmlsetsetup, e.g.
>>
>> \startxmlsetups xml:demo:base
>>    \xmlsetsetup{#1}{document|section|p}{xml:demo:*}
>> \stopxmlsetups
>>
>> However, in quite a few occasions I’ve noticed the usage of \xmldocument
>> instead of #1.
>>
>> What exactly is the difference ?
> 
> Hi Denis,
> 
> I have just found the following explanation
> (https://www.pragma-ade.com/general/manuals/xml-mkiv.pdf#search=xmlself):
> 
>    The macro \xmldocument expands to the current document id. There is
>    also \xmlself which expands to the current node number (#1 in setups).
> 
> Now I think that I have abused \xmldocument too much, since I should
> have used #1. But I’m afraid I haven’t got much different results.
> 
> I must also confess that a proper explanation would be helpful (to me in
> order) to understsand when \xmldocument should not be used.
if you load a main xmkl file that is then xml document; there can be 
many xml files loaded at the same time (which you can then access bu 
{whatever} you used and once in the tree nodes are #1)

-----------------------------------------------------------------
                                           Hans Hagen | PRAGMA ADE
               Ridderstraat 27 | 8061 GH Hasselt | The Netherlands
        tel: 038 477 53 69 | www.pragma-ade.nl | 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 / https://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : https://www.pragma-ade.nl / http://context.aanhet.net
archive  : https://bitbucket.org/phg/context-mirror/commits/
wiki     : https://contextgarden.net
___________________________________________________________________________________