tech note about pandoc troubleshooting

[maelle]

TODO for @maelle

• Add French translation

[cderv]

First review.

Overall I like this post.

I wonder if we are missing to big part (but that would make the post longer)

• A better intro to the "Why of the pandoc package" as we mention it a lot. Wondering about this because most of the function are intented to be run for debugging, with self installed pandoc, and not the quarto one, or the system one. Just a warning to user of the context and how they install and manage their pandoc to help them debug

• A part on Quarto as

  • A good alternative to further with pandoc
  • A warning of more difficulties to debug pandoc itself when from Quarto becasue Quarto adds a lot to it!

Not sure if I am clear enough, but hoepfully you get the rough ideas 😅

[steffilazerte]

Hi @maelle, Hi @cderv!

What a post! I've learned so much and am so excited to up my Quarto/Pandoc game, thank you 😁

The post is really well organized and covered a lot of really useful details. My suggestions are mostly fiddly wording tweaks, as well as some clarifications for readers who may be less technically inclined. See what you think (and whether I've understood correctly!).

Let me know if you have any questions!

• post follows Content Guidelines
• post follows Style Guide
• title is in Title Case -> See my suggestion
• publication date is ok
• alternative text of images is informative
• author metadata is provided with correct folder name
• html not included in pull request of Rmd post
• I ran roblog::ro_lint_md() on index.md
• I ran roblog::ro_check_urls() on index.md
• I ran a spell-check on index.md
• YAML subject tags are ok ("tech notes" for tech notes; "community" for non-staff non-editor)
  • Should there be a community tag because of Christophe?
• YAML field 'preface' is present if necessary

[steffilazerte]

Suggested change

	It's crucial to remember your Pandoc skills and vocabulary will improve with practice.
	It's crucial to remember that while this can seem like a lot, your Pandoc skills and vocabulary will improve with practice!

[steffilazerte]

Hi @maelle, Hi @cderv!

What a post! I've learned so much and am so excited to up my Quarto/Pandoc game, thank you 😁

The post is really well organized and covered a lot of really useful details. My suggestions are mostly fiddly wording tweaks, as well as some clarifications for readers who may be less technically inclined. See what you think (and whether I've understood correctly!).

Let me know if you have any questions!

• post follows Content Guidelines
• post follows Style Guide
• title is in Title Case -> See my suggestion
• publication date is ok
• alternative text of images is informative
• author metadata is provided with correct folder name
• html not included in pull request of Rmd post
• I ran roblog::ro_lint_md() on index.md
• I ran roblog::ro_check_urls() on index.md
• I ran a spell-check on index.md
• YAML subject tags are ok ("tech notes" for tech notes; "community" for non-staff non-editor)
  • Should there be a community tag because of Christophe?
• YAML field 'preface' is present if necessary

[steffilazerte]

Suggested change

	Below, we use an option to shift heading levels by 1 which increases the heading level number thereby reducing the heading importance.
	However, most options can be specified using the `args` argument of [`pandoc::pandoc_convert()`](https://cderv.github.io/pandoc/reference/pandoc_convert.html). In this example, we use an option to shift heading levels by 1 which increases the heading level number thereby reducing the heading importance.

[Bisaloo]

Thanks for sharing! It really helped me organize my mental model about Pandoc and the different ways we can change its behaviour.

I've made a couple of suggestions. Some of them might not be great because I'm just not used to reading technical content in French 😬. Feel free to ignore anything you disagree with!

[Bisaloo]

Question de style que je n'ai pas relevée plus tôt : quand tu donnes à la fois les termes anglais et français, c'est mieux de commencer par l'anglais ou le français ? Qu'est-ce qui est fait dans les autres billets du blog ?

[maelle]

Excellente question, je vais me renseigner 😸

[maelle]

@Bisaloo thanks a ton!! Super useful comments.