Add FAQs (#554)

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.

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

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
 
   `<https://github.com/k2-fsa/sherpa-onnx/blob/master/scripts/whisper/test.py>`_
 

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
 ------------------------------