[NTG-context] documentation: parameters of \setuplist

[NTG-context] documentation: parameters of \setuplist

[Henning Hraban Ramm]

I tried to complete https://wiki.contextgarden.net/Command/setuplist, 
but I don’t understand all parameters.

Can anyone explain these please:

* state (start stop): what does this en-/disable? collecting entries?
* label (yes no none Name): language dependent labels? as a prefix or what?
* location (none, here): disable placement? when makes this sense?
* aligntitle (yes no): align which part to what?
* symbol (one two three none default): where is this used?


Expect more questions…

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

maillist : ntg-context@ntg.nl / https://mailman.ntg.nl/mailman3/lists/ntg-context.ntg.nl
webpage  : https://www.pragma-ade.nl / https://context.aanhet.net (mirror)
archive  : https://github.com/contextgarden/context
wiki     : https://wiki.contextgarden.net
___________________________________________________________________________________

[NTG-context] Re: documentation: parameters of \setuplist

[Duncan Hothersall]

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

Hi Hraban,

I can help with one - aligntitle means an unnumbered section will align in
the table of contents under the number rather than the title. So for
example if you have a TOC combining \section and \subject entries, they
would look like this:

1 ... A section
A subject

rather than

1 ... A section
...... A subject

Duncan

On Mon, 22 Apr 2024 at 17:09, Henning Hraban Ramm <texml@fiee.net> wrote:

> I tried to complete https://wiki.contextgarden.net/Command/setuplist,
> but I don’t understand all parameters.
>
> Can anyone explain these please:
>
> * state (start stop): what does this en-/disable? collecting entries?
> * label (yes no none Name): language dependent labels? as a prefix or what?
> * location (none, here): disable placement? when makes this sense?
> * aligntitle (yes no): align which part to what?
> * symbol (one two three none default): where is this used?
>
>
> Expect more questions…
>
> Hraban
>
> ___________________________________________________________________________________
> If your question is of interest to others as well, please add an entry to
> the Wiki!
>
> maillist : ntg-context@ntg.nl /
> https://mailman.ntg.nl/mailman3/lists/ntg-context.ntg.nl
> webpage  : https://www.pragma-ade.nl / https://context.aanhet.net (mirror)
> archive  : https://github.com/contextgarden/context
> wiki     : https://wiki.contextgarden.net
>
> ___________________________________________________________________________________
>

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

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

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

maillist : ntg-context@ntg.nl / https://mailman.ntg.nl/mailman3/lists/ntg-context.ntg.nl
webpage  : https://www.pragma-ade.nl / https://context.aanhet.net (mirror)
archive  : https://github.com/contextgarden/context
wiki     : https://wiki.contextgarden.net
___________________________________________________________________________________

[NTG-context] Re: documentation: parameters of \setuplist

[Henning Hraban Ramm]

Am 22.04.24 um 18:30 schrieb Duncan Hothersall:
> Hi Hraban,
> 
> I can help with one - aligntitle means an unnumbered section will align 
> in the table of contents under the number rather than the title. So for 
> example if you have a TOC combining \section and \subject entries, they 
> would look like this:
> 
> 1 ... A section
> A subject
> 
> rather than
> 
> 1 ... A section
> ...... A subject

Thank you! I added it in the wiki.

Hraban

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

maillist : ntg-context@ntg.nl / https://mailman.ntg.nl/mailman3/lists/ntg-context.ntg.nl
webpage  : https://www.pragma-ade.nl / https://context.aanhet.net (mirror)
archive  : https://github.com/contextgarden/context
wiki     : https://wiki.contextgarden.net
___________________________________________________________________________________

[NTG-context] Re: documentation: parameters of \setuplist

[Henning Hraban Ramm]

Am 22.04.24 um 18:09 schrieb Henning Hraban Ramm:
> I tried to complete https://wiki.contextgarden.net/Command/setuplist, 
> but I don’t understand all parameters.
> 
> Can anyone explain these please:
> 
> * state (start stop): what does this en-/disable? collecting entries?
> * label (yes no none Name): language dependent labels? as a prefix or what?
> * location (none, here): disable placement? when makes this sense?
> * symbol (one two three none default): where is this used?

One solved, still 4 to go… Please, anyone who used these?

Hraban

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

maillist : ntg-context@ntg.nl / https://mailman.ntg.nl/mailman3/lists/ntg-context.ntg.nl
webpage  : https://www.pragma-ade.nl / https://context.aanhet.net (mirror)
archive  : https://github.com/contextgarden/context
wiki     : https://wiki.contextgarden.net
___________________________________________________________________________________

[NTG-context] Re: documentation: parameters of \setuplist

[Wolfgang Schuster]

Henning Hraban Ramm schrieb am 23.04.2024 um 21:43:
> Am 22.04.24 um 18:09 schrieb Henning Hraban Ramm:
>> I tried to complete https://wiki.contextgarden.net/Command/setuplist, 
>> but I don’t understand all parameters.
>>
>> Can anyone explain these please:
>>
>> * state (start stop): what does this en-/disable? collecting entries?
>> * label (yes no none Name): language dependent labels? as a prefix or 
>> what?

You can use the key to set language dependent texts for the section 
counters in the list entry, with "yes" the values from the document are 
used but you can also set whatever label you want.

\setuplabeltext
   [en]
   [chapter=Chapter ,
    appendix=Appendix ,
    hraban=Hraban ]

%\setuplist[chapter][label=hraban,width=3cm]
\setuplist[chapter][label=yes,width=3cm]

\starttext

\startfrontmatter
\completecontent
\stopfrontmatter

