aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: d27c46b7e55928e8fb061b59c4146a65e97e6ca7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# school

This repository is designed to organize and make portable all of Holden Rohrer's school work from the 2019-20 school year.

```
- README.md                % the file you're reading right now
- .gitignore               % exactly what you expect
- mla8.tex                 % a general mla formatter for typical written assignments
- citations.tex            % a citation generator and aggregator for MLA 8th Edition
- sort.py                  % a Python script which sorts sort.tex when called
- example.tex              % an example of the capability of mla8.tex
-|jones-la                 % all work for AP Lang, taught by Ms Jones; see internal README for more info
-|wroblewski-world         % all work for AP World, taught by Mr Wroblewski; see internal README for more info
```

## Compilation

To compile files, run `pdftex --shell-escape /dir/to/file` from this directory.

## MLA8 Formatting Usage

Because files are called from this directory, the relative path is `mla8.tex`, which should be included in TeX documents with `\\input mla8.tex` (this method is used to allow `mla8.tex` to call `citations.tex`).

In-document, mla8.tex provides a few facilities: fonts (`\\large` makes text 14pt, `\\it` italicizes text, `\\bf` bolds text; default 12pt roman Times New Roman), a running page-numbered header which can be enabled on the first page with `\\numberfirstpage`, blockquotes (`\\blockquote{Long quote}`), titles (`\\title{Title}``),and document headers (`\\name{Forename}\\last{Surname}\\teacher{Teacher}\\clas{Class}\\header`, with an optional `\\date{12 July 2019}` to use a different date than today; internal registers like `\\day` can also be set as numbers).

`citations.tex` provides `\\cite`, which has internal sub-commands: `\name{Author Last name for inline citation}{Author Full Name (e.g. Zinsser, William) for citation at end}`, `\\title{Chapter/Paper Title}`, `\\contain{Book or Journal Title}` (note that `\\title` should not be used with full books for citation structure), `\\version` for book version if notable, `\\relnums` for journal issue or volume number, `\\publish` for the publisher, `\\pubdate` for the date of publication, `\\locator` for the page numbers (if chapter) or web address, and `\\pagenum` for inline citation. Internal options are `\\nameinline` which includes the name in the inline citation (or title if no author) and `\\newcitation` to prevent double citing in the final. Python scripts alphabetize the citations.