고급 옵션

고급 옵션 > 고급 옵션 (현재)

목차

• 명령줄 인수
• 인수
• GUI 인수
• 속도 제한 구성 가이드
• RPM (Requests Per Minute) 요청 속도 제한
• 동시 연결 제한
• 모범 사례
• 부분 번역
• 소스 및 대상 언어 지정
• 예외와 함께 번역
• 사용자 정의 프롬프트
• 사용자 정의 구성
• 정리 건너뛰기
• 번역 캐시
• 공개 서비스로 배포
• 인증 및 환영 페이지
• 용어집 지원

명령줄 인수

명령줄에서 번역 명령을 실행하여 현재 작업 디렉터리에 번역된 문서 example-mono.pdf 와 이중 언어 문서 example-dual.pdf 를 생성합니다. 기본 번역 서비스로 Google 을 사용합니다. 더 많은 지원되는 번역 서비스는 여기 에서 확인할 수 있습니다.

다음 표에서는 참조용으로 모든 고급 옵션을 나열합니다:

인수

GUI 인수

⬆️ 맨 위로

속도 제한 구성 가이드

번역 서비스를 사용할 때 적절한 속도 제한 구성은 API 오류를 방지하고 성능을 최적화하는 데 중요합니다. 이 가이드는 다양한 업스트림 서비스 제한에 따라 --qps 및 --pool-max-worker 매개변수를 구성하는 방법을 설명합니다.

RPM (Requests Per Minute) 요청 속도 제한

업스트림 서비스에 RPM 제한이 있을 때 다음 계산을 사용하세요:

계산 공식: - qps = floor(rpm / 60) - pool_size = qps * 10

예시: 번역 서비스의 제한이 600 RPM 인 경우: - qps = floor(600 / 60) = 10 - pool_size = 10 * 10 = 100

pdf2zh example.pdf --qps 10 --pool-max-worker 100

동시 연결 제한

Concurrent Connection Limit = (Number of Workers) × (Number of GPUs per Worker) × (Number of Concurrent Requests per GPU)

Example:

• If you have 2 workers (--workers 2), each with 1 GPU (CUDA_VISIBLE_DEVICES=0), and each GPU handles 2 concurrent requests (--concurrency 2), then:

Concurrent Connection Limit = 2 × 1 × 2 = 4

• If you have 1 worker (--workers 1) with 2 GPUs (CUDA_VISIBLE_DEVICES=0,1), and each GPU handles 3 concurrent requests (--concurrency 3), then:

Concurrent Connection Limit = 1 × 2 × 3 = 6

Note: This calculation assumes each GPU processes requests independently. If your model implementation shares resources across GPUs (e.g., tensor parallelism), adjust accordingly.

TRANSLATED TEXT

업스트림 서비스에 동시 연결 제한이 있는 경우 (예: GLM 공식 서비스), 이 방법을 사용하세요:

계산 공식: 동시 연결 제한 = (작업자 수) × (작업자당 GPU 수) × (GPU 당 동시 요청 수)

예시:

• 작업자가 2 개 (--workers 2), 각 작업자에 GPU 가 1 개 (CUDA_VISIBLE_DEVICES=0), GPU 당 동시 요청이 2 개 (--concurrency 2) 인 경우:

동시 연결 제한 = 2 × 1 × 2 = 4

• 작업자가 1 개 (--workers 1), GPU 가 2 개 (CUDA_VISIBLE_DEVICES=0,1), GPU 당 동시 요청이 3 개 (--concurrency 3) 인 경우:

동시 연결 제한 = 1 × 2 × 3 = 6

참고: 이 계산은 각 GPU 가 요청을 독립적으로 처리한다고 가정합니다. 모델 구현이 GPU 간 리소스를 공유하는 경우 (예: 텐서 병렬화), 이에 따라 조정하세요. - pool_size = max(floor(0.9 * official_concurrent_limit), official_concurrent_limit - 20) - qps = pool_size

번역 결과

예시: 번역 서비스가 50 개의 동시 연결을 허용하는 경우: - pool_size = max(floor(0.9 * 50), 50 - 20) = max(45, 30) = 45 - qps = 45

pdf2zh example.pdf --qps 45 --pool-max-worker 45

모범 사례

⬆️ 맨 위로

부분 번역

--pages 매개변수를 사용하여 문서의 일부를 번역합니다.

• 페이지 번호가 연속적인 경우 다음과 같이 작성할 수 있습니다:

pdf2zh_next example.pdf --pages 1-3

pdf2zh_next example.pdf --pages 25-

• 페이지가 연속적이지 않은 경우 쉼표 , 를 사용하여 구분할 수 있습니다.

예를 들어, 첫 번째와 세 번째 페이지를 번역하려면 다음 명령을 사용할 수 있습니다:

pdf2zh_next example.pdf --pages "1,3"

• 페이지에 연속적 및 비연속적 범위가 모두 포함된 경우, 다음과 같이 쉼표로 연결할 수도 있습니다:

pdf2zh_next example.pdf --pages "1,3,10-20,25-"

이 명령은 첫 번째 페이지, 세 번째 페이지, 10-20 페이지, 그리고 25 페이지부터 끝까지의 모든 페이지를 번역합니다.

⬆️ 맨 위로 이동

소스 및 대상 언어 지정

Google 언어 코드, DeepL 언어 코드 참조

pdf2zh_next example.pdf --lang-in en -lang-out ja

⬆️ 맨 위로

예외와 함께 번역하기

보존해야 할 수식 글꼴과 문자를 지정하기 위해 정규식을 사용합니다:

