Enabling the new citeproc from a defaults file

Enabling the new citeproc from a defaults file

[Matthew Jolly]

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

Hi All, 

I've been attempting to automate configuration of pandoc within a docker 
container using a generated defaults file. 

I've seemingly got everything working, however I've been unable to trigger 
citation processing using the built-in citeproc. 

The manual suggests that it can be enabled using the following key/value 
pair but this doesn't appear to work:
`cite-method: citeproc`

My previous configuration used `--bibliography 
/working/resources/bibliography.yaml --citeproc` in the pandoc command to 
achieve this. 

My current generated defaults configuration, working except citeproc, is: 

```
metadata:
  bibliography: /working/resources/bibilogrpahy.yaml
  csl: https://www.zotero.org/styles/vancouver-superscript
variables:
  title-page-background: 
/working/resources/template_resources/titlepage-background.pdf
  link-citations: true
  table-row-highlighting: true
  title-page: true
  title: |
    Product \
    Operational Concept Document
  subject: Operational Concept Document
  nocite: |
    @smpte336m:2007, @smpterp210:2010
default-image-extension: .pdf
fail-if-warnings: true
self-contained: true
cite-method: citeproc
verbosity: WARNING
template: /working/templates/template.tex
toc: true
```

I am using pandoc 2.11.4.

What have I missed?

Thanks in advance for any advice!

-- 
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/0b35e04f-6030-4061-bc9f-b5f798effb7dn%40googlegroups.com.

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

Re: Enabling the new citeproc from a defaults file

[Pranesh Prakash]

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

Dear Matthew,
You also need to enable citeproc using either the `citeproc` or the 
`filter` option in the defaults file.

```
citeproc: true
filters:
- type: citeproc
```

Using it with the "filters" option allows you to control the sequence in 
which citeproc is applied vis-a-vis other filters. 

I hope that helps.

Regards,
Pranesh
On Wednesday, 27 January, 2021 at 7:01:17 am UTC+5:30 Matthew Jolly wrote:

> Hi All, 
>
> I've been attempting to automate configuration of pandoc within a docker 
> container using a generated defaults file. 
>
> I've seemingly got everything working, however I've been unable to trigger 
> citation processing using the built-in citeproc. 
>
> The manual suggests that it can be enabled using the following key/value 
> pair but this doesn't appear to work:
> `cite-method: citeproc`
>
> My previous configuration used `--bibliography 
> /working/resources/bibliography.yaml --citeproc` in the pandoc command to 
> achieve this. 
>
> My current generated defaults configuration, working except citeproc, is: 
>
> ```
> metadata:
>   bibliography: /working/resources/bibilogrpahy.yaml
>   csl: https://www.zotero.org/styles/vancouver-superscript
> variables:
>   title-page-background: 
> /working/resources/template_resources/titlepage-background.pdf
>   link-citations: true
>   table-row-highlighting: true
>   title-page: true
>   title: |
>     Product \
>     Operational Concept Document
>   subject: Operational Concept Document
>   nocite: |
>     @smpte336m:2007, @smpterp210:2010
> default-image-extension: .pdf
> fail-if-warnings: true
> self-contained: true
> cite-method: citeproc
> verbosity: WARNING
> template: /working/templates/template.tex
> toc: true
> ```
>
> I am using pandoc 2.11.4.
>
> What have I missed?
>
> Thanks in advance for any advice!
>

-- 
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/97c3e389-5c0f-4ad4-87ee-ec394d36f8aen%40googlegroups.com.

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

Re: Enabling the new citeproc from a defaults file

[Matthew Jolly]

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

Thanks for the advice Pranesh.

The pandoc manual suggests that: 

```
# turn on built-in citation processing. Note that if you need 
# control over when the citeproc processing is done relative 
# to other filters, you should instead use `citeproc` in the 
# list of `filters` (see below). 
citeproc: true

```

Is this incorrect?

My read of this comment is that if you *just* want to enable citation 
processing `citeproc: true` in the root (which I have tried and does not 
appear to be working) is all that should be required, _unless_ you want to 
control when citeproc processing is enabled. Is the manual wrong?

