joel-coffman / latex-incubator

LaTeX packages that don't have a stable API yet

LaTeX Incubator

LaTeX packages being developed start in this incubator until they reach sufficient maturity for a stable API.

Resources

Pakin, "How to Package Your LaTeX Package," September 2015

The LaTeX Project, "LaTeX2e for class and package writers," February 2006

latex-incubator's Issues

slides: Add overlay support to `beamercolorbox`

minted-doc: \minted@checkstyle removed in v2.6

Minted v2.6 removes \minted@checkstyle (see commit 5f42718 in the minted repository). Consequently, the minted-doc package no longer compiles due to its invocation of this macro.

make: Additional LaTeX runs necessary when using standalone

Content may be omitted when using the standalone package with the sort option:

Package standalone Warning: Sub-preamble of file '<path>' has changed.
Content will be ignored. Please rerun LaTeX!

This case is not handled by the default Makefile, which is why the content is missing. This issue was masked prior to #47, which tried to limit unnecessary LaTeX runs.

Include background in frame thumbnail for notes

Patch \insertslideintonotes so that the thumbnail includes the background, which is critical when the frame has a background image (and possibly minimal text).

Allow answer to fill remaining space on page

In some cases (e.g., essays), it is appropriate for an answer block to include all the remaining space on a page. Unfortunately, it isn't possible to simply use \vfill or its variants as the argument to height key of the answer environment.

The following expression does the trick: \dimexpr\pagegoal-\pagetotal-\baselineskip. It would be ideal to handle this case specifically, perhaps by supporting fill as the value of the height (or width) keys of the answer environment.

Relevant Stack Exchange question and answer: How to obtain the space left to bottom of page

Section titles aren't centered properly in resume

The section title is shifted slightly right of center as shown by the following minimal working example:

\documentclass[12pt]{article}

\usepackage{resume}


\begin{document}

\section{XXX}
\begin{center}
  yyy
\end{center}

\end{document}

Remove patch for beamer@outsideframenote

One patch for Beamer's notes command (commit 25fcb8f) has been partially upstreamed. Thus, this patch should be removed to avoid spurious warnings in the log file.

References josephwright/beamer#487

Support key-value options for question environment

The exam package should support key-value options for the question environment for extensibility. For example, a label could be specified similar to how Beamer allows setting the label for a frame.

For backward compatibility, points can still be assigned using pgfkeys's .unknown key handler.

Create package for business cards

A simple side-by-side card with a logo and personal information ought to be straightforward.

Use standard list environment for publications

Rather than defining a custom list environment (which matches a traditional bibliography), the resume package could simply use enumerate in conjunction with the enumitem package to format labels. Such an implementation would be much clearer and easier to maintain.

Overachieving Makefile

Makefile.tex runs pdflatex numerous times for a single make. Is there a way to have a "quick and dirty" make rule that only runs once, thus eliminating the longer, and often unnecessary, wait?

visualization: Add support for "jitter" in scatterplots

When plotting continuous and discrete data, many of the points on a scatterplot overlap, making it difficult to see individual data points. It would be ideal to add a "jitter" function for pgfplqts to offset the data points.

Stack Exchange:

• How to add a jitter to a scatter plot with pgfplots
• Gaussian random numbers

visualization: Add library for reading configuration file

Publications define labels multiple times in resume

The \publication macro in the resume package causes the bibliography labels to be multiply defined. For example,

LaTeX Warning: Label `coffman2019diversity' multiply defined.
LaTeX Warning: Label `coffman2014empirical' multiply defined.
LaTeX Warning: Label `cocoros2020evaluating' multiply defined.
...
LaTeX Warning: There were multiply-defined labels.

Although the resume package works correctly (e.g., the redefinition of the label is in the bibliography, which isn't included), there's no reason that such warnings should appear when using the package.

Use frame number in glossary entries for presentations

By default, the glossaries package uses the page number to index glossary entries. For (Beamer) presentations, the page number differs from the frame number when overlays are used, creating a discrepancy between the "page" and "frame" on which the entry appears.

Specify TeX configuration in texmf.cnf

To simplify the Makefile for LaTeX documents, LaTeX configuration can be put in a separate file. Doing so has the advantage of 1) making it easier to find configuration information and 2) providing greater consistency when make isn't used (for some reason).

Stack Exchange: texlive: Personal "texmf.cnf"

Investigate alternatives for the editing package

See what alternatives exist for the editing package in this repository -- e.g.,

• ed: Editorial notes for LaTeX documents
• FiXme: Collaborative annotation tool for LaTeX

Infer files to clean based on .gitignore patterns

Makefile.tex lists a variety of files that should be removed when executing make clean (or make mostlyclean) using the derivatives variable. Many, or possibly all, of these files are also explicitly excluded from version control by .gitignore patterns. Rather than repeating them, it might be advantageous to infer which files to remove based on the files ignored by Git.

Allow specification of background color for `imageframe` environment

Use standard bullets for itemize environment in resume

Are those the standard LaTeX bullets? Because they look small.

Create package to facilitate reproducible builds

Compiling documents with pdflatex is not reproducible -- i.e., compiling twice does not result in identical PDFs. Unfortunately, differing files make backups, etc. more difficult because a hash of the file isn't sufficient to determine if the content has changed.

Fortunately, pdfTeX versions since 1.40.17 (2016) have the ability to suppress the metadata that changes between different runs:

\pdfinfoomitdate=1  % omit the /CreationDate and /ModDate
\pdfsuppressptexinfo=1  % omit version info about pdfTeX
\pdftrailerid{}  % omit the trailer ID

See the pdfTeX user manual for more details.