WikiBrowse: Difference between revisions
(update) |
|||
(41 intermediate revisions by 19 users not shown) | |||
Line 1: | Line 1: | ||
<div style="align:center; border:1px solid #ccc; padding:3px; margin:3px; background-color:#cef">''For the old uncompressed activity, see [[WikiBrowse (old)]].''</div> |
<div style="align:center; border:1px solid #ccc; padding:3px; margin:3px; background-color:#cef">''For the old uncompressed activity, see [[WikiBrowse (old)]].''</div> |
||
{{translations}} |
|||
[[Image:Olpc_logo.jpg|center|250px]] |
|||
<center><span style="font-size:200%">WikiBrowse</span> <span style="font-size:150%">: a self-contained wiki server</span></center> |
|||
[[{{PAGENAME}}]] is a wiki server and compressed set of wiki pages that together act as a self-contained browsable offline wikireader. |
|||
== |
=== Releases === |
||
* See [[Activities/WikiBrowse_Spanish_(latest)]] |
|||
* See [[Activities/WikiBrowse English (latest)]] |
|||
==== Source download ==== |
|||
The [http://collison.ie/wikipedia-iphone/ Wikipedia on an Iphone] (WOAI) project by Patrick Collison makes it possible to have a working, usable mediawiki (read: wikipedia) dump in a very small space (read: the XO's flash drive). |
|||
The project's developed inside our git repository: |
|||
* '[http://dev.laptop.org/git/projects/wikiserver wikiserver]' code |
|||
Chris's initial [http://blog.printf.net/articles/2008/06/02/wikipedia-on-xo blog post] mentions how this project got started. |
|||
=== How it works === |
|||
==== Developers ==== |
|||
The wikipedia-iphone project's goal is to serve wikipedia content out of a compressed copy of the XML dump file after indexing it. The architecture is that there are C functions to pull out articles, and several interfaces to those C functions: the main interface is the iPhone app, but there's also a web server (written in Ruby with Mongrel) that runs locally and serves up pages from the compressed archive. |
|||
* [[User:Wade|Wade Brainerd]], [[User:Cjb|Chris Ball]], [http://mad.printf.net Madeleine Ball], [[User:Bemasc|Ben Schwartz]] |
|||
* [[User:Martinlanghoff]], [[User:Godiard|Gonzalo Odiard]], Rob Ochshorn |
|||
=== Testing === |
|||
[[User:Wade|Wade]] has helped port the original project's code to Python. [[user:Cjb|Cjb]] and Wade are working on fixing some of the unfinished aspects of the original, particularly: |
|||
* Template rendering |
|||
* Redlink/greenlink/bluelink rendering |
|||
* Image thumbnail retrieval |
|||
* Automated subselection (currently: via a minimum # of inbound links) |
|||
# Wikitext rendering. |
|||
A Ruby web server is working on a local machine (temporary: http://pullcord.laptop.org:9090/) serving up the whole Spanish wikipedia text (the compressed. bz2 file that pages are served out of is 400M, and the index is 10M); a subset of 35,000 articles can be stored in 80MB on an XO. "green" links can indicate articles which exist (on a local server, or on the internet) but not in the local dump, while red and blue links continue to indicate nonexistent and local existing pages. (greenlinks have yet to be implemented - --[[User:Sj|Sj]] [[User talk:Sj|<font style="color:#f70; font-size:70%">talk</font>]] 23:01, 7 May 2008 (EDT)) |
|||
#* Download the activity bundle click around links, looking for errors in rendering. Check these errors against [http://es.wikipedia.org/ Wikipedia], and report them in Trac if there is a real difference. |
|||
#* We should prepare an automated test suite that attempts to render all portal-page-linked articles and checks the results. |
|||
# Blacklisting |
|||
#* Please report any inappropriate articles or images with the link at the top of each page. |
|||
The mediawiki data dump is stored as a [http://en.wikipedia.org/wiki/Bz2 .bz2 file], which is made of smaller compressed blocks (which each contain multiple articles). The WOAI code, among other things, goes through and makes an index of which block each article is in. That way, when you want to read an article, your computer only uncompresses the tiny block it's in - the rest of the huge mediawiki dump stays compressed. This means that |
|||
* (1) it's really fast, since you're working with tiny compressed bundles and |
|||
* (2) it's really small, since you're only decompressing one tiny bundle at a time. |
|||
If you're willing to test code once the developers have it working, place your name below (make sure it links to some form of contact information). |
|||
=== What we're doing === |
|||
* [[User:Mchua|Mel Chua]] |
|||
We are working to make this into an XO activity. |
|||
* [[User:RafaelOrtiz | Rafael Ortiz]] |
|||
* [[User:Sj|Sj]] |
|||
* [[User:Googleplex12|Evan]] |
|||
* [[User:DyD|Ian Daniher]] |
|||
The first step was to port the code from Ruby with Mongrel to Python with BaseHTTPServer so it'll run natively on the XO - details below in [[#Help wanted]]. After that, we'd love to have a few more things done, like... |
|||
== Creating a slice of wikipedia == |
|||
* Wrapping this as a Sugar activity (code) |
|||
* Some article selection. Since it serves files out of the .xml.bz2, we can accomplish this by choosing what goes into the .xml.bz2 (perhaps there are already tools for doing this? I don't know much about it) as long as we deal with the link-breaking we do as a result. (content, curation) |
|||
* Add a subset of images. (curation) |
|||
* Finding some way to handle images - the current code only works with text, and image links are broken. (code) |
|||
* Removing the wikitext parser from the server and rewriting it as an independent plugin/middleware/etc architecture so that other wiki syntaxes can be supported. Javascript, slimming down the current Mediawiki php parser, and Python middleware are all options. The current solution is a very simple/incomplete parser within the server code itself. (code) |
|||
'''NOTE: this process was updated. To have information about the new process read http://wiki.sugarlabs.org/go/Activities/Wikipedia/HowTo''' |
|||
=== Download === |
|||
The current release is here: |
|||
: [http://dev.laptop.org/~cjb/eswiki/Wikipedia-6.xo Wikipedia-6.xo] |
|||
The current wikipedia slice was created based on the traffic statistics for Spanish wikipedia for the month February 2008. This file was provided by [http://en.wikipedia.org/wiki/User:Henrik User:Henrik] on English Wikipedia, who has collected traffic statistics for many different wikipedias (you can browse some of this at http://stats.grok.se ). Try approaching him if you want to acquire traffic stats for another wikipedia, or approach [[User:Madeleine Price Ball|Madeleine]] or [[Profiles/cjb|Chris]] if you want to get your hands on the Spanish or English Feb 2008 traffic stats. |
|||
This is a very large activity bundle, make sure you have at least 100MB free before downloading. It takes Sugar quite some time to decompress it. |
|||
* Parse the wikipedia xml dump to get a list of all articles and a list of all redirects ( GetPages.pl ) |
|||
== Help wanted == |
|||
* Parse the wikipedia xml dump to get a list of all links to other pages made by each page ( PageLinks.pl ) |
|||
* Recount the Feb 2008 traffic list to combine traffic with redirects with the traffic of main pages, output each as having the same summed traffic stat. ( GetPageCounts.pl ) |
|||
* Take the top N articles. A lot of these will get trimmed in a later step. For the current slice the top 70k articles was taken here. |
|||
* (optional) Remove blacklisted articles. ( RemoveBlacklist.pl ) |
|||
* Use the output of PageLinks.pl to assess the number of incoming links for each article within the current set. Remove all "orphaned" articles (articles with zero incoming links). ( RemoveUnlinked.pl ) |
|||
:* This step also removes many articles with certain name types: Wikipedia:, Ayuda:, Wikiproyecto:, MediaWiki:, Plantilla:, WP:, Portal:, and Categoría:. |
|||
:* This step should be repeated until there are no orphaned articles left. About 26k articles are removed in the first round. There are about 200 articles that become newly-orphaned if you repeat it. |
|||
* Re-add all template articles ("Plantilla:"). We ignored them because their traffic stats do not reflect their usage. |
|||
=== People === |
|||
* [[User:cjb|Chris Ball]] is the person to contact if you're unsure of how to get started. |
|||
* [[User:Wade|Wade]] - working on the python port and can help people trying to implement any of the desierd featureset |
|||
* [[User:Sj|Sj]] - working on the featureset & tests |
|||
* madprime - working on a Spanish portal page |
|||
=== Creating and editing a slice of wikipedia === |
|||
See [[WikiBrowse Editing]] for a technique to edit and polish a wikipedia slice. |
|||
=== Previous tasks === |
|||
=== How well does this work? === |
|||
There are concerns that the traffic based method will bias too heavily for "popular culture". The results seem to be better than other schemes tried so far (eg. ranking by number of incoming links). The vast majority of articles on the list are there due to constant traffic rather than a local peak in popularity. With ~ 24k articles (not counting redirects) the space gained by manually removing some articles is negligible. |
|||
The top 20 articles of the Feb 2008 Spanish wikipedia traffic stats are: |
|||
1 769326 Wikipedia |
|||
2 342777 Día de San Valentín |
|||
3 285346 Célula |
|||
4 281076 México |
|||
5 273326 Filosofía |
|||
6 270628 Ciencia |
|||
7 254431 España |
|||
8 245171 Física |
|||
9 233579 Ecología |
|||
10 226516 Naruto |
|||
11 225685 Calentamiento global |
|||
12 223276 Estados Unidos |
|||
13 217996 Valor |
|||
14 211550 Sistema operativo |
|||
15 208141 Psicología |
|||
16 207869 Wiki |
|||
17 197387 Computadora |
|||
18 197126 Biología |
|||
19 194576 Comunicación |
|||
20 193129 Baloncesto |
|||
===Method used on the English Wikipedia=== |
|||
''See [http://en.wikipedia.org/wiki/Wikipedia:Version_1.0_Editorial_Team/SelectionBot SelectionBot] and its [http://toolserver.org/~cbm/release-data/2008-3-7/HTML/ March 2008 results].'' |
|||
Another approach, as used on the English Wikipedia, combines '''four''' importance parameters using a logarithmic function, then adds in a factor for article quality. The four importance parameters are: |
|||
* Importance rating by WikiProject |
|||
* Number of internal links into the page |
|||
* Number of interwiki versions of the article (i.e., other language versions) |
|||
* Number of hits (as used in the previous Spanish example) |
|||
This combination of four parameters helps to smooth out the selection. Data are collected on the toolserver via a bot. Work is currently being done (July 2008) to balance the selections between different WikiProjects, and the system is expected to be optimized by August 2008. |
|||
=== Old tasks === |
|||
;Porting server code from Ruby to Python : {{done}} (wade) |
;Porting server code from Ruby to Python : {{done}} (wade) |
||
Line 59: | Line 99: | ||
# Find & fix rendering bugs in the wikitext parser. |
# Find & fix rendering bugs in the wikitext parser. |
||
# Implement Green-link, Red-link, Blue-link. |
# Implement Green-link, Red-link, Blue-link. |
||
# Expand templates before processing the XML |
# Expand templates before processing the XML. |
||
;Creating a python activity wrapper : {{done}} (wade) -- though this needs testing for journal/sugar integration. |
;Creating a python activity wrapper : {{done}} (wade) -- though this needs testing for journal/sugar integration. |
||
Line 66: | Line 106: | ||
#* Contact the testers who have signed up below, and give them instructions on how you'd like them to try out the code you've written, and what kind of feedback you're looking for. |
#* Contact the testers who have signed up below, and give them instructions on how you'd like them to try out the code you've written, and what kind of feedback you're looking for. |
||
;Creating a spanish-language portal page: mad is working on this |
;Creating a spanish-language portal page: {{done}} mad is working on this. |
||
== See also == |
|||
* [[Wikislices]] a collection of articles pulled from Wikipedia (without the wiki web server). |
|||
* [[Wikibooks]] a set of wiki pages in PDF format. |
|||
* [http://sugarlabs.org/go/Activities/InfoSlicer InfoSlicer] is a tool to create a collection from content (such as Wikipedia pages) on the Internet. |
|||
# Wikitext rendering. |
|||
#* There is no formal specification for how to convert Wikitext to HTML, so we are relying on a modified version of InstaView to do this for us, but we have founds bugs already in our limited tests, so this is one of the bigger areas that needs testing. |
|||
#* Download the activity bundle click around links, looking for errors in rendering. Check these errors against [http://es.wikipedia.org/ Wikipedia], and report them in Trac if there is a real difference. |
|||
#* Note that templates (including info boxes) are currently stripped from the pages due to an issue with how the database is processed, so please don't report missing infoboxes. |
|||
#* We should prepare an automated test suite that attempts to render all portal-page-linked articles and checks the results. |
|||
=== Testers === |
|||
[[Category:Open projects]] |
|||
If you're willing to test code once the developers have it working, place your name below (make sure it links to some form of contact information). |
|||
[[Category:Content]] |
|||
[[Category:Wiki texts]] |
|||
{{Activity page |
|||
|icon=Image:Activity-wikiserver.svg |
|||
|genre=General Search and Discovery |
|||
|activity group=Activities/G1G1 |
|||
|short description=Wikibrowse is a self-contained wiki server. |
|||
|long description=A wiki webserver activity is being developed, as a self-contained browsable offline wikireader. Other efforts to generate and browse slices of online wikis are being discussed in the [[Wikislice]] project. |
|||
== Introduction == |
|||
* [[User:Mchua|Mel Chua]] |
|||
* [[User:RafaelOrtiz | Rafael Ortiz]] |
|||
The [http://collison.ie/wikipedia-iphone/ Wikipedia on an Iphone] (WOAI) project by Patrick Collison makes it possible to have a working, usable mediawiki (read: wikipedia) dump in a very small space (read: the XO's flash drive). |
|||
* [[User:Sj|Sj]] |
|||
*[[User:Googleplex12|Evan]] |
|||
=== How it works === |
|||
The wikipedia-iphone project's goal is to serve wikipedia content out of a compressed copy of the XML dump file after indexing it. The architecture is that there are C functions to pull out articles, and several interfaces to those C functions: the main interface is the iPhone app, but there's also a web server (written in Ruby with Mongrel) that runs locally and serves up pages from the compressed archive. |
|||
Link coloring is present -- green links indicate articles which exist (on a local server, or on the internet) but not in the local dump, while blue links indicate locally-existing pages. |
|||
The mediawiki data dump is stored as a [http://en.wikipedia.org/wiki/Bz2 .bz2 file], which is made of smaller compressed blocks (which each contain multiple articles). The WOAI code, among other things, goes through and makes an index of which block each article is in. That way, when you want to read an article, your computer only uncompresses the tiny block it's in - the rest of the huge mediawiki dump stays compressed. This means that |
|||
* (1) it's really fast, since you're working with tiny compressed bundles and |
|||
* (2) it's really small, since you're only decompressing one tiny bundle at a time. |
|||
=== Downloads === |
|||
This is a very large activity bundle, make sure you have at least 100MB free before downloading. It takes Sugar a couple of minutes to decompress it, during which time the UI will be frozen. |
|||
|contact person=User:Cjb |
|||
|activity source=http://dev.laptop.org/git/projects/wikiserver |
|||
|language=fracais |
|||
|bundle URL=http://dev.laptop.org/~cjb/eswiki/Wikipedia-10.xo |
|||
|activity version=10 |
|||
|releases=8.2.0 (767) |
|||
|devel status=5. Production-stable |
|||
}} |
Latest revision as of 21:08, 11 January 2012
WikiBrowse is a wiki server and compressed set of wiki pages that together act as a self-contained browsable offline wikireader.
Releases
Source download
The project's developed inside our git repository:
- 'wikiserver' code
Chris's initial blog post mentions how this project got started.
Developers
- Wade Brainerd, Chris Ball, Madeleine Ball, Ben Schwartz
- User:Martinlanghoff, Gonzalo Odiard, Rob Ochshorn
Testing
- Wikitext rendering.
- Download the activity bundle click around links, looking for errors in rendering. Check these errors against Wikipedia, and report them in Trac if there is a real difference.
- We should prepare an automated test suite that attempts to render all portal-page-linked articles and checks the results.
- Blacklisting
- Please report any inappropriate articles or images with the link at the top of each page.
If you're willing to test code once the developers have it working, place your name below (make sure it links to some form of contact information).
Creating a slice of wikipedia
NOTE: this process was updated. To have information about the new process read http://wiki.sugarlabs.org/go/Activities/Wikipedia/HowTo
The current wikipedia slice was created based on the traffic statistics for Spanish wikipedia for the month February 2008. This file was provided by User:Henrik on English Wikipedia, who has collected traffic statistics for many different wikipedias (you can browse some of this at http://stats.grok.se ). Try approaching him if you want to acquire traffic stats for another wikipedia, or approach Madeleine or Chris if you want to get your hands on the Spanish or English Feb 2008 traffic stats.
- Parse the wikipedia xml dump to get a list of all articles and a list of all redirects ( GetPages.pl )
- Parse the wikipedia xml dump to get a list of all links to other pages made by each page ( PageLinks.pl )
- Recount the Feb 2008 traffic list to combine traffic with redirects with the traffic of main pages, output each as having the same summed traffic stat. ( GetPageCounts.pl )
- Take the top N articles. A lot of these will get trimmed in a later step. For the current slice the top 70k articles was taken here.
- (optional) Remove blacklisted articles. ( RemoveBlacklist.pl )
- Use the output of PageLinks.pl to assess the number of incoming links for each article within the current set. Remove all "orphaned" articles (articles with zero incoming links). ( RemoveUnlinked.pl )
- This step also removes many articles with certain name types: Wikipedia:, Ayuda:, Wikiproyecto:, MediaWiki:, Plantilla:, WP:, Portal:, and Categoría:.
- This step should be repeated until there are no orphaned articles left. About 26k articles are removed in the first round. There are about 200 articles that become newly-orphaned if you repeat it.
- Re-add all template articles ("Plantilla:"). We ignored them because their traffic stats do not reflect their usage.
Creating and editing a slice of wikipedia
See WikiBrowse Editing for a technique to edit and polish a wikipedia slice.
How well does this work?
There are concerns that the traffic based method will bias too heavily for "popular culture". The results seem to be better than other schemes tried so far (eg. ranking by number of incoming links). The vast majority of articles on the list are there due to constant traffic rather than a local peak in popularity. With ~ 24k articles (not counting redirects) the space gained by manually removing some articles is negligible.
The top 20 articles of the Feb 2008 Spanish wikipedia traffic stats are:
1 769326 Wikipedia 2 342777 Día de San Valentín 3 285346 Célula 4 281076 México 5 273326 Filosofía 6 270628 Ciencia 7 254431 España 8 245171 Física 9 233579 Ecología 10 226516 Naruto 11 225685 Calentamiento global 12 223276 Estados Unidos 13 217996 Valor 14 211550 Sistema operativo 15 208141 Psicología 16 207869 Wiki 17 197387 Computadora 18 197126 Biología 19 194576 Comunicación 20 193129 Baloncesto
Method used on the English Wikipedia
See SelectionBot and its March 2008 results. Another approach, as used on the English Wikipedia, combines four importance parameters using a logarithmic function, then adds in a factor for article quality. The four importance parameters are:
- Importance rating by WikiProject
- Number of internal links into the page
- Number of interwiki versions of the article (i.e., other language versions)
- Number of hits (as used in the previous Spanish example)
This combination of four parameters helps to smooth out the selection. Data are collected on the toolserver via a bot. Work is currently being done (July 2008) to balance the selections between different WikiProjects, and the system is expected to be optimized by August 2008.
Old tasks
- Porting server code from Ruby to Python
- Done. (wade)
- Embed the wiki content in a wrapper page which contains a search box, home link, etc.
- Find & fix rendering bugs in the wikitext parser.
- Implement Green-link, Red-link, Blue-link.
- Expand templates before processing the XML.
- Creating a python activity wrapper
- Done. (wade) -- though this needs testing for journal/sugar integration.
- Write a README on how to run your ported code and include it in the bundle.
- It would also be super nice to contact Patrick, the original "wikipedia on the iphone" developer, and work with that community to integrate your code into theirs. Chris made a start on this.
- Contact the testers who have signed up below, and give them instructions on how you'd like them to try out the code you've written, and what kind of feedback you're looking for.
- Creating a spanish-language portal page
- Done. mad is working on this.
See also
- Wikislices a collection of articles pulled from Wikipedia (without the wiki web server).
- Wikibooks a set of wiki pages in PDF format.
- InfoSlicer is a tool to create a collection from content (such as Wikipedia pages) on the Internet.
Activity Summary
Icon: | Sugar icon::Image:Activity-wikiserver.svg |
Genre: | Activity genre::General Search and Discovery |
Activity group: | ,|x|Activity group::x}} |
Short description: | Short description::Wikibrowse is a self-contained wiki server. |
Description: | [[Description::A wiki webserver activity is being developed, as a self-contained browsable offline wikireader. Other efforts to generate and browse slices of online wikis are being discussed in the Wikislice project.
IntroductionThe Wikipedia on an Iphone (WOAI) project by Patrick Collison makes it possible to have a working, usable mediawiki (read: wikipedia) dump in a very small space (read: the XO's flash drive). How it worksThe wikipedia-iphone project's goal is to serve wikipedia content out of a compressed copy of the XML dump file after indexing it. The architecture is that there are C functions to pull out articles, and several interfaces to those C functions: the main interface is the iPhone app, but there's also a web server (written in Ruby with Mongrel) that runs locally and serves up pages from the compressed archive. Link coloring is present -- green links indicate articles which exist (on a local server, or on the internet) but not in the local dump, while blue links indicate locally-existing pages. The mediawiki data dump is stored as a .bz2 file, which is made of smaller compressed blocks (which each contain multiple articles). The WOAI code, among other things, goes through and makes an index of which block each article is in. That way, when you want to read an article, your computer only uncompresses the tiny block it's in - the rest of the huge mediawiki dump stays compressed. This means that
DownloadsThis is a very large activity bundle, make sure you have at least 100MB free before downloading. It takes Sugar a couple of minutes to decompress it, during which time the UI will be frozen.]] |
Maintainers: | ,|x|Contact person::x}} |
Repository URL: | Source code::http://dev.laptop.org/git/projects/wikiserver |
Available languages: | ,|x|Available languages::x}} |
Available languages (codes): | ,|x|Language code::x}} |
Pootle URL: | |
Related projects: | Related projects,|x|Related projects::x}} |
Contributors: | ,|x|Team member::x}} |
URL from which to download the latest .xo bundle | Activity bundle::http://dev.laptop.org/~cjb/eswiki/Wikipedia-10.xo |
Last tested version number: | Activity version::10 |
The releases with which this version of the activity has been tested. | ,|x|Software release::x}} |
Development status: | Devel status::5. Production-stable |
Ready for testing (development has progressed to the point where testers should try it out): | ,|x|Ready for testing::x}} |
smoke tested : | |
test plan available : | |
test plan executed : | |
developer response to testing : |