Usage

Building Documents

pygacity build is the main way pygacity is used. In general, standard use involves two major tasks:

1. Creating a configuration file describing the document to be built and how to build it.

2. Running the pygacity build command with the configuration file as input.

• Input Configuration Files
  • document Section
  • build Section
• Document Compilation
  • --bundle-size and --two-sided

Generating Pygacity-Compatible LaTeX Code

The majority of work in creating a document with pygacity is in creating pygacity-compatible LaTeX code for problems, exercises, and other types of document content. The following sections provide guidance on these tasks.

• Writing LaTeX/Pythontex Problems
• Python Resources Available in Pygacity
  • Default pythontex resources: setup and teardown
  • Custom resources
• Short-Answer/Multiple-Choice/Fill-in-the-Blank/True-False Questions
  • Referencing short.tex from a Config
  • The Question-Pool YAML File
  • Question Types in Detail
  • Shuffling and Reproducibility
  • Answer Registration
  • Complete Examples

Other Subcommands

pygacity also has three other subcommands:

• Building a Single-Problem Document
• Creating Bundled PDFs
  • Options
  • Output
• Distributing Exams to Students
  • Required Arguments
  • Optional Arguments
  • How It Works
  • Examples