노트 유형과 템플릿

노트 유형은 순서가 있는 필드 목록과 하나 이상의 카드 템플릿을 정의합니다. 유형은 컬렉션에 속하므로 서로 다른 덱의 노트에서 사용할 수 있으며, 덱 전용 설정이 아닙니다.

Repeto는 목적에 맞춘 번역, 개념, 문답, Cloze 유형과 익숙한 Basic 계열인 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은 템플릿에서 생성된 모든 카드에 나타납니다.

현재 지원되는 실용적인 템플릿 문법은 다음과 같습니다.

• 대소문자를 구분하지 않는 필드 조회를 사용하는 {{Field}};
• 뒷면에서 쓰는 {{FrontSide}};
• 필드가 비어 있지 않을 때의 {{#Field}}…{{/Field}};
• 필드가 비어 있을 때의 {{^Field}}…{{/Field}};
• HTML을 제거하는 {{text:Field}};
• Cloze를 렌더링하는 {{cloze:Field}};
• 메타데이터용 {{Tags}}, {{Deck}}, {{Type}}, {{Card}}.

알 수 없는 필터는 현재 기본 필드 값으로 대체됩니다. 데스크톱 전용 필터가 똑같이 동작한다고 가정하지 말고 가져온 템플릿과 사용자 지정 템플릿을 모두 미리보세요.

웹 카드의 MathJax

웹 렌더러는 \(...\)로 감싼 Anki 방식의 인라인 MathJax와 \[...\]로 감싼 표시용 MathJax를 인식합니다. 렌더러는 로컬에 포함되어 있고 크기가 제한된 정리된 SVG를 만들며 원격 스크립트나 패키지를 불러오지 않습니다. 렌더링에 실패하면 식이 사라지지 않고 원래 표현이 그대로 보입니다.

달러 기호 구분자($...$, $$...$$), [latex] 블록, 데스크톱 LaTeX 이미지 생성, 원격 MathJax 패키지, 템플릿 스크립트는 지원하지 않습니다. 네이티브 클라이언트에는 아직 이 웹 MathJax 기능이 없습니다.

선택적 콘텐츠

조건부 구역을 사용하면 값이 없을 때 빈 레이블을 숨길 수 있습니다.

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

대체 콘텐츠에는 반전 구역을 사용합니다.

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

여러 템플릿과 역방향 카드

한 노트에서 다른 복습 방향도 생성해야 한다면 템플릿을 하나 더 추가하세요. 임시로 노트를 복제하지 말고 노트 유형에서 관계를 정의해야 합니다. 템플릿 순서는 형제 카드를 식별하는 카드 서수가 됩니다.

내장 역방향 유형은 공유 노트 하나에서 형제 카드 두 개를 만듭니다. 선택적 역방향 유형은 Add Reverse 필드가 비어 있지 않을 때만 두 번째 형제 카드를 만듭니다. 그 필드를 껐다가 다시 켜도 서로 무관한 노트를 만드는 대신 형제 카드의 식별자와 일정을 보존합니다.

Repeto는 지원되는 덱 프로필에서 역방향 연습도 생성할 수 있지만, 두 방향이 모두 학습 대상 모델의 일부라면 재사용 가능한 다중 템플릿 노트 유형이 더 튼튼한 기반입니다.

답 입력하기

앞면에 {{type:Field}}를 넣으면 입력형 답을 요청합니다. 복습 화면은 접근 가능한 한 줄 입력란에 초점을 맞추고, 정답을 표시하며, 문자 단위 비교와 일치율을 보여 줍니다. {{type:nc:Field}}는 발음 구별 기호를 무시해 비교하며, 입력형 Cloze는 현재 삭제 부분을 대상으로 합니다.

입력형 답은 회상을 비교하도록 돕지만 다시, 어려움, 좋음, 쉬움을 대신 선택하지 않습니다. 차이를 확인한 뒤 직접 평가해야 합니다.

Cloze 삭제

Cloze 노트는 더 큰 문장 안의 선택한 텍스트를 숨깁니다.

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

c1, c2와 그 이후 번호를 사용해 한 노트에서 별도 Cloze 카드를 만듭니다. Cloze 필드가 바뀌면 Repeto가 카드 서수를 조정하므로 삭제 부분을 추가하거나 제거하면 생성된 형제 카드 집합도 갱신됩니다.

스타일과 안전

노트 유형에는 CSS를 넣을 수 있습니다. Repeto는 격리된 미리보기·복습 영역에서 템플릿 HTML을 렌더링하고 삽입 전에 정리합니다. 스타일은 글꼴, 간격, 색상, 미디어 크기처럼 카드 내부에 집중하세요. 스크립트나 앱 전역 선택자에 의존하지 마세요.

노트 유형을 저장하기 전에 Repeto는 템플릿 구조, 알 수 없거나 예약된 필드, 비어 있거나 중복된 앞면, Cloze 요구 조건, 지원되지 않는 필터, 위험한 HTML/CSS를 검사합니다. 오류는 저장을 막고 경고는 호출자에게 남아 편집기나 가져오기 미리보기가 호환 범위를 설명할 수 있습니다.

유형을 편집한 뒤에는 선택 필드가 비어 있는 노트, 긴 텍스트, 이미지, 밝고 어두운 테마를 대표 표본으로 미리보세요. 가져온 템플릿은 템플릿 색상 유지를 켠 상태와 끈 상태 모두 확인해야 합니다.

현재 정의의 검사가 끝나지 않았거나 진단을 사용할 수 없으면, 검사하지 않은 정의를 허용하지 않고 저장을 멈춥니다.

기존 노트를 다른 유형으로 변환하기

카드 브라우저를 노트 모드로 열고 같은 표준 유형의 노트를 선택한 뒤 노트 유형 변경을 고르세요. 각 대상 필드에 원본 필드를, 각 기존 형제 카드에 최대 하나의 대상 템플릿 또는 삭제를 매핑합니다. 필드와 카드가 각각 하나 이상 필요합니다. 매핑된 카드는 ID, 덱, 일정, 기록을 보존하고 새 형제는 새 일정으로 시작합니다.

변경 사항 미리보기는 보존 일정, 새/폐기 형제, 매핑되지 않은 비어 있지 않은 값, 빈 앞면을 보고합니다. 매핑을 바꾸면 미리보기가 만료됩니다. 확정은 미리보기 지문을 보내며 버릴 값, 빈 앞면, 폐기 카드 ID에 대한 별도의 정확한 확인을 요구합니다. 미리보기 뒤 노트가 바뀌면 오래된 지문이 변환을 막습니다.

Cloze와 Image Occlusion은 전용 변환 규칙이 생길 때까지 원본·대상이 될 수 없습니다. 사용 중 유형 안의 임의 필드 이전, 자동 빈 카드 정리, 클라이언트 간 안정 필드/템플릿 ID도 아직 없습니다.

빈 카드 찾아서 제거하기

설정 → 노트 유형 → 빈 카드를 열어 표준 노트 유형에서 앞면이 비어 있게 렌더링되는 카드, 삭제된 템플릿이 남긴 카드, 중복된 템플릿 식별자, 고립된 노트·유형 레코드를 검사하세요. 정확한 후보를 검토하고 제거할 카드만 선택한 뒤 지문이 포함된 미리보기를 확정합니다. 오래된 미리보기는 거부됩니다.

정리는 일반적인 동기화 대상 삭제 표시를 만듭니다. 일정과 복습 이력 행은 조용히 지워지지 않고 무결성 확인과 감사를 위해 남습니다. 검사는 수동이며 콘텐츠에서 파생된 Cloze 또는 Image Occlusion 형제 카드를 의도적으로 빈 카드로 분류하지 않습니다.

Image Occlusion

덱에서 새 카드를 만들고 Image Occlusion을 선택한 뒤 전체 페이지 편집기를 여세요. PNG, JPEG, GIF, WebP, AVIF 이미지를 올리고 사각형·타원·다각형 마스크를 그릴 수 있습니다. SVG와 기타 활성 미디어는 파일 확장자가 지원 형식처럼 보여도 거부됩니다.

각 마스크 그룹은 형제 카드 한 장이 되며 여러 도형을 담을 수 있습니다. 선택한 그룹 합치기, 여러 도형 그룹 나누기, 순서 변경, 명시적 확인 후 삭제가 가능합니다. 그룹 ID가 지속되므로 마스크를 고쳐도 대응 카드의 일정은 유지되고, 폐기된 카드의 기록도 보존됩니다.

모두 숨기고 하나 맞히기는 질문에서 모든 그룹을 가리고 답에서 현재 그룹만 공개합니다. 하나 숨기고 하나 맞히기는 현재 그룹만 가립니다. 편집기에는 질문/답 미리보기, 선택적 머리말과 뒷면 추가 글, 비공개 댓글, 태그가 있습니다. 포인터와 터치를 지원하며, 선택 도형은 화살표 키로 이동하고 사각형·타원은 Shift+화살표로 크기를 바꾸며 Delete로 삭제합니다.

복습 화면은 전용 이미지·마스크 표면을 사용합니다. 현재 그룹을 식별하고 대상 윤곽과 선택적 뒷면 추가 글을 공개하며, 평가는 평소처럼 다시·어려움·좋음·쉬움을 사용합니다.

현재 한도는 노트당 마스크 그룹 512개, 그룹당 도형 64개, 다각형당 점 256개입니다. 자유곡선 마스크, 자동 라벨 감지, 일반/Cloze 노트 유형과의 안전한 변환은 지원하지 않습니다.