add number_section function in yaml options?

[JiaxiangBU]

I find there are toc and toc_depth options in yaml. Maybe number_section function will make the toc better.

    radix::radix_article:
        toc: true
        toc_depth: 2
        number_section: yes

[jjallaire]

The problem is that pandoc number_sections wants to use H1 as section headings within the document whereas radix/distill uses H2 section headings. So even if you add number_sections (which you could actually do via pandoc_args: ["--number-sections"] ) you get unsatisfactory output.

[larmarange]

It seems that section numbering could be customized with pandoc-crossref, cf. http://lierdakil.github.io/pandoc-crossref/#section-numbering

[larmarange]

Integrating crossref within Radix would also allow to customize Figure and Table labels (cf. http://lierdakil.github.io/pandoc-crossref/#settings-file)

[jjallaire]

The issue w/ relying on pandoc-crossref is that users need to install another Haskell binary (which will I think be too big a hurdle to surmount for most). It would be much better to find a solution based on a a Lua filter.

[larmarange]

That issue of adding an additional parameter to pandoc has been raised on pandoc's GitHub: jgm/pandoc#5071

However, as long as a new option is not added to Pandoc, another possibility would be to rely on a custom filter, directly provided by Radix.

[ssp3nc3r]

The problem is that pandoc number_sections wants to use H1 as section headings within the document whereas radix/distill uses H2 section headings. So even if you add number_sections (which you could actually do via pandoc_args: ["--number-sections"] ) you get unsatisfactory output.

Adding pandoc_args: ["--number-sections"] actually works fine, at least if using distill::distill_article as a base_format for bookdown::html_document2:, like so:

output:
  bookdown::html_document2:
    base_format: distill::distill_article
    toc: true
    toc_depth: 2
    pandoc_args: ["--number-sections"]

[GitHunter0]

Adding pandoc_args: ["--number-sections"] actually works fine, at least if using distill::distill_article as a base_format for bookdown::html_document2:, like so:

Nice trick, it is working for me even for native distill articles