diff options
author | 2022-11-12 18:32:32 -0800 | |
---|---|---|
committer | 2022-11-12 18:32:32 -0800 | |
commit | 3dc5756446a94acf04d235781a74019e90e64727 (patch) | |
tree | 7e7df577bb2d9e4f90628e822522ac97a8087c45 | |
parent | Added some of wookies Windows guide review suggestions (diff) | |
parent | Update pydis_site/apps/content/resources/guides/python-guides/windows/putting... (diff) |
Merge branch 'add-windows-guide' of https://github.com/discretegames/python-discord-site into add-windows-guide
3 files changed, 8 insertions, 8 deletions
diff --git a/pydis_site/apps/content/resources/guides/python-guides/windows/common-issues.md b/pydis_site/apps/content/resources/guides/python-guides/windows/common-issues.md index 6ab3e3c5..878ff20c 100644 --- a/pydis_site/apps/content/resources/guides/python-guides/windows/common-issues.md +++ b/pydis_site/apps/content/resources/guides/python-guides/windows/common-issues.md @@ -5,7 +5,7 @@ icon: fab fa-windows toc: 3 --- -### When I run `python` in the terminal I get no result, or the Windows Store opens! +### When I run `python` in the terminal I get no result, or the Microsoft Store opens! By default Windows has an alias for `python` in the terminal to guide you to install it from the [Microsoft Store](https://apps.microsoft.com/store/search/python). We don't recommend installing Python from the Microsoft diff --git a/pydis_site/apps/content/resources/guides/python-guides/windows/installing-and-using-python.md b/pydis_site/apps/content/resources/guides/python-guides/windows/installing-and-using-python.md index 4bbaf4a3..cbfc17a3 100644 --- a/pydis_site/apps/content/resources/guides/python-guides/windows/installing-and-using-python.md +++ b/pydis_site/apps/content/resources/guides/python-guides/windows/installing-and-using-python.md @@ -34,7 +34,7 @@ Windows 11 or other modern versions of Python.) > version compatibility or for working on projects made in a certain version. Only uninstall things if you want to. 1. Go to [python.org/downloads](https://www.python.org/downloads) and click the big yellow "Download Python 3.x.x" - button near the top of the page. That should start the download of the latest Windows Python installer that best + button near the top of the page. That should start the download of the installer for the latest version that best suits your computer. If you want a different version or it doesn't work for some reason, you can download the @@ -54,7 +54,7 @@ Windows 11 or other modern versions of Python.) [](/static/images/content/python-on-windows/recommended_install_3.png) 4. Then click the big "Install Now" button. Aside from adding Python to PATH, the rest of the installer defaults are - usually fine, so there's no need to customize the installation unless you want to. + usually fine, so there's no need to customize the installation unless you have a specific reason to. [](/static/images/content/python-on-windows/recommended_install_4.png) @@ -73,7 +73,7 @@ Python console app and run some code like `print("Hello, World!")`. [](/static/images/content/python-on-windows/recommended_install_7.png) Or try the more usual way of running Python by typing `python` in a new terminal window to open up the Python -[REPL](https://en.wikipedia.org/wiki/Read%E2%80%93eval%E2%80%93print_loop), or use `python somefile.py` to run some +[REPL](https://en.wikipedia.org/wiki/Read%E2%80%93eval%E2%80%93print_loop), or use `python somefile.py` to run a Python file. You can use whichever terminal you prefer: Command Prompt, PowerShell, an IDE-integrated terminal, [Windows Terminal](https://apps.microsoft.com/store/detail/windows-terminal/9N0DX20HK701), etc. It just has to be a freshly opened terminal or the commands may not be recognized. @@ -211,7 +211,7 @@ and requires Django 3.2, and the other is newer and requires Django 4.1. If you you install 3.2 or 4.1, one or the or the other of the projects will have the wrong version. If instead you make a virtual environment for each project, you can install the required Django version for each separately. -Virtual environments are not exclusive to Windows, but the commands to use them can differ a bit across operating +Virtual environments are not exclusive to Windows, but the commands to use them can differ across operating systems. Check out the [official docs](https://docs.python.org/3/tutorial/venv.html#creating-virtual-environments) and the builtin [venv](https://docs.python.org/3/library/venv.html) module for more details, but there are basically 3 important venv commands. Run them once you `cd` into your project folder. diff --git a/pydis_site/apps/content/resources/guides/python-guides/windows/putting-python-on-path.md b/pydis_site/apps/content/resources/guides/python-guides/windows/putting-python-on-path.md index fdb33c9a..09c6f9da 100644 --- a/pydis_site/apps/content/resources/guides/python-guides/windows/putting-python-on-path.md +++ b/pydis_site/apps/content/resources/guides/python-guides/windows/putting-python-on-path.md @@ -115,7 +115,7 @@ installed](https://pypi.org/project/pyinstaller/) it) now work for you! Hopefully things are indeed working, however, it is possible that, due to having multiple Python versions, or other mixups, the commands are still not behaving how you expect. If so, read on to learn how to manually edit the Path. (If -you already did that, open a help channel on the [Python Discord server](https://discord.com/invite/python) and someone +you already did that, open a help channel on the [Python Discord server](https://discord.com/invite/python) explaining everything you've tried so far, and someone will hopefully be able to help.) ## Advanced Method: Manually edit the Path @@ -155,7 +155,7 @@ Again, the Path lookup order is: ### Adding Python to your Path -Here the common case of adding Python and the Python Scripts directory to the Windows Path is detailed. Though knowing +Here only the common case of adding Python and the Python Scripts directory to the Windows Path is detailed. However, knowing how to manually modify the Path is handy beyond just Python for whenever you need to change or debug which programs run on the command line in Windows. (The less customizable but [safer method is above](#safe-method-let-the-installer-add-python-to-path) if you missed it.) @@ -202,7 +202,7 @@ Follow these steps to add Python to the Path. **You will need administrator priv [](/static/images/content/python-on-windows/edit_path_3.png) - I suggest using the User Path (what the screenshots show) for the default installation of Python. In general, only + You should use the User Path (what the screenshots show) for the default installation of Python. In general, only put things on the System Path if they are installed for all users (e.g. in `C:\Program Files` or `C:\`) and you're certain they won't overshadow anything in User Paths. **Remember, the System Path takes precedence over the User Path when commands are looked up.** |