Manual:Pywikibot/Installation/ko

 이 문서를 통해 여러분은 Pywikibot (파이위키봇)을 Toolforge나 PAWS, 또는 여러분의 컴퓨터에서 직접 사용하는 방법에 대해서 도움을 받을 수 있습니다.

  PAWS PAWS: A Web Shell은 Pywikibot을 사용하기 가장 쉬운 방법 중 하나입니다. 특별히 설치해야 할 것은 없으며, 브라우저 창을 통해 명령을 내릴 수 있습니다.

 컴퓨터에서 직접 작동 이 문서의 이하의 내용에서는 여러분의 컴퓨터에 직접 Pywikibot를 설치하고 작동시키는 법에 대해 적혀있습니다. 이 설치법은 크게 보았을 때 총 네 번의 단계로 구분됩니다.  Toolforge (툴포지) Toolforge provides you with a stable cloud infrastructure on Wikimedia servers that allows you to run bots continuously or on a schedule.
 * Python 설치하기
 * Pywikibot 설치하기
 * Pywikibot 설정하기
 * 스크립트 가동하기

파이썬 설치하기
https://www.python.org/downloads/ 에서 파이썬을 내려받아 설치하세요.

만일 이미 파이썬이 설치되어 있다면,  명령어 등을 이용하여 여러분이 사용 중인 파이썬 버전을 확인해 보세요. 파이썬 버전이 2.7.4 이상, 혹은 3.4 이상이라면, Pywikibot을 가동하기에 충분합니다. However, Python versions below 3.5 can be dropped in near future. It is strictly recommended to use Python 3.5 or higher.

Modify the path
On Windows systems, even after installing python, the command line interface may not initially know where the python installation is located (although the installer has an option to make it know). In other words, if you enter the command

C:\Users\Joe>python

it may result in the following error:

'python' is not recognized as an internal or external command, operable program or batch file.

To fix this, you need to modify the environment variable named "path" and add the folder which contains "python.exe". On Windows 10, this is under Settings > System > About > System info > Advanced System Settings > Environment Variables. Closing and re-opening the command line, entering "python" should give some information about your current python installation. This same process can be repeated for pip. If you enter the command

C:\Users\Joe>pip

and it displays an error, also add the folder containing "pip.exe" to the path.

기타 필요물 설치하기
Pywikibot을 작동시키기 위해선 'requests' 모듈이 필요합니다. 설치한 파이썬 폴더 안에 있는 pip를 이용하여 'requests' 모듈을 바로 설치할 수 있습니다. 따로 지정해 두지 않았다면, pip는 파이썬 설치 하위 폴더인 Scripts 폴더 안에 위치해 있습니다.

Unix 계열(Linux/BSD/Solaris)에선 Terminal을, Windows의 경우 커맨드 창(명령 프롬프트)을 열고 cd 명령어를 이용하여 Scripts 폴더로 이동합니다. 파이썬을 C 드라이브의 'Python'이란 폴더에 설치했다고 가정했을 경우, 이동을 위해선 다음 같이 입력해야 합니다.

그리고 다음과 같이 입력하여 'requests' 모듈을 설치합니다.

Pywikibot 설치하기
Pywikibot의 stable branch판(최신판) 내려받기 링크: .tar.gz 확장자, .zip 확장자. 둘 중 아무거나 다운 받으면 됩니다.

다운이 끝나면, 다운 받은 파일의 압축을 풉니다. 예를 들면  또는   경로에 압축을 풀어주면 됩니다.

Alternatively, you may retrieve the latest version using git or svn client from Gerrit, see. This is the recommended way for active bot operators and developers to use Pywikibot.

Other versions are available at https://tools.wmflabs.org/pywikibot/.

Pywikibot 업데이트
Pywikibot을 계속해서 최신 상태로 유지시켜 주십시오. 새 버전은 계속해서 나오고 있습니다.

If you are using git or svn release, you may skip this note. Otherwise please be aware of a necessity to backup your configuration files and scripts (user-config.py, any family file, or custom script that you might have created or changed, and any current XML dump file you're using for a wiki) before installing a new release.

Unpack the new version over the old version, overwriting all files.

Pywikibot 설정하기
Unix 계열(Linux/BSD/Solaris)에선 'Terminal'을, Windows에서는 '커맨드 창'(명령 프롬프트)를 엽니다. 그리고 여러분이 Pywikibot의 압축을 푼 폴더로 경로를 이동시킵니다. 이동을 위해선 다음과 같이 입력해야 합니다.


 * Unix 계열(Linux/BSD/Solaris):




 * Windows:



물론 상기한 경로 외에 여러분이 원하는 다른 경로를 쓸 수도 있습니다.

그리고 다음과 같은 명령을 입력하여 사용자-설정(user-config) 파일을 생성합니다. Windows에서는 가장 앞에 있는 'python' 부분은 입력할 필요가 없습니다. 또한 .py 확장자 파일의 기본 연결프로그램 설정이 파이썬이 아닌 다른 프로그램으로 되어 있으면 제대로 동작하지 않을 수 있습니다.

그 후 나타나는 글에 따라 순서대로 본인에게 맞는 설정을 입력합니다.

마지막으로 다음 명령을 입력하여 여러분이 설정한 위키에 로그인합니다. 그리고, 비밀번호를 입력하여 로그인을 완료합니다.

third-party 위키에서 사용하기
Pywikibot is pre-configured for a large number of wikis, but possibly not for the one you want to work on. See for how to configure Pywikibot for your wiki.

More configuration options
Pywikibot provides a wide range of configuration options to change the behavior of your bot. You can change these settings in the file user-config.py. See config2.py for a list of all parameters you can use.

Proxy configuration
Pywikibot relies on  for communicating with the web. You can use  and   environment variables to make requests use a proxy server. Refer to requests' documentation for more info.

스크립트 가동하기
Pywikibot의 'scripts' 디렉토리 안에는 매우 많은 수의 기성 스크립트들이 있습니다. 이 스크립트들을 이용하려면 다음과 같이 입력하면 됩니다.

에서 여러분이 원하는 기능을 가진 스크립트를 찾아보세요.

그 외 필요물
대부분의 스크립트는 여러분이 바로 그대로 이용할 수 있지만, 몇몇 스크립트들은 추가적으로 설치해야 할 것이 있을 수 있습니다. 그런 스크립트들과 해당 스크립트에 필요한 설치품이 무엇인지 확인하려면 requirements.txt을 참고하세요.

To install dependencies for some script, use pip, and run the following command:

Alternatively, run the following command to install all dependencies for all scripts at once: