PDF 번역 후에도 링크가 계속 사용할 수 있나요: 먼저, 링크 목록을 만드세요

PDF 번역 후에는 외부 링크, 내부 리디렉션, 문서 내 로컬 동작이 무효화되거나 잘못된 위치를 가리킬 수 있습니다. 많은 팀이 납품 전에야 이러한 문제를 발견하여 높은 재작업 비용이 발생합니다. 문서 번역, 지식 기반 마이그레이션 또는 출판 과정을 담당하고 있다면, 이 글은 전달 전에 링크를 재고하는 데 도움이 될 수 있습니다.

다음 방법은 먼저 링크를 분류한 후, 카테고리별로 어떻게 처리할지 결정합니다. 샘플 코드는 재고 관리와 분류만 수행하며, 어떤 링크도 접근하거나 실행하지 않습니다. 이 글을 읽고 나면, 어떤 링크는 계약서에만 표시해야 하고, 어떤 링크는 목표 페이지 번호를 기록해야 하며, 어떤 링크는 수동 검토에 맡겨야 하는지 명확히 할 수 있을 것입니다.

PDF 번역 후에도 링크를 계속 사용할 수 있나요? 요컨대, 결론입니다

번역된 링크가 계속 사용될 수 있는지는 먼저 각 링크의 유형을 명확히 식별한 뒤, 유형별로 별도로 처리하는 것에 달려 있습니다; 스크립트는 카테고리만 처리하며 링크에는 접근하지 않습니다.

당신의 상황	추천 레시피	이유
문서에는 외부 HTTP 링크가 포함되어 있습니다	계약서만 허용된 것으로 표시하고 점검 기록을 보관하세요	계약서에 따른 허가가 대상 웹사이트의 신뢰성을 보장하지는 않습니다; 신뢰성은 별도로 확인해야 합니다
문서에는 내부 리디렉션이 포함되어 있습니다	제로 기준 목표 페이지 번호를 기록합니다	분할하거나 병합한 후에는 페이지 번호가 바뀌어 다시 매핑해야 합니다
문서에는 지역 행동이 포함되어 있습니다	수동으로 검토 표시를 하세요, 열었거나 실행된 상태가 아니라요	로컬 액션은 자동으로 실행되어서는 안 됩니다
PDF는 OCR이거나 재포맷됩니다	링크 사각형이 보이는 텍스트와 일치하는지 수동으로 확인하세요	링크 자체는 안전하며, 사용자 경험은 이미 손상되었을 수 있습니다

이 글에서 어떤 문제를 먼저 다루나요?

허용 목록에 있는 링크 계약은 이 형식 검사가 통과했다는 것만을 나타내며, 대상 웹사이트가 신뢰할 만하다는 의미는 아닙니다. 예시는 링크에 접근하거나 실행하지 않고 목록 작성과 분류만 합니다. 내부 페이지 번호는 제로 베이스 인덱스를 사용하여 재매핑됩니다; 분할하거나 병합한 후에는 다시 매핑되어야 합니다.

자급 완성 작곡의 예

의존성에 대해서는 가져오기 목록을 참조하세요. 코드는 메모리에 구성되며, 런타임 레코드는 별도로 제공되므로 모든 진짜 파일이 보장되는 것은 아닙니다.

import pymupdf
from urllib.parse import urlsplit
def classify(link):
    if link.get("kind") == pymupdf.LINK_URI:
        scheme = urlsplit(link.get("uri", "")).scheme.lower()
        return "allowed_scheme_needs_review" if scheme in {"https", "http", "mailto"} else "blocked_scheme"
    if link.get("kind") == pymupdf.LINK_GOTO:
        return "internal_remap_needed"
    return "manual_review"
with pymupdf.open() as source:
    page = source.new_page()
    page.insert_link({"kind": pymupdf.LINK_URI, "uri": "https://example.com/", "from": pymupdf.Rect(10, 10, 100, 30)})
    raw = source.tobytes()
with pymupdf.open(stream=raw, filetype="pdf") as doc:
    links = doc[0].get_links()
    assert len(links) == 1
    assert classify(links[0]) == "allowed_scheme_needs_review"
assert classify({"kind": pymupdf.LINK_URI, "uri": "javascript:alert(1)"}) == "blocked_scheme"
assert classify({"kind": pymupdf.LINK_GOTO, "page": 0}) == "internal_remap_needed"
assert classify({"kind": pymupdf.LINK_LAUNCH}) == "manual_review"

PyMuPDF 링크 추출 및 보안 검사 예시

PyMuPDF API 동작에 따라 작성된 예시: LINK_GOTO 타입의 링크는 page 키를 사용하며, 페이지 번호는 0부터 시작하며 topage나 firstpagenum가 아닙니다. get_text()는 clip 매개변수가 없는 모든 콘텐츠를 반환합니다.

예시에는 각각 정상 경로와 하나의 키 경계 조건을 다루는 두 가지 주장이 포함되어 있습니다.

링크 수락 체크리스트 및 수동 검토 경계

코드는 기계적 분류를 수행할 수 있지만, 비즈니스 판단을 대체할 수는 없습니다. 아래 표는 일반적인 링크 상태와 이에 따른 처리 결정을 나열하여 자동화 검토와 수동 검토의 경계를 명확히 합니다.

코드는 올바른 분류 논리만을 보장할 수 있습니다. 링크를 유지할지 아니면 카피라이팅을 업데이트해야 하는지는 문서 업무에 익숙한 사람이 결정해야 합니다. 특히 OCR이나 PDF 재포맷 후에는 링크 사각형이 보이는 텍스트와 어긋날 수 있습니다. 이 시점에서는 링크 자체가 안전하더라도 사용자 경험이 손상되어 수동으로 조정해야 합니다.

📊 핵심 비교

아래 표는 링크 유형별로 처리 방법을 비교하며, 각 줄은 무엇을 해야 하고 어떤 추론을 해서는 안 되는지 목록으로 나와 있습니다.

관찰	무엇을 해야 할까요	그리고 판단해서는 안 된다
HTTP 링크	계약을 허용된 것으로 표시할 뿐입니다	타겟의 신뢰성은 별도로 점검될 것입니다
내부 리디렉션	제로베이스 타겟 페이지를 기록하세요	분리 후 재매핑
지역 활동	마크 매뉴얼 리뷰	공개적이거나 처형되지 않았다

참고문헌 및 다음 단계

PyMuPDF Page.get_links() 공식 문서: https://pymupdf.readthedocs.io/en/latest/page.html#Page.get_links
PyMuPDF 좌표계 설명 (직사각형 위치 연결 이해): https://pymupdf.readthedocs.io/en/latest/page.html#coordinates

여러 링크 유형을 포함하는 대표적인 PDF를 선택하고, 위 분류 스크립트를 로컬 환경에서 실행한 후 링크 감사 보고서를 생성하는 것이 권장됩니다. 보고서 내 '수동 검토' 항목의 비율에 따라 보안 정책 상수를 조정하거나 화이트리스트를 보완하세요. 보고서 내용이 안정적이고 설명 가능할 때에만 공식 번역 납품 승인 절차에 포함됩니다.

문서 번역을 위해 이 체크리스트를 사용하세요

먼저 페이지 순서, 출처 위치, 텍스트 무결성을 확인한 후, 동일한 감작 샘플을 번역 과정에 제출하세요. 번역 후에도 제목, 본문, 캡션이 정확히 일치하는지 확인하는 것이 여전히 필요합니다; 텍스트가 유창한지 여부만으로는 판단할 수 없습니다.

OmniDoc (제품 입력)는 다중 형식의 문서 번역 포털을 제공하며, 공식 웹사이트에서는 OCR, 용어집, 이중언어 참고 기능을 소개합니다. 파일에서 바로 시작하고 싶다면 실제 샘플로 이 경로를 평가할 수 있습니다.

업로드를 승인한 익명 파일을 사용해 이 기사의 체크리스트와 결과를 확인해 주시기 바랍니다. 이는 OmniDoc이 이 글에서 언급한 오픈 소스 라이브러리나 내부 알고리즘을 사용한다는 주장도 아니며, 예시들이 제품 성능 테스트를 대체하지도 않습니다.

🎯 어떤 방법이 당신에게 맞나요?

링크를 유지할 수 있는지 빠르게 확인해야 한다면,

먼저 링크의 유형을 살펴보겠습니다. 외부 HTTP 링크는 프로토콜 검사만 수행합니다; 대상 신뢰성은 별도로 검증되어야 합니다.

PDF가 분할되거나 병합된 경우에는

내부 점프의 페이지 번호를 리매핑하고, 0기준 타겟 페이지를 기록한 후 수락을 수행합니다.

PDF가 OCR이나 재포맷을 거쳤다면

각 링크 사각형을 확인하여 보이는 텍스트가 정렬되어 있는지 확인하세요; 이 단계는 스크립트만으로는 할 수 없습니다.

여러 문서를 대량으로 처리해야 할 경우

먼저 대표성 샘플을 사용해 감사 보고서를 생성하고, 보고서가 안정적이고 해석 가능한지 확인한 후 공식 프로세스로 승격됩니다.

❓ 자주 묻는 질문 (FAQ)

1. 링크 계약이 검사를 통과하면 자신 있게 링크를 클릭할 수 있나요?

아니. 프로토콜 검사는 이 형식이 통과되었음을 나타낼 뿐이며; 대상 웹사이트가 신뢰할 수 있는지 별도로 확인해야 합니다.

2. PDF를 분할하거나 병합한 후에는 내부 리디렉션을 어떻게 처리해야 하나요?

내부 페이지 번호는 제로 베이스 인덱스를 사용하며, 분할하거나 병합한 후에는 다시 매핑해야 합니다.

3. 스크립트가 어떤 링크를 유지할지 자동으로 결정할 수 있나요?

아니. 이 코드는 기계적 분류만 완료하며; 링크가 유지되고 카피라이팅이 업데이트될지는 해당 업계에 익숙한 사람들에 따라 다릅니다.

4. 링크 자체는 괜찮은데, 왜 경험이 잘못될 수 있을까요?

OCR 또는 재포맷 후에는 링크 사각형이 보이는 텍스트와 정렬이 어긋날 수 있어 수동 검증이 필요합니다.

5. 샘플 코드가 문서의 링크에 접근할 수 있나요?

아니. 예시는 링크에 접근하거나 실행하지 않고 목록 작성과 분류만 합니다.

📝 요약

PDF 번역 후 링크 문제는 먼저 재고 체크리스트를 참고하고, 그 다음에는 수동 판단에 의존하세요. 스크립트는 분류를 담당하며, 비즈니스 의사결정과 경험 검증은 수작업이 필요합니다.

지금 경험해보세요: 원본 형식을 유지하면서 번역을 시작하려면 문서를 업로드하세요