(The site's still under construction)

(Note that stuff in the readme file in the zip archive is probably not up-to-date like this web page)

(Version 1.0.1 will be out soon - fixed the main bug! Meanwhile, download the bug fix (see below))

MzReader


MzReader: Free Download (version 1.0.0, Windows) - You MUST agree to the license (see LICENSE section)

Bug fix released: to fix the runtime errors/script errors, replace Wikipedia.HTM with this one (it's compressed; you'll need to extract the contents with any ZIP supporting archiver).

MzReader (Version 1.0.0): README

Before you start, I'd just like to remind you to PLEASE, PLEASE, PLEASE post your comments (or problems!) to my Wikipedia talk page at en.wikipedia.org/wiki/User_talk:Mun206. PLEASE!

Well, basically, MzReader is an offline Wikipedia reader that makes a page look more authentic and 'Wikipedia-like'. Currently it only supports the monobook theme; it aims to support more skins in the future. The program is Windows-only; it should work, in theory, on Windows 98, Me, 2000, XP, Vista, but it has only been tested on Vista Home Premium 32-bit and XP Professional SP2.

LICENSE

By using, installing or otherwise accessing MzReader and related files, you agree to the any licenses that apply to Wikipedia, including copyright and trademark licenses and agreements.

INSTALLATION

So to get started, simply extract the contents of the ZIP file to any destination; preferably C:\MzReader\ or similar, if you don't mind using the root of your drive to store folders in. You'll need to download the latest version of BzReader (NOT created by me; see http://en.wikipedia.org/wiki/Wikipedia:Tools/Alternative_browsing#Windows), any Wikipedia articles dump (see http://en.wikipedia.org/wiki/Wikipedia:Database_dump; something similar to pages-articles.xml.bz2 is required). DO NOT DECOMPRESS THE DUMP! It will likely increase in size up to several times more decompressed, and neither BzReader nor MzReader can process a decompressed dump.

Install and start BzReader, and allow it to make an index of the data dump. The index will take up roughly 600 to 700 MB, and it can take 2 to 3 hours (on my Core 2 Duo T7300 (2 GHz, 800 MHz FSB and 4 MB L2) it took about 1.5 to 2 hours, so a Pentium 4 running at 3 GHz would likely take a similar amount of time). You'll only need to open one article on BzReader (any will do). After doing this, right-click on the browsing area, and click Properties. Where it says Address (URL), you'll get something similar to this:

http://localhost:49242/?topic=Wikipedia&index=enwiki-20081008-pages-articles.xml_2.bz2

Copy the port number (49242 in this case) to the clipboard. You MUST leave BzReader on; do not close it.

Note: when I started BzReader and searched for an article, it wanted access to the Internet; make sure you allow this access, because it's actually accessing localhost:port (I'm not sure if it searches for updates too).

Most users will probably not have Visual Basic 6.0, and the installed components of Internet Explorer 6 and the Inet Control for VB6. These are key components required for MzReader to function. To install these, open the Package folder and double-click Setup.exe.

Once you've installed the components, started BzReader and copied the port number, run MzReader. Paste the port number (ctrl-v) and press OK. You must allow MzReader to access the Internet (it doesn't actually access the Internet but accesses localhost:port; it DOES NOT search for updates either), whether you are connected or not. Then, simply search for an article in the address bar. (Note that the navigation bar at the side, when it appears after loading an article, doesn't actually work, and this isn't a bug). Press enter or click Go to open the article. If all went well, you should have an authentic-looking user-friendly article in front of you.

For more information, run MzReader and navigate to mz:help.

TROUBLESHOOTING & FAQ

**This bug has been fixed - see above** The following error comes up twice every time I load an article: 'A Runtime Error has occurred. Do you wish to Debug?' What do I do?

Unfortunately, you can't do anything about it. This is the only major bug in the program; you'll simply have press the 'n' key twice as the fastest way of getting around it or somehow disable debugging in Internet Explorer (it uses the version 6 ActiveX control).

**This bug has been fixed - see above**

Some images are missing and/or there's no navigation bar at the side! What do I do?

Some files are missing from the MzReader folder. You should have the following files and subfolders in the MzReader folder:

Wikipedia_files (Folder)

Wikipedia.htm

WikipediaX.htm

Wiki.png

user.gif

MzReader.exe

special.html

specialhelp.html

specialnotsupported.html

The special*.html are not replaceable, but aren't REQUIRED for MzReader to work.

Wiki.png, user.gif and WikipediaX.htm are of little importance and can be replaced easily; in fact, WikipediaX need not even be there. It is simply used as a test page to see if MzReader or your web browser is causing a problem. As for the other two, Wiki.png can be downloaded at http://upload.wikimedia.org/wikipedia/en/b/bc/Wiki.png, and user.gif at http://upload.wikimedia.org/skins/monobook/user.gif.

Wikipedia.htm and MzReader.exe are core files and must be re-downloaded or extracted from the ZIP archive.

If none of these files are missing, look for the following files in the Wikipedia_files folder:

100px-Wikipedia-logo-en-big.png

16px-Sound-icon.png

180px-Wikimedia_Foundation_RGB_logo_with_text.png

20px-Padlock-silver-medium.png

25px-Commons-logo.png

25px-Wikibooks-logo.png

25px-Wikinews-logo.png

25px-Wikiquote-logo.png

25px-Wikisource-logo.png

25px-Wikiversity-logo-Snorky.png

25px-Wiktionary-logo-en.png

45px-Sound-icon.png

50px-Wikimedia-logo-meta.png

ajax.js

centralnotice.js.disabled

commonPrint.css

headbg.jpg

highlight.css

hyperlink.js

index.css

index.php

index_002.css

index_002.php

index_003.css

index_004.css

index_005.css

magnify-clip.png

main.css

main_002.css

mvpagescripts.js

mwsuggest.js

OggPlayer.js

pixel.gif

play.png

poweredby_mediawiki_88x31.png

shared.css

sticky.js

wikibits.js

wikimedia-button.png

Except for the pictures, the other files can't be downloaded from Wikipedia because they've been edited to work with MzReader. You'll have to find the files in the ZIP archive and extract them again.