RetexPDF은(는) 무엇을 하나요?
일반적인 요청은 다음과 같습니다: 입력 PDF → 전체 번역 → 일반적인 arXiv 스타일 LaTeX → 컴파일된 PDF. 레이아웃 분류 및 번역을 포함한 이 작업을 수행하십시오. 사용자가 저자의 TeX 소스를 찾거나, LaTeX를 사용하거나, 번역 API를 구성하거나, 스크립트를 실행하도록 요구하지 마십시오. 에이전트가 번역하고; 스크립트가 지속되고, 조립하고 컴파일합니다. 제공된 PDF가 권위 있는 버전입니다.
환경 자동 준비
Windows:
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "<skill>/scripts/bootstrap.ps1" -WithPdf
macOS:
bash "<skill>/scripts/bootstrap.sh" ensure --with-pdf
반환된 JSON의 절대 python 실행 파일을 사용하십시오. status: ready를 요구하십시오. 부트스트랩은 재사용 가능한 개인 환경과 호환되는 설치된 Python을 먼저 사용하고; 호환되는 Python이 없을 때만 Python을 다운로드합니다. 명시적으로 제공된 -PythonPath / --python이 우선합니다. 관리되는 PDF 환경은 64비트 Python 3.10–3.14를 지원합니다. 개인 환경에 고정된 PyMuPDF를 설치하고 Tectonic을 감지하거나 설치합니다. 시스템 Python, PATH, 셸 프로필 또는 레지스트리를 수정하지 마십시오. 전체 TeX 배포판을 설치하지 마십시오. %LOCALAPPDATA%/RetexPDF 또는 ~/Library/Caches/RetexPDF 아래의 기존 캐시를 사용하십시오.
첫 사용 시 누락된 종속성, 패키지 및 글꼴에 대한 네트워크 액세스가 필요합니다. 일반적인 첫 사용 시 -Offline / --offline을 전달하지 마십시오. Doctor는 읽기 전용입니다. 오프라인은 다운로드를 명시적으로 금지합니다. macOS 진입점이 존재하지만 여전히 기본 Mac 검증이 필요합니다. 환경 실패 시 구체적인 로그를 보존하고 가능한 경우 복구하십시오. 사용자에게 수동으로 LaTeX를 설치하도록 안내하지 마십시오.
입력 경로 선택
- PDF 제공됨: PDF 워크플로,
scripts/pdf_translate.py및assets/arxiv-paper.tex를 사용하십시오. 저자 TeX를 찾거나 재구성된 발췌문을 고정하는 것으로 전환하지 마십시오. 저자 소스는 필수 조건이 아닙니다. 에이전트는 렌더링된 PDF를 분류하고 완전한 번역 원장을 채워야 합니다. - 기존 TeX 프로젝트 제공됨: 소스 원장 및
scripts/translation_ledger.py를 사용하십시오. 원본 TeX 수학은 직접 유지될 수 있습니다. 사용자가 일반 템플릿을 요청하지 않는 한 제공된 클래스를 유지하십시오. - 논문 링크/ID 제공됨: 요청된 정확한 PDF를 얻으십시오. 일치하는 소스는 선택 사항입니다. 다른 판을 자동으로 대체하지 마십시오.
사용자가 요청한 대상 언어와 로케일을 사용하십시오. 대화에서 설정된 대상을 유추하고; 정말로 지정되지 않은 경우에만 물어보십시오. 중국어는 고정된 대상이 아닙니다. 요청된 문자 체계에 맞는 글꼴 및 언어 지원을 선택하십시오.
불가결한 콘텐츠 규칙
- 모든 단락, 제목, 캡션, 일반 각주, 감사 인사, 알고리즘, 증명 및 부록을 포함하여 전체 논문을 번역하십시오. 결과를 보려는 요청은 샘플이 명시적으로 요청되지 않는 한 여전히 전체 논문을 의미합니다. 요약, 유도 단축, 또는 생략된 내용에 대한 설명으로 섹션을 대체하지 마십시오.
- 저자 블록 전체(이름, 순서, 소속 텍스트, 위첨자, 기여/교신 주석 및 이메일)를 정확히 보존하십시오. 참고 문헌 항목과 번호를 보존하십시오. 데이터, 식별자 및 수식 레이블을 보존하십시오. 그림/표 아트워크와 값을 보존하고; 캡션을 번역하십시오. 사용자가 아트워크/표 내부의 텍스트 번역을 요청하는 경우, 자동으로 번역된 것으로 처리하지 말고 별도의 매핑된 텍스트 레이어 워크플로를 추가하십시오.
- 각 인라인 수식을 해당 문장에 유지하십시오. 모든 디스플레이 수식, 여러 줄 유도 및 기호를 보존하십시오. PDF 입력의 경우, 분수, 근호, 악센트 및 방정식 번호를 포함하여 수식/그림/표 영역을 벡터 PDF 클립으로 복사하십시오. 이미지 생성으로 수학을 다시 그리지 마십시오. 신뢰할 수 없는 추출된 문자 순서에서 수식을 재구성하지 마십시오.
- 원본 순서를 유지하십시오. 번역하기 전에 페이지에 걸쳐 분할된 문장을 결합하십시오. 그림/표 캡션을 해당 개체와 함께 유지하고 페이지에 맞는 경우 알고리즘을 함께 유지하십시오. 일반 템플릿을 사용하여 텍스트를 재배치하십시오. 명시적으로 요청하지 않는 한 원본 좌표와 원본 페이지 수는 요구 사항이 아닙니다.
- 논문 내에 번역자 서문, 읽기 지침, 생략 주석, 요약 또는 새로운 콘텐츠를 추가하지 마십시오. 기술 보고서는 PDF 외부에 있어야 합니다.
- 조립하기 전에 원본, 전체 목록 및 각 번역을 유지하십시오. 각 소스 단위에는 번역 또는 명시적으로 합법적인 보존 자산이 있어야 합니다. 미완료 번역을 숨기기 위해 변경되지 않은 산문 대체를 사용하지 마십시오. 컨텍스트 제한은 보류 중인 단위를 저장하고 재개하는 것을 의미하며, 생략하는 것이 아닙니다.
- 글리프 목록은 추출된 글리프의 기계적 적용 범위만 증명합니다. 추출, 스캔된 텍스트, 다중 열 읽기 순서 및 손상된 추출을 포착하기 위해 렌더링된 소스 페이지를 목록과 비교하십시오. 각 번역된 단위를 전체 소스와 비교하십시오.
reviewed플래그는 실제 작업을 기록합니다. 빌드를 통과하기 위한 지름길이 아닙니다.
PDF 실행
명령 및 JSON 형식에 대한 자세한 참조를 따르십시오:
extract: 정확한 원본 PDF, 모든 페이지, 글리프, 글꼴 및 위치를 보존하십시오.- 페이지 렌더링을 검사하고
layout.json에서 저자 블록, 그림, 표, 캡션 및 디스플레이 수학을 분류하십시오. 인라인 수학 세분화 및 결합을 수정하십시오. 보이는 내용을 목록과 비교한 후에만 페이지를 검토된 것으로 표시하십시오. 기본 텍스트가 없는 그래픽 콘텐츠를 포함하십시오. prepare --target-language ...: 번역 ID를 할당하고 레이아웃, 산문 및 벡터 조각을 고정하십시오. 모든 기본 글리프는 정확히 한 번 설명되어야 합니다.pending: 컨텍스트와 함께 완전한 단위를 읽으십시오. 배치 단위로 번역하고 실제 소스 비교 후에만put --file ... --reviewed로 저장하십시오. 수학 자리 표시자는 완전하고 순서대로 유지되어야 합니다. 일관된 용어집을 사용하십시오.build --output <new-project>: 새main.tex및fragments.pdf를 조합한 다음 자동으로 컴파일하십시오. 누락된 번역, 변경된 소스/레이아웃, 누락된 수식 토큰 또는 검토되지 않은 단위/페이지는 빌드를 중지합니다. 미완료 번역에 대해 이러한 검사를 우회하기 위해 컴파일러만 사용하지 마십시오.- 실제 컴파일된 PDF를 렌더링하고 검사하십시오. 클리핑, 겹침, 잘못된 글리프, 분리된 캡션 및 깨진 인라인 수식을 수정하십시오. 최종 부록을 포함한 모든 소스 페이지와 섹션에 해당 출력 콘텐츠가 있는지 확인하십시오. 작업이 완료된 후에만 전달하십시오.
레이아웃 변경은 다시 prepare가 필요합니다. 번역 ID가 변경될 수 있습니다: 고정된 소스 해시와 페이지별로 이전 행을 조정한 다음 매핑을 확인하십시오. 변경된 콘텐츠를 승인하기 위해 맹목적으로 이전 ID 키가 있는 행을 복사하거나 해시를 다시 계산하지 마십시오.
스캔 또는 손상된 텍스트 추출의 경우, 번역 전에 유지된 목록에 OCR/시각적 전사를 추가하십시오. 이 스크립트의 기본 추출기는 OCR 엔진이 아니며 이미지만 있는 페이지를 빈 페이지로 처리해서는 안 됩니다. 블록을 아직 읽을 수 없는 경우 계속 복구하십시오. 자동으로 생략하거나 완전한 출력이라고 주장하지 마십시오.
글꼴, 컴파일 및 전달
번들 템플릿은 arXiv 스타일 출력에 적합한 일반 단일 열 학술 기사입니다. 고유한 공식 arXiv 템플릿이 아닙니다. 중국어는 기본적으로 ctex와 Fandol을 사용합니다. 다른 스크립트는 올바른 글꼴/언어 패키지가 포함된 --language-setup을 제공할 수 있습니다. 대표적인 제목, 단락 및 수식으로 적용 범위, 모양 및 방향을 확인하십시오. 대상 언어 매개변수만으로 글꼴이 구성되었다는 증거로 취급하지 마십시오.
Tectonic은 누락된 패키지/글꼴을 자동으로 다운로드합니다. 생성된 작업 복사본 또는 생성기에서 컴파일러 오류를 수정하십시오. 콘텐츠를 삭제하여 수정하지 마십시오. failed는 전달 가능한 상태가 아닙니다. review_required는 PDF가 존재하지만 경고를 해결해야 함을 의미합니다. compiled는 컴파일만 확인할 뿐 의미론적 또는 시각적 완전성을 확인하지 않습니다. 소스 전용 컴파일 요청의 경우 retex.ps1 -Action Compile 또는 retex.sh compile을 직접 사용하십시오. 셸 이스케이프는 비활성화된 상태로 유지됩니다.
작업/중간 파일은 RetexPDF 작업 캐시 또는 사용자가 지정한 작업 디렉토리에 보관하십시오. 완전한 번역 PDF 및 편집 가능한 조립 프로젝트를 전달하고; 추적 가능성을 위해 원본 스냅샷, 레이아웃, 번역 원장 및 적용 범위 보고서를 유지하십시오. 논문의 데이터나 번역을 설치된 스킬에 번들로 묶지 마십시오. 해당되는 경우 그림/표 내부에서 보존된 원본 언어 레이블을 포함하여 논문 외부에 구체적인 남은 제한 사항을 공개하십시오. 기계적 검사가 모든 가능한 PDF에 대해 완벽한 의미 번역을 보장한다고 약속하지 마십시오.