This document will guide you through installing Python 3.12 and Django on\nWindows. It also provides instructions for setting up a virtual environment,\nwhich makes it easier to work on Python projects. This is meant as a beginner’s\nguide for users working on Django projects and does not reflect how Django\nshould be installed when developing changes for Django itself.
\n이 가이드의 단계는 Windows 10에서 테스트되었습니다. 다른 버전에서는 단계가 비슷합니다. Windows(윈도우) 명령 프롬프트를 사용하는 방법을 숙지해야 합니다.
\nDjango is a Python web framework, thus requiring Python to be installed on your\nmachine. At the time of writing, Python 3.12 is the latest version.
\n컴퓨터에 Python을 설치하려면 https://www.python.org/downloads/로 이동합니다. 웹 사이트에서 최신 Python 버전에 대한 다운로드 버튼을 제공해야 합니다. 실행 가능한 설치 프로그램을 다운로드하고 실행합니다. “모든 사용자를 위한 런처 설치(권장)” 옆의 확인란을 선택한 다음 “지금 설치”를 클릭합니다.
\nAfter installation, open the command prompt and check that the Python version\nmatches the version you installed by executing:
\n...\\> py --version\npip에 대하여Link to this heading#pip is a package manager for Python and is included by default with the\nPython installer. It helps to install and uninstall Python packages\n(such as Django!). For the rest of the installation, we’ll use pip to\ninstall Python packages from the command line.
생성하는 각 Django 프로젝트에 전용 환경을 제공하는 것이 좋습니다. 파이썬 생태계 내 환경 및 패키지를 관리할 수 있는 여러 가지 옵션이 있으며 이 중 일부는 파이썬 설명서(https://packaging.python.org/guides/tool-recommendations/)에 나와 있습니다. Python 자체는 우리가 이 가이드에 사용할 환경을 관리하기 위한 :doc:’venv <python:tutorial/venv’와 함께 제공됩니다.
\nTo create a virtual environment for your project, open a new command prompt,\nnavigate to the folder where you want to create your project and then enter the\nfollowing:
\n...\\> py -m venv project-name\nThis will create a folder called ‘project-name’ if it does not already exist\nand set up the virtual environment. To activate the environment, run:
\n...\\> project-name\\Scripts\\activate.bat\n가상 환경이 활성화되고 명령 프롬프트 옆에 “(프로젝트 이름)”이 표시되어 가상 환경을 지정합니다. 새 명령 프롬프트를 시작할 때마다 환경을 다시 활성화해야 합니다.
\nDjango는 가상 환경 내에서 “pip”을 사용하여 쉽게 설치할 수 있습니다.
\nIn the command prompt, ensure your virtual environment is active, and execute\nthe following command:
\n...\\> py -m pip install Django\n그러면 최신 Django 릴리스가 다운로드되고 설치됩니다.
\n설치가 완료되면 명령 프롬프트에서 “django-admin –version”을 실행하여 Django 설치를 확인할 수 있습니다.
\nDjango와의 데이터베이스 설치에 대한 자세한 내용은:ref:’데이터베이스 설치’를 참조하십시오.
\n삶의 질 기능은 터미널에 (흑백이 아닌) 컬러 출력을 추가합니다. 최신 터미널에서는 CMD와 PowerShell 모두에서 작동합니다. 비활성화해야 하는 경우, 환경 변수 :envvar:`DJANGO_COLORS`를 ``nocolor``로 설정하십시오.
\nOn older Windows versions, or legacy terminals, colorama 0.4.6+ must be\ninstalled to enable syntax coloring:
\n...\\> py -m pip install "colorama >= 0.4.6"\n색상 설정에 대한 자세한 내용은 :ref:`syntax-coloring`을 참조하세요.
\n만약 “django-admin”이 어떤 주장이 주어지더라도 도움말 텍스트만 표시한다면, 윈도우의 파일 연결에 문제가 있을 것입니다. “PATH”에서 Python 스크립트를 실행하기 위해 둘 이상의 환경 변수가 설정되어 있는지 확인합니다. 일반적으로 Python 버전이 두 개 이상 설치된 경우 이러한 문제가 발생합니다.
If you are connecting to the internet behind a proxy, there might be problems\nin running the command py -m pip install Django. Set the environment\nvariables for proxy configuration in the command prompt as follows:
...\\> set http_proxy=http://username:password@proxyserver:proxyport\n...\\> set https_proxy=https://username:password@proxyserver:proxyport\n일반적으로, Django는 UTF-8 인코딩이 I/O에 사용된다고 가정합니다. 시스템이 다른 인코딩을 사용하도록 설정된 경우 이로 인해 문제가 발생할 수 있습니다. 최신 버전의 Python에서는 UTF-8 인코딩을 강제하기 위해 PYTHONUTF8 환경 변수를 설정할 수 있습니다. Windows 10은 또한 시스템 설정의 :menuselection:`언어 –> 관리 언어 설정 –> 시스템 로케일 변경`에서 ``세계 언어 지원에 유니코드 UTF-8 사용``을 선택하여 시스템 전체 설정을 제공합니다.