Repeto ドキュメント
ドキュメントを見る

ノートタイプとテンプレート

条件付きフィールドや Cloze 削除を含む、再利用可能なフィールドとカード設計を定義します。

ノートタイプは、順序付きフィールド一覧と一つ以上のカードテンプレートを定義します。タイプはコレクションに属するため、異なるデッキのノートでも利用できます。デッキ固有の設定ではありません。

Repeto には翻訳、概念、Q&A、Cloze に加え、Basic (and reversed card)Basic (optional reversed card)Basic (type in the answer) と、完全な自社 Image Occlusion フローが用意されています。設定 → ノートタイプでは独自タイプを作成、複製、プレビュー、編集できます。

ノートタイプを管理する

設定 → ノートタイプでコレクション全体の管理画面を開きます。組み込み/独自タイプ、フィールド/テンプレート数を表示し、作成、定義編集、複製、フィールド・テンプレート・CSS の Markdown コピーができます。組み込みタイプは削除できません。未使用の独自タイプは確認後に削除できますが、使用中ならノートの変換または削除まで保持されます。

全画面エディターではフィールドとテンプレートの順序が明示されます。標準/Cloze タイプでは追加、改名、並べ替え、削除、表裏と共有 CSS の編集、サンプル値による隔離ライブプレビューができます。Image Occlusion の必須フィールド順とテンプレート一覧は固定され、マスクはデッキの専用エディターで作ります。

末尾への追加は安全です。既存要素の改名、移動、削除は位置による同一性を変えるため、エディターが構造警告を出し、使用中ノートがある危険な変更をサーバーが拒否します。明示的なノート変換を使ってください。

表面と裏面のテンプレート

各カードテンプレートには表面と裏面があります。フィールド名を二重の波括弧で囲んで挿入します。

<!-- Front -->
{{Term}}

<!-- Back -->
{{FrontSide}}<hr>{{Translation}}

{{FrontSide}} はレンダリング済みの表面を裏面に配置します。置換部分の周囲にある通常の HTML は、そのテンプレートから生成したすべてのカードに表示されます。

