## Timewarrior Holiday Files

The holidays files were created manually for now. The data delivered from
holidata.net for Germany is nearly complete, but it lacks some states and has
some formal issues. I have handed in this to the holdata.net devs, and as soon
as they have fixed that I will switch to using the refresh script.

They contain following files (example):

- **2018/de/holidays.de-DE:** Holidays which apply to all of Germany for 2018
- **2018/de/holidays.de-XX:** Holidays for German state XX (XX=ISO-3166-2 code for the
				respective states). Said code will be displayed in the output.
- **2018/vacation-2018:** Sample vacation file. As timewarrior only knows the
				holiday definition and this is pretty sufficient (holidays
				only are an auxiliary display anyway), we will mark them as
				"VAC" and are done with it.

### refresh script

Since the refresh script included in the holidays plugin is not working, I'm
creating my own. I'm not a python zen guru, so this is rather slow development.
However, the current state is the following:

* You can pass on the desired locale (e.g. de-DE) and the desired year to the
script (call it with --help to see details). It will then create files for all
of the regions and the country's allover holidays.
* --region is not functional yet, this will be included soon.
* If you don't supply --locale, for now it will draw de-DE by default. In
future versions it will work like the original script, i.e. refresh all
existing files (this will come after the implementation of --region as that is
a prerequisite).

### ISO-3166-2 codes

The following tables are just explanatives - if you know your ISO-3166, you can
ignore this.

#### Germany

|  ISO  | State                           |
| :---: | ------------------------------- |
| de-BB | Brandenburg                     |
| de-BE | Berlin                          |
| de-BW | Baden-Württemberg               |
| de-BY | Bavaria                         |
| de-DE | Pseudocode: in all of Germany   |
| de-HB | Bremen                          |
| de-HE | Hesse                           |
| de-HH | Hamburg                         |
| de-MV | Mecklenburg - Western Pomerania |
| de-NI | Lower Saxony                    |
| de-NW | North Rine - Westphalia         |
| de-RP | Rhineland-Palatinate            |
| de-SH | Schleswig-Holstein              |
| de-SL | Saarland                        |
| de-SN | Saxony                          |
| de-ST | Saxony-Anhalt                   |
| de-TH | Thuringia                       |

#### Austria

The official ISO-3166 codes are just AT-1 through AT-9, in alphabetical order
of the states. So in this case, we use pseudo codes to make it easier for
timewarrior users to identify their state.

| Code  | State                  | ISO  |
| :---: | ---------------------- | ---- |
| at-AT | Pseudo: all of Austria | ---- |
| at-BL | Burgenland             | AT-1 |
| at-KT | Carinthia (Kärnten)    | AT-2 |
| at-NO | Lower Austria          | AT-3 |
| at-OO | Upper Austria          | AT-4 |
| at-SZ | Salzburg               | AT-5 |
| at-ST | Styria (Steiermark)    | AT-6 |
| at-TI | Tyrol                  | AT-7 |
| at-VA | Vorarlberg             | AT-8 |
| at-WI | Vienna (Wien)          | AT-9 |

#### Switzerland

|  ISO  | State                      |
| :---: | -------------------------- |
| ch-AG | Aargau                     |
| ch-AI | Appenzell Innerrhoden      |
| ch-AR | Appenzell Ausserrhoden     |
| ch-BL | Basel-Landschaft           |
| ch-BS | Basel-Stadt                |
| ch-BE | Bern                       |
| ch-CH | Pseudo: all of Switzerland |
| ch-FR | Freiburg (Fribourg)        |
| ch-GE | Genf (Génève)              |
| ch-GL | Glarus                     |
| ch-GR | Graubünden                 |
| ch-JU | Jura                       |
| ch-LU | Luzern (Lucerne)           |
| ch-NE | Neuenburg (Neuchâtel)      |
| ch-NW | Nidwalden                  |
| ch-OW | Obwalden                   |
| ch-SH | Schaffhausen               |
| ch-SZ | Schwyz                     |
| ch-SO | Solothurn                  |
| ch-SG | St. Gallen                 |
| ch-TI | Tessin (Ticino)            |
| ch-TG | Thurgau                    |
| ch-UR | Uri                        |
| ch-VD | Waadt                      |
| ch-VS | Wallis (Vallese)           |
| ch-ZG | Zug                        |
| ch-ZH | Zürich (Zurigo)            |