Manual:Pywikibot/PAWS/ko


 * 더 자세한 사항은 PAWS에서 확인하세요.

이 문서는 PAWS(Pywikibot: A Web Shell)를 이용하여 위키미디어 실험실 환경의 노트북을 이용한 Pywikibot의 빠른 대화형 개요를 제공합니다.

위키미디어 계정 만들기
To follow this walk-through, you only need a Wikipedia/Wikimedia account. Use Special:CreateAccount to create one.

Once you have created an account, please visit https://test.wikipedia.org/ and check that your username appears in the top right corner (this works around T120327).

노트북으로 접속하기
노트북에서 진행을 시작하려면, 여기로 가세요.

‘Sign in with MediaWiki’를 클릭하고 나서 ‘OAuth 이용 인증’에 동의하는지 물어볼 때 ‘허용합니다’를 클릭합니다. PAWS에 처음 접속하려면, 서버 생성이 필요합니다. 초록색 ‘Start my Server’ 버튼을 클릭합니다. 새로운 서버가 시작되려면 몇 분 정도 기다리는 것이 보통입니다.

완료되었다면, https://paws.wmflabs.org/paws/user/ /tree 처럼 URL에다가 넘겨주기가 됩니다.

장치 시작하기
새로운 대화형 장치를 시작하기 위해,
 * 1) PAWS 대문에 가서
 * 2) ‘New’를 오른쪽 버튼으로 클릭하고
 * 3) ‘Terminal’을 선택합니다.

이러면 리눅스‘$’프롬프트와 함께 https://paws.wmflabs.org/paws/user/ /terminals/1 URL의 새로운 창이 열립니다.

이 URL을 즐겨찾기로 지정할 수 있으며, 또한 브라우저를 닫거나 혹은 컴퓨터가 멈춘 이후에도 언제든 장치로 돌아가게 됩니다.

이 장치는 모방기가 아닙니다. 실제 배시 셀은 도커 용기에 있는 실제 리눅스 설치의 일부분으로, 그렇기에 어떠한 배시 명령어든 쓸 수 있고, 또한 설치한 리눅스에서 사용가능한 어떠한 명령어도 쓸 수 있습니다.

사용가능한 일부 명령어를 보려면, 을 쓰세요.

위키에 로그인하기
이는 서버 내에 계정이 만들어질 것이고 명령줄에서 로그인이 허가됩니다. 아래의 명령어는 연습위키에 접속할 수 있음을 보여줍니다. OAuth를 이용한다면, 비밀번호를 입력할 필요가 없습니다.

디렉토리 내에 ‘user-config.py’라는 이름의 파일을 만들고 ‘mylang ’ 및 ‘family’ 변수를 추가한다면 pywikibot에서 다른 위키로 연결할 수 있습니다:

문서 만들기
문서를 만들려면, 장치에 사용자 이름과 ‘ ’을 대신하여 아래의 명령어를 입력하고, 바뀜을 즉시 수락하려면 ‘Y’를 누르세요.

위키를 편집했습니다. 웹 브라우저 상에서 https://test.wikipedia.org/wiki/User_talk: 를 열어 바뀜을 봅시다.

‘-help’ 명령줄 옵션과 이러한 명령줄 스크립트 각각에 대해 자세히 볼 수 있습니다.

문서 꺼내오기
많은 문서를 가져오는 것은 ‘listpages’ 명령어로 합니다.

이전 문단에서 만들었던 문서의 내용을 가져오려면, 다음 명령어를 입력하세요:

지금 만일 PAWS 파일 목록에 가려면, 문서가 현재 저장되어 있어야 합니다.

