joel-coffman / latex-usafa.edu Goto Github PK

Many packages have additional dependencies that should be packaged with the distribution archive. For example, the usafa.edu Beamer theme uses the falcon color theme and the logo outer theme, but the relevant files are not currently included in the distribution archive, which is particularly problematic for the logo outer theme because it's developed in a separate repository. Thus, all the ancillary packages that aren't publicly available from CTAN should be bundled in the distribution archives.

The distcheck goal should be modified to verify that each package can be created using only the files in its distribution archive, similar to what's done for the promotion template (#32).

Current issues:

• #61
• #69
• #60
• #71

A diverging stacked bar chart is the best way to visualize responses to questions that use a Likert scale. Unfortunately, a diverging stacked bar chart does not facilitate a direct comparison of the central tendency. For example, does an increase in the number of respondents who "strong agree" outweigh an increase in the number of respondents who "slightly disagree"? A way to combine these different perspectives is needed for course evaluations, as a simple bar chart with error bars has obvious limitations.

The LaTeXgit package supports fetching information from Git and typesetting it. This package could be used instead of creating the version identifier in the Makefile and writing it to a separate file.

Use the visualization package (latex-incubator) for consistent styling of data visualizations.

Create a standardized report for course evaluations (example) that standardizes report elements (e.g., bar graphs).

Create a package for graded reviews, particularly the cover page with the academic security policy, authorized resources, and version identifier.

When multiple versions of a graded review (GR) are required, it would be ideal to infer the version from the filename. The following code uses the currfile package to do exactly that:

\let\oldversion=\version\relax

\renewcommand*{\version}[1][\currfilebase\ (revision~\oldversion)]{%
  \def\initial##1{%
    \textbf{\MakeUppercase{##1}}%
  }%
  \expandafter\initial#1%
}

This code assumes that files are named using the NATO phonetic alphabet (alfa, bravo, charlie, etc.). The first letter is automatically capitalized and uses a bold font weight -- e.g., "Alfa" or "Bravo" followed by the Git commit hash.

Inferring the version from the filename leaves less for the user to do when using this package and eliminates the possibility that the user might forget to update the information in the document when creating a new version (typically by copying an existing one).

The following example is not handled correctly by the supplements package:

\supplement[
  options={
    pagecommand={
      \begin{tikzpicture}[
          remember picture,
          overlay,
      ]
        \node at (current page.center) {DRAFT};
      \end{tikzpicture}
    },
  }
]{path}{title}

The issue is caused by expansion of the various macros, specifically their expansion prior to the actual invocation of \includepdf.