docs: add translation

.github/workflows/sync-and-translate.yml

@@ -38,7 +38,7 @@ jobs:
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip
-        pip install setuptools polib==1.2.0 openai==v1.3.6 python-dotenv==1.0.0 pytest==8.2.2 sphinx-intl sphinx-book-theme==1.0.1 myst-parser sphinxcontrib-bibtex==2.5.0 autodocsumm sphinx-copybutton sphinx-icon sphinx_design sphinxemoji numpy matplotlib warp-lang gymnasium
+        pip install setuptools polib==1.2.0 openai==v1.3.6 python-dotenv==1.0.0 pytest==8.2.2 sphinx-intl sphinx-book-theme==1.0.1 myst-parser sphinxcontrib-bibtex==2.5.0 autodocsumm sphinx-copybutton sphinx-icon sphinx_design sphinxemoji numpy matplotlib warp-lang gymnasium sphinx-comments
 
     - name: Generate gettext
       run: |
@@ -52,12 +52,6 @@ jobs:
         sphinx-intl update -p _build/gettext -l zh_CN
         popd
 
-    - name: show po and pot files
-      run: |
-        ls docs
-        ls docs/_build/gettext
-        ls docs/locale/zh_CN/LC_MESSAGES
-
     - name: Translate using custom script
       run: |
         pushd docs

docs/conf.py

@@ -54,6 +54,7 @@
     "sphinxcontrib.icon",
     "sphinx_copybutton",
     "sphinx_design",
+    "sphinx_comments",
 ]
 
 # mathjax hacks
@@ -257,4 +258,10 @@ def setup(app):
     app.connect("autodoc-skip-member", skip_member)
 
 locale_dirs = ['locale/']  # path is example but recommended.
-gettext_compact = False     # optional.
+gettext_compact = False     # optional.
+
+comments_config = {
+   "utterances": {
+      "repo": "fan-ziqi/IsaacLab",
+   }
+}

docs/index.rst

@@ -64,6 +64,7 @@ Table of Contents
    source/setup/sample
    source/setup/template
    source/setup/faq
+   source/setup/translation
 
 .. toctree::
    :maxdepth: 2

docs/source/setup/translation.rst

@@ -0,0 +1,6 @@
+About Translation
+=========================
+
+Translator: `fan-ziqi <https://github.com/fan-ziqi>`__ 
+
+Translation will be updated on `fan-ziqi/IsaacLab <https://github.com/fan-ziqi/IsaacLab>`__