アップグレード
アップグレード
バージョンごとの変更と、データ更新の扱い。
2.5.0から2.7.0へ
呼び出し側で変わるものはなく、2.5.0にあったものはすべて残っています。新しく加わったのは、どれも専用のエントリポイントにあり、呼ぶまで何も取得しないものです。@johnmorrisdotca/jisho/entriesのloadEntry、readEntry、referenceOf(単語の完全な項目)、@johnmorrisdotca/jisho/examplesのloadExamples、exampleCredit、furiganaOfExample(単語の例文)、@johnmorrisdotca/jisho/strokesのloadStrokes、loadAllStrokes、strokesOf、strokeOrderSvg、pathPoints、findByDrawing(筆順と、描いて漢字を探す)、そしてwordsのsuggestWordsです。Wordには、JMdictがその項目に付けた番号idが加わり、どの行にもそれが付いています。そのため行のチャンクは、294個から同じ大きさの318個になり、wordsエントリを1つのバンドルにしたときのgzipの大きさは1 MB増えました。パッケージのダウンロードは14.8 MB増え(13.8 MBから28.6 MB)、すべて新しいエントリポイントの分です。そのデータ(項目、例文、筆順)にはそれぞれのライセンスがあります。NOTICE.mdに書いてあり、例文や筆順を表示するページは出典を示す必要があります。
2.3.0から2.4.0へ
呼び出し側で変わるものはありません。新しく加わったのは、readText、studyList、studyListText、furiganaOf、furiganaOfSurface(テキストを読み、単語、ふりがな、意味、レベル、学習リストを得る)です。InflectedWordには、引いたときの辞書形を表すformが加わりました。バンドラーがすべてのチャンクをたどる場合、wordsのエントリはgzip圧縮後で約17 kB大きくなります(リーダー本体と、漢字の学年とJLPTの表(14 kB)。表はreadTextを呼んだときだけ取得されます)。
2.2.0から2.3.0へ
呼び出し側で変わるものはありません。新しく加わったのは、findInflected、inflectedOf、loadWordsのinflectedオプション(活用した文字列を、道すじ付きで辞書形から見つける)と、deinflect(単独のエントリポイント@johnmorrisdotca/jisho/deinflectでも使えます)です。Wordのkindsに、な形容詞(静か)を表すnが入ることがあります。これまで空だった語にnが付くので、空のkindsを「動詞でもい形容詞でもない」と読んでいたコードは、nも許してください。規則のぶん、パッケージは約2 kB(gzip圧縮後)大きくなります。データは同じJMdictですが、チャンクの区切り位置が少し変わりました。Hikidashiを使う方法は不要になり、Hikidashiは開発用の依存先でもなくなりました。
2.0.0から2.1.0へ
呼び出し側で変わるものはなく、2.0.0にあったものはすべて残っています。Wordにrankとpriorityの二つのフィールドが増え、文字列は引く前に整えられるようになりました(カミや余分な空白、見えない文字でもカミと同じ単語が見つかります)。そのため、そうした文字列で例外が出たり何も見つからなかったりした検索でも、単語が見つかるようになります。取得できないチャンクは、これまではバンドラーやブラウザーが投げたエラーで拒否されていましたが、WordsLoadErrorで拒否されるようになりました。新しく加わったのは、findByMeaning、wordsWithKanji、kanjiOfWord、searchMeanings、romajiToKana、kanaFromRomaji、normalizeText、commonestFirst、priorityTags、rankOfTagsとromajiオプションです。新しい索引のために、ダウンロードするパッケージは3.7 MB大きくなります(10.2 MBから13.9 MB)。索引を取得するのは新しい検索だけです。
2.0.0より前
forChildrenはmodeになりました。変更履歴を参照してください。
データの更新
EDRDGは、そのファイルを使うパッケージに最新の状態を保つよう求めています。そのためKANJIDIC2とJMdictをそれぞれ毎月取得し、変更があればパッチリリースにします。読み、意味、単語はパッチで変わることがあり、JMdictが単語を加えたり外したりすれば、そのとおりに反映されます。学年、レベル、組のスコアの元になるファイルは、めったに変わりません。
この日本語は、まだ日本語を母語とする方の確認を受けていません。訂正を歓迎します。