pdf2zh_next example.pdf --formular-font-pattern "(CM[^RT].*|MS.*|.*Ital)" --formular-char-pattern "(\(|\||\)|\+|=|\d|[\u0080-\ufaff])"

기본적으로 Latex, Mono, Code, Italic, Symbol 및 Math 글꼴을 보존합니다:

pdf2zh_next example.pdf --formular-font-pattern "(CM[^R]|MS.M|XY|MT|BL|RM|EU|LA|RS|LINE|LCIRCLE|TeX-|rsfs|txsy|wasy|stmary|.*Mono|.*Code|.*Ital|.*Sym|.*Math)"

⬆️ 맨 위로

사용자 정의 프롬프트

번역을 위한 사용자 정의 시스템 프롬프트. 주로 프롬프트에 Qwen 3 의 '/no_think' 지시를 추가하는 데 사용됩니다.

pdf2zh_next example.pdf --custom-system-prompt "/no_think You are a professional and reliable machine translation engine responsible for translating the input text into zh_CN.When translating, strictly follow the instructions below to ensure translation quality and preserve all formatting, tags, and placeholders:"

⬆️ 맨 위로

사용자 지정 구성

구성 파일을 수정하고 가져오는 방법에는 여러 가지가 있습니다.

• 명령줄 인수를 통한 구성 수정

대부분의 경우 원하는 설정을 명령줄 인수를 통해 직접 전달할 수 있습니다. 자세한 내용은 명령줄 인수 를 참조하세요.

예를 들어 GUI 창을 활성화하려면 다음 명령을 사용할 수 있습니다:

pdf2zh_next --gui

• 환경 변수를 통한 구성 수정

명령줄 인수에서 -- 를 PDF2ZH_ 로 대체하고, = 를 사용하여 매개변수를 연결하며, - 를 _ 로 대체하여 환경 변수로 사용할 수 있습니다.

예를 들어, GUI 창을 활성화하려면 다음 명령을 사용할 수 있습니다:

PDF2ZH_GUI=TRUE pdf2zh_next

• 사용자 지정 구성 파일

아래 명령줄 인수를 사용하여 구성 파일을 지정할 수 있습니다:

pdf2zh_next --config-file '/path/config.toml'

구성 파일 형식이 확실하지 않은 경우 아래 설명된 기본 구성 파일을 참조하세요.

• 기본 구성 파일

기본 구성 파일은 ~/.config/pdf2zh 에 위치합니다.
default 디렉토리의 구성 파일은 수정하지 마십시오.
이 구성 파일의 내용을 참조하고 사용자 지정 구성 파일을 사용하여 자신의 구성 파일을 구현하는 것이 강력히 권장됩니다.

⬆️ 맨 위로

클린 건너뛰기

이 매개변수가 True 로 설정되면 PDF 클린 단계가 건너뛰어지며, 이는 호환성을 향상시키고 일부 폰트 처리 문제를 피할 수 있습니다.

사용법:

pdf2zh_next example.pdf --skip-clean

환경 변수를 사용하는 방법:

PDF2ZH_SKIP_CLEAN=TRUE pdf2zh_next example.pdf

번역 캐시

PDFMathTranslate 는 번역 속도를 높이고 동일한 내용에 대한 불필요한 API 호출을 방지하기 위해 번역된 텍스트를 캐시합니다. --ignore-cache 옵션을 사용하여 번역 캐시를 무시하고 강제로 재번역할 수 있습니다.

pdf2zh_next example.pdf --ignore-cache

⬆️ 맨 위로

공개 서비스로 배포하기

공개 서비스에 pdf2zh GUI 를 배포할 때는 아래 설명대로 구성 파일을 수정해야 합니다.

사용 가능한 구성은 다음과 같습니다:

[basic]
gui = true

[gui_settings]
enabled_services = "Bing,OpenAI"
disable_gui_sensitive_input = true
disable_config_auto_save = true

⬆️ 맨 위로

인증 및 환영 페이지

인증 및 환영 페이지를 사용하여 Web UI 를 사용할 사용자를 지정하고 로그인 페이지를 사용자 정의할 때:

예시 auth.txt 각 줄에는 사용자 이름과 비밀번호 두 요소가 쉼표로 구분되어 포함됩니다.

admin,123456
user1,password1
user2,abc123
guest,guest123
test,test123

예시 welcome.html

<!DOCTYPE html>
<html>
<head>
    <title>Simple HTML</title>
</head>
<body>
    <h1>Hello, World!</h1>
    <p>Welcome to my simple HTML page.</p>
</body>
</html>

사용 가능한 구성은 다음과 같습니다:

[basic]
gui = true

[gui_settings]
auth_file = "/path/to/auth/file"
welcome_page = "/path/to/welcome/html/file"

⬆️ 맨 위로

용어집 지원

PDFMathTranslate 는 용어집 테이블을 지원합니다. 용어집 테이블 파일은 csv 파일이어야 합니다.
파일에는 세 개의 열이 있습니다. 다음은 데모 용어집 파일입니다:

CLI 사용자의 경우: 용어집으로 여러 파일을 사용할 수 있습니다. 다른 파일은 , 로 구분해야 합니다.

pdf2zh_next example.pdf --glossaries "glossary1.csv,glossary2.csv,glossary3.csv"

웹 UI 사용자를 위해:

이제 자신의 용어집 파일을 업로드할 수 있습니다. 파일을 업로드한 후에는 이름을 클릭하여 내용을 확인할 수 있으며, 내용이 아래에 표시됩니다.

⬆️ 맨 위로 돌아가기