https://github.com/vitto4/minnanods
Lightly-opinionated compendium of vocabulary from Minna no Nihongo Shokyū I & II books.
https://github.com/vitto4/minnanods
japanese-language japanese-study language-learning minna-no-nihongo vocabulary-lists yaml
Last synced: 8 days ago
JSON representation
Lightly-opinionated compendium of vocabulary from Minna no Nihongo Shokyū I & II books.
- Host: GitHub
- URL: https://github.com/vitto4/minnanods
- Owner: vitto4
- Created: 2024-11-28T17:54:32.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-05T17:32:55.000Z (over 1 year ago)
- Last Synced: 2025-03-02T17:12:26.397Z (over 1 year ago)
- Topics: japanese-language, japanese-study, language-learning, minna-no-nihongo, vocabulary-lists, yaml
- Homepage:
- Size: 549 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# MinnaNoDS
All of the vocabulary from your Minna no Nihongo Shokyū Ⅰ & Ⅱ textbooks formulated into a tiny little YAML file.
```yaml
- id: [2, 10]
edition: [1, 2]
kanji: "新聞"
kana: "しんぶん"
romaji: "shinbun"
meaning: {
en: "newspaper",
fr: "journal",
}
```
Figure – A word straight from the dataset. More information on the format this way.
## 🧭 Table of contents
1. [Overview](#-overview)
1. [Usage](#️-usage)
1. [Bibliography](#-bibliography)
1. [Conventions](#-conventions)
1. [Notes](#-notes)
1. [Warning](#-warning)
## ☁ Overview
This project aims to serve as a comprehensive vocabulary list for the [`Minna no Nihongo Shokyū`](https://www.3anet.co.jp/np/en/list.html?af=1&g=7-12-33&s=1 "みんなの日本語 初級 Ⅰ & Ⅱ") series, packaged into a single YAML file – which we'll refer to as *the dataset*.
To be more specific, it intends to be as close as possible to the source material, in an effort to (hopefully) provide a foundation anyone can use or expand on.
The dataset currently targets two languages for `meaning` :
```yaml
languages:
en: "English"
fr: "Français"
```
Further information here.
**Rōmaji** are provided solely for convenience, and do not correspond to those of the [*rōmaji edition*](https://www.3anet.co.jp/np/en/books/2303/ "みんなの日本語 初級 ローマ字版") of the books.
These were generated using a mix of [`pykakasi`](https://pypi.org/project/pykakasi/) and readings supplied by [Google Translate](https://translate.google.com/). As a result, they more or less follow standards set by the [*Modified Hepburn*](https://en.wikipedia.org/wiki/Hepburn_romanization#Variants) system (yes, mācrōns inclūdēd !).
## ⚙️ Usage
Here is a basic example in [`python`](https://www.python.org/).
```py
import yaml
# Load the dataset
with open("minna-no-ds.yaml", "r", encoding="utf-8") as f:
ds = yaml.load(f, Loader=yaml.FullLoader)
# Extract the keys for all available lessons
lessons: list = [lesson["key"] for lesson in ds["lessons"]] # ['lesson-01', 'lesson-02', ...]
# Go through each lesson and print out its contents
for key in lessons:
print(f"Contents of {key}") # Outputs : Contents of lesson-01
print(ds[key]) # Outputs : [{'id': [1, 1], 'edition': [1, 2], 'kanji': None, 'kana': 'わたし', 'romaji': 'watashi', 'meaning': {'en': 'I', 'fr': 'je, moi'}}, ...]
```
## 📚 Bibliography
As you may know, `Minna no Nihongo Shokyū` comes in two books of twenty-five lessons each ; both available in two editions (the second of which is an updated version of the original).
Presented bellow is a table showing the books used in the making of the dataset.
| 📗📘📙 | First Edition | Second Edition |
|:-----:|:-------------:|:--------------:|
| **Book 1**
*English Version* | みんなの日本語初級Ⅰ 翻訳・文法解説英語版
[`ISBN : 9784883191079`](https://web.archive.org/web/20040820203739/http://www.3anet.co.jp/english/text_e_m_trans.html) | みんなの日本語初級Ⅰ 第２版 翻訳・文法解説 英語版
[`ISBN : 9784883196043`](https://www.3anet.co.jp/np/en/books/2302/) |
| **Book 2**
*English Version* | みんなの日本語初級Ⅱ 翻訳・文法解説英語版
[`ISBN : 9784883191086`](https://web.archive.org/web/20040820203739/http://www.3anet.co.jp/english/text_e_m_trans.html) | みんなの日本語初級Ⅱ 第２版 翻訳・文法解説 英語版
[`ISBN : 9784883196647`](https://www.3anet.co.jp/np/en/books/2402/) |
| **Book 1**
*French Version* | みんなの日本語初級Ⅰ 翻訳・文法解説フランス語版
[`ISBN : 9784883191338`](https://web.archive.org/web/20040820203739/http://www.3anet.co.jp/english/text_e_m_trans.html)| みんなの日本語初級Ⅰ 第２版 翻訳・文法解説 フランス語版
[`ISBN : 9784883196456`](https://www.3anet.co.jp/np/en/books/2312/) |
| **Book 2**
*French Version* | みんなの日本語初級Ⅱ 翻訳・文法解説フランス語版
[`ISBN : 9784883191383`](https://web.archive.org/web/20040820203739/http://www.3anet.co.jp/english/text_e_m_trans.html) | みんなの日本語初級Ⅱ 第２版 翻訳・文法解説 フランス語版
[`ISBN : 9784883197057`](https://www.3anet.co.jp/np/en/books/2412/) |
## 🚦 Conventions
What I call a *convention* is any rule I set while creating the dataset that is not directly derived from the source material.
See
CONVENTIONS.md
This file also includes general information about the structure of the dataset.
## 🔖 Notes
- When starting out with this project, I used [Paul Denisowski's vocabulary lists](http://www.denisowski.org/Japanese/Japanese.html) to generate a blank template for me to fill in. Serious time-saver right there !
- As strings in `romaji` do not need to be spellchecked, you may use the following config with [`CSpell`](https://cspell.org/).
```json
"cSpell.ignoreRegExpList": [
"/romaji:\\s*\"[^\"]*\"/gi"
]
```
- This project should have shipped with the set of scripts I used to lint and validate the dataset.
It didn't, but who knows, I may get to it when (if) I stop being obsessed with that one space dwarves simulator ¯\\\_(ツ)_/¯
- Adding or removing a word will alter the `id` of all subsequent words in the same lesson.
Therefore, any time this has to be done, the version number will have to be bumped to the next major release as this could be considered breaking change for anyone using `id` as a [primary key](## "Which it intends to be, when it is in fact more of something I believed to be called a `natural key` and may thus be unstable.").
- « This must have taken quite the amount of time to make » well you don't say ! (笑)
Though I think I'm happy with how it turned out c:
- ~~I haven't yet managed to get my hands on a French version of the first edition of book 1, so words found exclusively in `Book 1, edition 1` have no French `meaning` for now~~ — fixed as of [v1.1.0](https://github.com/vitto4/MinnaNoDS/releases/tag/v1.1.0).
## 🚧 Warning
```yaml
# * The selection of words and their respective translations are the sole property of 3A Corporation.
# This dataset and subsequent projects that depend on it shall only be used *in conjunction with* – and not *as a substitute for* – the books ; so as to not cause any financial harm to the IP owners.
# * As per previous remarks, no commercial use of this file shall be admissible.
```
More here.
The lack of license is deliberate, as I am uncertain about the appropriate licensing options for this project.
Content isn't mine, only the dataset structure and the actual work of filling it in.
If you know a suitable option, feel free to open an issue !
Hopefully that doesn't stop anyone from using the dataset though.