Where is the locator attribute in my Citation element?

Where is the locator attribute in my Citation element?

[A A]

[-- Attachment #1: Type: text/plain, Size: 2012 bytes --]

According to the docs <https://pandoc.org/MANUAL.html#citation-syntax>

Citation items may optionally include a prefix, a locator, and a suffix. In

Blah blah [see @doe99, pp. 33-35 and *passim*; @smith04, chap. 1].

the first item (doe99) has prefix see, locator pp. 33-35, and suffix and
*passim*.
The second item (smith04) has locator chap. 1 and no prefix or suffix.

So I made markdown file test.md containing *only* the following:
[see @doe99, pp. 33-35 and *passim*]

When I run pandoc --from markdown --to native test.md I get the following:

[ Para
    [ Cite
        [ Citation
            { citationId = "doe99"
            , citationPrefix = [ Str "see" ]
            , citationSuffix =
                [ Str ","
                , Space
                , Str "pp.\160\&33-35"
                , Space
                , Str "and"
                , Space
                , Emph [ Str "passim" ]
                ]
            , citationMode = NormalCitation
            , citationNoteNum = 1
            , citationHash = 0
            }
        ]
        [ Str "[see"
        , Space
        , Str "@doe99,"
        , Space
        , Str "pp."
        , Space
        , Str "33-35"
        , Space
        , Str "and"
        , Space
        , Str "*passim*]"
        ]
    ]
]

I was expecting a locator attribute somewhere containing pp. 33-35, however
this is not the case and the locator and suffix as mentioned by the docs
are basically all mixed together inside a suffix attribute.

Is there such a thing as a locator? If not why does the documentation
mention it?

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/CAMwawgPvbd2kYqD2B%3DFt6fPzUsWOCAAabJuzD%2BU%2B8X%2BgSP%2BMfQ%40mail.gmail.com.

[-- Attachment #2: Type: text/html, Size: 11126 bytes --]

Re: Where is the locator attribute in my Citation element?

[Bastien DUMONT]

There are two levels of processing: representing the text in Pandoc's AST via the reader for your input format and formatting the citation via citeproc. Extracting the locator from the suffix belongs to the latter level. I guess that you already know it, but just in case, the AST is better described here: https://pandoc.org/lua-filters.html

Le Thursday 23 February 2023 à 10:51:41AM, A A a écrit :
> According to the [1]docs
> 
>     Citation items may optionally include a prefix, a locator, and a suffix. In
> 
>     Blah blah [see @doe99, pp. 33-35 and *passim*; @smith04, chap. 1].
> 
>     the first item (doe99) has prefix see, locator pp. 33-35, and suffix and
>     *passim*.
>     The second item (smith04) has locator chap. 1 and no prefix or suffix.
> 
> So I made markdown file test.md containing only the following:
> [see @doe99, pp. 33-35 and *passim*]
> 
> When I run pandoc --from markdown --to native test.md I get the following:
> 
> [ Para
>     [ Cite
>         [ Citation
>             { citationId = "doe99"
>             , citationPrefix = [ Str "see" ]
>             , citationSuffix =
>                 [ Str ","
>                 , Space
>                 , Str "pp.\160\&33-35"
>                 , Space
>                 , Str "and"
>                 , Space
>                 , Emph [ Str "passim" ]
>                 ]
>             , citationMode = NormalCitation
>             , citationNoteNum = 1
>             , citationHash = 0
>             }
>         ]
>         [ Str "[see"
>         , Space
>         , Str "@doe99,"
>         , Space
>         , Str "pp."
>         , Space
>         , Str "33-35"
>         , Space
>         , Str "and"
>         , Space
>         , Str "*passim*]"
>         ]
>     ]
> ]
> 
> I was expecting a locator attribute somewhere containing pp. 33-35, however
> this is not the case and the locator and suffix as mentioned by the docs are
> basically all mixed together inside a suffix attribute.
> 
> Is there such a thing as a locator? If not why does the documentation mention
> it?
> 
> 
> --
> You received this message because you are subscribed to the Google Groups
> "pandoc-discuss" group.
> To unsubscribe from this group and stop receiving emails from it, send an email
> to [2]pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
> To view this discussion on the web visit [3]https://groups.google.com/d/msgid/
> pandoc-discuss/
> CAMwawgPvbd2kYqD2B%3DFt6fPzUsWOCAAabJuzD%2BU%2B8X%2BgSP%2BMfQ%40mail.gmail.com.
> 
> References:
> 
> [1] https://pandoc.org/MANUAL.html#citation-syntax
> [2] mailto:pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org
> [3] https://groups.google.com/d/msgid/pandoc-discuss/CAMwawgPvbd2kYqD2B%3DFt6fPzUsWOCAAabJuzD%2BU%2B8X%2BgSP%2BMfQ%40mail.gmail.com?utm_medium=email&utm_source=footer

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/Y/c7jxMzmnNe%2BbiS%40localhost.