From d1ed2df95b61ff6d1600296b28a5f3db16190981 Mon Sep 17 00:00:00 2001 From: Holden Rohrer Date: Wed, 14 Aug 2019 16:16:00 -0400 Subject: updated main README --- README.md | 20 +++++++++++++++----- 1 file changed, 15 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 1bc05aa..d27c46b 100644 --- a/README.md +++ b/README.md @@ -4,13 +4,23 @@ This repository is designed to organize and make portable all of Holden Rohrer's ``` - 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 -- .gitignore % exactly what you expect - 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 - |- zinsser-annotation.tex % annotations of "On Writing Well" by William Zinnser - |- zinsser-essay.rough.tex% rough draft of "On Writing Well" essay - |- zinsser-esssay.tex % final draft of "On Writing Well" essay +-|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. -- cgit