including '\usepackage{abc}` via command line option

including '\usepackage{abc}` via command line option

[ivo welch]

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


[Apologies.  I read the docs twice, but I could not find it.  This must be 
obvious.]

I want to include in latex documents a '\usepackage{abc}`, so that my latex 
runs (or pdf runs) include it (following kpsewhich, of course).  I do not 
want pandoc to include the file itself and I do not want to set it in the 
yaml header.
 
How?

-- 
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 post to this group, send email to pandoc-discuss-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/674a937f-d17b-4c83-b293-e2163e089146%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

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

Re: including '\usepackage{abc}` via command line option

[BPJ]

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

You should be able to use `-M header-includes='\usepackage{mypackage}'`
or put whatever LaTeX you want in a file and include it with `-H file.tex`
but then you can't have any header-includes in your file metadata.

In my latex template I have something like this near the top:

````
$for(use-packages)$
if(use-packages.name)$
\usepackage[$for(use-packages.opts)$$use-packages.opts$$sep$,$endfor$]{$
use-packages.name$}
$else$
\usepackage{$use-packages$}
$endif$
$endfor$
````

(I wrote this from memory so some details may be wrong.)

Now I can do this in my metadata:

````
---
use-packages:
  - somepackage
  - name: otherpackage
    opts: optname
  - name: thirdpackage
    opts:
      - firstoption
      - secondoption
---
````

and on the command line I can do:

````
-M use-packages=thispackage -M use-packages=thatpackage
````

Also if you are converting from some format other than Pandoc's Markdown
you can use the `--metadata-file=metadata.yaml` option and use

````````
header-includes:
  - |
    ```{=latex}
    \usepackage{somepackage}
    ```
````````

or custom template stuff and whatever metadata you need in that file.

Den fre 17 maj 2019 19:29ivo welch <ivowel-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> skrev:

>
> [Apologies.  I read the docs twice, but I could not find it.  This must be
> obvious.]
>
> I want to include in latex documents a '\usepackage{abc}`, so that my
> latex runs (or pdf runs) include it (following kpsewhich, of course).  I do
> not want pandoc to include the file itself and I do not want to set it in
> the yaml header.
>
> How?
>
> --
> 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 post to this group, send email to pandoc-discuss-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
> To view this discussion on the web visit
> https://groups.google.com/d/msgid/pandoc-discuss/674a937f-d17b-4c83-b293-e2163e089146%40googlegroups.com
> <https://groups.google.com/d/msgid/pandoc-discuss/674a937f-d17b-4c83-b293-e2163e089146%40googlegroups.com?utm_medium=email&utm_source=footer>
> .
> For more options, visit https://groups.google.com/d/optout.
>

-- 
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 post to this group, send email to pandoc-discuss-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/CADAJKhBoueM%2BP7N3-9Vq2aYKiu%2BTh3oVwpAwH2TMcaep65BEjw%40mail.gmail.com.
For more options, visit https://groups.google.com/d/optout.

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

Re: including '\usepackage{abc}` via command line option

[ivo welch]

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


thanks.  this does not work for me, because the backslash seems to be 
escaped:

     $ pandoc -s -M header-includes='\usepackage{abc}' -o sample.tex 
sample.md
     $ grep abc pandoctbl.tex
     \textbackslash usepackage\{abc\}


On Friday, May 17, 2019 at 11:51:32 AM UTC-7, BP wrote:
>
> You should be able to use `-M header-includes='\usepackage{mypackage}'`
> or put whatever LaTeX you want in a file and include it with `-H file.tex` 
> but then you can't have any header-includes in your file metadata.
>
> In my latex template I have something like this near the top:
>
> ````
> $for(use-packages)$
> if(use-packages.name)$
> \usepackage[$for(use-packages.opts)$$use-packages.opts$$sep$,$endfor$]{$
> use-packages.name$}
> $else$
> \usepackage{$use-packages$}
> $endif$
> $endfor$
> ````
>
> (I wrote this from memory so some details may be wrong.)
>
> Now I can do this in my metadata:
>
> ````
> ---
> use-packages:
>   - somepackage
>   - name: otherpackage
>     opts: optname
>   - name: thirdpackage
>     opts:
>       - firstoption
>       - secondoption
> ---
> ````
>
> and on the command line I can do:
>
> ````
> -M use-packages=thispackage -M use-packages=thatpackage
> ````
>
> Also if you are converting from some format other than Pandoc's Markdown 
> you can use the `--metadata-file=metadata.yaml` option and use
>
> ````````
> header-includes:
>   - |
>     ```{=latex}
>     \usepackage{somepackage}
>     ```
> ````````
>
> or custom template stuff and whatever metadata you need in that file.
>
> Den fre 17 maj 2019 19:29ivo welch <ivo...-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org <javascript:>> skrev:
>
>>
>> [Apologies.  I read the docs twice, but I could not find it.  This must 
>> be obvious.]
>>
>> I want to include in latex documents a '\usepackage{abc}`, so that my 
>> latex runs (or pdf runs) include it (following kpsewhich, of course).  I do 
>> not want pandoc to include the file itself and I do not want to set it in 
>> the yaml header.
>>  
>> How?
>>
>> -- 
>> 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-...-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org <javascript:>.
>> To post to this group, send email to pandoc-...-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org 
>> <javascript:>.
>> To view this discussion on the web visit 
>> https://groups.google.com/d/msgid/pandoc-discuss/674a937f-d17b-4c83-b293-e2163e089146%40googlegroups.com 
>> <https://groups.google.com/d/msgid/pandoc-discuss/674a937f-d17b-4c83-b293-e2163e089146%40googlegroups.com?utm_medium=email&utm_source=footer>
>> .
>> For more options, visit https://groups.google.com/d/optout.
>>
>

