[Tex/LaTex] a good format or package for writing a commentary about a paper

packages

I often find myself writing commentaries on scientific papers. By this I mean an informal document written to collect all my comments regarding a peer reviewed publication (which is often about 10 pages, but can easily be from 5 to 20).

These commentaries usually:

  • Are short – 1-3 pages. Short sentences, short paragraphs, concise language where possible. Often use bullet point lists.
  • Have simple, minimalistic but well defined formatting – the idea is to spend minimal time on fancy layouts (and avoid distracting the reader) to produce a short text which is as effortless as possible for the reader (usually a colleague) to consume. However, things like specific formatting for eg. species names or code are still useful (and used).
  • May include figures, but often do not (there is no need).
  • May include citations, but often do not (and since the document is informal, strictly formatted citations aren't really necessary).
  • Make heavy use of sectioning with deep hierarchy to collect comments based on what part or aspect of the paper they pertain to.

The function of such a commentary is to allow in-depth discussion of a paper when meeting at a set time is difficult, and to facilitate such discussion by enabling the participants to organize and flesh out their own comments before sharing them.

I find that such commentaries are often necessary to write when discussing publications particularly relevant to one's research group, when collaborating on formal commentary (peer reviews) and for various course work revolving around discussing papers.

My question is, is there already a LaTeX package out there meant precisely for writing such commentaries? If not, how do I iron out the details (margins, columns, heading styles) to create my own style? What advice is there for formatting and organizing such commentaries?

Previously I have used the default style of Word 2010+. It doesn't look too pretty, but it is quite functional – there are many different heading and subheading styles, which are sufficiently distinct and don't get in the way too much, the default margins, paragraph spacings and bullet point list formats do a decent job of keeping separate units of text appropriately delimited with space.

I have tried to cobble together a few lines my own LaTeX, using actual scientific publications as a vague basis. Unfortunately, scientific papers tend to be formatted with a much different document in mind (many figures, proper citations, dense text, limited subsectioning) which runs counter to what I would expect from a commentary. Also, if using columns, sometimes the commentary is so short that the last column looks too short and ugly. Still, it looks nicer than Word, but I haven't used it long enough to comment on functionality (ie. ease of reading).

I know about the Tufte books package, and at first the "handout" seemed to be close, but it looks very different from what I was expecting. I don't need such a large margin for figures and footnotes, because I rarely have any. Also, to me the heading font doesn't stand out enough at a glance – it looks too similar to body text (maybe a boldface would work better).

Best Answer

It would be, as @jon pointed out, a good idea to use a light-weight markup language for note taking. My favorite is pandoc, which provides a nice front-end to LaTeX. How should a document like this look? Structured, clean and uncluttered, which can be achieved with either article, memoir or KOMA-Script and a nice font.

So, let's try this with the standard document class article and the New PX font:

---
title: Commentary on XY
date: Date
documentclass: article
papersize: a4paper
geometry:
    - right=2cm
    - left=2cm
    - top=1cm
    - bottom=1cm
header-includes: 
    - \usepackage{newpxtext}
    - \usepackage{newpxmath}
numbersections: true
---

# Level 1

Lorem ipsum Non ullamco dolor.

#. Item
    #. Item
        #. Item
            #. Item
            #. Item
    #. Item
        #. Item
            #. Item

## Level 2 

Lorem ipsum *Mollit* quis **nostrud** nulla exercitation consectetur sit in in et in.

### Level 3

Lorem ipsum Et labore nulla aliqua mollit ex magna sit in dolore proident ut laboris.

- This
- Is
    - A
        - Bullet 
            - list

#### Level 4

Lorem ipsum Et irure esse mollit.

##### Level 5

Lorem ipsum Excepteur.

###### Level 6

Lorem ipsum Do adipisicing occaecat ut.

The resulting (simply: pandoc in.md -o out.pdf in the terminal) PDF looks like this:

enter image description here

Update 1

Pandoc can convert between several formats on the in- and output side, including .pdf, .docx, .odt, .html, and .tex. The native pandoc markup is a superset of markdown: That means, that pandoc is on the one hand fully compatible to markdown and adds on the other hand some very powerful commands, e.g. for footnotes, tables and citations. (Some are even writing their whole thesis in pandoc.) It is worthwhile reading the user's guide.

Update 2

Pandoc can produce .tex files directly. In order to do so, just set the file extension accordingly: pandoc -s in.md -o out.tex

This produces a standalone tex file, using the default latex template. Omitting -s (standalone) will give a fragment containing only the written text in LaTeX markup without header, footer, etc. This is rather convenient if you want to \include the file in another document.

It is, of course, possible to write custom templates, which quite easy, as a template is just a LaTeX document with some $variables$. pandoc -D latex prints the default LaTeX template.

Related Question