summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/windycity/README.md
blob: a2ad25cd12792347db9891b2fdccdfece25007f0 (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
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
# Windy City

## About

Windy City is a style for [biblatex](http://www.ctan.org/pkg/biblatex
"biblatex") that formats notes, bibliographies, parenthetical
citations, and reference lists according to the 17th edition of [The
Chicago Manual of Style](http://www.chicagomanualofstyle.org/ "Chicago
Manual of Style"). It accurately handles a wide range of citations and
includes a set of options and commands to support special
circumstances. It also has extensive support for citing and arranging
different kinds of editors, translators, and compilers within a single
citation. These features make Windy City especially suitable for
academic work.

Windy City's latest release is available on
[CTAN](https://www.ctan.org/pkg/windycity "CTAN: pkg/windycity"), the
[Comprehensive TeX Archive Network](https://www.ctan.org "CTAN"). It
includes a PDF of the [user
guide](http://mirrors.ctan.org/macros/latex/contrib/biblatex-contrib/windycity/doc/windycity.pdf
"windycity.pdf"). More recent changes are available at Windy City's
[repository on GitHub](https://github.com/brianchase/windycity
"GitHub: brianchase/windycity").

## Getting Started

If you already know how to use
[biblatex](http://www.ctan.org/pkg/biblatex "biblatex"), getting
started with Windy City is easy. The first task is to confirm that
[biblatex](http://www.ctan.org/pkg/biblatex "biblatex") and Windy City
are installed properly on your system. Since both are included in some
distributions of [LaTeX](https://en.wikipedia.org/wiki/LaTeX "LaTeX"),
you might be able to skip this step.

Windy City consists of four files:

* [windycity.bbx](https://github.com/brianchase/windycity/blob/master/bbx/windycity.bbx "windycity.bbx")
* [windycity.cbx](https://github.com/brianchase/windycity/blob/master/cbx/windycity.cbx "windycity.cbx")
* [windycity.dbx](https://github.com/brianchase/windycity/blob/master/windycity.dbx "windycity.dbx")
* [american-windycity.lbx](https://github.com/brianchase/windycity/blob/master/lbx/american-windycity.lbx "american-windycity.lbx")

If you need to install Windy City on your system, you have several
options. For a one-off compilation, say, to give Windy City a trial
run on a single document, you could copy Windy City's files to the
document's root directory. Beyond that, your best option is to install
it in your local `texmf`. Copy the files to a directory of your
choosing, then update your `texmf` file name database.

To compile a document with Windy City, tell
[biblatex](http://www.ctan.org/pkg/biblatex "biblatex") to load it
with the load-time option `style`:

```
\usepackage[style=windycity]{biblatex}
```

Typically, this goes in a document's preamble or in one of its style
files.

For some entries in your bibliography database, you may need to add
fields or make other adjustments to get the right output. But since
Windy City relies as much as possible on standard `BibTeX` fields, and
secondarily on [biblatex](http://www.ctan.org/pkg/biblatex "biblatex")
fields, you may not need to make major changes. The examples in this
document and its accompanying bibliography database,
[windycity.bib](https://github.com/brianchase/windycity/blob/master/doc/windycity.bib
"windycity.bib"), should serve as a guide for how to manage your input
for nearly every circumstance that the style is meant to handle.

## License

Under the terms of the [LaTeX Project Public
License](http://www.latex-project.org/lppl.txt "lppl.txt"), version
1.3, permission is granted to copy, distribute, or modify this
software. See also <https://www.latex-project.org/lppl/>.

This software is provided as is, without warranty of any kind, either
expressed or implied, including, but not limited to, the implied
warranties of merchantability and fitness for a particular purpose.

## Requirements

* [biblatex](http://www.ctan.org/pkg/biblatex "biblatex") 3.13 or later