From 2f202e26b27c08fa233ca466800377ae5a888e47 Mon Sep 17 00:00:00 2001 From: Tony031218 <975062472@qq.com> Date: Mon, 15 Feb 2021 12:23:53 +0800 Subject: [PATCH] update docs for pip install --- README.md | 51 ++++++++++++-------- docs/source/getting_started/installation.rst | 10 +++- 2 files changed, 41 insertions(+), 20 deletions(-) diff --git a/README.md b/README.md index d9f2f5ee..56e090ec 100644 --- a/README.md +++ b/README.md @@ -4,9 +4,10 @@

+[![pypi version](https://img.shields.io/pypi/v/manimgl?logo=pypi)](https://pypi.org/project/manimgl/) [![MIT License](https://img.shields.io/badge/license-MIT-blue.svg?style=flat)](http://choosealicense.com/licenses/mit/) -[![Manim Subreddit](https://img.shields.io/reddit/subreddit-subscribers/manim.svg?color=ff4301&label=reddit)](https://www.reddit.com/r/manim/) -[![Manim Discord](https://img.shields.io/discord/581738731934056449.svg?label=discord)](https://discord.gg/mMRrZQW) +[![Manim Subreddit](https://img.shields.io/reddit/subreddit-subscribers/manim.svg?color=ff4301&label=reddit&logo=reddit)](https://www.reddit.com/r/manim/) +[![Manim Discord](https://img.shields.io/discord/581738731934056449.svg?label=discord&logo=discord)](https://discord.gg/mMRrZQW) [![docs](https://github.com/3b1b/manim/workflows/docs/badge.svg)](https://3b1b.github.io/manim/) Manim is an engine for precise programatic animations, designed for creating explanatory math videos. @@ -18,12 +19,21 @@ Since the fork, this version has evolved to work on top of OpenGL, and allows re ## Installation Manim runs on Python 3.6 or higher (Python 3.8 is recommended). -System requirements are [FFmpeg](https://ffmpeg.org/), [OpenGL](https://www.opengl.org//) and [LaTeX](https://www.latex-project.org) (optional, if you want to use LaTeX). +System requirements are [FFmpeg](https://ffmpeg.org/), [OpenGL](https://www.opengl.org/) and [LaTeX](https://www.latex-project.org) (optional, if you want to use LaTeX). -For more options, take a look at the [Using manim](#using-manim) sections further below. ### Directly +```sh +# Install manimgl +pip install manimgl + +# Try it out +manimgl +``` + +For more options, take a look at the [Using manim](#using-manim) sections further below. + If you want to hack on manimlib itself, clone this repository and in that directory execute: ```sh @@ -35,7 +45,21 @@ manimgl example_scenes.py OpeningManimExample # or manim-render example_scenes.py OpeningManimExample ``` + +### Directly (Windows) + +1. [Install FFmpeg](https://www.wikihow.com/Install-FFmpeg-on-Windows). +2. Install a LaTeX distribution. [MiKTeX](https://miktex.org/download) is recommended. +3. Install the remaining Python packages. + ```sh + git clone https://github.com/3b1b/manim.git + cd manim + pip install -e . + manimgl example_scenes.py OpeningManimExample + ``` + ### Mac OSX + 1. Install FFmpeg, LaTeX in terminal using homebrew. ```sh brew install ffmpeg mactex @@ -49,23 +73,12 @@ manim-render example_scenes.py OpeningManimExample manimgl example_scenes.py OpeningManimExample ``` -### Directly (Windows) -1. [Install FFmpeg](https://www.wikihow.com/Install-FFmpeg-on-Windows). -2. Install a LaTeX distribution. [MiKTeX](https://miktex.org/download) is recommended. -3. Install the remaining Python packages. - ```sh - git clone https://github.com/3b1b/manim.git - cd manim - pip install -e . - manimgl example_scenes.py OpeningManimExample - ``` - ## Anaconda Install -* Install LaTeX as above. -* Create a conda environment using `conda create -n manim python=3.8`. -* Activate the environment using `conda activate manim`. -* Install manimgl using `pip install -e .`. +1. Install LaTeX as above. +2. Create a conda environment using `conda create -n manim python=3.8`. +3. Activate the environment using `conda activate manim`. +4. Install manimgl using `pip install -e .`. ## Using manim diff --git a/docs/source/getting_started/installation.rst b/docs/source/getting_started/installation.rst index 8b88e3c2..17969870 100644 --- a/docs/source/getting_started/installation.rst +++ b/docs/source/getting_started/installation.rst @@ -1,7 +1,7 @@ Installation ============ -Manim runs on Python 3.8. +Manim runs on Python 3.6 or higher (Python 3.8 is recommended). System requirements are: @@ -12,6 +12,14 @@ System requirements are: Directly -------- +.. code-block:: sh + + # Install manimgl + pip install manimgl + + # Try it out + manimgl + If you want to hack on manimlib itself, clone this repository and in that directory execute: