diff --git a/docs/linux.md b/docs/linux.md index 4769aa91c..80e2b0a8c 100644 --- a/docs/linux.md +++ b/docs/linux.md @@ -3,6 +3,8 @@ ## Requirements These instructions are written for Debian/Ubuntu; adjust for your distribution. +Some extra notes have been provided by a forum member: +https://forums.ankiweb.net/t/guide-how-to-build-and-run-anki-from-source-with-xubuntu-20-04/12865 Glibc is required - if you are on a distro like Alpine that uses musl, you'll need to contribute fixes to the upstream [Rust rules](https://github.com/bazelbuild/rules_rust/issues/390), @@ -25,13 +27,12 @@ $ sudo apt install python3.8 ``` If you are using a packaged Python version that is installed in /usr/bin, you can jump -immediately to the next section. +immediately to the next section after ensuring python3.8-distutils is installed. -If Python 3.8 is not available in your distro, you can download it from python.org, -compile it, and install it in /usr/local. - -If you're on a basic Debian install, make sure you have the following installed -before building Python: +If Python 3.8 is not available in your distro, you can download it from +python.org, compile it, and install it in /usr/local. If you're on a basic +Debian install, make sure you have the following installed before building +Python: gcc g++ make libsqlite3-dev libreadline-dev libssl-dev zlib1g-dev libffi-dev @@ -45,10 +46,11 @@ build --action_env=PYTHON_SYS_EXECUTABLE=/usr/local/bin/python3.8 If you're building Anki from a docker container or distro that has no `python` command in /usr/bin, you'll need to symlink `python` to `/usr/bin/python`. `/usr/bin/python` does not -need to be Python 3.8; any version will do. +need to be Python 3.8; any version will do. `apt install python-is-python3` can also be +used to link python3 to python. If your system only has Python 3.9, you should be able to build Anki with it, -but the pylint tests will currently fail, as pylint does not yet support Python 3.9. +but the pylint tests may fail. Anki's build system will not place packages in system locations, so you do not need to build with an active Python virtual environment, and building outside