실제 스크립트 예시
위키백과 상에서 사용된 웹사이트가 URL를 바꾼다면 위키백과 상의 해당 링크는 낡게 되고, 만일 웹사이트가 오래된 URL에서 새 URL로 넘겨주기되지 않았다면 깨진 링크가 될 수도 있습니다. 가령, 예를 들어 브리태니커 백과사전은 http://www.britannica.com/EBchecked/media/ 에서 http://www.britannica.com/topic/[topic name]/images-videos/* 로 문서를 이동한 것과 같이 링크를 바꿨습니다. 여기에서 영어 위키백과 상의 오래된 URL의 사용 목록을 찾아볼 수 있습니다. 이 모든 링크를 수작업으로 갱신하는 것은 매우 많은 시간이 걸릴 것입니다. 다행스럽게도 브리태니커 백과사전은 오래된 URL에서 새 URL로의 넘겨주기를 유지하고 있고, 그래서 이를 즉각적으로 고칠 필요는 없습니다.

간단한 예로는, 영어 위키백과는 최근 http://www.britannica.com/EBchecked/ 대신에 http://britannica.com/EBchecked/ 링크를 포함하고 있습니다. 즉, ‘www.’ 하위 도메인은 URL 상에서 사라집니다.

최근 영어 위키백과에는 15건의 사례가 있습니다.

다른 언어로 된 위키백과 또한 이러한 문제를 지니고 있습니다. 가령, 독일어 위키백과 상에 1건의 사례가 있습니다.

이 링크를 고치기 위해, 우리는 Pywikibot replace.py 스크립트를 사용할 수 있습니다. 이 견본에서 우리는 영어 위키백과의 자동 편집에 대한 엄격한 규칙이 있으므로, 위키에 작성하는 것을 막기 위해 ‘-simulate’ 인수를 사용할 것입니다.

먼저 http://britannica.com/EBchecked/ 에 연결된 모든 문서를 기재하세요.

Now we check those pages actually have the literal URL in the page; i.e. they are not using a template.

이제 빠진 ‘www.’을 추가하여 대체해서 사용합니다.

In PAWS, and any terminal that supports color, the diff of changes will show the added "www." in green text color, making it easier to find the proposed changes.

Pywikibot 내부
다음은 PAWS 파이썬의 시즌을 사용합니다.


 * 1) PAWS 대문에 가서
 * 2) ‘New’를 오른쪽 버튼으로 클릭하고
 * 3) ‘Python 3’을 선택합니다.

이러면 새로운 창이 열립니다.

In the text box, enter the following and in the Cell menu select 'Run' (or pressing shift+enter to run).

A new text box will appear below. Run the following to create an APISite object connected to https://test.wikipedia.org/:

Describe "site" by entering it into the new text box and selecting "Run".

It should show

Out[3]: APISite("test", "wikipedia")

Create a page object:

Check it exists by running:

It should output

VERBOSE:pywiki:Found 1 wikipedia:test processes running, including this one. Out[5]: True

Show the text on the page:

Change the page text in the object:

Save the page to the wiki:

The response should be:

The interactive Python 3 notebook allows many lines to be run together. The above could be put into one text box and Run

The log of your interactive Python session can be saved or downloaded for future reference.

PAWS 내 온라인 문서에 접근하기
Pywikibot documentation may be found at https://doc.wikimedia.org/pywikibot/index.html. It is primarily sourced from docstrings, which can be loaded in the interactive Python 3 notebook using the Python built-in function help.

For example, to look at the arguments for the save method above, run either:

또는

Pywikibot 스크립트 편집하기
The Pywikibot library and scripts are located in /srv/paws, and are read-only. The installed Pywikibot library can not be modified in PAWS.

Scripts may be modified after copying them into your PAWS home.

For example, to run a modified "checkimages.py":
 * 1) In the terminal, enter
 * 2) In a browser, go to your PAWS home and click on the file.
 * 3) In the browser, you can edit the file. Edit the code -- for instance, just after the   code on line 1775, add a new line 1776 that will print out your name:
 * 4) In the editing interface, use the File menu and click Save to save your modifications.
 * 5) In the terminal, enter

같이 보기

 * 한 사용자의 PAWS 요약(예: API 및 데이터베이스 접근)