Markdown to PDF via TeX: Tyring to change section title color

Markdown to PDF via TeX: Tyring to change section title color

[rurq...-Zl5T1cyB3pc@public.gmane.org]

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

Hi all,

I found several items on the web about customizing my pdf output from 
Pandoc.

I am calling pandoc with the following parameters:

     pandoc *.md -H seccolor.tex -o test_doc.pdf --table-of-contents 
--number-sections --indented-code-classes=javascript 
--highlight-style=monochrome -V mainfont="Palatino" -V documentclass=report 
-V papersize=A5 -V geometry:margin=1in -V monofont="Courier" 
--pdf-engine=xelatex

The seccolor.tex file is:

    \usepackage{titlesec}
\definecolor{DPurple}{rgb}{.75,.52,.153}
\titleformat*{\section}{\color{DPurple}}
% \sectionfont{\color{DPurple}}

When i run the command i get:

Error producing PDF.
! LaTeX Error: File `titlesec.sty' not found.

Type X to quit or <RETURN> to proceed,
or enter new name. (Default extension: sty)

Enter file name: 
! Emergency stop.
<read *> 
         
l.98 \definecolor

Should i be using another style? I WAS able to generate a standard PDF, but 
just wanted to add a splash of color. From what I read, this snippet of TeX 
should work.

Can anyone suggest how I can fix this?

Thanks,

Russ

-- 
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/c487e498-4249-4800-ab99-0e3dc9fca664n%40googlegroups.com.

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

Re: Markdown to PDF via TeX: Tyring to change section title color

[gnpan]

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

It should work OK. Maybe the titlesec package is not installed, check your 
TeX installation (<https://www.tug.org/texlive/>).

On Saturday, 15 May 2021 at 00:22:02 UTC+3 rurq...-Zl5T1cyB3pc@public.gmane.org wrote:

> Hi all,
>
> I found several items on the web about customizing my pdf output from 
> Pandoc.
>
> I am calling pandoc with the following parameters:
>
>      pandoc *.md -H seccolor.tex -o test_doc.pdf --table-of-contents 
> --number-sections --indented-code-classes=javascript 
> --highlight-style=monochrome -V mainfont="Palatino" -V documentclass=report 
> -V papersize=A5 -V geometry:margin=1in -V monofont="Courier" 
> --pdf-engine=xelatex
>
> The seccolor.tex file is:
>
>     \usepackage{titlesec}
> \definecolor{DPurple}{rgb}{.75,.52,.153}
> \titleformat*{\section}{\color{DPurple}}
> % \sectionfont{\color{DPurple}}
>
> When i run the command i get:
>
> Error producing PDF.
> ! LaTeX Error: File `titlesec.sty' not found.
>
> Type X to quit or <RETURN> to proceed,
> or enter new name. (Default extension: sty)
>
> Enter file name: 
> ! Emergency stop.
> <read *> 
>          
> l.98 \definecolor
>
> Should i be using another style? I WAS able to generate a standard PDF, 
> but just wanted to add a splash of color. From what I read, this snippet of 
> TeX should work.
>
> Can anyone suggest how I can fix this?
>
> Thanks,
>
> Russ
>

-- 
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/8d49ee0f-a978-4cac-9df0-6f0fcb2b6369n%40googlegroups.com.

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

AW: Markdown to PDF via TeX: Tyring to change section title color

[denis.maier-FfwAq0itz3ofv37vnLkPlQ]

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

Exactly, it’s about the titlesec package not being available. (What’s your installed TeX-Distribution ?)
\definecolor just happens to be on the next line, but the error is not about adding colors.
Otherwise you’d get an error like
Undefined control sequence \definecolor
or similar...
Best,
Denis

Von: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org <pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org> Im Auftrag von gnpan
Gesendet: Samstag, 15. Mai 2021 09:31
An: pandoc-discuss <pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org>
Betreff: Re: Markdown to PDF via TeX: Tyring to change section title color

