leodido / markarticle

Markdown template for academic articles

Markarticle

A Markdown article.

Write you academic paper in R markdown, choice a tex template and compile it in PDF.

Dependecies

• R
• a tex distribution (e.g., TeX Live)
• knitr
• pandoc

Workflow

1. Clone this repository and enter its directory

2. Create a new branch

3. Open article.Rmd and write your paper

4. Compile it

Details

A tex template, with its configuration variables, is already provided.

Replacing it is very simple: put your template into the templates directory and consequently update the pandoc configuration file

Edit article.pandoc configuration file to:

• change the variables of the tex template (e.g., author, title, link as footnotes, language, font size)
• fine-tune the pandoc conversion (e.g., TOC, bibliography, latex engine, output format)
• use your own tex template

And thousands of other things: is only to your imagination and your needs.

Building article

To build your paper digit make knit in shell.

Also a make clean and a make deepclean are provided.

markarticle's Issues

Define a template system

• folder for templates
• mechanism for template selection
• subsequent mechanism to set the template supported pandoc variables

Improve support for bibliography

• externalize bibliography
• support csl
• support bibliography solution based on knitr (i.e., knitcitations package)
• enhance pandoc bibliography

Create a demo

Report the document used to present the source latex article.

Refine makefile

• deepclean command: don't erase README.md file
• clean: deletion also in subfolders

Remove bookmarks nesting

Remove the nesting of the PDF bookmarks. This implies that the root bookmark (i.e., Article) for the paper have to be removed, too.

Add a README