Python使用Docling庫(kù)玩轉(zhuǎn)文檔處理
一、背景
在日常開(kāi)發(fā)中，文檔處理一直是令人頭疼的問(wèn)題。無(wú)論是技術(shù)文檔、設(shè)計(jì)文檔，還是各種格式的文件（如 PDF、DOCX、PPTX等），如何高效地解析、轉(zhuǎn)換和提取信息，常常耗費(fèi)大量精力。Docling 的出現(xiàn)，為這一問(wèn)題提供了優(yōu)雅的解決方案。它不僅支持多種主流文檔格式，還能深度解析PDF，提取頁(yè)面布局、表格結(jié)構(gòu)等復(fù)雜信息。更重要的是，Docling 提供了統(tǒng)一的文檔表示格式和便捷的 CLI，使得文檔處理變得簡(jiǎn)單高效。
接下來(lái)，我們將深入了解 Docling 的強(qiáng)大功能，并通過(guò)實(shí)際代碼示例，展示它如何幫助我們高效處理文檔。
二、什么是 Docling
Docling 是一個(gè)強(qiáng)大的 Python 第三方庫(kù)，專(zhuān)注于文檔處理和轉(zhuǎn)換。它支持多種文檔格式，包括PDF、DOCX、PPTX、HTML、圖片等。Docling 的核心功能是深度解析 PDF，能夠識(shí)別頁(yè)面布局、閱讀順序、表格結(jié)構(gòu)，甚至支持 OCR功能，處理掃描版文檔。此外，Docling 還提供了統(tǒng)一的文檔表示格式（DoclingDocument），方便開(kāi)發(fā)者進(jìn)行后續(xù)處理。
三、安裝 Docling
作為第三方庫(kù)，Docling 的安裝非常簡(jiǎn)單。只需通過(guò) pip 命令即可完成安裝：
pip install docling
如果需要支持 CPU 版本的 PyTorch，可以使用以下命令：
pip install docling --extra-index-url https://download.pytorch.org/whl/cpu
安裝完成后，即可使用 Docling 提供的強(qiáng)大功能。
四、庫(kù)函數(shù)使用方法
以下是 Docling 的五個(gè)常用函數(shù)及其使用方法：
1. DocumentConverter.convert()
該函數(shù)用于轉(zhuǎn)換文檔，支持本地路徑或 URL。
from docling.document_converter import DocumentConverter source = "https://arxiv.org/pdf/2408.09869" # 文檔路徑或 URL converter = DocumentConverter() result = converter.convert(source)
source：文檔的路徑或 URL。
converter.convert()：將文檔轉(zhuǎn)換為 Docling 的內(nèi)部表示格式。
2. export_to_markdown()
將文檔導(dǎo)出為 Markdown 格式。
markdown_content = result.document.export_to_markdown() print(markdown_content)
export_to_markdown()：將文檔內(nèi)容轉(zhuǎn)換為 Markdown 格式。
3. export_to_json()
將文檔導(dǎo)出為 JSON 格式。
json_content = result.document.export_to_json() print(json_content)
export_to_json()：將文檔內(nèi)容轉(zhuǎn)換為 JSON 格式。
4. HierarchicalChunker.chunk()
對(duì)文檔進(jìn)行分塊處理，返回文本內(nèi)容和元數(shù)據(jù)。
from docling_core.transforms.chunker import HierarchicalChunker chunks = list(HierarchicalChunker().chunk(result.document)) print(chunks[0])
HierarchicalChunker()：創(chuàng)建分塊器。
chunk(result.document)：對(duì)文檔進(jìn)行分塊處理。
5. PdfPipelineOptions
自定義 PDF 轉(zhuǎn)換選項(xiàng)。
from docling.datamodel.pipeline_options import PdfPipelineOptions pipeline_options = PdfPipelineOptions(do_table_structure=True) pipeline_options.table_structure_options.do_cell_matching = False
PdfPipelineOptions：自定義 PDF 轉(zhuǎn)換選項(xiàng)。
do_table_structure：是否解析表格結(jié)構(gòu)。
do_cell_matching：是否將表格單元格映射回 PDF。
五、使用場(chǎng)景示例
以下是五個(gè)實(shí)際使用場(chǎng)景及其代碼示例：
場(chǎng)景 1：將 PDF 轉(zhuǎn)換為 Markdown
from docling.document_converter import DocumentConverter source = "https://arxiv.org/pdf/2408.09869" converter = DocumentConverter() result = converter.convert(source) markdown_content = result.document.export_to_markdown() print(markdown_content)
convert()：將 PDF 轉(zhuǎn)換為 Docling 的內(nèi)部表示格式。
export_to_markdown()：將文檔導(dǎo)出為 Markdown 格式。
場(chǎng)景 2：限制文檔大小
from docling.document_converter import DocumentConverter source = "https://arxiv.org/pdf/2408.09869" converter = DocumentConverter() result = converter.convert(source, max_num_pages=100, max_file_size=20971520)
max_num_pages：限制文檔的最大頁(yè)數(shù)。
max_file_size：限制文檔的最大文件大小。
場(chǎng)景 3：自定義 PDF 轉(zhuǎn)換選項(xiàng)
from docling.datamodel.pipeline_options import PdfPipelineOptions
from docling.document_converter import DocumentConverter
pipeline_options = PdfPipelineOptions(do_table_structure=True)
pipeline_options.table_structure_options.do_cell_matching = False
converter = DocumentConverter(pipeline_options=pipeline_options)
result = converter.convert("path/to/your/document.pdf")
PdfPipelineOptions：自定義 PDF 轉(zhuǎn)換選項(xiàng)。
do_table_structure 和 do_cell_matching：控制表格結(jié)構(gòu)的解析方式。
場(chǎng)景 4：文檔分塊處理
from docling.document_converter import DocumentConverter
from docling_core.transforms.chunker import HierarchicalChunker
converter = DocumentConverter()
result = converter.convert("https://arxiv.org/pdf/2206.01062")
chunks = list(HierarchicalChunker().chunk(result.document))
print(chunks[0])
HierarchicalChunker.chunk()：對(duì)文檔進(jìn)行分塊處理。
輸出包含文本內(nèi)容和元數(shù)據(jù)，方便后續(xù)處理。
場(chǎng)景 5：使用 OCR 處理掃描版 PDF
from docling.datamodel.pipeline_options import PipelineOptions, TesseractOcrOptions
from docling.document_converter import DocumentConverter
pipeline_options = PipelineOptions()
pipeline_options.do_ocr = True
pipeline_options.ocr_options = TesseractOcrOptions()
converter = DocumentConverter(pipeline_options=pipeline_options)
result = converter.convert("path/to/scanned_document.pdf")
PipelineOptions 和 TesseractOcrOptions：配置 OCR 選項(xiàng)。
do_ocr：?jiǎn)⒂?OCR 功能。
六、常見(jiàn)問(wèn)題及解決方案
以下是使用 Docling 時(shí)常見(jiàn)的三個(gè)問(wèn)題及其解決方案：
問(wèn)題 1：TensorFlow 相關(guān)警告
錯(cuò)誤信息：
This TensorFlow binary is optimized to use available CPU instructions in performance-critical operations.
解決方案：安裝適合 CPU 的 TensorFlow 版本。
conda create --name py11 python==3.11 conda activate py11 conda install tensorflow
問(wèn)題 2：Tesseract OCR 安裝問(wèn)題
錯(cuò)誤信息：Tesseract OCR 未安裝或配置錯(cuò)誤。
解決方案：安裝 Tesseract OCR 并設(shè)置 TESSDATA_PREFIX。
# macOS brew install tesseract leptonica pkg-config TESSDATA_PREFIX=/opt/homebrew/share/tessdata/ # Linux apt-get install tesseract-ocr tesseract-ocr-eng libtesseract-dev libleptonica-dev pkg-config TESSDATA_PREFIX=$(dpkg -L tesseract-ocr-eng | grep tessdata$)
問(wèn)題 3：Tesserocr 安裝失敗
錯(cuò)誤信息：Tesserocr 安裝失敗。
解決方案：重新安裝 Tesserocr。
pip uninstall tesserocr pip install --no-binary :all: tesserocr
七、總結(jié)
Docling是一個(gè)功能強(qiáng)大的文檔處理庫(kù)，支持多種文檔格式和深度解析功能。它提供了統(tǒng)一的文檔表示格式和豐富的導(dǎo)出選項(xiàng)，能夠滿足多種開(kāi)發(fā)需求。通過(guò)簡(jiǎn)單的安裝和使用，開(kāi)發(fā)者可以輕松地將文檔處理集成到自己的項(xiàng)目中。無(wú)論是技術(shù)文檔處理還是AI 應(yīng)用開(kāi)發(fā)，Docling 都是一個(gè)值得信賴的選擇。
到此這篇關(guān)于Python使用Docling庫(kù)玩轉(zhuǎn)文檔處理的文章就介紹到這了,更多相關(guān)Python Docling文檔處理內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
關(guān)于Python內(nèi)存分配時(shí)的小秘密分享
這篇文章主要給大家分享介紹了關(guān)于Python內(nèi)存分配時(shí)的小秘密，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家學(xué)習(xí)或者使用Python具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2019-09-09
Python函數(shù)必須先定義,后調(diào)用說(shuō)明(函數(shù)調(diào)用函數(shù)例外)
這篇文章主要介紹了Python函數(shù)必須先定義,后調(diào)用說(shuō)明(函數(shù)調(diào)用函數(shù)例外)，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。一起跟隨小編過(guò)來(lái)看看吧2020-06-06
這篇文章主要介紹了Python JSON模塊的使用詳情，JSON(JavaScript Object Notation) 是一種輕量級(jí)的數(shù)據(jù)交換格式，易于人閱讀和編寫(xiě)下面文章圍繞Python JSON模塊的相關(guān)資料展開(kāi)內(nèi)容，需要的小伙伴可以參考一下，希望 對(duì)你有所幫助2021-12-12
在使用python的時(shí)候,有時(shí)候會(huì)需要找到python包的安裝位置,本文主要介紹了查看Python安裝路徑幾種方法,具有一定的參考價(jià)值,感興趣的可以了解一下2023-09-09
這篇文章介紹了Python實(shí)現(xiàn)base64編碼的方法，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2022-06-06
使用Python自動(dòng)化創(chuàng)建和掃描二維碼
二維碼（Quick Response code）已成為在物理和數(shù)字領(lǐng)域之間架起橋梁的多功能工具,從分享聯(lián)系信息和網(wǎng)站鏈接到促進(jìn)支付和跟蹤庫(kù)存,二維碼在各個(gè)行業(yè)中找到了應(yīng)用,本文將展示如何使用Python自動(dòng)化創(chuàng)建和掃描二維碼,感興趣的朋友可以參考下2024-07-07
這篇文章主要為大家詳細(xì)介紹了30分鐘如何使用Python制作自己的記事本,文中的示例代碼講解詳細(xì),感興趣的小伙伴可以跟隨小編一起學(xué)習(xí)一下2026-02-02
Python 中對(duì) XML 文件的編碼轉(zhuǎn)換問(wèn)題
這篇文章主要介紹了Python 中對(duì) XML 文件的編碼轉(zhuǎn)換問(wèn)題,本文給大家介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值，需要的朋友可以參考下2023-03-03
Python中PDF解析利器pdfplumber的使用詳細(xì)教程
pdfplumber是一個(gè)Python庫(kù),專(zhuān)門(mén)用于從PDF文件中提取文本、表格和其他信息,本文將為大家詳細(xì)介紹一下pdfplumber的安裝與詳細(xì)使用,有需要的小伙伴可以參考下2025-04-04
python實(shí)現(xiàn)簡(jiǎn)單井字棋游戲
這篇文章主要為大家詳細(xì)介紹了python實(shí)現(xiàn)簡(jiǎn)單井字棋游戲，文中示例代碼介紹的非常詳細(xì)，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下2020-03-03