docs: add command line usage documentation of quickstart page (#14110)

2025-12-28 07:28:55 +00:00 · 2024-10-29 08:29:34 +08:00 · 2024-10-29 08:29:34 +08:00 · 7cecf0ad1f
commit 7cecf0ad1f
parent 4b35b756cd
2 changed files with 192 additions and 2 deletions
--- a/docs/quick_start.en.md
+++ b/docs/quick_start.en.md
@ -10,7 +10,7 @@ hide:
 pip install paddleocr
 ```

-### Use
+### Use by code

 === "Detection + Classification + Recognition"

@ -169,6 +169,101 @@ pip install paddleocr
    ['0', 0.99999964]
    ```

+### Usy by command line
+
+Show help information
+
+```bash linenums="1"
+paddleocr -h
+```
+
+=== "Detection + Classification + Recognition"
+
+    ```bash linenums="1"
+    paddleocr --image_dir PaddleOCR/doc/imgs_en/img_12.jpg --use_angle_cls true --lang en
+    ```
+
+    Output will be a list, each item contains bounding box, text and recognition confidence
+
+    ```python linenums="1"
+    [[[442.0, 173.0], [1169.0, 173.0], [1169.0, 225.0], [442.0, 225.0]], ['ACKNOWLEDGEMENTS', 0.99283075]]
+    [[[393.0, 340.0], [1207.0, 342.0], [1207.0, 389.0], [393.0, 387.0]], ['We would like to thank all the designers and', 0.9357758]]
+    [[[399.0, 398.0], [1204.0, 398.0], [1204.0, 433.0], [399.0, 433.0]], ['contributors whohave been involved in the', 0.9592447]]
+    ......
+    ```
+
+    pdf file is also supported, you can infer the first few pages by using the page_num parameter, the default is 0, which means infer all pages
+
+    ```bash linenums="1"
+    paddleocr --image_dir ./xxx.pdf --use_angle_cls true --use_gpu false --page_num 2
+    ```
+
+=== "Detection + Recognition"
+
+    ```bash linenums="1"
+    paddleocr --image_dir PaddleOCR/doc/imgs_en/img_12.jpg --lang en
+    ```
+
+    Output will be a list, each item contains bounding box, text and recognition confidence
+
+    ```python linenums="1"
+    [[[442.0, 173.0], [1169.0, 173.0], [1169.0, 225.0], [442.0, 225.0]], ['ACKNOWLEDGEMENTS', 0.99283075]]
+    [[[393.0, 340.0], [1207.0, 342.0], [1207.0, 389.0], [393.0, 387.0]], ['We would like to thank all the designers and', 0.9357758]]
+    [[[399.0, 398.0], [1204.0, 398.0], [1204.0, 433.0], [399.0, 433.0]], ['contributors whohave been involved in the', 0.9592447]]
+    ......
+    ```
+
+=== "Classification + Recognition"
+
+    ```bash linenums="1"
+    paddleocr --image_dir PaddleOCR/doc/imgs_words_en/word_10.png --use_angle_cls true --det false --lang en
+    ```
+
+    Output will be a list, each item contains text and recognition confidence
+
+    ```python linenums="1"
+    ['PAIN', 0.990372]
+    ```
+
+=== "Only detection"
+
+    ```bash linenums="1"
+    paddleocr --image_dir PaddleOCR/doc/imgs_en/img_12.jpg --rec false
+    ```
+
+    Output will be a list, each item only contains bounding box
+
+    ```python linenums="1"
+    [[756.0, 812.0], [805.0, 812.0], [805.0, 830.0], [756.0, 830.0]]
+    [[820.0, 803.0], [1085.0, 801.0], [1085.0, 836.0], [820.0, 838.0]]
+    [[393.0, 801.0], [715.0, 805.0], [715.0, 839.0], [393.0, 836.0]]
+    ......
+    ```
+
+=== "Only recognition"
+
+    ```bash linenums="1"
+    paddleocr --image_dir PaddleOCR/doc/imgs_words_en/word_10.png --det false --lang en
+    ```
+
+    Output will be a list, each item contains text and recognition confidence
+
+    ```python linenums="1"
+    ['PAIN', 0.990372]
+    ```
+
+=== "Only classification"
+
+    ```bash linenums="1"
+    paddleocr --image_dir PaddleOCR/doc/imgs_words_en/word_10.png --use_angle_cls true --det false --rec false
+    ```
+
+    Output will be a list, each item contains classification result and confidence
+
+    ```python linenums="1"
+    ['0', 0.99999964]
+    ```
+
 ### Online Demo

 - PP-OCRv4 online experience：<https://aistudio.baidu.com/aistudio/projectdetail/6611435>
--- a/docs/quick_start.md
+++ b/docs/quick_start.md
@ -10,7 +10,7 @@ hide:
 pip install paddleocr
 ```

-### 使用
+### Python脚本使用

 === "文本检测+方向分类+文本识别"

@ -169,6 +169,101 @@ pip install paddleocr
    ['0', 0.99999964]
    ```

+### 命令行使用
+
+显示帮助信息
+
+```bash linenums="1"
+paddleocr -h
+```
+
+=== "文本检测+方向分类+文本识别"
+
+    ```bash linenums="1"
+    paddleocr --image_dir PaddleOCR/doc/imgs_en/img_12.jpg --use_angle_cls true --lang en
+    ```
+
+    输出示例：
+
+    ```python linenums="1"
+    [[[442.0, 173.0], [1169.0, 173.0], [1169.0, 225.0], [442.0, 225.0]], ['ACKNOWLEDGEMENTS', 0.99283075]]
+    [[[393.0, 340.0], [1207.0, 342.0], [1207.0, 389.0], [393.0, 387.0]], ['We would like to thank all the designers and', 0.9357758]]
+    [[[399.0, 398.0], [1204.0, 398.0], [1204.0, 433.0], [399.0, 433.0]], ['contributors whohave been involved in the', 0.9592447]]
+    ......
+    ```
+
+    还支持pdf文件，您可以使用`page_num`参数推断前几页，默认值为0，这意味着识别全部页面
+
+    ```bash linenums="1"
+    paddleocr --image_dir ./xxx.pdf --use_angle_cls true --use_gpu false --page_num 2
+    ```
+
+=== "文本检测+文本识别"
+
+    ```bash linenums="1"
+    paddleocr --image_dir PaddleOCR/doc/imgs_en/img_12.jpg --lang en
+    ```
+
+    输出示例：
+
+    ```python linenums="1"
+    [[[442.0, 173.0], [1169.0, 173.0], [1169.0, 225.0], [442.0, 225.0]], ['ACKNOWLEDGEMENTS', 0.99283075]]
+    [[[393.0, 340.0], [1207.0, 342.0], [1207.0, 389.0], [393.0, 387.0]], ['We would like to thank all the designers and', 0.9357758]]
+    [[[399.0, 398.0], [1204.0, 398.0], [1204.0, 433.0], [399.0, 433.0]], ['contributors whohave been involved in the', 0.9592447]]
+    ......
+    ```
+
+=== "方向分类+文本识别"
+
+    ```bash linenums="1"
+    paddleocr --image_dir PaddleOCR/doc/imgs_words_en/word_10.png --use_angle_cls true --det false --lang en
+    ```
+
+    输出示例：
+
+    ```python linenums="1"
+    ['PAIN', 0.990372]
+    ```
+
+=== "只有文本检测"
+
+    ```bash linenums="1"
+    paddleocr --image_dir PaddleOCR/doc/imgs_en/img_12.jpg --rec false
+    ```
+
+    输出示例：
+
+    ```python linenums="1"
+    [[756.0, 812.0], [805.0, 812.0], [805.0, 830.0], [756.0, 830.0]]
+    [[820.0, 803.0], [1085.0, 801.0], [1085.0, 836.0], [820.0, 838.0]]
+    [[393.0, 801.0], [715.0, 805.0], [715.0, 839.0], [393.0, 836.0]]
+    ......
+    ```
+
+=== "只有识别"
+
+    ```bash linenums="1"
+    paddleocr --image_dir PaddleOCR/doc/imgs_words_en/word_10.png --det false --lang en
+    ```
+
+    输出示例：
+
+    ```python linenums="1"
+    ['PAIN', 0.990372]
+    ```
+
+=== "只有方向分类"
+
+    ```bash linenums="1"
+    paddleocr --image_dir PaddleOCR/doc/imgs_words_en/word_10.png --use_angle_cls true --det false --rec false
+    ```
+
+    输出示例：
+
+    ```python linenums="1"
+    ['0', 0.99999964]
+    ```
+
 ### 在线demo

 - PP-OCRv4 在线体验地址：<https://aistudio.baidu.com/community/app/91660>