From e2eba4c4ad4ae3a01bba6f98e87f751d968802d3 Mon Sep 17 00:00:00 2001 From: MarkHoo Date: Sun, 18 Feb 2024 21:56:14 +0800 Subject: [PATCH] Delete installations directory --- installations/conda.md | 25 -------- installations/docker.md | 51 ---------------- installations/jupyter.md | 68 --------------------- installations/linux.md | 125 --------------------------------------- installations/macos.md | 62 ------------------- installations/windows.md | 63 -------------------- 6 files changed, 394 deletions(-) delete mode 100644 installations/conda.md delete mode 100644 installations/docker.md delete mode 100644 installations/jupyter.md delete mode 100644 installations/linux.md delete mode 100644 installations/macos.md delete mode 100644 installations/windows.md diff --git a/installations/conda.md b/installations/conda.md deleted file mode 100644 index 1511f8c..0000000 --- a/installations/conda.md +++ /dev/null @@ -1,25 +0,0 @@ -# Conda - -## 所需的依赖项 - -要创建 conda 环境，您必须首先安装 [conda](https://docs.conda.io/projects/conda/en/latest/user-guide/install/download.html) 或[mamba](https://mamba.readthedocs.io/en/latest/installation.html)这两个最流行的 conda 客户端。 - -安装 conda 后，您可以创建一个新环境并`manim`通过运行在里面安装 - -```sh -conda create -n my-manim-environment -conda activate my-manim-environment -conda install -c conda-forge manim -``` - -由于所有依赖项（LaTeX 除外）均由 conda 处理，因此您无需担心需要安装额外的依赖项。 - -## 可选依赖项 - -例如，为了利用 Manim 的 LaTeX 接口来渲染方程，还必须安装 LaTeX。请注意，这是一个可选的依赖项：如果您不打算使用 LaTeX，则不必安装它。 - -您可以按照[Windows]()、 [Linux]()或 [macOS]()的可选依赖项步骤安装 LaTeX 。 - -## 与Manim一起工作 - -此时，您应该已经安装好了 Manim，请前往我们的[快速入门教程]()，了解如何制作您自己的*动画*！ diff --git a/installations/docker.md b/installations/docker.md deleted file mode 100644 index adfb26c..0000000 --- a/installations/docker.md +++ /dev/null @@ -1,51 +0,0 @@ -# Docker - -社区维护着一个 docker 镜像，可以 [在 DockerHub 上](https://hub.docker.com/r/manimcommunity/manim)找到。对于我们的图像`manimcommunity/manim`，有以下标签： - -- `latest`[：对应主分支](https://github.com/ManimCommunity/manim)的最新版本， -- `stable`：最新发布的版本（根据 [发布页面](https://github.com/ManimCommunity/manim/releases)）， -- `vX.Y.Z`：任何特定的发布版本（根据 [发布页面](https://github.com/ManimCommunity/manim/releases)）。 - -> 笔记 - -> 在 Docker 容器中使用 Manim 的 CLI 时， 不支持某些标志，例如`-p`（预览文件）和（在文件浏览器中显示输出文件）。`-f` - -## Docker 容器的基本用法 - -假设您可以通过终端（bash / PowerShell）访问系统上的 docker 安装`docker`，则可以 使用以下命令`CircleToSquare`在文件 test_scenes.py 中渲染场景。 - -```sh -docker run --rm -it -v "/full/path/to/your/directory:/manim" manimcommunity/manim manim -qm test_scenes.py CircleToSquare -``` - -> 提示 - -> 对于 Linux 用户，让容器中的用户写入已安装的卷时可能会出现权限问题。添加到 CLI 参数以防止创建不属于您的用户的输出文件。` --user="$(id -u):$(id -g)"``docker ` - -您还可以创建一个可以根据自己的喜好进行修改的命名容器，而不是使用上面概述的“一次性容器”方法。第一次运行 - -```sh -docker run -it --name my-manim-container -v "/full/path/to/your/directory:/manim" manimcommunity/manim /bin/bash -``` - -在容器内获取交互式 shell，允许您安装更多依赖项（例如使用 texlive 包 `tlmgr`）。一旦您满意，请立即退出容器。然后，在使用它之前，通过运行启动容器 - -```sh -docker start my-manim-container -``` - -它在后台启动容器。`CircleToSquare`然后，要渲染文件中的场景`test_scenes.py`，请运行 - -```sh -docker exec -it my-manim-container manim -qm test_scenes.py CircleToSquare -``` - -## 通过 Docker 运行 JupyterLab - -使用 Docker 映像的另一种替代方法是启动本地 JupyterLab 实例。为此，只需运行 - -```sh -docker run -it -p 8888:8888 manimcommunity/manim jupyter lab --ip=0.0.0.0 -``` - -然后按照终端中的说明进行操作。 diff --git a/installations/jupyter.md b/installations/jupyter.md deleted file mode 100644 index 2451b15..0000000 --- a/installations/jupyter.md +++ /dev/null @@ -1,68 +0,0 @@ -# Jupyter Notebooks - -## Binder - -[Binder](https://mybinder.readthedocs.io/en/latest/)是一个在线平台，以 Jupyter 笔记本的形式托管可共享和可定制的计算环境。Manim 附带内置的`%%manim` Jupyter magic 命令，这使得它可以在这些笔记本中轻松使用。 - -要查看此类环境的示例，请访问我们的交互式教程：[https://try.manim.community/](https://try.manim.community/)。 - -以允许通过 Binder 交互共享的方式准备自己的笔记本相对简单： - -1. 首先，准备一个目录，其中包含您想要在交互式环境中共享的一个或多个笔记本。您可以通过使用本地安装的 Manim 的 Jupyter 笔记本来创建这些笔记本，也可以在我们预先存在的 [交互式教程环境](https://try.manim.community/)中工作。 -2. 在包含笔记本的同一目录中，添加一个名为`Dockerfile`以下内 ​​ 容的文件： - -```py -FROM docker.io/manimcommunity/manim:v0.9.0 - -COPY --chown=manimuser:manimuser . /manim -``` - - 创建笔记本时，不要忘记将版本标记更改`v0.9.0`为您在本地使用的版本。 - -3. 使包含您的工作表的目录并向`Dockerfile` 公众开放（特别是：Binder！）。有 [几种不同的选择可以做到这一点](https://mybinder.readthedocs.io/en/latest/introduction.html#how-can-i-prepare-a-repository-for-binder)，在社区中我们通常使用 GitHub 存储库或要点。 -4. 您的材料公开后，请访问 [https://mybinder.org](https://mybinder.org)并按照其中的说明为您的工作表生成交互式环境。 - -暗示 - -[包含我们的交互式教程的](https://try.manim.community)存储库可以在[https://github.com/ManimCommunity/jupyter_examples](https://github.com/ManimCommunity/jupyter_examples)找到 。 - -## 谷歌合作实验室 - -也可以在 [Google Colaboratory](https://colab.research.google.com/)环境中安装 Manim。与 Binder 不同，您可以预先自定义和准备环境（例如 Manim 已安装并可以使用），而每次在 Google Colab 中启动新笔记本时，您都必须注意这一点。幸运的是，这并不是特别困难。 - -创建新笔记本后，将以下代码块粘贴到单元格中，然后执行它。 - -```sh -!sudo apt update -!sudo apt install libcairo2-dev ffmpeg \ - texlive texlive-latex-extra texlive-fonts-extra \ - texlive-latex-recommended texlive-science \ - tipa libpango1.0-dev -!pip install manim -!pip install IPython --upgrade -``` - -您应该开始看到 Colab 安装这些命令中指定的所有依赖项。执行完成后，会提示您重新启动运行时。单击单元输出底部的“重新启动运行时”按钮。您现在可以在 Colab 中使用 Manim 了！ - -要检查一切是否按预期工作，首先通过运行导入 Manim - -```py -from manim import * -``` - -在新的代码单元中。然后创建另一个包含以下代码的单元格： - -```py -%%manim -qm -v WARNING SquareToCircle - -class SquareToCircle(Scene): - def construct(self): - square = Square() - circle = Circle() - circle.set_fill(PINK, opacity=0.5) - self.play(Create(square)) - self.play(Transform(square, circle)) - self.wait() -``` - -运行此单元格后，应渲染并显示一个将正方形转换为圆形的短动画。 diff --git a/installations/linux.md b/installations/linux.md deleted file mode 100644 index c8816e6..0000000 --- a/installations/linux.md +++ /dev/null @@ -1,125 +0,0 @@ -# Linux - -安装说明取决于您的特定操作系统和包管理器。如果您恰好知道自己在做什么，您还可以简单地确保您的系统具有： - -- Python 3 的最新版本 (3.7–3.10)， -- [与 pycairo](https://cairographics.org/pycairo/)形式的有效 Cairo 绑定一起 ， -- FFmpeg 可通过命令行访问`ffmpeg`， -- 和[Pango](https://pango.gnome.org)标头。 - -然后，安装 Manim 只需要运行： - -```sh -pip3 install manim -``` - -> 笔记 - -> 鉴于当前迁移到通过 OpenGL 进行渲染的努力，此列表可能不完整。如果您在安装时遇到缺少依赖项，请告诉我们 。 - -无论如何，我们还在下面编译了几种常见的操作系统和包管理器组合的说明。 - -## 所需的依赖项 - -### apt – Ubuntu / Mint / Debian - -要首先更新源代码，然后安装 Cairo、Pango 和 FFmpeg，只需运行： - -```sh -sudo apt update -sudo apt install build-essential python3-dev libcairo2-dev libpango1.0-dev ffmpeg -``` - -如果您没有安装 python3-pip，请通过以下方式安装： - -```sh -sudo apt install python3-pip -``` - -然后，要安装 Manim，请运行： - -```sh -pip3 install manim -``` - -继续阅读[可选依赖项]() 部分。 - -### dnf – Fedora / CentOS / RHEL - -安装 Cairo 和 Pango： - -```sh -sudo dnf install cairo-devel pango-devel -``` - -为了成功构建`pycairo`轮子，您还需要 Python 开发标头： - -```sh -sudo dnf install python3-devel -``` - -FFmpeg 只能通过 RPMfusion 存储库使用，您必须先配置该存储库 - 请参阅[https://rpmfusion.org/Configuration/](https://rpmfusion.org/Configuration/)了解说明。然后，安装 FFmpeg： - -```sh -sudo dnf install ffmpeg -``` - -此时，您已拥有所有必需的依赖项，并且可以通过运行以下命令来安装 Manim： - -```sh -pip3 install manim -``` - -继续阅读[可选依赖项]() 部分。 - -### pacman – Arch / Manjaro - -提示 - -感谢*groctel ，* AUR 上有一个专用的 Manim 包！ - -如果您不想使用 AUR 的打包版本，则需要手动执行以下操作：更新包源，然后安装 Cairo、Pango 和 FFmpeg： - -```sh -sudo pacman -Syu -sudo pacman -S cairo pango ffmpeg -``` - -如果您尚未`python-pip`安装，请运行以下命令来获取它： - -```sh -sudo pacman -S python-pip -``` - -然后只需通过以下方式安装 Manim： - -```sh -pip3 install manim -``` - -继续阅读[可选依赖项]() 部分。 - -## 可选依赖项 - -为了利用 Manim 的 LaTeX 接口来渲染方程等，还必须安装 LaTeX。请注意，这是一个可选的依赖项：如果您不打算使用 LaTeX，则不必安装它。 - -您可以使用您喜欢的任何 LaTeX 发行版或最容易通过包管理器安装的发行版。通常， 如果您不太关心磁盘空间，[TeX Live 是一个不错的选择。](https://www.tug.org/texlive/) - -对于基于 Debian 的系统（如 Ubuntu），可以通过运行以下命令来安装足够的 LaTeX 依赖项： - -```sh -sudo apt install texlive texlive-latex-extra -``` - -如果您选择使用一些较小的 TeX 发行版（例如 [TinyTeX ）](https://yihui.org/tinytex/)，Manim 以某种方式与之交互的 LaTeX 包的完整列表（一个子集可能足以满足您的特定应用程序）是： - -```sh -collection-basic amsmath babel-english cbfonts-fd cm-super ctex doublestroke -dvisvgm everysel fontspec frcursive fundus-calligra gnu-freefont jknapltx -latex-bin mathastext microtype ms physics preview ragged2e relsize rsfs -setspace standalone tipa wasy wasysym xcolor xetex xkeyval -``` - -## 与Manim一起工作 - -此时，您应该已经安装好了 Manim，请前往我们的[快速入门教程](../tutorials/quickstart.html)，了解如何制作您自己的*动画*！ diff --git a/installations/macos.md b/installations/macos.md deleted file mode 100644 index de1ea9d..0000000 --- a/installations/macos.md +++ /dev/null @@ -1,62 +0,0 @@ -# macOS - -为了简单起见，以下说明假设您已安装流行的[包管理器 Homebrew](https://brew.sh)。虽然您当然也可以在没有它的情况下安装所有依赖项，但使用 Homebrew 使该过程变得更加容易。 - -如果您想使用 Homebrew 但尚未安装，请按照[Homebrew 的安装说明](https://docs.brew.sh/Installation)进行操作。 - -> 笔记 - -> 在 Apple 发布其新的基于 ARM 的处理器（Apple Silicon 芯片，如*“M1 芯片”*）后的一段时间内，推荐的 Manim 安装方式依赖于*Rosetta*，Apple 在 Intel 和 ARM 架构之间的兼容层。这不再是必要的，Manim 可以（并且建议）本地安装。 - -## 所需的依赖项 - -要安装安装 Manim 所需的所有依赖项（即：ffmpeg、Python 和一些必需的 Python 包），请运行： - -```sh -brew install py3cairo ffmpeg -``` - -在基于*Apple Silicon*的机器上（即具有 M1 芯片或类似芯片的设备；如果您不确定要检查哪个处理器，请打开 Apple 菜单，选择“ *关于本机”并检查\_\_“芯片”*旁边的条目），需要一些额外的依赖项，即： - -```sh -brew install pango scipy -``` - -安装所有必需的依赖项后，只需运行： - -```sh -pip3 install manim -``` - -安装Manim。 - -> 笔记 - -> 安装问题的一个常见原因是`pip3` 系统上没有指向正确的 Python 安装。要检查这一点，请运行：对于 macOS Intel，路径应以 开头，对于 Apple Silicon， 路径应以 开头。如果不是这种情况，则您要么在安装 Homebrew 期间忘记修改 shell 配置文件 ( )，要么在执行此操作后没有重新加载 shell（例如，通过打开新终端）。也有可能其他一些软件（如 Pycharm）更改了该变量 \- 要解决此问题，请确保与 Homebrew 相关的行位于文件的最末尾。` pip3 -V``/usr/local``/opt/homebrew``.zprofile``PATH``.zprofile ` - -## 可选依赖项 - -为了利用 Manim 的 LaTeX 接口来渲染方程等，还必须安装 LaTeX。请注意，这是一个可选的依赖项：如果您不打算使用 LaTeX，则不必安装它。 - -对于 macOS，推荐的 LaTeX 发行版是 [MacTeX](http://www.tug.org/mactex/)。您可以按照链接中的说明进行安装，或者也可以通过 Homebrew 运行： - -```sh -brew install --cask mactex-no-gui -``` - -> 警告 - -> MacTeX 是一个\_完整的\_LaTeX 发行版，需要超过 4GB 的磁盘空间。如果这对您来说是个问题，请考虑安装较小的发行版，例如 [BasicTeX](http://www.tug.org/mactex/morepackages.html)。 - -如果您选择使用某些部分 TeX 发行版，Manim 以某种方式与之交互的 LaTeX 包的完整列表（一个子集可能足以满足您的特定应用程序）是： - -```sh -amsmath babel-english cbfonts-fd cm-super ctex doublestroke dvisvgm everysel -fontspec frcursive fundus-calligra gnu-freefont jknapltx latex-bin -mathastext microtype ms physics preview ragged2e relsize rsfs -setspace standalone tipa wasy wasysym xcolor xetex xkeyval -``` - -## 与Manim一起工作 - -此时，您应该已经安装了可以正常工作的 Manim。前往我们的[快速入门教程，]()了解如何制作自己的*动画*！ diff --git a/installations/windows.md b/installations/windows.md deleted file mode 100644 index edb0082..0000000 --- a/installations/windows.md +++ /dev/null @@ -1,63 +0,0 @@ -# Windows - --------------------------- - -## 所需依赖项 - -- Windows系统版本要求为 `Windows10+` -- Python版本要求： `Python3.8+` -- `FFmpeg` - -### 安装 Python - -1. 官网 [下载Python](https://www.python.org/downloads/) -2. 双击安装包，勾选 `Add To Path` ，安装时会自动为你配置好`Python`环境变量 -3. 安装路径，删除掉中间的路径，直接安装到C盘根目录，比如Python3.9： `C:\Python39` - --------------------------- - -> 提示：使用 `pip` 安装时，最好使用镜像，否则可能会因为网络安装失败，因为安装依赖较多且依赖包较大。 - -> 提示：提前升级 `pip` 到最新版本，否则会在本地安装依赖包时会报错提示因版本问题要求更新 `pip` ，命令如下： - -```sh -python -m pip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple -``` - -### 安装 Manim - -```sh -pip install manim -i https://pypi.tuna.tsinghua.edu.cn/simple -``` - -运行以下命令，检查是否安装完成 - -```sh -manim -``` - --------------------------- - -### 安装 `FFmpeg` - -1. 官网 [下载FFmpeg](https://ffmpeg.org/download.html#build-windows)，或者这里 [点击下载FFmpeg](https://www.gyan.dev/ffmpeg/builds/ffmpeg-release-essentials.7z) (推荐) -2. 将下载好的FFmpeg压缩包解压出来，把文件夹名称改为 `ffmpeg` ,然后将文件夹剪切或复制到C盘根目录 -3. 配置环境变量。依次打开 `Windows设置 -> 系统 -> 关于 -> 高级系统设置 -> 高级 -> 环境变量` ，然后根据需求在user或者系统变量里的 `Path` 中增加一条FFmpeg的bin路径，如： `C:\ffmpeg\bin` ，然后依次点击确定关闭所有窗口。 -4. 用快捷键 `Windows键 + r` 打开cmd，输入 `ffmpeg` 命令看能否正常运行，也可通过 `ffmpeg -version` 查看FFmpeg版本信息。 - -> 提示：Windows键也就是Windows系统图标的那个键，一般在 `Ctrl` 旁边 - --------------------------- - -## 可选依赖项 - -`MiKTeX`: 如果需要渲染方程或公式等等，需要安装。 - -### 安装 `MiKTeX` - -1. 官网 [下载MiKTeX](https://miktex.org/download) -2. 将下载好的 `MiKTeX` 的exe文件右键管理员打开，一直下一步即可，中间有选择为user安装或者为所有用户安装，可根据自身需要选择。 - -## 安装完成 - -恭喜！安装完成，开始愉快的学习吧！