From e72390d613f905bf806d5df5a882e91e606268cc Mon Sep 17 00:00:00 2001
From: Safin Singh <42120904+safinsingh@users.noreply.github.com>
Date: Wed, 21 Oct 2020 21:22:45 -0700
Subject: [PATCH 1/6] Clean up README
---
README.md | 93 ++++++++++++++++++++++++++++---------------------------
1 file changed, 47 insertions(+), 46 deletions(-)
diff --git a/README.md b/README.md
index c8e231d425..c91382bb51 100644
--- a/README.md
+++ b/README.md
@@ -1,34 +1,45 @@
-
-
-
-[](https://manimce.readthedocs.io/en/latest/?badge=latest)
-[](http://choosealicense.com/licenses/mit/)
-[](https://www.reddit.com/r/manim/)
-[](https://discord.gg/mMRrZQW)
-
-Manim is an animation engine for explanatory math videos. It's used to create precise animations programmatically, as seen in the videos at [3Blue1Brown](https://www.3blue1brown.com/).
-
-> NOTE: This repository is maintained by the Manim Community, and is not associated with Grant Sanderson or 3Blue1Brown in any way (though we are definitely indebted to him for providing his work to the world). If you want to study how Grant makes his videos, head over to his repository (3b1b/manim). This is a more frequently updated repository than that one, and is recommended if you want to use Manim for your own projects.
+
+
+
+
+
+
+
+
+
+
+
+ An animation engine for explanatory math videos
+
+
+
+
+`manim` is an animation engine for explanatory math videos. It's used to create precise animations programmatically, as demonstrated in the videos of [3Blue1Brown](https://www.3blue1brown.com/).
+
+> NOTE: This repository is maintained by the Manim Community, and is not associated with Grant Sanderson or 3Blue1Brown in any way (although we are definitely indebted to him for providing his work to the world). If you would like to study how Grant makes his videos, head over to his repository ([3b1b/manim](https://github.com/3b1b/manim)). This fork is updated more frequently than that his, and it's recommended to use this fork if you'd like to use Manim for your own projects.
## Table of Contents:
-- [Installation](#installation)
-- [Usage](#usage)
-- [Documentation](#documentation)
-- [Help with Manim](#help-with-manim)
-- [Contributing](#contributing)
-- [License](#license)
+- [Installation](#installation)
+- [Usage](#usage)
+- [Documentation](#documentation)
+- [Help with Manim](#help-with-manim)
+- [Contributing](#contributing)
+- [License](#license)
## Installation
-Manim has a few dependencies that need to be installed before it. Please visit
-the
-[documentation](https://manimce.readthedocs.io/en/latest/installation.html)
-and follow the instructions according to your operating system.
+`manim` requires a few dependencies that must be installed prior to using it. Please visit the [documentation](https://manimce.readthedocs.io/en/latest/installation.html) and follow the appropriate instructions for your operating system.
+
+Once the dependencies have been installed, run the following in a terminal window:
+
+```bash
+pip install manimce
+```
## Usage
-Here is an example manim script:
+`manim` is an extremely versatile package. The following is an example `Scene` you can construct:
```python
from manim import *
@@ -46,21 +57,18 @@ class SquareToCircle(Scene):
self.play(FadeOut(square))
```
-Save this code in a file called `example.py`. Now open your terminal in the
-folder where you saved the file and execute
+In order to view the output of this scene, save the code in a file called `example.py`. Then, run the following in a terminal window:
```sh
manim example.py SquareToCircle -pl
```
-You should see your video player pop up and play a simple scene where a square
-is transformed into a circle. You can find some more simple examples in the
-[GitHub repository](https://github.com/ManimCommunity/manim/tree/master/example_scenes).
-Visit the [official gallery](https://manimce.readthedocs.io/en/latest/examples.html) for more advanced examples.
+You should see your native video player program pop up and play a simple scene in which a square is transformed into a circle. You may find some more simple examples within this
+[GitHub repository](https://github.com/ManimCommunity/manim/tree/master/example_scenes). You can also visit the [official gallery](https://manimce.readthedocs.io/en/latest/examples.html) for more advanced examples.
## Command line arguments
-The general usage of manim is as follows:
+The general usage of `manim` is as follows:

@@ -68,12 +76,11 @@ The `-p` flag in the command above is for previewing, meaning the video file wil
Some other useful flags include:
-- `-s` to skip to the end and just show the final frame.
-- `-n ` to skip ahead to the `n`'th animation of a scene.
-- `-f` show the file in the file browser.
+- `-s` to skip to the end and just show the final frame.
+- `-n ` to skip ahead to the `n`'th animation of a scene.
+- `-f` show the file in the file browser.
-For a thorough list of command line arguments, visit the
-[documentation](https://manimce.readthedocs.io/en/latest/tutorials/configuration.html).
+For a thorough list of command line arguments, visit the [documentation](https://manimce.readthedocs.io/en/latest/tutorials/configuration.html).
## Documentation
@@ -81,21 +88,15 @@ Documentation is in progress at [ReadTheDocs](https://manimce.readthedocs.io/en/
## Help with Manim
-If you need help installing or using Manim, please take a look at [the Reddit
-Community](https://www.reddit.com/r/manim) or the [Discord
-Community](https://discord.gg/mMRrZQW). For bug reports and feature requests,
-please open an issue.
+If you need help installing or using Manim, feel free to reach out to our [Reddit Community](https://www.reddit.com/r/manim) or [Discord
+Server](https://discord.gg/mMRrZQW). If you would like to submit bug report or feature request, please open an issue.
## Contributing
-Is always welcome. In particular, there is a dire need for tests and
-documentation. For guidelines please see the
-[documentation](https://manimce.readthedocs.io/en/latest/contributing.html).
-This project uses [Poetry](https://python-poetry.org/docs/) for management. You need to have poetry installed and available in your environment.
-You can find more information about it in its [Documentation](https://manimce.readthedocs.io/en/latest/installation/for_dev.html)
+Contributions to `manim` are always welcome. In particular, there is a dire need for tests and documentation. For contribution guidelines, please see the [documentation](https://manimce.readthedocs.io/en/latest/contributing.html).
+
+This project uses [Poetry](https://python-poetry.org/docs/) for management. You must have poetry installed and available in your environment. You can learn more `poetry` and how to use it at its [Documentation](https://manimce.readthedocs.io/en/latest/installation/for_dev.html).
## License
-The software is double-licensed under the MIT license, with copyright
-by 3blue1brown LLC (see LICENSE), and copyright by Manim Community
-Developers (see LICENSE.community).
+The software is double-licensed under the MIT license, with copyright by 3blue1brown LLC (see LICENSE), and copyright by Manim Community Developers (see LICENSE.community).
From 2099054c5ae905459c1a796b27684d963b8ae8bd Mon Sep 17 00:00:00 2001
From: Safin Singh <42120904+safinsingh@users.noreply.github.com>
Date: Thu, 22 Oct 2020 12:58:21 -0700
Subject: [PATCH 2/6] update flags
---
README.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/README.md b/README.md
index c91382bb51..ba86764b91 100644
--- a/README.md
+++ b/README.md
@@ -60,7 +60,7 @@ class SquareToCircle(Scene):
In order to view the output of this scene, save the code in a file called `example.py`. Then, run the following in a terminal window:
```sh
-manim example.py SquareToCircle -pl
+manim example.py SquareToCircle -p -ql
```
You should see your native video player program pop up and play a simple scene in which a square is transformed into a circle. You may find some more simple examples within this
From 5988cec920650b7694522bd5b6823c502f783468 Mon Sep 17 00:00:00 2001
From: Leo Torres
Date: Sun, 8 Nov 2020 20:47:47 -0500
Subject: [PATCH 3/6] Apply suggestions from code review
---
README.md | 12 ++++++------
1 file changed, 6 insertions(+), 6 deletions(-)
diff --git a/README.md b/README.md
index f95b73a2a5..1269378ba4 100644
--- a/README.md
+++ b/README.md
@@ -29,7 +29,7 @@
## Installation
-`manim` requires a few dependencies that must be installed prior to using it. Please visit the [documentation](https://manimce.readthedocs.io/en/latest/installation.html) and follow the appropriate instructions for your operating system.
+Manim requires a few dependencies that must be installed prior to using it. Please visit the [documentation](https://manimce.readthedocs.io/en/latest/installation.html) and follow the appropriate instructions for your operating system.
Once the dependencies have been installed, run the following in a terminal window:
@@ -39,7 +39,7 @@ pip install manimce
## Usage
-`manim` is an extremely versatile package. The following is an example `Scene` you can construct:
+Manim is an extremely versatile package. The following is an example `Scene` you can construct:
```python
from manim import *
@@ -68,11 +68,11 @@ You should see your native video player program pop up and play a simple scene i
## Command line arguments
-The general usage of `manim` is as follows:
+The general usage of manim is as follows:

-The `-p` flag in the command above is for previewing, meaning the video file will automatically open when it is done rendering. The `-l` flag is for a faster rendering at a lower quality.
+The `-p` flag in the command above is for previewing, meaning the video file will automatically open when it is done rendering. The `-ql` flag is for a faster rendering at a lower quality.
Some other useful flags include:
@@ -88,8 +88,8 @@ Documentation is in progress at [ReadTheDocs](https://manimce.readthedocs.io/en/
## Help with Manim
-If you need help installing or using Manim, feel free to reach out to our [Reddit Community](https://www.reddit.com/r/manim) or [Discord
-Server](https://discord.gg/mMRrZQW). If you would like to submit bug report or feature request, please open an issue.
+If you need help installing or using Manim, feel free to reach out to our [Discord
+Server](https://discord.gg/mMRrZQW) or [Reddit Community](https://www.reddit.com/r/manim). If you would like to submit bug report or feature request, please open an issue.
## Contributing
From 0a6e7e17bc32627e6073fafca7c426a57d43f0cd Mon Sep 17 00:00:00 2001
From: kolibril13
Date: Mon, 9 Nov 2020 15:42:58 +0100
Subject: [PATCH 4/6] updated command.png
---
readme-assets/command.png | Bin 29522 -> 56285 bytes
1 file changed, 0 insertions(+), 0 deletions(-)
diff --git a/readme-assets/command.png b/readme-assets/command.png
index 1fc7004ddda6cd3de39bea3eba0c201095e00aeb..33772374ce7be8f841a6f833a1e62d951db1bd64 100644
GIT binary patch
literal 56285
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