-- 
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 post to this group, send email to pandoc-discuss-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/d8907aaa-1e1f-4efd-9612-950b42917c33%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

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

Re: including '\usepackage{abc}` via command line option

[John MacFarlane]

It will work if you put it in metadata under
header-includes

header-includes:
- \usepackage{abc}

Why is it that you don't want to do that?
It will be passed through verbatim to your
output, assuming it's PDF via LaTeX.
(If it's another format, this will just be
ignored.)

You could also use a separate metadata file
if the concern is clutter in the main document.


ivo welch <ivowel-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> writes:

> thanks.  this does not work for me, because the backslash seems to be 
> escaped:
>
>      $ pandoc -s -M header-includes='\usepackage{abc}' -o sample.tex 
> sample.md
>      $ grep abc pandoctbl.tex
>      \textbackslash usepackage\{abc\}
>
>
> On Friday, May 17, 2019 at 11:51:32 AM UTC-7, BP wrote:
>>
>> You should be able to use `-M header-includes='\usepackage{mypackage}'`
>> or put whatever LaTeX you want in a file and include it with `-H file.tex` 
>> but then you can't have any header-includes in your file metadata.
>>
>> In my latex template I have something like this near the top:
>>
>> ````
>> $for(use-packages)$
>> if(use-packages.name)$
>> \usepackage[$for(use-packages.opts)$$use-packages.opts$$sep$,$endfor$]{$
>> use-packages.name$}
>> $else$
>> \usepackage{$use-packages$}
>> $endif$
>> $endfor$
>> ````
>>
>> (I wrote this from memory so some details may be wrong.)
>>
>> Now I can do this in my metadata:
>>
>> ````
>> ---
>> use-packages:
>>   - somepackage
>>   - name: otherpackage
>>     opts: optname
>>   - name: thirdpackage
>>     opts:
>>       - firstoption
>>       - secondoption
>> ---
>> ````
>>
>> and on the command line I can do:
>>
>> ````
>> -M use-packages=thispackage -M use-packages=thatpackage
>> ````
>>
>> Also if you are converting from some format other than Pandoc's Markdown 
>> you can use the `--metadata-file=metadata.yaml` option and use
>>
>> ````````
>> header-includes:
>>   - |
>>     ```{=latex}
>>     \usepackage{somepackage}
>>     ```
>> ````````
>>
>> or custom template stuff and whatever metadata you need in that file.
>>
>> Den fre 17 maj 2019 19:29ivo welch <ivo...-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org <javascript:>> skrev:
>>
>>>
>>> [Apologies.  I read the docs twice, but I could not find it.  This must 
>>> be obvious.]
>>>
>>> I want to include in latex documents a '\usepackage{abc}`, so that my 
>>> latex runs (or pdf runs) include it (following kpsewhich, of course).  I do 
>>> not want pandoc to include the file itself and I do not want to set it in 
>>> the yaml header.
>>>  
>>> How?
>>>
>>> -- 
>>> 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-...-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org <javascript:>.
>>> To post to this group, send email to pandoc-...-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org 
>>> <javascript:>.
>>> To view this discussion on the web visit 
>>> https://groups.google.com/d/msgid/pandoc-discuss/674a937f-d17b-4c83-b293-e2163e089146%40googlegroups.com 
>>> <https://groups.google.com/d/msgid/pandoc-discuss/674a937f-d17b-4c83-b293-e2163e089146%40googlegroups.com?utm_medium=email&utm_source=footer>
>>> .
>>> For more options, visit https://groups.google.com/d/optout.
>>>
>>
>
> -- 
> 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 post to this group, send email to pandoc-discuss-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
> To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/d8907aaa-1e1f-4efd-9612-950b42917c33%40googlegroups.com.
> For more options, visit https://groups.google.com/d/optout.

Re: including '\usepackage{abc}` via command line option

[ivo welch]

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



thanks.  switching to default files now.

does pandoc understand ${HOME}/.pandoc/ for default.* files?  On macos, 
(brewed 2.7.2),

    pandoc -s -o sample.tex -t latex --template ~/.pandoc/default.latex 
sample.md

works, but

    pandoc -s -o pandoctbl.tex -t latex sample.md

