基于 Gitea 服务端渲染的 Jupyter Notebooks

本指南将向您展示如何通过配置外部渲染器来使 Gitea 呈现 Jupyter Notebooks。当然，你还可以根据本指南来为你的 Gitea 实例配置其他类型的文档渲染器，甚至是二进制文件！相信Gitea，一切皆有可能。

• 💡你知道吗？我们现在已经开通了微信公众号和哔哩哔哩视频栏目，欢迎关注、点赞、一键三连! 🍵
• 点击链接加入群聊【Gitea 官方技术群】：328432459

如何让 Gitea 原生支持渲染 .ipynb 文件

首先，让我们在 Gitea 实例上创建一个新的存储库并将示例笔记本推送上去：

当前，就如我们看到的那样，Gitea 只是将文档的原始内容以纯文本的形式渲染出来——虽然高效但是可读性差。

如何才能生成可读的 HTML 文档

为了向用户显示更有吸引力的东西，我们需要一些 HTML，幸运的是 Jupyter 有一个名为 nbconvert 的模块：

在 Gitea 服务器上安装我们所需的 nbconvert，它是一个 Python 模块：

sudo apt install python3-pip
pip3 install nbconvert

安装完成，我们可以通过运行命令来测试它，将一个 .ipynb