I'm having some issues with the JSONSchema validator that I'm using not 
accepting TypeScript union types (and I've temporarily defined `filters:` 
as a string in my schema as a result), so until I have a fix for that I'm 
hoping to avoid calling it as a filter!

Regardless I appreciate the advice and will test/implement when I have a 
chance.

Cheers!
On Wednesday, January 27, 2021 at 4:56:00 PM UTC+11 the.so...-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org 
wrote:

> Dear Matthew,
> You also need to enable citeproc using either the `citeproc` or the 
> `filter` option in the defaults file.
>
> ```
> citeproc: true
> filters:
> - type: citeproc
> ```
>
> Using it with the "filters" option allows you to control the sequence in 
> which citeproc is applied vis-a-vis other filters. 
>
> I hope that helps.
>
> Regards,
> Pranesh
> On Wednesday, 27 January, 2021 at 7:01:17 am UTC+5:30 Matthew Jolly wrote:
>
>> Hi All, 
>>
>> I've been attempting to automate configuration of pandoc within a docker 
>> container using a generated defaults file. 
>>
>> I've seemingly got everything working, however I've been unable to 
>> trigger citation processing using the built-in citeproc. 
>>
>> The manual suggests that it can be enabled using the following key/value 
>> pair but this doesn't appear to work:
>> `cite-method: citeproc`
>>
>> My previous configuration used `--bibliography 
>> /working/resources/bibliography.yaml --citeproc` in the pandoc command to 
>> achieve this. 
>>
>> My current generated defaults configuration, working except citeproc, is: 
>>
>> ```
>> metadata:
>>   bibliography: /working/resources/bibilogrpahy.yaml
>>   csl: https://www.zotero.org/styles/vancouver-superscript
>> variables:
>>   title-page-background: 
>> /working/resources/template_resources/titlepage-background.pdf
>>   link-citations: true
>>   table-row-highlighting: true
>>   title-page: true
>>   title: |
>>     Product \
>>     Operational Concept Document
>>   subject: Operational Concept Document
>>   nocite: |
>>     @smpte336m:2007, @smpterp210:2010
>> default-image-extension: .pdf
>> fail-if-warnings: true
>> self-contained: true
>> cite-method: citeproc
>> verbosity: WARNING
>> template: /working/templates/template.tex
>> toc: true
>> ```
>>
>> I am using pandoc 2.11.4.
>>
>> What have I missed?
>>
>> Thanks in advance for any advice!
>>
>

-- 
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/6fca2e0c-561c-4a18-ac90-fec5522194c2n%40googlegroups.com.

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

Re: Enabling the new citeproc from a defaults file

[Matt Jolly]

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

Ah, Disregard. 

Turns out my schema was wrong resulting in the citeproc key being placed 
under variables instead of as a root key. All working. Thanks for the 
insight Pranesh!

On Wednesday, January 27, 2021 at 5:53:35 PM UTC+11 Matt Jolly wrote:

