更新

Author: xinetzone

.github/workflows/pages.yml

@@ -46,7 +46,7 @@ jobs:
           pip install --upgrade pip
           pip install .[doc] --upgrade
           conda install -c conda-forge pandoc compilers cppyy pandoc llvm doxygen 
-          conda install anaconda::graphviz
+          conda install -c conda-forge -y graphviz
           invoke doc
       - name: Setup Pages
         uses: actions/configure-pages@main

doc/conf.py

@@ -26,6 +26,7 @@
 # -------------------------------------------------------------------------------------
 extensions = [
     "myst_nb",
+    "breathe",
     "sphinx_design",
     "sphinx.ext.viewcode", # 添加到高亮源代码的链接
     "sphinx.ext.extlinks", # 缩短外部链接
@@ -124,8 +125,8 @@
 # ===================== 可选 ==========================================================
 # 用户可以使用 BibTeX 格式的参考文献数据库，并在文档中插入引用和生成参考文献列表。
 # -------------------------------------------------------------------------------------
-extensions.append('sphinxcontrib.bibtex')
-bibtex_bibfiles = ['refs.bib']
+# extensions.append('sphinxcontrib.bibtex')
+# bibtex_bibfiles = ['refs.bib']
 # 自动生成 API 文档的路径
 # -------------------------------------------------------------------------------------
 extensions.append("autoapi.extension")

doc/draft/draft2.md

@@ -35,7 +35,7 @@ echo %ERRORLEVEL%
 ```
 ````
 
-````{tab-item}Linux
+````{tab-item} Linux
 ```sh
 echo $?
 ```

doc/exercises/cpp2c.ipynb

@@ -16,13 +16,27 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
-   "metadata": {
-    "vscode": {
-     "languageId": "c++"
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stderr",
+     "output_type": "stream",
+     "text": [
+      "input_line_8:1:10: fatal error: 'cppExample.h' file not found\n",
+      "#include \"cppExample.h\"\n",
+      "         ^~~~~~~~~~~~~~\n"
+     ]
+    },
+    {
+     "ename": "Interpreter Error",
+     "evalue": "",
+     "output_type": "error",
+     "traceback": [
+      "Interpreter Error: "
+     ]
     }
-   },
-   "outputs": [],
+   ],
    "source": [
     "//C++头文件 cppExample.h\n",
     "#ifndef CPP_EXAMPLE_H\n",
@@ -47,6 +61,13 @@
     "    return 0;\n",
     "}"
    ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
   }
  ],
  "metadata": {
@@ -56,7 +77,11 @@
    "name": "xcpp14"
   },
   "language_info": {
-   "name": "C++14"
+   "codemirror_mode": "text/x-c++src",
+   "file_extension": ".cpp",
+   "mimetype": "text/x-c++src",
+   "name": "c++",
+   "version": "14"
   }
  },
  "nbformat": 4,