It should work OK. Maybe the titlesec package is not installed, check your TeX installation (<https://www.tug.org/texlive/>).
On Saturday, 15 May 2021 at 00:22:02 UTC+3 rurq...-Zl5T1cyB3pc@public.gmane.org<mailto:rurq...@d2iq.com> wrote:
Hi all,

I found several items on the web about customizing my pdf output from Pandoc.

I am calling pandoc with the following parameters:

     pandoc *.md -H seccolor.tex -o test_doc.pdf --table-of-contents --number-sections --indented-code-classes=javascript --highlight-style=monochrome -V mainfont="Palatino" -V documentclass=report -V papersize=A5 -V geometry:margin=1in -V monofont="Courier" --pdf-engine=xelatex

The seccolor.tex file is:

    \usepackage{titlesec}
\definecolor{DPurple}{rgb}{.75,.52,.153}
\titleformat*{\section}{\color{DPurple}}
% \sectionfont{\color{DPurple}}

When i run the command i get:
Error producing PDF.
! LaTeX Error: File `titlesec.sty' not found.

Type X to quit or <RETURN> to proceed,
or enter new name. (Default extension: sty)

Enter file name:
! Emergency stop.
<read *>

l.98 \definecolor

Should i be using another style? I WAS able to generate a standard PDF, but just wanted to add a splash of color. From what I read, this snippet of TeX should work.

Can anyone suggest how I can fix this?

Thanks,

Russ
--
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-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org<mailto:pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org>.
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/8d49ee0f-a978-4cac-9df0-6f0fcb2b6369n%40googlegroups.com<https://groups.google.com/d/msgid/pandoc-discuss/8d49ee0f-a978-4cac-9df0-6f0fcb2b6369n%40googlegroups.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/d32560495cc7456bbb78e302aaff271f%40ub.unibe.ch.

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

Re: Markdown to PDF via TeX: Tyring to change section title color

['russurquhart1' via pandoc-discuss]

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

i installed BasicTex as the website i read said this should be sufficient, 
but I guess for certain things its not. Can i add the titlesec style ti 
this? Or do i need to install another Tex version?

Thanks,

Russ

On Saturday, May 15, 2021 at 2:35:02 AM UTC-5 denis...-FfwAq0itz3ofv37vnLkPlQ@public.gmane.org wrote:

> Exactly, it’s about the titlesec package not being available. (What’s your 
> installed TeX-Distribution ?)
>
> \definecolor just happens to be on the next line, but the error is not 
> about adding colors. 
>
> Otherwise you’d get an error like
>
> Undefined control sequence \definecolor
>
> or similar...
>
> Best,
>
> Denis
>
>  
>
> *Von:* pandoc-...-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org <pandoc-...-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org> *Im 
> Auftrag von *gnpan
> *Gesendet:* Samstag, 15. Mai 2021 09:31
> *An:* pandoc-discuss <pandoc-...-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org>
> *Betreff:* Re: Markdown to PDF via TeX: Tyring to change section title 
> color
>
>  
>
> It should work OK. Maybe the titlesec package is not installed, check your 
> TeX installation (<https://www.tug.org/texlive/>).
>
> On Saturday, 15 May 2021 at 00:22:02 UTC+3 rurq...-Zl5T1cyB3pc@public.gmane.org wrote:
>
> Hi all,
>
>  
>
> I found several items on the web about customizing my pdf output from 
> Pandoc.
>
>  
>
> I am calling pandoc with the following parameters:
>
>  
>
>      pandoc *.md -H seccolor.tex -o test_doc.pdf --table-of-contents 
> --number-sections --indented-code-classes=javascript 
> --highlight-style=monochrome -V mainfont="Palatino" -V documentclass=report 
> -V papersize=A5 -V geometry:margin=1in -V monofont="Courier" 
> --pdf-engine=xelatex
>
> The seccolor.tex file is:
>
>     \usepackage{titlesec}
>
> \definecolor{DPurple}{rgb}{.75,.52,.153}
>
> \titleformat*{\section}{\color{DPurple}}
>
> % \sectionfont{\color{DPurple}}
>
> When i run the command i get:
>
> Error producing PDF.
>
> ! LaTeX Error: File `titlesec.sty' not found.
>
>  
>
> Type X to quit or <RETURN> to proceed,
>
> or enter new name. (Default extension: sty)
>
>  
>
> Enter file name: 
>
> ! Emergency stop.
>
> <read *> 
>
>          
>
> l.98 \definecolor
>
> Should i be using another style? I WAS able to generate a standard PDF, 
> but just wanted to add a splash of color. From what I read, this snippet of 
> TeX should work.
>
> Can anyone suggest how I can fix this?
>
> Thanks,
>
>  
>
> Russ
>
> -- 
> 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-discus...-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
> To view this discussion on the web visit 
> https://groups.google.com/d/msgid/pandoc-discuss/8d49ee0f-a978-4cac-9df0-6f0fcb2b6369n%40googlegroups.com 
> <https://groups.google.com/d/msgid/pandoc-discuss/8d49ee0f-a978-4cac-9df0-6f0fcb2b6369n%40googlegroups.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/37ef69ff-8fd6-4092-9291-bd7a2515b679n%40googlegroups.com.

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

Re: Markdown to PDF via TeX: Tyring to change section title color

[gnpan]

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

Your BasicTex installation should include tlmgr, which you can run from the 
terminal to install a package (see 
<https://www.tug.org/texlive/doc/tlmgr.html#install-option...-pkg>): 
tlmgr install titlesec 
should do it. However, if you can spare 2gigabytes, it's worth downloading 
the whole MacTex distribution (<http://www.tug.org/mactex/>)

On Saturday, 15 May 2021 at 19:06:32 UTC+3 russur...-H+0wwilmMs3R7s880joybQ@public.gmane.org wrote:

> i installed BasicTex as the website i read said this should be sufficient, 
> but I guess for certain things its not. Can i add the titlesec style ti 
> this? Or do i need to install another Tex version?
>
> Thanks,
>
> Russ
>
> On Saturday, May 15, 2021 at 2:35:02 AM UTC-5 denis...-FfwAq0itz3ofv37vnLkPlQ@public.gmane.org wrote:
>
>> Exactly, it’s about the titlesec package not being available. (What’s 
>> your installed TeX-Distribution ?)
>>
>> \definecolor just happens to be on the next line, but the error is not 
>> about adding colors. 
>>
>> Otherwise you’d get an error like
>>
>> Undefined control sequence \definecolor
>>
>> or similar...
>>
>> Best,
>>
>> Denis
>>
>>  
>>
>> *Von:* pandoc-...-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org <pandoc-...-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org> *Im 
>> Auftrag von *gnpan
>> *Gesendet:* Samstag, 15. Mai 2021 09:31
>> *An:* pandoc-discuss <pandoc-...-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org>
>> *Betreff:* Re: Markdown to PDF via TeX: Tyring to change section title 
>> color
>>
>>  
>>
>> It should work OK. Maybe the titlesec package is not installed, check 
>> your TeX installation (<https://www.tug.org/texlive/>).
>>
>> On Saturday, 15 May 2021 at 00:22:02 UTC+3 rurq...-Zl5T1cyB3pc@public.gmane.org wrote:
>>
>> Hi all,
>>
>>  
>>
>> I found several items on the web about customizing my pdf output from 
>> Pandoc.
>>
>>  
>>
>> I am calling pandoc with the following parameters:
>>
>>  
>>
>>      pandoc *.md -H seccolor.tex -o test_doc.pdf --table-of-contents 
>> --number-sections --indented-code-classes=javascript 
>> --highlight-style=monochrome -V mainfont="Palatino" -V documentclass=report 
>> -V papersize=A5 -V geometry:margin=1in -V monofont="Courier" 
>> --pdf-engine=xelatex
>>
>> The seccolor.tex file is:
>>
>>     \usepackage{titlesec}
>>
>> \definecolor{DPurple}{rgb}{.75,.52,.153}
>>
>> \titleformat*{\section}{\color{DPurple}}
>>
>> % \sectionfont{\color{DPurple}}
>>
>> When i run the command i get:
>>
>> Error producing PDF.
>>
>> ! LaTeX Error: File `titlesec.sty' not found.
>>
>>  
>>
>> Type X to quit or <RETURN> to proceed,
>>
>> or enter new name. (Default extension: sty)
>>
>>  
>>
>> Enter file name: 
>>
>> ! Emergency stop.
>>
>> <read *> 
>>
>>          
>>
>> l.98 \definecolor
>>
>> Should i be using another style? I WAS able to generate a standard PDF, 
>> but just wanted to add a splash of color. From what I read, this snippet of 
>> TeX should work.
>>
>> Can anyone suggest how I can fix this?
>>
>> Thanks,
>>
>>  
>>
>> Russ
>>
>> -- 
>> 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-discus...-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
>> To view this discussion on the web visit 
>> https://groups.google.com/d/msgid/pandoc-discuss/8d49ee0f-a978-4cac-9df0-6f0fcb2b6369n%40googlegroups.com 
>> <https://groups.google.com/d/msgid/pandoc-discuss/8d49ee0f-a978-4cac-9df0-6f0fcb2b6369n%40googlegroups.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/37e25787-5f00-460f-8860-7ea48aa224c6n%40googlegroups.com.

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

Re: Markdown to PDF via TeX: Tyring to change section title color

[Randy Yates]

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

Hi Russ,

I hope you don't resent these thoughts since they do not solve your problem 
directly, but may I ask why you are trying to go from markdown to latex to 
pdf? 
Latex is compilable directly to pdf and almost certainly will generate 
better pdf than pandoc. 

Don't use markdown as your source document format. Latex's capabilities for 
generating rich output are far, far greater than markdown, which can't even 
generate numbered section headers. Latex also offers:


   1. Elegant mathematics
   2. An extensive bibliography/citation system
   3. The ability to natively generate graphics using Tikz/Pgm.

I've also found an excellent, free tool for converting latex docs to html: 
LaTeXML <https://dlmf.nist.gov/LaTeXML/>. It automagically handles 
citations. It is even capable of translating many tikz illustrations to 
html, e.g. several of the examples here 
<https://texample.net/tikz/examples/>.

So in general, choose a source document format that's the least "lossy" in 
terms of typographical capability, then translation to other formats incurs 
the least loss possible.

--Randy

On Friday, May 14, 2021 at 5:22:02 PM UTC-4 rurq...-Zl5T1cyB3pc@public.gmane.org wrote:

> Hi all,
>
> I found several items on the web about customizing my pdf output from 
> Pandoc.
>
> I am calling pandoc with the following parameters:
>
>      pandoc *.md -H seccolor.tex -o test_doc.pdf --table-of-contents 
> --number-sections --indented-code-classes=javascript 
> --highlight-style=monochrome -V mainfont="Palatino" -V documentclass=report 
> -V papersize=A5 -V geometry:margin=1in -V monofont="Courier" 
> --pdf-engine=xelatex
>
> The seccolor.tex file is:
>
>     \usepackage{titlesec}
> \definecolor{DPurple}{rgb}{.75,.52,.153}
> \titleformat*{\section}{\color{DPurple}}
> % \sectionfont{\color{DPurple}}
>
> When i run the command i get:
>
> Error producing PDF.
> ! LaTeX Error: File `titlesec.sty' not found.
>
> Type X to quit or <RETURN> to proceed,
> or enter new name. (Default extension: sty)
>
> Enter file name: 
> ! Emergency stop.
> <read *> 
>          
> l.98 \definecolor
>
> Should i be using another style? I WAS able to generate a standard PDF, 
> but just wanted to add a splash of color. From what I read, this snippet of 
> TeX should work.
>
> Can anyone suggest how I can fix this?
>
> Thanks,
>
> Russ
>

-- 
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/f025f0e7-98ff-4f50-9ba2-37687041fb3dn%40googlegroups.com.

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

Re: Markdown to PDF via TeX: Tyring to change section title color

[John MacFarlane]

Randy Yates <yates-EkmVulN54Sk@public.gmane.org> writes:

> Don't use markdown as your source document format. Latex's capabilities for 
> generating rich output are far, far greater than markdown,

This is true.

> which can't even generate numbered section headers.

It can.  pandoc -f markdown --number-sections

>    1. Elegant mathematics

Also accessible from within pandoc markdown, which allows you
to use tex math and even macros.

>    2. An extensive bibliography/citation system

Pandoc's markdown has one too (see Citations in the user's guide and pandoc --citeproc).

>    3. The ability to natively generate graphics using Tikz/Pgm.

This can be done in pandoc markdown using a filter: https://github.com/pandoc/lua-filters/tree/master/diagram-generator

Although it's true that LaTeX is more expressive and more powerful
than markdown, but many users may find that pandoc's extended
markdown has all the power they need.  In addition, there are
advantages to writing in this more limited format, especially
if you may need to target output formats other than PDF.
I discuss this in my TUG 2020 talk "Pandoc for TeXnicians":
video: https://www.youtube.com/watch?v=T9uZJFO54iM
slides: https://johnmacfarlane.net/tug-2020-pandoc-for-texnicians.pdf

> So in general, choose a source document format that's the least "lossy" in 
> terms of typographical capability, then translation to other formats incurs 
> the least loss possible.

Conversions from LaTeX to other formats are notorious for being
lossy -- precisely *because* of the expressiveness of LaTeX.  I
look at a couple examples in the talk.  If translation to other
formats  is an issue, you've got good reason to use a less
expressive source format which can be translated more reliably.

Re: Markdown to PDF via TeX: Tyring to change section title color

[Randy Yates]

John,

First of all, no matter what approach, let me thank you for such a 
powerful and wonderful tool.

Regarding your TUG talk on youtube, the problem with using markdown as 
the source document for our documentation flow is that we use the 
markdown as input to doxygen to generate our final doxygen (html) 
output, and AFAIK doxygen does not honor any of the special 
pandoc-specific extensions to markdown.

So this brings me to the following important question: when using pandoc 
to convert from markdown input to markdown output, is the markdown 
output "standard" markdown with all the pandoc-specific extenions 
implemented as native markdown? If so, that would work with our doxygen 
flow.

I am still not on-board with the idea that markdown is the ideal or best 
input language, but having options is always better than the old days.

--Randy

On 5/15/21 8:12 PM, John MacFarlane wrote:
> Randy Yates <yates-EkmVulN54Sk@public.gmane.org> writes:
>
>> Don't use markdown as your source document format. Latex's capabilities for
>> generating rich output are far, far greater than markdown,
> This is true.
>
>> which can't even generate numbered section headers.
> It can.  pandoc -f markdown --number-sections
>
>>     1. Elegant mathematics
> Also accessible from within pandoc markdown, which allows you
> to use tex math and even macros.
>
>>     2. An extensive bibliography/citation system
> Pandoc's markdown has one too (see Citations in the user's guide and pandoc --citeproc).
>
>>     3. The ability to natively generate graphics using Tikz/Pgm.
> This can be done in pandoc markdown using a filter: https://github.com/pandoc/lua-filters/tree/master/diagram-generator
>
> Although it's true that LaTeX is more expressive and more powerful
> than markdown, but many users may find that pandoc's extended
> markdown has all the power they need.  In addition, there are
> advantages to writing in this more limited format, especially
> if you may need to target output formats other than PDF.
> I discuss this in my TUG 2020 talk "Pandoc for TeXnicians":
> video: https://www.youtube.com/watch?v=T9uZJFO54iM
> slides: https://johnmacfarlane.net/tug-2020-pandoc-for-texnicians.pdf
>
>> So in general, choose a source document format that's the least "lossy" in
>> terms of typographical capability, then translation to other formats incurs
>> the least loss possible.
> Conversions from LaTeX to other formats are notorious for being
> lossy -- precisely *because* of the expressiveness of LaTeX.  I
> look at a couple examples in the talk.  If translation to other
> formats  is an issue, you've got good reason to use a less
> expressive source format which can be translated more reliably.

Re: Markdown to PDF via TeX: Tyring to change section title color

[Russ Urquhart]

Hi All,

Thanks for all the help! I finally got titlesec installed, what hoops
you have to be aware of!

To answer the question of why use Markdown to go to PDF via LaTeX when
LaTex is more expressive. I completely understand that. Our tech doc
group, using a Docs as Code workflow, already has their documentation,
initially contributed by development, in Markdown. (To my way of
thinking, going to Asciidoc would solve most of our problems of
Including files and generating PDF's directly, but you have to work
with what you have.)

I feel more confident that we'll be able to get where we want to go,
just may have to dig into TeX/LaTex a little more!

Thanks,

Russ

On Sat, May 15, 2021 at 9:14 PM Randy Yates <yates-EkmVulN54Sk@public.gmane.org> wrote:
>
> John,
>
> First of all, no matter what approach, let me thank you for such a
> powerful and wonderful tool.
>
> Regarding your TUG talk on youtube, the problem with using markdown as
> the source document for our documentation flow is that we use the
> markdown as input to doxygen to generate our final doxygen (html)
> output, and AFAIK doxygen does not honor any of the special
> pandoc-specific extensions to markdown.
>
> So this brings me to the following important question: when using pandoc
> to convert from markdown input to markdown output, is the markdown
> output "standard" markdown with all the pandoc-specific extenions
> implemented as native markdown? If so, that would work with our doxygen
> flow.
>
> I am still not on-board with the idea that markdown is the ideal or best
> input language, but having options is always better than the old days.
>
> --Randy
>
> On 5/15/21 8:12 PM, John MacFarlane wrote:
> > Randy Yates <yates-EkmVulN54Sk@public.gmane.org> writes:
> >
> >> Don't use markdown as your source document format. Latex's capabilities for
> >> generating rich output are far, far greater than markdown,
> > This is true.
> >
> >> which can't even generate numbered section headers.
> > It can.  pandoc -f markdown --number-sections
> >
> >>     1. Elegant mathematics
> > Also accessible from within pandoc markdown, which allows you
> > to use tex math and even macros.
> >
> >>     2. An extensive bibliography/citation system
> > Pandoc's markdown has one too (see Citations in the user's guide and pandoc --citeproc).
> >
> >>     3. The ability to natively generate graphics using Tikz/Pgm.
> > This can be done in pandoc markdown using a filter: https://github.com/pandoc/lua-filters/tree/master/diagram-generator
> >
> > Although it's true that LaTeX is more expressive and more powerful
> > than markdown, but many users may find that pandoc's extended
> > markdown has all the power they need.  In addition, there are
> > advantages to writing in this more limited format, especially
> > if you may need to target output formats other than PDF.
> > I discuss this in my TUG 2020 talk "Pandoc for TeXnicians":
> > video: https://www.youtube.com/watch?v=T9uZJFO54iM
> > slides: https://johnmacfarlane.net/tug-2020-pandoc-for-texnicians.pdf
> >
> >> So in general, choose a source document format that's the least "lossy" in
> >> terms of typographical capability, then translation to other formats incurs
> >> the least loss possible.
> > Conversions from LaTeX to other formats are notorious for being
> > lossy -- precisely *because* of the expressiveness of LaTeX.  I
> > look at a couple examples in the talk.  If translation to other
> > formats  is an issue, you've got good reason to use a less
> > expressive source format which can be translated more reliably.
>
> --
> 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/47556979-9357-c3d3-b3ed-a3031a195127%40ieee.org.

Re: Markdown to PDF via TeX: Tyring to change section title color

[Daniel Staal]

On 5/15/21 10:14 PM, Randy Yates wrote:
> So this brings me to the following important question: when using pandoc 
> to convert from markdown input to markdown output, is the markdown 
> output "standard" markdown with all the pandoc-specific extenions 
> implemented as native markdown? If so, that would work with our doxygen 
> flow.

The default output would be with all/most of the pandoc-specific 
extensions enabled.  So by default I wouldn't expect it to work with 
doxygen directly.  (At least, you'll get some markup text getting passed 
through.)

However, Pandoc uses named extensions for all or nearly all of it's 
extensions, and they can be enabled/disabled on an individual basis.  It 
also has direct support for several Markdown variants, so if doxygen 
directly supports say Github's Markdown, you can tell Pandoc to only 
export that.  (One of those variants being the original base Markdown.)

So you may want to tweak a bit to get the best support, but generally 
Pandoc should be tweakable to get what you need.

Daniel T. Staal

-- 
---------------------------------------------------------------
This email copyright the author.  Unless otherwise noted, you
are expressly allowed to retransmit, quote, or otherwise use
the contents for non-commercial purposes.  This copyright will
expire 5 years after the author's death, or in 30 years,
whichever is longer, unless such a period is in excess of
local copyright law.
---------------------------------------------------------------