Repeto Dokumentacja
Przeglądaj dokumentację

Typy notatek i szablony

Definiuj pola i schematy kart wielokrotnego użytku, w tym pola warunkowe i luki Cloze.

Typ notatki definiuje uporządkowaną listę pól oraz co najmniej jeden szablon karty. Należy do kolekcji, więc można go stosować do notatek w różnych taliach. Nie jest ustawieniem konkretnej talii.

Repeto zawiera specjalnie przygotowane typy Tłumaczenie, Pojęcie, Pytanie i odpowiedź oraz Cloze, a także znane rodziny Basic: Basic (and reversed card), Basic (optional reversed card) i Basic (type in the answer). Kolekcja ma również trwały fundament typu notatki Image Occlusion. W Ustawienia → Typy notatek możesz tworzyć, duplikować, przeglądać i edytować własne typy.

Szablony przodu i tyłu

Każdy szablon karty ma przód i tył. Wstaw pole, otaczając jego nazwę podwójnymi nawiasami klamrowymi:

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

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

{{FrontSide}} umieszcza wyrenderowany przód na tyle. Zwykły HTML wokół zamienników pojawia się na każdej karcie utworzonej z szablonu.

Repeto obsługuje obecnie tę praktyczną składnię:

  • {{Field}} — zamiana pola z wyszukiwaniem nazwy bez rozróżniania wielkości liter;
  • {{FrontSide}} na tyle;
  • {{#Field}}…{{/Field}}, gdy pole nie jest puste;
  • {{^Field}}…{{/Field}}, gdy pole jest puste;
  • {{text:Field}} — usunięcie HTML;
  • {{cloze:Field}} — renderowanie Cloze;
  • {{Tags}}, {{Deck}}, {{Type}} i {{Card}} — metadane.

Nieznane filtry obecnie wracają do podstawowej wartości pola. Oglądaj podgląd każdego importowanego i własnego szablonu zamiast zakładać, że filtr dostępny tylko na komputerze zachowa się identycznie.

Treść opcjonalna

Sekcje warunkowe ukrywają etykiety, gdy wartość jest pusta:

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

Dla treści zastępczej użyj sekcji odwróconej:

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

Wiele szablonów i karty odwrócone

Dodaj kolejny szablon, jeśli jedna notatka ma tworzyć inny kierunek powtórki. Tę relację powinien definiować typ notatki, a nie jednorazowa kopia notatki. Kolejność szablonów staje się numerem porządkowym używanym do identyfikacji kart siostrzanych.

Wbudowany typ odwrócony tworzy dwie karty siostrzane z jednej wspólnej notatki. Typ opcjonalnie odwrócony tworzy drugą kartę tylko wtedy, gdy pole Add Reverse nie jest puste. Wyłączenie i ponowne włączenie pola zachowuje tożsamość oraz harmonogram karty, zamiast tworzyć niezależną notatkę.

Repeto może też generować ćwiczenia odwrotne dla obsługiwanych profili talii, lecz typ z wieloma szablonami jest solidniejszą podstawą, jeśli oba kierunki należą do modelu przedmiotu.

Wpisywanie odpowiedzi

Umieść {{type:Field}} na przodzie, aby poprosić o wpisaną odpowiedź. Ekran powtórek ustawia fokus na dostępnym jednowierszowym polu, odsłania poprawną wartość i pokazuje porównanie znak po znaku oraz procent zgodności. {{type:nc:Field}} porównuje bez znaków diakrytycznych, a wpisywane Cloze dotyczy aktywnej luki.

Wpisane odpowiedzi pomagają porównać przypomnienie; nie wybierają za Ciebie Ponownie, Trudna, Dobra ani Łatwa. Po sprawdzeniu różnicy nadal oceniasz kartę samodzielnie.

Luki Cloze

Notatka Cloze ukrywa wybrany tekst wewnątrz większego zdania:

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

Używaj c1, c2 i kolejnych numerów, aby tworzyć osobne karty Cloze z jednej notatki. Gdy pole Cloze się zmieni, Repeto uzgadnia numery kart, więc dodanie lub usunięcie luki aktualizuje zestaw kart siostrzanych.

Style i bezpieczeństwo

Każdy typ notatki może zawierać CSS. Repeto renderuje HTML szablonu w izolowanym podglądzie lub ekranie powtórek i oczyszcza go przed wstawieniem. Ogranicz style do karty: typografii, odstępów, kolorów i rozmiarów multimediów. Nie polegaj na skryptach ani selektorach globalnych aplikacji.

Przed zapisaniem typu Repeto sprawdza strukturę szablonów, nieznane i zastrzeżone pola, puste lub zduplikowane przody, wymagania Cloze, nieobsługiwane filtry i niebezpieczny HTML/CSS. Błędy blokują zapis. Ostrzeżenia pozostają widoczne, aby edytor lub podgląd importu mógł wyjaśnić granicę zgodności.

Po edycji obejrzyj reprezentatywne notatki z pustymi polami opcjonalnymi, długim tekstem i obrazami, w jasnym oraz ciemnym motywie. Importowane szablony sprawdź zarówno z włączonym, jak i wyłączonym zachowaniem kolorów szablonu.

API może wyświetlić podgląd i zatwierdzić standardową konwersję typu notatki z jawnym mapowaniem pól i kart. Zachowuje identyfikatory, harmonogramy, talie i dzienniki powtórek mapowanych kart, a odmawia konwersji Cloze lub Image Occlusion, której nie może wykonać bezpiecznie. Pełny interfejs menedżera do diagnostyki i konwersji jest nadal integrowany.

Image Occlusion

W talii zacznij tworzyć nową kartę, wybierz Image Occlusion i otwórz edytor pełnoekranowy. Prześlij obraz PNG, JPEG, GIF, WebP lub AVIF i narysuj maski prostokątne, eliptyczne albo wielokątne. SVG i inne aktywne media są odrzucane, nawet gdy rozszerzenie wygląda na obsługiwane.

Każda grupa masek tworzy jedną kartę siostrzaną i może zawierać kilka kształtów. Edytor łączy wybrane grupy, dzieli grupę wielokształtową, zmienia kolejność i usuwa po wyraźnym potwierdzeniu. Trwałe ID grup sprawiają, że edycja masek zachowuje harmonogram odpowiedniej karty; historia wycofanej karty również pozostaje zachowana.

Ukryj wszystkie, odgadnij jedną zasłania wszystkie grupy w pytaniu i ujawnia tylko bieżącą w odpowiedzi. Ukryj jedną, odgadnij jedną zasłania wyłącznie bieżącą grupę. Edytor ma podgląd pytania/odpowiedzi, opcjonalny nagłówek i tekst dodatkowy na odwrocie, prywatne komentarze oraz tagi. Obsługuje wskaźnik i dotyk; wybrany kształt przesuwaj strzałkami, prostokąt lub elipsę skaluj przez Shift+strzałka, a usuwaj klawiszem Delete.

Ekran powtórek używa wyspecjalizowanej powierzchni obrazu i masek. Wskazuje bieżącą grupę, pokazuje kontur celu i opcjonalny tekst dodatkowy, a oceny pozostają zwykłe: Ponownie, Trudna, Dobra i Łatwa.

Obecne limity to 512 grup na notatkę, 64 kształty na grupę i 256 punktów na wielokąt. Maski odręczne, automatyczne wykrywanie etykiet oraz bezpieczna konwersja z lub do zwykłych typów/Cloze nie są obsługiwane.