\startbodymatter
\chapter{First chapter}
\chapter{Second chapter}
\stopbodymatter

\startappendices
\chapter{First appendix}
\stopappendices

\stoptext

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

maillist : ntg-context@ntg.nl / https://mailman.ntg.nl/mailman3/lists/ntg-context.ntg.nl
webpage  : https://www.pragma-ade.nl / https://context.aanhet.net (mirror)
archive  : https://github.com/contextgarden/context
wiki     : https://wiki.contextgarden.net
___________________________________________________________________________________

[NTG-context] Re: documentation: parameters of \setuplist

[Henning Hraban Ramm]

Am 23.04.24 um 23:14 schrieb Wolfgang Schuster:
> Henning Hraban Ramm schrieb am 23.04.2024 um 21:43:
>> Am 22.04.24 um 18:09 schrieb Henning Hraban Ramm:
>>> I tried to complete https://wiki.contextgarden.net/Command/setuplist, 
>>> but I don’t understand all parameters.
>>>
>>> Can anyone explain these please:
>>>
>>> * state (start stop): what does this en-/disable? collecting entries?
>>> * label (yes no none Name): language dependent labels? as a prefix or 
>>> what?
> 
> You can use the key to set language dependent texts for the section 
> counters in the list entry, with "yes" the values from the document are 
> used but you can also set whatever label you want.

Thank you!
So it is related to \setuplabeltext as I suspected, while I didn’t 
understand why we need label _and_ prefix, until I recognized there’s 
only pageprefix… (I had prefix in my list of parameters, maybe some MkII 
leftover).

> \setuplabeltext
>    [en]
>    [chapter=Chapter ,
>     appendix=Appendix ,
>     hraban=Hraban ]
> 
> %\setuplist[chapter][label=hraban,width=3cm]
> \setuplist[chapter][label=yes,width=3cm]

Yes, now I understand.

Hraban

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

maillist : ntg-context@ntg.nl / https://mailman.ntg.nl/mailman3/lists/ntg-context.ntg.nl
webpage  : https://www.pragma-ade.nl / https://context.aanhet.net (mirror)
archive  : https://github.com/contextgarden/context
wiki     : https://wiki.contextgarden.net
___________________________________________________________________________________

[NTG-context] Re: documentation: parameters of \setuplist

[Bruce Horrocks]

> On 23 Apr 2024, at 20:43, Henning Hraban Ramm <texml@fiee.net> wrote:
> 
> Am 22.04.24 um 18:09 schrieb Henning Hraban Ramm:
>> I tried to complete https://wiki.contextgarden.net/Command/setuplist, but I don’t understand all parameters.
>> Can anyone explain these please:
>> * state (start stop): what does this en-/disable? collecting entries?
>> * label (yes no none Name): language dependent labels? as a prefix or what?
>> * location (none, here): disable placement? when makes this sense?
>> * symbol (one two three none default): where is this used?
> 
> One solved, still 4 to go… Please, anyone who used these?

In the source there is a comment relating to location:


%D Regular list entries are bound to a specific location in order to get the right
%D pagenumber etc.\ associated. When pushing something inbetween (in mkiv) it ends
%D up directtly in the list. This is the default because otherwise users will wonder
%D why spacing might get messed up (due to an unseen but present node). It is
%D possible to force a location by explicitly setting \type {location} to \type
%D {here}.
%D
%D Another way to force a certain order is to set the \type {order} variable when
%D placing a list. The \type {command} option only pushes commands into the right
%D order, and \type {all} orders all entries (which might be too much). In this case
%D no specific location is needed with the inbetween method. Maybe additional
%D mechanisms show up some day. See \type {inbetween-001.tex} for an example.

I don't really understand what capability the comment is referring to let alone be able to create an example demonstrating the difference.

—
Bruce Horrocks
Hampshire, UK

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

maillist : ntg-context@ntg.nl / https://mailman.ntg.nl/mailman3/lists/ntg-context.ntg.nl
webpage  : https://www.pragma-ade.nl / https://context.aanhet.net (mirror)
archive  : https://github.com/contextgarden/context
wiki     : https://wiki.contextgarden.net
___________________________________________________________________________________

[NTG-context] Re: documentation: parameters of \setuplist

[Henning Hraban Ramm]

Am 24.04.24 um 01:00 schrieb Bruce Horrocks:
> In the source there is a comment relating to location:
> 
> %D Regular list entries are bound to a specific location in order to get the right
> %D pagenumber etc.\ associated. When pushing something inbetween (in mkiv) it ends
> %D up directtly in the list. This is the default because otherwise users will wonder
> %D why spacing might get messed up (due to an unseen but present node). It is
> %D possible to force a location by explicitly setting \type {location} to \type
> %D {here}.
> %D
> %D Another way to force a certain order is to set the \type {order} variable when
> %D placing a list. The \type {command} option only pushes commands into the right
> %D order, and \type {all} orders all entries (which might be too much). In this case
> %D no specific location is needed with the inbetween method. Maybe additional
> %D mechanisms show up some day. See \type {inbetween-001.tex} for an example.
> 
> I don't really understand what capability the comment is referring to let alone be able to create an example demonstrating the difference.

Thank you, so it looks like "location=here" is only used with 
\writebetweenlist to get the current page number.

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

maillist : ntg-context@ntg.nl / https://mailman.ntg.nl/mailman3/lists/ntg-context.ntg.nl
webpage  : https://www.pragma-ade.nl / https://context.aanhet.net (mirror)
archive  : https://github.com/contextgarden/context
wiki     : https://wiki.contextgarden.net
___________________________________________________________________________________