現在、Repeto は次の実用的な構文に対応しています。

  • {{Field}}:大文字と小文字を区別せずフィールドを置換する。
  • {{FrontSide}}:裏面に表面を表示する。
  • {{#Field}}…{{/Field}}:フィールドが空でない場合に表示する。
  • {{^Field}}…{{/Field}}:フィールドが空の場合に表示する。
  • {{text:Field}}:HTML を取り除く。
  • {{cloze:Field}}:Cloze をレンダリングする。
  • {{Tags}}{{Deck}}{{Type}}{{Card}}:メタデータを表示する。

不明なフィルターは現在、元のフィールド値にフォールバックします。デスクトップ専用フィルターが同じ動作をすると想定せず、インポートまたは独自作成したテンプレートは必ずプレビューしてください。

Web カードの MathJax

Web レンダラーは、\(...\) で囲まれた Anki 形式のインライン MathJax と、\[...\] で囲まれた表示用 MathJax を認識します。レンダラーはローカルに同梱され、サイズを制限して無害化した SVG を生成し、リモートのスクリプトやパッケージを読み込みません。レンダリングに失敗した場合は、式が消えるのではなく元のまま表示されます。

ドル記号の区切り($...$$$...$$)、[latex] ブロック、デスクトップ版の LaTeX 画像生成、リモートの MathJax パッケージ、テンプレートスクリプトには対応していません。ネイティブクライアントは、まだこの Web 版 MathJax 機能を共有していません。

任意の内容

条件付きセクションを使うと、値がないラベルをカードから除けます。

{{#Example}}
  <p class="example">{{Example}}</p>
{{/Example}}

代替表示には反転セクションを使います。

{{^Example}}
  <p>No example yet.</p>
{{/Example}}

複数テンプレートと逆方向カード

一つのノートから別方向の問題も作る場合はテンプレートを追加します。この関係は一時的な重複ノートではなく、ノートタイプで定義してください。テンプレート順は兄弟カードを識別するカード序数になります。

Repeto は対応するデッキプロファイル向けに逆方向の練習も生成できます。ただし両方向が科目モデルの一部なら、複数テンプレートを持つ再利用可能なノートタイプがより堅牢な基礎です。

答えを入力する

表面に {{type:Field}} を置くと入力回答を求めます。レビュアーはアクセシブルな入力欄へフォーカスし、正解、文字単位の比較、一致率を表示します。{{type:nc:Field}} はダイアクリティカルマークを無視し、入力 Cloze は現在の穴を対象にします。

比較が「もう一度・難しい・普通・簡単」を自動選択することはありません。自分で評価します。

Cloze 削除

Cloze ノートは、長い文の一部を隠します。

The hippocampus is important for {{c1::episodic memory}}.

c1c2 以降の番号を使うと、一つのノートから別々の Cloze カードを作れます。Cloze フィールドが変わると Repeto がカード序数を調整するため、削除箇所の追加や削除によって兄弟カード一式も更新されます。

スタイルと安全性

各ノートタイプには CSS を含められます。Repeto はテンプレート HTML を隔離されたプレビュー/レビュアー領域でレンダリングし、挿入前に無害化します。スタイルはタイポグラフィ、余白、色、メディアサイズなどカード内に限定し、スクリプトやアプリ全体のセレクターには依存しないでください。

編集後は、任意フィールドが空のノート、長い文章、画像、ライト/ダークテーマを代表例としてプレビューします。インポートしたテンプレートは テンプレートの色を保持 をオンとオフの両方で確認してください。

保存前に Repeto は構造、未知/予約フィールド、空または重複した表面、Cloze 要件、未対応フィルター、危険な HTML/CSS を検査します。エラーは保存を止め、警告は表示します。

現在の定義の検査が終わっていない場合や診断を利用できない場合、未検査の定義を通さず保存を待機します。

既存ノートを別のタイプへ変換する

カードブラウザをノートモードで開き、同じ標準タイプのノートを選び、ノートタイプを変更を選びます。各対象フィールドに元フィールドを、各既存兄弟カードに最大1つの対象テンプレートまたは削除を割り当てます。少なくとも1フィールドと1カードが必要です。割り当てたカードは ID、デッキ、予定、履歴を保持し、新しい兄弟は新規予定で始まります。

変更をプレビューは保持予定、新規/廃止兄弟、未割り当ての非空値、空の表面を報告します。割り当て変更でプレビューは失効します。確定では指紋を送り、破棄値、空表面、廃止カード ID を個別かつ正確に確認します。プレビュー後にノートが変われば古い指紋が変換を拒否します。

Cloze と Image Occlusion は専用規則ができるまで変換元/先にできません。使用中タイプ内の任意フィールド移行、自動空カード整理、クライアント間で安定したフィールド/テンプレート ID も未対応です。

空カードを見つけて削除する

設定 → ノートタイプ → 空カードを開くと、表面が空でレンダリングされるカード、削除したテンプレートが残したカード、重複したテンプレート ID、孤立したノート/タイプ記録を標準ノートタイプから検索できます。正確な候補を確認し、削除するカードだけを選び、フィンガープリント付きプレビューを確定してください。古くなったプレビューは拒否されます。

整理処理は、通常の同期対象となる削除記録を作成します。スケジュールと復習履歴の行は暗黙に消去されず、整合性と監査のために利用可能なままです。この検索は手動であり、内容から生成された Cloze や Image Occlusion の兄弟カードを意図的に空カードとして分類しません。

Image Occlusion

デッキで新しいカードを作り、Image Occlusion を選んで全画面エディターを開きます。PNG、JPEG、GIF、WebP、AVIF をアップロードし、長方形・楕円・多角形のマスクを描けます。SVG などのアクティブメディアは、対応形式らしい拡張子でも拒否されます。

各マスクグループが兄弟カード1枚になります。1グループには複数の図形を含められ、選択グループの結合、複数図形グループの分割、並べ替え、確認後の削除ができます。永続的なグループ ID により、マスクを編集しても対応カードのスケジュールは維持され、廃止されたカードの履歴も保存されます。

すべて隠して1つ答えるは質問面ですべてを覆い、回答面で現在のグループだけを表示します。1つ隠して1つ答えるは現在のグループだけを覆います。質問/回答プレビュー、任意のヘッダーと裏面追加文、非公開コメント、タグもあります。ポインターとタッチに対応し、選択図形は矢印キーで移動、長方形と楕円は Shift+矢印でサイズ変更、Delete で削除できます。

レビュアーは専用の画像・マスク画面を使い、現在のグループを示して対象の輪郭と任意の裏面追加文を表示します。評価は通常どおり「もう一度」「難しい」「良い」「簡単」です。

現在の上限はノート1件につき512グループ、グループごとに64図形、多角形ごとに256点です。フリーハンドマスク、自動ラベル検出、通常/Cloze タイプとの安全な相互変換には未対応です。