does not pick up the personalized default.latex.  or did I put 
default.latex into the wrong directory?  (I know it's just command line 
clutter, and presumably it would also require an option not to pull default 
files from ~/.pandoc/).

/iaw



On Friday, May 17, 2019 at 1:14:05 PM UTC-7, John MacFarlane wrote:
>
>
> It will work if you put it in metadata under 
> header-includes 
>
> header-includes: 
> - \usepackage{abc} 
>
>

-- 
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 post to this group, send email to pandoc-discuss-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/ac6aece5-f574-4c66-946c-9f13f19c59cf%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

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

Re: including '\usepackage{abc}` via command line option

[John MacFarlane]

ivo welch <ivowel-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> writes:

> does pandoc understand ${HOME}/.pandoc/ for default.* files?  On macos, 

Put them in a 'templates' subdirectory under
that directory.

Re: including '\usepackage{abc}` via command line option

[ivo welch]

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


thanks.  works great now.  much less painful.

can I make a small suggestion?  Use \IfFileExists{
~/.pandoc/templates/add2preamble.latex}{\input{
~/.pandoc/templates/add2preamble.latex}}{} or something like it to 
optionally include 'add2preamble.latex' (and equivalent 'add2preamble.ext' 
in other default files).  This way, users can remain hedged against future 
changes to your default files if they just want to add some fragments.

PS:  curious---what else is supposed to go into ~/.pandoc, so that these 
should go into ~/.pandoc/templates ?


On Friday, May 17, 2019 at 3:55:13 PM UTC-7, John MacFarlane wrote:
>
>
> ivo welch <ivo...-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org <javascript:>> writes: 
>
> > does pandoc understand ${HOME}/.pandoc/ for default.* files?  On macos, 
>
> Put them in a 'templates' subdirectory under 
> that directory. 
>
>
>

-- 
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 post to this group, send email to pandoc-discuss-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/12e388cf-ccd2-4823-825e-a12cc4a57c58%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

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

Re: including '\usepackage{abc}` via command line option

[John MacFarlane]

ivo welch <ivowel-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> writes:

> thanks.  works great now.  much less painful.
>
> can I make a small suggestion?  Use \IfFileExists{
> ~/.pandoc/templates/add2preamble.latex}{\input{
> ~/.pandoc/templates/add2preamble.latex}}{} or something like it to 
> optionally include 'add2preamble.latex' (and equivalent 'add2preamble.ext' 
> in other default files).  This way, users can remain hedged against future 
> changes to your default files if they just want to add some fragments.

We have --include-in-header, which adds things to the
latex preamble.

> PS:  curious---what else is supposed to go into ~/.pandoc, so that these 
> should go into ~/.pandoc/templates ?

See manual under --data-dir.

Re: including '\usepackage{abc}` via command line option

[ivo welch]

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


thx.

`-H` does what I need most.  (actually, it is the best answer to my 
original question.)  so, I am ok.  alas, it would be a nice addition if 
pandoc could check for the existence of a default preamble file *if it 
exists*, too.  

I searched for `data-dir` for uses.  I found:

- slidy/
- slideous/
- filters/
- templates/
- epub.css
- reference.docx
- reference.odt

regards,

/iaw


On Sunday, May 19, 2019 at 11:43:16 AM UTC-7, John MacFarlane wrote:
>
> ivo welch <ivo...-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org <javascript:>> writes: 
>
> > thanks.  works great now.  much less painful. 
> > 
> > can I make a small suggestion?  Use \IfFileExists{ 
> > ~/.pandoc/templates/add2preamble.latex}{\input{ 
> > ~/.pandoc/templates/add2preamble.latex}}{} or something like it to 
> > optionally include 'add2preamble.latex' (and equivalent 
> 'add2preamble.ext' 
> > in other default files).  This way, users can remain hedged against 
> future 
> > changes to your default files if they just want to add some fragments. 
>
> We have --include-in-header, which adds things to the 
> latex preamble. 
>
> > PS:  curious---what else is supposed to go into ~/.pandoc, so that these 
> > should go into ~/.pandoc/templates ? 
>
> See manual under --data-dir. 
>
>

-- 
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 post to this group, send email to pandoc-discuss-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/9a1ed20c-a559-48e1-9b39-86acb12f98d3%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

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

Re: including '\usepackage{abc}` via command line option

[ivo welch]

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

 

thanks.  works great now.  much less painful.

can I make a small suggestion?   Add a facility to the template 
metalanguage to include a file if it exists, and then use it to add 
~/.pandoc/templates/preamble.<type> into your default.type files 
themselves.  the average user should not tinker with the default files when 
all (s) even if (s)he wants to include a snippet in the preamble, latex, 
html or whatever else.  This way, changes in default.<type> in future 
versions will continue to be picked up automatically.

PS:  curious---what else is supposed to go into ~/.pandoc, so that these 
should go into ~/.pandoc/templates ?

>
>

-- 
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 post to this group, send email to pandoc-discuss-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/49ab8aa1-15ea-433d-a610-d9ee9e2aacf9%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

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