docs/README_ja-JP.md · xnwh/pz at main

English | 简体中文 | 繁體中文 | 日本語

PDFMathTranslate

科学 PDF 文書の翻訳およびバイリンガル比較ツール

📊 数式、チャート、目次、注釈を保持 (プレビュー)
🌐 複数の言語と多様な翻訳サービスをサポート
🤖 コマンドラインツール、インタラクティブユーザーインターフェース、および Docker を提供

フィードバックは GitHub Issues、Telegram グループ

プレビュー

公共サービス 🌟

無料サービス (https://pdf2zh.com/)

インストールなしで公共サービスをオンラインで試すことができます。

デモ

インストールなしで HuggingFace上のデモ, ModelScope上のデモを試すことができます。デモの計算リソースは限られているため、乱用しないようにしてください。

インストールと使用方法

このプロジェクトを使用するための4つの方法を提供しています：コマンドライン、ポータブル、GUI、および Docker。

pdf2zhの実行には追加モデル（wybxc/DocLayout-YOLO-DocStructBench-onnx）が必要です。このモデルはModelScopeでも見つけることができます。起動時にこのモデルのダウンロードに問題がある場合は、以下の環境変数を使用してください：

set HF_ENDPOINT=https://hf-mirror.com

For PowerShell user:

$env:HF_ENDPOINT = https://hf-mirror.com

方法1. コマンドライン

Pythonがインストールされていること (バージョン3.8 <= バージョン <= 3.12)
パッケージをインストールします：
```
pip install pdf2zh
```
翻訳を実行し、現在の作業ディレクトリにファイルを生成します：
```
pdf2zh document.pdf
```

方法2. ポータブル

Python環境を事前にインストールする必要はありません

setup.bat をダウンロードしてダブルクリックして実行します

方法3. GUI

Pythonがインストールされていること (バージョン3.8 <= バージョン <= 3.12)
パッケージをインストールします：
```
pip install pdf2zh
```
ブラウザで使用を開始します：
```
pdf2zh -i
```
ブラウザが自動的に起動しない場合は、次のURLを開きます：
```
http://localhost:7860/
```

詳細については、GUIのドキュメントを参照してください。

方法4. Docker

プルして実行します：

docker pull byaidu/pdf2zh
docker run -d -p 7860:7860 byaidu/pdf2zh

ブラウザで開きます：
```
http://localhost:7860/
```

クラウドサービスでのDockerデプロイメント用：

高度なオプション

コマンドラインで翻訳コマンドを実行し、現在の作業ディレクトリに翻訳されたドキュメント example-mono.pdf とバイリンガルドキュメント example-dual.pdf を生成します。デフォルトではGoogle翻訳サービスを使用します。More support translation services can find HERE.

以下の表に、参考のためにすべての高度なオプションをリストしました：

オプション	機能	例
files	ローカルファイル	`pdf2zh ~/local.pdf`
links	オンラインファイル	`pdf2zh http://arxiv.org/paper.pdf`
`-i`	GUIに入る	`pdf2zh -i`
`-p`	部分的なドキュメント翻訳	`pdf2zh example.pdf -p 1`
`-li`	ソース言語	`pdf2zh example.pdf -li en`
`-lo`	ターゲット言語	`pdf2zh example.pdf -lo zh`
`-s`	翻訳サービス	`pdf2zh example.pdf -s deepl`
`-t`	マルチスレッド	`pdf2zh example.pdf -t 1`
`-o`	出力ディレクトリ	`pdf2zh example.pdf -o output`
`-f`, `-c`	例外	`pdf2zh example.pdf -f "(MS.*)"`
`--share`	[gradio公開リンクを取得]	`pdf2zh -i --share`
`--authorized`	[ウェブ認証とカスタム認証ページの追加]	`pdf2zh -i --authorized users.txt [auth.html]`
`--prompt`	[カスタムビッグモデルのプロンプトを使用する]	`pdf2zh --prompt [prompt.txt]`
`--onnx`	[カスタムDocLayout-YOLO ONNXモデルの使用]	`pdf2zh --onnx [onnx/model/path]`
`--serverport`	[カスタムWebUIポートを使用する]	`pdf2zh --serverport 7860`
`--dir`	[batch translate]	`pdf2zh --dir /path/to/translate/`
`--config`	configuration file	`pdf2zh --config /path/to/config/config.json`
`--serverport`	[custom gradio server port]	`pdf2zh --serverport 7860`

全文または部分的なドキュメント翻訳

全文翻訳

pdf2zh example.pdf

部分翻訳

pdf2zh example.pdf -p 1-3,5

ソース言語とターゲット言語を指定

Google Languages Codes、DeepL Languages Codes を参照してください

pdf2zh example.pdf -li en -lo ja

異なるサービスで翻訳

以下の表は、各翻訳サービスに必要な環境変数を示しています。各サービスを使用する前に、これらの変数を設定してください。

Translator	Service	Environment Variables	Default Values	Notes
Google (Default)	`google`	None	N/A	None
Bing	`bing`	None	N/A	None
DeepL	`deepl`	`DEEPL_AUTH_KEY`	`[Your Key]`	See DeepL
DeepLX	`deeplx`	`DEEPLX_ENDPOINT`	`https://api.deepl.com/translate`	See DeepLX
Ollama	`ollama`	`OLLAMA_HOST`, `OLLAMA_MODEL`	`http://127.0.0.1:11434`, `gemma2`	See Ollama
OpenAI	`openai`	`OPENAI_BASE_URL`, `OPENAI_API_KEY`, `OPENAI_MODEL`	`https://api.openai.com/v1`, `[Your Key]`, `gpt-4o-mini`	See OpenAI
AzureOpenAI	`azure-openai`	`AZURE_OPENAI_BASE_URL`, `AZURE_OPENAI_API_KEY`, `AZURE_OPENAI_MODEL`	`[Your Endpoint]`, `[Your Key]`, `gpt-4o-mini`	See Azure OpenAI
Zhipu	`zhipu`	`ZHIPU_API_KEY`, `ZHIPU_MODEL`	`[Your Key]`, `glm-4-flash`	See Zhipu
ModelScope	`modelscope`	`MODELSCOPE_API_KEY`, `MODELSCOPE_MODEL`	`[Your Key]`, `Qwen/Qwen2.5-Coder-32B-Instruct`	See ModelScope
Silicon	`silicon`	`SILICON_API_KEY`, `SILICON_MODEL`	`[Your Key]`, `Qwen/Qwen2.5-7B-Instruct`	See SiliconCloud
Gemini	`gemini`	`GEMINI_API_KEY`, `GEMINI_MODEL`	`[Your Key]`, `gemini-1.5-flash`	See Gemini
Azure	`azure`	`AZURE_ENDPOINT`, `AZURE_API_KEY`	`https://api.translator.azure.cn`, `[Your Key]`	See Azure
Tencent	`tencent`	`TENCENTCLOUD_SECRET_ID`, `TENCENTCLOUD_SECRET_KEY`	`[Your ID]`, `[Your Key]`	See Tencent
Dify	`dify`	`DIFY_API_URL`, `DIFY_API_KEY`	`[Your DIFY URL]`, `[Your Key]`	See Dify,Three variables, lang_out, lang_in, and text, need to be defined in Dify's workflow input.
AnythingLLM	`anythingllm`	`AnythingLLM_URL`, `AnythingLLM_APIKEY`	`[Your AnythingLLM URL]`, `[Your Key]`	See anything-llm
Argos Translate	`argos`			See argos-translate
Grok	`grok`	`GORK_API_KEY`, `GORK_MODEL`	`[Your GORK_API_KEY]`, `grok-2-1212`	See Grok
DeepSeek	`deepseek`	`DEEPSEEK_API_KEY`, `DEEPSEEK_MODEL`	`[Your DEEPSEEK_API_KEY]`, `deepseek-chat`	See DeepSeek
OpenAI-Liked	`openai-liked`	`OPENAILIKE_BASE_URL`, `OPENAILIKE_API_KEY`, `OPENAILIKE_MODEL`	`url`, `[Your Key]`, `model name`	None

(need Japenese translation) For large language models that are compatible with the OpenAI API but not listed in the table above, you can set environment variables using the same method outlined for OpenAI in the table.

-s service または -s service:model を使用してサービスを指定します：

pdf2zh example.pdf -s openai:gpt-4o-mini

または環境変数でモデルを指定します：

set OPENAI_MODEL=gpt-4o-mini
pdf2zh example.pdf -s openai

For PowerShell user:

$env:OPENAI_MODEL = gpt-4o-mini
pdf2zh example.pdf -s openai

例外を指定して翻訳

正規表現を使用して保持する必要がある数式フォントと文字を指定します：

pdf2zh example.pdf -f "(CM[^RT].*|MS.*|.*Ital)" -c "(\(|\||\)|\+|=|\d|[\u0080-\ufaff])"

デフォルトで Latex、Mono、Code、Italic、Symbol および Math フォントを保持します：

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

スレッド数を指定

-t を使用して翻訳に使用するスレッド数を指定します：

pdf2zh example.pdf -t 1

カスタムプロンプト

--promptを使用して、LLMで使用するプロンプトを指定します：

pdf2zh example.pdf -pr prompt.txt

prompt.txtの例：

[
    {
        "role": "system",
        "content": "You are a professional,authentic machine translation engine.",
    },
    {
        "role": "user",
        "content": "Translate the following markdown source text to ${lang_out}. Keep the formula notation {{v*}} unchanged. Output translation directly without any additional text.\nSource Text: ${text}\nTranslated Text:",
    },
]

カスタムプロンプトファイルでは、以下の3つの変数が使用できます。

変数	内容
`lang_in`	ソース言語
`lang_out`	ターゲット言語
`text`	翻訳するテキスト

API

Python

from pdf2zh import translate, translate_stream

params = {"lang_in": "en", "lang_out": "zh", "service": "google", "thread": 4}
file_mono, file_dual = translate(files=["example.pdf"], **params)[0]
with open("example.pdf", "rb") as f:
    stream_mono, stream_dual = translate_stream(stream=f.read(), **params)

HTTP

pip install pdf2zh[backend]
pdf2zh --flask
pdf2zh --celery worker

curl http://localhost:11008/v1/translate -F "[email protected]" -F "data={\"lang_in\":\"en\",\"lang_out\":\"zh\",\"service\":\"google\",\"thread\":4}"
{"id":"d9894125-2f4e-45ea-9d93-1a9068d2045a"}

curl http://localhost:11008/v1/translate/d9894125-2f4e-45ea-9d93-1a9068d2045a
{"info":{"n":13,"total":506},"state":"PROGRESS"}

curl http://localhost:11008/v1/translate/d9894125-2f4e-45ea-9d93-1a9068d2045a
{"state":"SUCCESS"}

curl http://localhost:11008/v1/translate/d9894125-2f4e-45ea-9d93-1a9068d2045a/mono --output example-mono.pdf

curl http://localhost:11008/v1/translate/d9894125-2f4e-45ea-9d93-1a9068d2045a/dual --output example-dual.pdf

curl http://localhost:11008/v1/translate/d9894125-2f4e-45ea-9d93-1a9068d2045a -X DELETE

謝辞

ドキュメントのマージ：PyMuPDF
ドキュメントの解析：Pdfminer.six
ドキュメントの抽出：MinerU
ドキュメントプレビュー：Gradio PDF
マルチスレッド翻訳：MathTranslate
レイアウト解析：DocLayout-YOLO
ドキュメント標準：PDF Explained、PDF Cheat Sheets
多言語フォント：Go Noto Universal

Spaces:

xnwh
/

pz

Running

PDFMathTranslate

最近の更新

プレビュー

公共サービス 🌟

無料サービス (https://pdf2zh.com/)

デモ

インストールと使用方法

方法1. コマンドライン

方法2. ポータブル

方法3. GUI

方法4. Docker

高度なオプション

全文または部分的なドキュメント翻訳

ソース言語とターゲット言語を指定

異なるサービスで翻訳

例外を指定して翻訳

スレッド数を指定

カスタムプロンプト

API

Python

HTTP

謝辞

貢献者

スター履歴

PDFMathTranslate

最近の更新

プレビュー

公共サービス 🌟

無料サービス (https://pdf2zh.com/)

デモ

インストールと使用方法

方法1. コマンドライン

方法2. ポータブル

方法3. GUI

方法4. Docker

高度なオプション

全文または部分的なドキュメント翻訳

ソース言語とターゲット言語を指定

異なるサービスで翻訳

例外を指定して翻訳

スレッド数を指定

カスタム プロンプト

API

Python

HTTP

謝辞

貢献者

スター履歴

カスタムプロンプト