Merge pull request #928 from icecraft/docs/using_raw_zh

opendatalab · Nov 11, 2024 · ebe9780 · ebe9780
2 parents fe7b811 + 24416f9
commit ebe9780
Show file tree

Hide file tree

Showing 4 changed files with 170 additions and 147 deletions.
diff --git a/next_docs/zh_cn/additional_notes/faq.rst b/next_docs/zh_cn/additional_notes/faq.rst
@@ -2,25 +2,22 @@
 ============
 
 1.在较新版本的mac上使用命令安装pip install magic-pdf[full] zsh: no matches found: magic-pdf[full]
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-在 macOS 上，默认的 shell 从 Bash 切换到了 Z shell，而 Z shell
-对于某些类型的字符串匹配有特殊的处理逻辑，这可能导致no matches
-found错误。 可以通过在命令行禁用globbing特性，再尝试运行安装命令
+在 macOS 上，默认的 shell 从 Bash 切换到了 Z shell，而 Z shell 对于某些类型的字符串匹配有特殊的处理逻辑，这可能导致no matches found错误。 可以通过在命令行禁用globbing特性，再尝试运行安装命令
 
 .. code:: bash
 
    setopt no_nomatch
    pip install magic-pdf[full]
 
 2.使用过程中遇到_pickle.UnpicklingError: invalid load key, ‘v’.错误
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-可能是由于模型文件未下载完整导致，可尝试重新下载模型文件后再试
-参考：https://github.com/opendatalab/MinerU/issues/143
+可能是由于模型文件未下载完整导致，可尝试重新下载模型文件后再试。参考：https://github.com/opendatalab/MinerU/issues/143
 
 3.模型文件应该下载到哪里/models-dir的配置应该怎么填
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 模型文件的路径输入是在”magic-pdf.json”中通过
 
@@ -30,13 +27,11 @@ found错误。 可以通过在命令行禁用globbing特性，再尝试运行安
      "models-dir": "/tmp/models"
    }
 
-进行配置的。
-这个路径是绝对路径而不是相对路径，绝对路径的获取可在models目录中通过命令
-“pwd” 获取。
+进行配置的。这个路径是绝对路径而不是相对路径，绝对路径的获取可在models目录中通过命令 “pwd” 获取。
 参考：https://github.com/opendatalab/MinerU/issues/155#issuecomment-2230216874
 
 4.在WSL2的Ubuntu22.04中遇到报错\ ``ImportError: libGL.so.1: cannot open shared object file: No such file or directory``
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 WSL2的Ubuntu22.04中缺少\ ``libgl``\ 库，可通过以下命令安装\ ``libgl``\ 库解决：
 
@@ -47,7 +42,7 @@ WSL2的Ubuntu22.04中缺少\ ``libgl``\ 库，可通过以下命令安装\ ``lib
 参考：https://github.com/opendatalab/MinerU/issues/388
 
 5.遇到报错 ``ModuleNotFoundError : Nomodulenamed 'fairscale'``
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 需要卸载该模块并重新安装
 
@@ -59,7 +54,7 @@ WSL2的Ubuntu22.04中缺少\ ``libgl``\ 库，可通过以下命令安装\ ``lib
 参考：https://github.com/opendatalab/MinerU/issues/411
 
 6.在部分较新的设备如H100上，使用CUDA加速OCR时解析出的文字乱码。
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 cuda11对新显卡的兼容性不好，需要升级paddle使用的cuda版本
 
@@ -70,9 +65,8 @@ cuda11对新显卡的兼容性不好，需要升级paddle使用的cuda版本
 参考：https://github.com/opendatalab/MinerU/issues/558
 
 7.在部分Linux服务器上，程序一运行就报错 ``非法指令 (核心已转储)`` 或 ``Illegal instruction (core dumped)``
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 可能是因为服务器CPU不支持AVX/AVX2指令集，或cpu本身支持但被运维禁用了，可以尝试联系运维解除限制或更换服务器。
 
-参考：https://github.com/opendatalab/MinerU/issues/591 ，
-https://github.com/opendatalab/MinerU/issues/736
+参考：https://github.com/opendatalab/MinerU/issues/591 ，https://github.com/opendatalab/MinerU/issues/736