diff --git a/docs/source/onnx/faqs/index.rst b/docs/source/onnx/faqs/index.rst new file mode 100644 index 000000000..e790aa375 --- /dev/null +++ b/docs/source/onnx/faqs/index.rst @@ -0,0 +1,42 @@ +Frequently Asked Question (FAQs) +================================ + +This page contains frequently asked questions for `sherpa-onnx`_. + +Cannot open shared library libasound_module_conf_pulse.so +--------------------------------------------------------- + +The detailed errors are given below: + +.. code-block:: + + Cannot open shared library libasound_module_conf_pulse.so + (/usr/lib64/alsa-lib/libasound_module_conf_pulse.so: cannot open shared object file: No such file or directory) + ALSA lib pcm.c:2722:(snd_pcm_open_noupdate) Unknown PCM + +If you use Linux and get the above error when trying to use the microphone, please do the following: + + 1. Locate where is the file ``libasound_module_conf_pulse.so`` on your system + + .. code-block:: bash + + find / -name libasound_module_conf_pulse.so 2>/dev/null + + 2. If the above search command prints:: + + /usr/lib/x86_64-linux-gnu/alsa-lib/libasound_module_conf_pulse.so + /usr/lib/i386-linux-gnu/alsa-lib/libasound_module_conf_pulse.so + + 3. Please run:: + + sudo mkdir -p /usr/lib64/alsa-lib + sudo ln -s /usr/lib/x86_64-linux-gnu/alsa-lib/libasound_module_conf_pulse.so /usr/lib64/alsa-lib + + 4. Now your issue should be fixed. + + +TTS 中文模型没有声音 +-------------------- + +Please see :ref:`how_to_enable_utf8_on_windows`. +You need to use ``UTF-8`` encoding for your system. diff --git a/docs/source/onnx/index.rst b/docs/source/onnx/index.rst index 1ecda9129..a48607f71 100644 --- a/docs/source/onnx/index.rst +++ b/docs/source/onnx/index.rst @@ -24,6 +24,7 @@ Also, we show how to use it for speech recognition with pre-trained models. :maxdepth: 5 ./install/index + ./faqs/index ./python/index ./c-api/index ./go-api/index diff --git a/docs/source/onnx/pretrained_models/whisper/export-onnx.rst b/docs/source/onnx/pretrained_models/whisper/export-onnx.rst index 1b50a432c..2052024c3 100644 --- a/docs/source/onnx/pretrained_models/whisper/export-onnx.rst +++ b/docs/source/onnx/pretrained_models/whisper/export-onnx.rst @@ -116,7 +116,7 @@ Now the generated files so far are as follows: ``*.ort`` are the corresponding `onnxruntime`_ format. -To check whether the export model works correctly, we can use +To check whether the exported model works correctly, we can use ``_ diff --git a/docs/source/onnx/tts/faq.rst b/docs/source/onnx/tts/faq.rst index d2fc09d74..4e31889f1 100644 --- a/docs/source/onnx/tts/faq.rst +++ b/docs/source/onnx/tts/faq.rst @@ -1,3 +1,5 @@ +.. _tts_faqs: + Frequently Asked Question (FAQs) ================================ @@ -14,6 +16,8 @@ It shows you - How to download pre-trained text-to-speech (TTS) models - How to use `sherpa-onnx`_ with pre-trained models for TTS +.. _how_to_enable_utf8_on_windows: + How to enable UTF-8 on Windows ------------------------------