This is a toolkit for Wikipedia editors who wish to edit their pages easily. 这个套件是写给那些想更快编写维基百科的人用的。
Then how to use the toolkit? 那么怎么用这个套件呢？
<class 'wikipedia_toolkit'> is used for basic operations on Wikipedia, including login, viewing code and editing.
<class 'wikipedia_toolkit'> 用来执行维基百科一些基本的操作, 包括登录、查看源码和编辑。
Clone the repository into your workspace and open a new file. At the beginning, one should instantiate by presenting his username and password like this:
把该资料库放在工作区中，并在目录中开始一个新程序。在一开始，用户应当给出要进行操作的特定语言维基百科以及账户和密码以实例化，像这样：
#login.py
import wikipedia_toolkit
login=wikipedia_toolkit.wikipedia_toolkit('zh','BrandNew Jim Zhang','**********')#fetch_code_test.py
import wikipedia_toolkit
login=wikipedia_toolkit.wikipedia_toolkit(language,username,password)
login.fetch_code(page)Fig. 1. Taylor Swift article demo Taylor Swift条目截图
Fig. 2. Taylor Swift code demo Taylor Swift条目源代码截图
For example, if one want to fetch the code of the page "Taylor Swift" (an American singer) (with the article pic shown in Fig. 1 and Fig. 2), just run this code:
举个例子，如果一个人想获取"Taylor Swift"（一位美国女歌手）条目（图1和图2分别显示了条目和源代码）的源代码，只需运行这段代码：
#fetch_code_test.py
import wikipedia_toolkit
login=wikipedia_toolkit.wikipedia_toolkit(language,username,password)
login.fetch_code("Taylor Swift")Then the result in console will go like this:
那么控制台会输出：
Done. The source code was written in 'Taylor Swift.wikitext'.
All processes were done in xxx second(s).
And the source code has already been stored in your workspace. 源代码已经存储在你的工作区中了。
You have to be an autoconfirmed user to use this toolkit to upload your edition.
要上传编辑的话，你必须是一名自动确认用户。
Now it's time to upload the wikitext into wikipedia server! Just run this code in the new file:
是时候将维基文本上传至维基百科服务器中了！只需在新文件运行下面的代码：
#upload.py
import wikipedia_toolkit
login=wikipedia_toolkit.wikipedia_toolkit(language,username,password)
login.upload(page,path,summary="",minor=False)As for the params and args, the doc says: 对于参数，正如官方文件说的那样：
Upload the code of a page.
Page is the page you want to upload to, like 'Taylor Swift' and 'Bill Gates'.
Path is the place where you store the text, both relative and absolute path are OK.
Parameters:
Summary is the way like you did in Wikipedia.
Minor is Boolean, which will identify the edit is minor or not, default False.
Now give an example for further explanation, in this example, I try to edit one of my userpage and the source code I submit is the code from Taylor Swift page.
现在举个例子说得更清楚一点，在这个例子中，我试图更改我的的一个用户页，提交的代码是Taylor Swift页面的代码。
#upload.py
import wikipedia_toolkit
login=wikipedia_toolkit.wikipedia_toolkit(language,username,password)
login.upload('User:BrandNew Jim Zhang','Taylor Swift.wikitext',summary="test",minor=True)Then the result in console will go like this:
那么控制台会输出：
Upload done. See the page on https://en.wikipedia.org/w/index.php?title=User:BrandNew_Jim_Zhang
After uploading, your editcount is 2053.
All processes were done in 19.497 second(s).See, your editcount is also displayed.
看，你的编辑数也会被显示出来。
As for the result, the content has already been changed, shown in Fig. 3 and 4.
内容已经改变了，已在图3和图4中显示出来。
Fig. 3. Page changed demo 条目被更改后截图
Fig. 4. Page history demo 条目编辑历史截图
As Wikipedia editors, we know it's necessary to use Template:Cite web to cite web contents like this:
作为维基百科编者，我们知道使用Template:Cite web这一模板来引用网页里的内容是很重要的。如下所示：
Fig. 5. Template:cite web displaying result Template:cite web 效果截图
Fig. 6. Template:cite web source code demo Template:cite web 源代码截图
<class 'spider'> is a class containing various method for scraping webpage into cite web. It can automatically turn the page like Fig. 7 into the wikitext below for reference, making your editing easier.
<class 'spider'>这个类包含多种方法，可以将不同网站上的信息转化为维基文本中的引用模式。这个类可以将图7里的新闻自动转化成下方的代码，让你的编辑变得更容易。
Fig. 7. News from billboard.com 美国《公告牌》杂志网站 上的新闻截图
The printed wikitext turns like this: 输出的维基文本如下：
<ref>{{cite web|url=https://www.billboard.com/articles/business/chart-beat/8551159/justin-bieber-changes-billboard-200-debut-forecast|title=Justin Bieber's 'Changes' Album Set for No. 1 Debut on Billboard 200 Chart|first=Keith|last=Caulfield|date=Feb 16, 2020|accessdate=Feb 17, 2020|publisher=[[Billboard (magazine)|Billboard]]}}</ref>Now the websites contain billboard.com, edm.com, pitchfork.com. And pitchfork album review is under testing.
目前网站包括 billboard.com、edm.com 和 pitchfork.com。Pitchfork专辑评论正在测试。
Scraping news from billboard.com into wikitext reference. 爬取 billboard.com 的内容以获取维基文本的引用形式
Just run this code:
只需运行以下代码：
#billboard_news.py
import wikipedia_toolkit
spider=wikipedia_toolkit.spider()
spider.billboard(url)Take this news about 2020 NBA All-Star Game for an example:
举这个有关2020年NBA全明星的新闻作为例子：
#billboard_news.py
import wikipedia_toolkit
spider=wikipedia_toolkit.spider()
spider.billboard('https://www.billboard.com/articles/news/8551157/chance-the-rapper-2020-nba-all-star-game-halftime-show')And the console will display:
控制台会输出：
<ref>{{cite web|url=https://www.billboard.com/articles/news/8551157/chance-the-rapper-2020-nba-all-star-game-halftime-show|title=Chance the Rapper Brings Out Special Guests, Pays Tribute to Kobe Bryant at 2020 NBA All-Star Game Halftime Show|first=Ashley|last=Iasimone|date=Feb 16, 2020|accessdate=Feb 17, 2020|publisher=[[Billboard (magazine)|Billboard]]}}</ref>
All processes were done in 2.312 second(s).
Wow, so easy. 哇，是不是很简单~
Like above and take this news about Calvin Harris (Scottish DJ, my idol) for an example:
像上面一样，举这个和Calvin Harris（苏格兰DJ，我的偶像）有关新闻的例子：
#billboard_news.py
import wikipedia_toolkit
spider=wikipedia_toolkit.spider()
spider.edm('https://edm.com/music-releases/calvin-harris-love-regenerator-2')And the console will display:
<ref>{{cite web|url=https://edm.com/music-releases/calvin-harris-love-regenerator-2|title=Calvin Harris Drops 2 More Love Regenerator Tracks for Valentine's Day|first=John|last=Cameron|date=Feb 14, 2020|accessdate=Feb 17, 2020|website=edm.com}}</ref>
All processes were done in 3.000 second(s).
Scraping news from pitchfork.com into wikitext reference. 爬取 pitchfork.com 的内容以获取维基文本的引用形式
#billboard_news.py
import wikipedia_toolkit
spider=wikipedia_toolkit.spider()
spider.pitchfork_news(url)Another example, news from pitchfork about Justin Bieber's (Canadian singer) new album Changes:
下一个例子，Pitchfork上一个和Justin Bieber（加拿大歌手）新专辑《Changes》有关的新闻：
#billboard_news.py
import wikipedia_toolkit
spider=wikipedia_toolkit.spider()
spider.pitchfork_news('https://pitchfork.com/news/listen-to-justin-biebers-new-album-changes/')And the console will display:
控制台会显示：
<ref>{{cite web|url=https://pitchfork.com/news/listen-to-justin-biebers-new-album-changes/|title=Listen to Justin Bieber’s New Album Changes|first=Madison|last=Bloom|date=Feb 14, 2020|accessdate=Feb 17, 2020|publisher=[[Pitchfork (website)|Pitchfork]]}}</ref>
All processes were done in 33.274 second(s).
Scraping album scores from pitchfork.com 爬取 pitchfork.com 的专辑评分以获取维基文本的引用形式
Pitchfork release album reviews irregularly like this:
Pitchfork总是不定期放出些专辑评论，还有像这样的专辑分数：
Fig. 8. Pitchfork album review screenshot
Fig. 9. Album review source code (Check it in this page)
Now let's have a try in this toolkit:
那我们试试：
#album review.py
import wikipedia_toolkit
spider=wikipedia_toolkit.spider()
spider.pitchfork_album_review('https://pitchfork.com/reviews/albums/lil-wayne-funeral/')And the console will display:
控制台会显示：
|rev?=''[[Pitchfork (website)|Pitchfork]]''
|rev?Score=7.3/10<ref>{{cite web|url=https://pitchfork.com/reviews/albums/lil-wayne-funeral/|title=Lil Wayne: Funeral|first=Sheldon|last=Pearce|date=Feb 04, 2020|accessdate=Feb 17, 2020|publisher=[[Pitchfork (website)|Pitchfork]]}}</ref>
All processes were done in 7.000 second(s).
Because it cannot be decided as 'rev4', I use 'rev?' instead. Remember to replace the '?' with according number.
显然我们不能决定是'rev4'，我使用了'rev?'作为替代。记得在编辑时要把'?'换回来。