idelsink/mexdown

LaTeX templates that use markdown

🖼️ Picture of the Day

Berliner Dom during the Festival of Lights 🌈
_{Wed Sep 08 2021
This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.}

👋 Well hi there!

I'm a Dutch Software Engineer living in Berlin. In my daily life I try to convince the computer to do what I tell it to do.

mexdown's Issues

mexdown-report: font size option is ignored

\documentclass[12pt]{mexdown-report}

Gives the same result as 10pt, 11pt, or any other value.

More testing

Test the template(s) on multiple platforms (use https://travis-ci.org/?)

document features

What features are used in this template (report)

List at end of chapter causes stack overflow

Given the following chapter markdown:

# Chapter

Have a nice list:

* One
* Two

The build fails with an error like this:

Chapter 1.
)
! TeX capacity exceeded, sorry [input stack size=5000].
\@restorepar ->\def \par 
                         {\@par }
l.117 

Increasing the stack size does not make a difference.

Workaround: have at least one paragraph after the last list in the chapter.

version

give current and future templates a version number.

add glossary package

Add the glossary package into the mexdown-report class.
This can be very useful when writing technical documentation.

https://en.wikibooks.org/wiki/LaTeX/Glossary

[pandoc warning] --chapters is deprecated. Use --top-level-division=chapter instead.

This was changed in pandoc 1.18.

listings style always select the LaTeX style.

The global style is set to LaTeX. so the default code highlighting behaviour is LaTeX.

LaTeX Error: Too deeply nested. => \tightlist

LaTeX Error: Too deeply nested.

The list that it applies to:

\tightlist 

This can be solved by increasing the max nesting value in the lists.sty file in the tex directory.

change 'include-markdown' to 'input-markdown'

Change the package include-markdown to input-markdown for consistency.
The command is \inputmarkdown so it would only logic to call the package the same.

Include fontawesome package

Include the fontawesome package in the report.

Argument of \inputmarkdown has an extra }.

When I have the following:

\inputmarkdown{chapters}{chap1}
\inputmarkdown{chapters}{chap2}

I get the error:
Argument of \inputmarkdown has an extra }.

But this does not happen when I do:

\inputmarkdown{chapters}{chap1}

\inputmarkdown{chapters}{chap2}

Default pdf scaling

set default pdf scaling with: pdfstartview={XYZ null null 1.00},