STEM 보충 노트 (LaTeX)
모든 STEM 원본 자료에서 .tex 파일로 학습 자료를 생성합니다. 사용자는 객관식 질문(AskUserQuestion)을 통해 모든 선택을 주도하므로, 질문을 먼저 하고 작성하세요.
지원 파일 (해당 단계에 도달하면 읽으세요):
references/tooling.md: 소프트웨어, 설치 명령어 및 용량, 변환 명령어references/questions.md: MCQ 질문 은행 (입력 라운드, 컴파일 질문 포함)references/style-guide.md: 레이아웃, 레이블링, 풀이 형식, 검증 및 불일치 규칙templates/formula_sheet.tex,templates/solutions.tex,templates/summary_notes.tex: 복사할 프리앰블
워크플로우
1. 소스 목록 확인
- 사용자가 가리킨 파일(폴더 또는
@경로)을 나열합니다. PDF, PNG/JPG, PPTX/DOCX를 허용합니다. - 각 PDF에 대해
pdfinfo(페이지 수)와pdftotext -layout을 실행하여 세션 스크래치패드에 저장한 후, 단어 수를 셉니다. 페이지당 약 50단어 미만이면 스캔 또는 이미지 위주 파일입니다: 모든 페이지를 이미지로 읽으세요. 텍스트 덤프는 무용지물입니다. - 슬라이드 자료는 종종 방정식과 그림을 이미지로만 유지합니다. 텍스트가 있어도 페이지를 확인하세요.
2. 도구 확인 (먼저 읽기 전용)
which pdfinfo pdftotext pdftoppm soffice tectonic pdflatex를 실행합니다. 필요한 것이 없으면 첫 번째 MCQ 라운드에 포함하며, 용량 정보는 references/tooling.md를 참조하세요. MCQ 답변 없이 절대 설치하지 마세요. LibreOffice는 오피스 파일이 있을 때만 필요합니다. 사용자가 질문에 질문으로 답변하면(예: "저장 용량은 얼마인가요?") 답변한 후 다시 질문하세요.
3. 입력 MCQ
references/questions.md의 라운드를 물어보되, AskUserQuestion 호출당 최대 4개 질문으로 제한합니다. 권장 옵션을 먼저 배치하고 "(Recommended)"라고 표시하세요. 사용자가 선택한 출력 유형에 대해서만 질문 그룹을 물어보세요. 컴파일 질문은 항상 마지막에 묻습니다. 답변을 문자 그대로 읽으세요: 자유 텍스트 답변이 옵션을 덮어씁니다.
4. 모든 내용 읽기
- PDF:
pages매개변수와 함께 Read 도구 사용 (호출당 최대 20페이지, 따라서 큰 범위는 분할)하고 모든 파일의 모든 페이지 범위 읽기를 하나의 병렬 배치로 발행합니다. Read 도구는 poppler의pdftoppm이 필요합니다. - 이미지: 직접 읽습니다.
- PPTX/DOCX: 스크래치패드에서 PDF로 변환 (
soffice --headless --convert-to pdf --outdir <scratchpad> file)한 후 PDF로 읽습니다. - 모든 질문 또는 예제에 대해: 소스 파일, 슬라이드/페이지, 문제 번호, 소스에서 이미 해결했는지(전체 또는 부분), 그리고 출력된 답변을 기록합니다.
5. 풀이 및 검증
- 범위 내의 모든 문제를 풉니다. 간단하지 않은 것(곡선 피팅, 적분, 모멘트 평형, 다단계 수치 계산)에 대해서는 스크래치패드에서 짧은
python3스크립트로 숫자를 확인합니다. - 인쇄된 답변과 비교합니다. 일치하지 않으면 재확인한 후, 문서와 사용자에게 불일치를 보고합니다. 결코 인쇄된 답변에 맞추기 위해 풀이를 왜곡하지 마십시오.
- 소스의 오타(잘못된 부호, 잘못된 항, 일관되지 않은 데이터)는 각주 또는 "이것이 왜 여기 있는가" 노트에 표시합니다.
6. .tex 파일 작성
templates/의 해당 템플릿에서 시작합니다: 프리앰블을 유지하고%% TODO플레이스홀더를 대체합니다.references/style-guide.md를 따릅니다: 모든 항목에 소스 · 슬라이드/페이지 · 문제 번호를 태그하고, 적용 범위 테이블을 추가하며, 각 질문을 전체로 다시 쓰고, 답변을 상자에 넣습니다.- ASCII 전용 소스를 사용합니다. 주석은 한 줄
%주석만 가능하며, 여러 줄 배너 주석은 사용하지 않습니다. - 기본 출력 폴더는 사용자가 다르게 선택하지 않는 한 소스 옆의
latex/입니다.
7. 사용자가 선택한 경우에만 컴파일
- tectonic:
tectonic -X compile file.tex. MacTeX:latexmk -pdf file.tex. 오류를 수정하고 깨끗해질 때까지 재컴파일합니다. - 사용자가 중단을 요청하면 즉시 작업을 중단(TaskStop)하고 재시도하지 않습니다.
8. 보고
간략히 나열합니다: 작성된 파일, 각 파일의 내용, 건너뛴 질문(소스에서 이미 해결됨), 발견된 불일치, 컴파일 상태. 컴파일하지 않은 경우 명확히 말합니다.