Difference between revisions of "Wikipedia Extractor"
Jump to navigation
Jump to search
Firespeaker (talk | contribs) |
|||
| (16 intermediate revisions by 5 users not shown) | |||
| Line 2: | Line 2: | ||
== Goal == |
== Goal == |
||
This tool extracts main text from xml Wikipedia dump files, producing a text corpus, which is useful for training unsupervised part-of-speech taggers, n-gram language models, etc. |
This tool extracts main text from xml [[Wikipedia dump]] files (at https://dumps.wikimedia.org/backup-index.html, ideally the "'''pages-articles.xml.bz2'''" file), producing a text corpus, which is useful for training unsupervised part-of-speech taggers, n-gram language models, etc. |
||
| ⚫ | |||
== Tool == |
|||
There are three versions of Wikipedia Extractor: |
|||
| ⚫ | |||
The original, works with Python 2.x and outputs multiple files. |
|||
http://code.google.com/p/natural-language-qa/source/browse/MakeCorpus/WikiExtractor.py |
|||
License GPL-V3. |
|||
| ⚫ | |||
Guampa's version, works with Python 3.x and outputs multiple files. |
|||
https://github.com/hltdi/guampa/blob/master/wikipedia-import/WikiExtractor.py |
|||
License GPL-V3 |
|||
(Note: If you are on a Mac, make sure that <tt>--</tt> is really two hyphens and not an em-dash like this: —). |
|||
New version, a modified version of Guampa's, works with Python 3.x and outputs a single file |
|||
https://svn.code.sf.net/p/apertium/svn/trunk/apertium-tools/WikiExtractor.py |
|||
== Applicable == |
|||
Work well : '''Wikipedia''', '''Wikivoyage''', '''Wikibooks''' |
|||
With problem: '''Wiktionary''' (Mistakenly, not all articles fully included, and foreign words' explanations included.) |
|||
(Thanks to the feedback by Per Tunedal!) |
|||
== New Version == |
|||
| ⚫ | |||
| ⚫ | |||
| ⚫ | |||
This will run through all of the articles, get all of the text and put it in wiki.txt. This version also supports compression (BZip2 and Gzip), so you can use <code>dump.xml.bz2</code> or <code>dump.xml.gz</code> instead of <code>dump.xml.</code> You can also compress (Bzip2) the output file by adding <code>--compress</code> to the command. |
This will run through all of the articles, get all of the text and put it in wiki.txt. This version also supports compression (BZip2 and Gzip), so you can use <code>dump.xml.bz2</code> or <code>dump.xml.gz</code> instead of <code>dump.xml.</code> You can also compress (Bzip2) the output file by adding <code>--compress</code> to the command. |
||
| Line 37: | Line 16: | ||
You can also run <code>python3 WikiExtractor.py --help</code> to get more details. |
You can also run <code>python3 WikiExtractor.py --help</code> to get more details. |
||
== |
== Steps == |
||
=== 1. Get the script === |
|||
http://code.google.com/p/natural-language-qa/source/browse/MakeCorpus/WikiExtractor.py |
|||
| ⚫ | |||
http://dumps.wikimedia.org/backup-index.html |
|||
Take Chinese as an example, download the file '''zhwiki-20130625-pages-articles.xml.bz2''' on this page http://dumps.wikimedia.org/zhwiki/20130625/. Alternatively, we can download the latest version on this page, http://dumps.wikimedia.org/zhwiki/lastest/ |
|||
=== 3. Use the script === |
|||
<pre> |
|||
mkdir output |
|||
bzcat zhwiki-20130625-pages-articles.xml.bz2 | ./WikiExtractor -o output |
|||
cat output/*/* > zhwiki.text |
|||
</pre> |
|||
Optionally, we can use |
|||
"-c" for compression for saving disk space, and |
|||
"-b" for setting specified bytes per output file. |
|||
More information please type "./WikiExtractor --help". |
|||
Ok, let's have a cup of tea and come back an hour later. The output should be '''output/AA/wikiXX''', where wikiXX are the extracted texts. |
|||
=== 4. clean up "<>" tags === |
|||
We are only one step away from the final text corpus, because there are still links in wikiXX files. Let's use the following tiny script to filter out "<>" tags and special "__XXX__" marks. |
|||
Here's a simple step-by-step guide to the above. |
|||
<pre> |
|||
# Get the <code>WikiExtractor.py</code> script from https://github.com/apertium/WikiExtractor: |
|||
#! /usr/bin/python |
|||
#: <code>$ wget https://raw.githubusercontent.com/apertium/WikiExtractor/master/WikiExtractor.py</code> |
|||
# -*- coding:utf-8 -*- |
|||
# Download the Wikipedia dump for the language in question from http://dumps.wikimedia.org/backup-index.html. The below uses a hypothetical file name for a language with the <tt>xyz</tt> code: |
|||
import sys |
|||
#: <code>$ wget https://dumps.wikimedia.org/xyzwiki/20230120/xyzwiki-20230120-pages-articles.xml.bz2</code> |
|||
import re |
|||
| ⚫ | |||
re1 = re.compile(ur"<.*?>") # ref tags |
|||
#: <code>$ python3 WikiExtractor.py --infn xyzwiki-20230120-pages-articles.xml.bz2 --compress</code> |
|||
re2 = re.compile(ur"__[A-Z]+__") # special marks e.g. __TOC__ __NOTOC__ |
|||
line = sys.stdin.readline() |
|||
while line != "": |
|||
line = re1.sub("", re2.sub("", line)) |
|||
print line, |
|||
line = sys.stdin.readline() |
|||
</pre> |
|||
This will output a file called <code>wiki.txt.bz2</code>. You will probably want to rename it to something like <code>xyz.wikipedia.20230120.txt.bz2</code>. |
|||
Save the above lines in a file '''filter.py''', and: |
|||
==See also== |
|||
<pre> |
|||
* [[ Wikipedia dumps ]] |
|||
python filter.py < zhwiki.text > zhwiki.filter.text |
|||
</pre> |
|||
=== 5. done :) === |
|||
[[Category: |
[[Category:Resources]] |
||
[[Category:Development]] |
|||
[[Category:Corpora]] |
|||
[[Category:Documentation in English]] |
|||
Latest revision as of 18:55, 30 January 2023
Contents |
Goal[edit]
This tool extracts main text from xml Wikipedia dump files (at https://dumps.wikimedia.org/backup-index.html, ideally the "pages-articles.xml.bz2" file), producing a text corpus, which is useful for training unsupervised part-of-speech taggers, n-gram language models, etc.
It was modified by a number of people, including by BenStobaugh during Google Code-In 2013, and can be cloned from GitHub at https://github.com/apertium/WikiExtractor.
This version is much simpler than the old version. This version auto-removes any formatting and only outputs the text to one file. To use it, simply use the following command in your terminal, where dump.xml is the Wikipedia dump
$ python3 WikiExtractor.py --infn dump.xml.bz2
(Note: If you are on a Mac, make sure that -- is really two hyphens and not an em-dash like this: —).
This will run through all of the articles, get all of the text and put it in wiki.txt. This version also supports compression (BZip2 and Gzip), so you can use dump.xml.bz2 or dump.xml.gz instead of dump.xml. You can also compress (Bzip2) the output file by adding --compress to the command.
You can also run python3 WikiExtractor.py --help to get more details.
Steps[edit]
Here's a simple step-by-step guide to the above.
- Get the
WikiExtractor.pyscript from https://github.com/apertium/WikiExtractor: - Download the Wikipedia dump for the language in question from http://dumps.wikimedia.org/backup-index.html. The below uses a hypothetical file name for a language with the xyz code:
- Run the script on the Wikipedia dump file:
$ python3 WikiExtractor.py --infn xyzwiki-20230120-pages-articles.xml.bz2 --compress
This will output a file called wiki.txt.bz2. You will probably want to rename it to something like xyz.wikipedia.20230120.txt.bz2.
