Koyomi Calendars ドキュメント

Koyomi Calendars 暦 — calendar-page icons as SVG

カレンダーのページをSVGで描きます。1日を18種類のアイコンで、1か月をポスターや卓上カレンダーで、そして日めくりも使えます。

インストール

npm install @johnmorrisdotca/koyomi-calendars

最初に読む

• はじめに最初のカレンダーアイコン、月間カレンダー、ページめくりを、依存なし・追加のビルドなしで、数分で描いてみます。

エントリーポイント

ガイド

やり方

• アイコンとデザイン18種類のカレンダーデザイン、名前による選び方、今も使える古い名前、calendarIconのすべてのオプションを説明します。
• 枠・リング・傾きアイコンを円盤の上に載せる、スパイラルリングで綴じる、少し傾ける、そしてそれらをまとめた5つの名前付きプリセットを説明します。
• 月間カレンダー1か月分を、ポスター、メモボード、壁掛け、卓上パッドで描きます。週の始まり、自分のメモ、データとしての日付の表も扱えます。
• ページをめくるアイコンを次の日、または前の日へ4種類の方法でめくります。日付の補助関数、動きの軽減、flipCalendarのオプションを説明します。
• 日本の暦日本の祝日、旧暦、六曜を、表から引かずに計算します。日めくりのページに表示することも、ふつうの関数として使うこともできます。
• 言語とロケールブラウザーやNodeが知っている任意の言語での月と曜日の名前、日本語・中国語・韓国語での順序の違い、未知のロケールのときの動作を説明します。
• フレームワークとサーバーアイコンや月間カレンダーを、ふつうのHTML、React、Vue、Svelte、Angularに入れ、サーバーやファイルで描き、コンポーネントからめくります。
• ふつうのHTMLとCDNビルドなしでページにアイコンを描きます。jsDelivrやunpkgから読み込み、デザインを1つだけ読み込み、ボタンでページをめくります。
• ViteとwebpackViteやwebpackのプロジェクトでこのパッケージを使い、デザインを1つだけ読み込んでバンドルを小さく保ち、バンドルに何が入ったかを確かめます。
• iframeで埋め込むiframe 1つ、スクリプトなしで、カレンダーアイコンや月間カレンダーをどのページにも置き、何を出すかはアドレスで決めます。
• TypeScriptとNodeパッケージの型を使い、サーバーやビルドスクリプトでアイコンと月間カレンダーを描き、ファイルに書き出します。

解説

• サイズとバンドル各インポートがページに与える重さ、デザイン1つだけをインポートする方法、ほかが付いてこない理由、CIが守るバイトの予算を説明します。
• アクセシビリティとテーマ各アイコンと月間カレンダーがスクリーンリーダーに伝えること、ライトとダークの扱い、動きの軽減の働き、絵の中で変えられるものを説明します。
• アーキテクチャパッケージが小さなインポートにどう分かれているか、デザインとは何か、絵がどう作られるか、出力、サイズ、独自性を守る決まりを説明します。

困ったとき・よくある質問

• 困ったとき・よくある質問RangeError、曜日や列が空、リングが出ない、めくりが動かない、ロケールが英語になるなど、うまくいかないときの対処と、よくある質問です。

アップグレード

• アップグレード各バージョンで対応が必要な変更、meigen-sportsのカレンダーアイコンからの移行、今も使える名前をまとめます。

• 変更履歴@johnmorrisdotca/koyomi-calendars 0.3.0 のソースから作成しました。
• すべてのエクスポートを1ページでapi.html
• 言語モデル向けのドキュメントllms.txt · llms-full.txt

この日本語は、まだ日本語を母語とする方の確認を受けていません。訂正を歓迎します。