고급 옵션

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

목차

• 명령줄 인수
• 속도 제한 구성 가이드
• 부분 번역
• 원본 및 대상 언어 지정
• 예외와 함께 번역하기
• 사용자 지정 프롬프트
• 사용자 지정 구성
• Skip clean
• 번역 캐시
• 공개 서비스로 배포하기
• 인증 및 환영 페이지
• 용어집 지원

명령줄 인수

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

다음 표에서는 참조를 위해 모든 고급 옵션을 나열합니다:

인수

GUI Args

⬆️ 맨 위로 이동

속도 제한 구성 가이드

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

RPM(분당 요청 수) 속도 제한

업스트림 서비스에 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

동시 연결 제한

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

계산 공식: - 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 디렉토리에 있는 구성 파일은 수정하지 마십시오. 이 구성 파일의 내용을 참조하여 사용자 지정 구성 파일을 사용하여 자신만의 구성 파일을 구현하는 것을 강력히 권장합니다.

⬆️ 맨 위로 이동

Skip clean

이 매개변수가 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

example 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"

WebUI 사용자의 경우:

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

⬆️ 맨 위로 돌아가기