> Thanks for the advice Pranesh.
>
> The pandoc manual suggests that: 
>
> ```
> # turn on built-in citation processing. Note that if you need 
> # control over when the citeproc processing is done relative 
> # to other filters, you should instead use `citeproc` in the 
> # list of `filters` (see below). 
> citeproc: true
>
> ```
>
> Is this incorrect?
>
> My read of this comment is that if you *just* want to enable citation 
> processing `citeproc: true` in the root (which I have tried and does not 
> appear to be working) is all that should be required, _unless_ you want to 
> control when citeproc processing is enabled. Is the manual wrong?
>
> I'm having some issues with the JSONSchema validator that I'm using not 
> accepting TypeScript union types (and I've temporarily defined `filters:` 
> as a string in my schema as a result), so until I have a fix for that I'm 
> hoping to avoid calling it as a filter!
>
> Regardless I appreciate the advice and will test/implement when I have a 
> chance.
>
> Cheers!
> On Wednesday, January 27, 2021 at 4:56:00 PM UTC+11 the.so...-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org 
> wrote:
>
>> Dear Matthew,
>> You also need to enable citeproc using either the `citeproc` or the 
>> `filter` option in the defaults file.
>>
>> ```
>> citeproc: true
>> filters:
>> - type: citeproc
>> ```
>>
>> Using it with the "filters" option allows you to control the sequence in 
>> which citeproc is applied vis-a-vis other filters. 
>>
>> I hope that helps.
>>
>> Regards,
>> Pranesh
>> On Wednesday, 27 January, 2021 at 7:01:17 am UTC+5:30 Matthew Jolly wrote:
>>
>>> Hi All, 
>>>
>>> I've been attempting to automate configuration of pandoc within a docker 
>>> container using a generated defaults file. 
>>>
>>> I've seemingly got everything working, however I've been unable to 
>>> trigger citation processing using the built-in citeproc. 
>>>
>>> The manual suggests that it can be enabled using the following key/value 
>>> pair but this doesn't appear to work:
>>> `cite-method: citeproc`
>>>
>>> My previous configuration used `--bibliography 
>>> /working/resources/bibliography.yaml --citeproc` in the pandoc command to 
>>> achieve this. 
>>>
>>> My current generated defaults configuration, working except citeproc, 
>>> is: 
>>>
>>> ```
>>> metadata:
>>>   bibliography: /working/resources/bibilogrpahy.yaml
>>>   csl: https://www.zotero.org/styles/vancouver-superscript
>>> variables:
>>>   title-page-background: 
>>> /working/resources/template_resources/titlepage-background.pdf
>>>   link-citations: true
>>>   table-row-highlighting: true
>>>   title-page: true
>>>   title: |
>>>     Product \
>>>     Operational Concept Document
>>>   subject: Operational Concept Document
>>>   nocite: |
>>>     @smpte336m:2007, @smpterp210:2010
>>> default-image-extension: .pdf
>>> fail-if-warnings: true
>>> self-contained: true
>>> cite-method: citeproc
>>> verbosity: WARNING
>>> template: /working/templates/template.tex
>>> toc: true
>>> ```
>>>
>>> I am using pandoc 2.11.4.
>>>
>>> What have I missed?
>>>
>>> Thanks in advance for any advice!
>>>
>>

-- 
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/be6cde8e-e7b1-4424-9419-a27f85a539aen%40googlegroups.com.

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

Re: Enabling the new citeproc from a defaults file

[John MacFarlane]

citeproc: true

is what you want; or put 'citeproc' in the list of filters,
if you want control over the order in which the transformations
occur.

cite-method:

is used only to select between what would be --natbib,
--biblatex, or the default on the command line, and it only
affects LaTeX output.  This is confusing.
I'll try to improve the docs on this.

Matthew Jolly <kangie-S+5N7tjWkgv8X0x+8FA6VA@public.gmane.org> writes:

> Hi All,
>
> I've been attempting to automate configuration of pandoc within a docker
> container using a generated defaults file.
>
> I've seemingly got everything working, however I've been unable to trigger
> citation processing using the built-in citeproc.
>
> The manual suggests that it can be enabled using the following key/value
> pair but this doesn't appear to work:
> `cite-method: citeproc`
>
> My previous configuration used `--bibliography
> /working/resources/bibliography.yaml --citeproc` in the pandoc command to
> achieve this.
>
> My current generated defaults configuration, working except citeproc, is:
>
> ```
> metadata:
>   bibliography: /working/resources/bibilogrpahy.yaml
>   csl: https://www.zotero.org/styles/vancouver-superscript
> variables:
>   title-page-background:
> /working/resources/template_resources/titlepage-background.pdf
>   link-citations: true
>   table-row-highlighting: true
>   title-page: true
>   title: |
>     Product \
>     Operational Concept Document
>   subject: Operational Concept Document
>   nocite: |
>     @smpte336m:2007, @smpterp210:2010
> default-image-extension: .pdf
> fail-if-warnings: true
> self-contained: true
> cite-method: citeproc
> verbosity: WARNING
> template: /working/templates/template.tex
> toc: true
> ```
>
> I am using pandoc 2.11.4.
>
> What have I missed?
>
> Thanks in advance for any advice!
>
> --
> 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/0b35e04f-6030-4061-bc9f-b5f798effb7dn%40googlegroups.com.