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) oraz kompletny własny przepływ Image Occlusion. W Ustawienia → Typy notatek możesz tworzyć, duplikować, przeglądać i edytować własne typy.

Zarządzaj typami notatek

Ustawienia → Typy notatek otwiera menedżera całej kolekcji. Oznacza typy wbudowane i własne, pokazuje liczbę pól/szablonów oraz pozwala tworzyć, edytować definicję, duplikować lub kopiować pola, szablony i CSS jako Markdown. Typów wbudowanych nie można usunąć. Nieużywany typ własny można skasować po potwierdzeniu; używany pozostaje do czasu konwersji lub usunięcia notatek.

Pełnoekranowy edytor jawnie pokazuje kolejność pól i szablonów. Dla typów standardowych i Cloze można je dodawać, zmieniać nazwy, porządkować lub usuwać, edytować przód, tył i wspólny CSS oraz oglądać izolowane podglądy z przykładowymi wartościami. Image Occlusion zachowuje wymagany układ i listę szablonów; maski tworzy się w specjalnym edytorze talii.

Dodanie na końcu jest bezpieczne. Zmiana nazwy, położenia lub usunięcie istniejącego elementu zmienia jego tożsamość pozycyjną, więc edytor ostrzega, a serwer blokuje niebezpieczną zmianę, dopóki notatki używają typu. Użyj jawnej konwersji.

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.

MathJax na kartach internetowych

Renderer internetowy rozpoznaje liniowy MathJax w stylu Anki ujęty w \(...\) oraz MathJax w trybie blokowym ujęty w \[...\]. Renderer jest dołączony lokalnie, tworzy oczyszczony plik SVG o ograniczonym rozmiarze i nie ładuje zdalnych skryptów ani pakietów. Jeśli renderowanie się nie powiedzie, pierwotne wyrażenie pozostaje widoczne zamiast zniknąć.

Separatory dolarowe ($...$ i $$...$$), bloki [latex], komputerowe generowanie obrazów LaTeX, zdalne pakiety MathJax i skrypty szablonów nie są obsługiwane. Klienty natywne nie udostępniają jeszcze tej funkcji MathJax z wersji internetowej.

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.

Jeśli sprawdzanie bieżącej definicji nie dobiegło końca albo diagnostyka jest niedostępna, zapis czeka zamiast dopuścić niesprawdzoną definicję.

Zmień istniejące notatki na inny typ

Otwórz Przeglądarkę kart w trybie Notatki, wybierz notatki jednego typu standardowego i Zmień typ notatki. Przypisz każdemu polu docelowemu pole źródłowe, a każdej istniejącej karcie siostrzanej najwyżej jeden szablon docelowy lub usunięcie. Wymagane jest co najmniej jedno pole i karta. Przypisane karty zachowują ID, talię, harmonogram i historię; nowe zaczynają ze świeżym harmonogramem.

Podgląd zmian podaje zachowane harmonogramy, nowe/wycofane karty, nieprzypisane niepuste wartości i puste przody. Zmiana mapowania unieważnia podgląd. Zatwierdzenie wysyła jego odcisk i wymaga osobnych dokładnych potwierdzeń dla odrzuconych wartości, pustych przodów oraz ID wycofanych kart. Zmiana notatki po podglądzie blokuje konwersję jako nieaktualną.

Cloze i Image Occlusion są odrzucane jako źródło lub cel do czasu specjalnych reguł. Brakuje też dowolnych migracji w używanym typie, automatycznego czyszczenia pustych kart oraz stabilnych ID pól/szablonów między klientami.

Znajdź i usuń puste karty

Otwórz Ustawienia → Typy notatek → Puste karty, aby przeskanować standardowe typy w poszukiwaniu kart z pustym wyrenderowanym przodem, kart pozostawionych przez usunięty szablon, zduplikowanych tożsamości szablonów oraz osieroconych rekordów notatek lub typów. Sprawdź dokładnych kandydatów, wybierz tylko karty przeznaczone do usunięcia i zatwierdź podgląd oznaczony odciskiem. Nieaktualny podgląd zostanie odrzucony.

Czyszczenie tworzy zwykłe znaczniki usunięcia widoczne dla synchronizacji. Wiersze harmonogramu i historii powtórek pozostają dostępne dla kontroli integralności i audytu, zamiast być po cichu kasowane. Skanowanie jest ręczne i celowo nie klasyfikuje jako pustych kart siostrzanych Cloze ani Image Occlusion wyprowadzonych z treści.

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.