# Santoka

> _arukeba kimpouge suwareba kimpouge_  
> if i walk the buttercups if i sit the buttercups

Translations of 668 of [Taneda Santōka](https://en.wikipedia.org/wiki/Sant%C5%8Dka_Taneda)'s free-verse haiku, including excellent translations by [Hiroaki Satō](<https://en.wikipedia.org/wiki/Hiroaki_Sato_(translator)>), [Scott Watson](https://www.instagram.com/swbotl), and [Cid Corman](https://en.wikipedia.org/wiki/Cid_Corman).

Available as JSON for easy parsing, or in the [Leaflet.md]() format for viewing in Markdown-friendly apps like [Obsidian](https://obsidian.md/).

You can explore the poems in the dataset at [lucaaurelia.com/santoka](https://lucaaurelia.com/santoka).

## Source

Many of these poems were originally compiled and digitized by Gábor Terebess for [Terebess Asia Online](https://terebess.hu/english/haiku/taneda.html). I've added metadata like publication URLs and converted to a structured format for easy parsing.

## Poems

See `./poems.json`. Poems are in this format:

```json
{
  "id": 68,
  "publicationId": 3,
  "englishText": "Absolutely no cloud I take off my hat",
  "japaneseText": "Mattaku kumo ga nai kasa o nugi"
}
```

The `japaneseText` field is missing for some poems, and can contain either romaji or kana/kanji.

## Publications

See `./publications.json`. Publications are in this format:

```json
{
  "id": 12,
  "name": "Santôka",
  "translatorIds": [11, 16],
  "year": 2006,
  "description": "Santôka: A Translation with Photographic Images. Photographs by Hakudô Inoue; book and cover design by Kazuya Takaoka; English text by Emiko Miyashita and Paul Watsky. (PIE Books, Tokyo, 2006). 400 pages",
  "url": "https://thehaikufoundation.org/omeka/items/show/2643",
  "lucaRanking": 5
}
```

| Field           | Description                                                                                                                                                                                                               |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `name`          | This is my best attempt to identify a single name for the publication, but it's occasionally a judgment call since the data includes personal web pages and other informal sources.                                       |
| `translatorIds` | This is an array since sometimes publications have multiple people working on the English text, like in the example above. Publications with one translator (most of them) use a one-element array: `translatorIds: [8]`. |
| `year`          | This is either a number, or `null` if I couldn't determine a publication year.                                                                                                                                            |
| `description`   | This is a free-form text description of the publication.                                                                                                                                                                  |
| `url`           | A somewhat authoritative URL for the publication, when I could find it. `null` if I couldn't.                                                                                                                             |
| `lucaRanking`   | This is a subjective ranking based on where I want the publication to show up on [lucaaurelia.com/santoka](https://lucaaurelia.com/santoka).                                                                              |

## Translators

See `./translators.json`. Translators are in this format:

```json
{
  "id": 10,
  "name": "Scott Watson"
}
```

## Installation

If you're using Rust, you can install this dataset from [crates.io]().

```bash
cargo add santoka
```

## Example usage

Parsing JSON is straightforward in most languages. Here's a JavaScript example:

```javascript
import fs from "fs";

const poemsJson = fs.readFileSync("./santoka/poems.json");
const poems = JSON.parse(poemsJson);
console.log(poems);
```

If you're using Rust, the `santoka` crate takes care of parsing for you:

```rust
fn main() {
    let dataset = santoka::Dataset::new();

    for poem in &dataset.poems {
        dbg!(&poem);

        let publication = dataset.publication(poem.publication_id);
        dbg!(&publication);

        let translators = dataset.translators(publication.translator_ids);
        dbg!(&translators);
    }
}
```