Set up images (Linux)
diff --git a/home/wiki/App/Databases/Overview.html b/home/wiki/App/Databases/Overview.html
index 4fe7abd3d..011fff730 100644
--- a/home/wiki/App/Databases/Overview.html
+++ b/home/wiki/App/Databases/Overview.html
@@ -93,7 +93,7 @@
Wikitext databases will have -text- in the file name. For example, en.wikipedia.org-text-ns.000.xowa
Wikitext databases have been supported since the very start of XOWA. As such, they have a full set of functionality
diff --git a/home/wiki/App/Import/English_Wikipedia.html b/home/wiki/App/Import/English_Wikipedia.html
index 4e3ab24d7..67681f95d 100644
--- a/home/wiki/App/Import/English_Wikipedia.html
+++ b/home/wiki/App/Import/English_Wikipedia.html
@@ -102,7 +102,7 @@
diff --git a/home/wiki/App/Import/Import_overview.html b/home/wiki/App/Import/Import_overview.html
index 3a5fa2a2e..fa7831b2f 100644
--- a/home/wiki/App/Import/Import_overview.html
+++ b/home/wiki/App/Import/Import_overview.html
@@ -68,7 +68,7 @@
Import online by click
- The Import online page lists 800+ wikis that can be imported by clicking on a link.
+ The Import online page lists 800+ wikis that can be imported by clicking on a link.
diff --git a/home/wiki/App/Import/Manual.html b/home/wiki/App/Import/Manual.html
index 96f12b0f2..7d3d1c63f 100644
--- a/home/wiki/App/Import/Manual.html
+++ b/home/wiki/App/Import/Manual.html
@@ -21,7 +21,7 @@
Reasons for manual import
- The list of data dumps allows you to download dumps for any wiki with one mouse click. However, there are times when you want to manually import a wiki:
+ The list of data dumps allows you to download dumps for any wiki with one mouse click. However, there are times when you want to manually import a wiki:
diff --git a/home/wiki/App/Import/Shrinking.html b/home/wiki/App/Import/Shrinking.html
index 7e9519f50..25db09e94 100644
--- a/home/wiki/App/Import/Shrinking.html
+++ b/home/wiki/App/Import/Shrinking.html
@@ -30,7 +30,7 @@
This file is not used by XOWA, and can be removed from the system.
- If you are using the automated set up from Dashboard/Import/Online, the BZ2 file is moved to /xowa/wiki/#done. XOWA does not delete this file in case the user wants to re-import the wiki, and avoid redownloading the entire file.
+ If you are using the automated set up from Dashboard/Import/Online, the BZ2 file is moved to /xowa/wiki/#done. XOWA does not delete this file in case the user wants to re-import the wiki, and avoid redownloading the entire file.
Namespace removal
diff --git a/home/wiki/App/Search.html b/home/wiki/App/Search.html
index 18bff64e2..e44f34598 100644
--- a/home/wiki/App/Search.html
+++ b/home/wiki/App/Search.html
@@ -559,7 +559,7 @@
By default, XOWA returns results sorted by "page length descending". In other words, the largest page would be the first in the list and the smallest page would be the last.
- If a wiki is built with PageRank, or if a wiki is downloaded from archive.org, then the results will be sorted by "PageRank descending". See Options/Search for enabling PageRank.
+ If a wiki is built with PageRank, or if a wiki is downloaded from archive.org, then the results will be sorted by "PageRank descending". See Options/Search for enabling PageRank.
For example, for English Wikipedia, the dump size is 12 GB.
diff --git a/home/wiki/App/UI/Address_bar/Shortcuts.html b/home/wiki/App/UI/Address_bar/Shortcuts.html
index 0cc2aff44..7546480a5 100644
--- a/home/wiki/App/UI/Address_bar/Shortcuts.html
+++ b/home/wiki/App/UI/Address_bar/Shortcuts.html
@@ -296,7 +296,7 @@
Customizing shortcuts
- XOWA also allows customization of shortcuts by modifying the custom gfs file. See: Options/Config_script
+ XOWA also allows customization of shortcuts by modifying the custom gfs file. See: Options: App - Startup
Shortcuts should be chosen wisely. In particular, using "http", "https" and "file" as a shortcut is heavily discouraged. Similarly, "Category", "Talk", "Help", "Template", "Wikipedia" and other wiki namespaces should be avoided.
diff --git a/home/wiki/App/UI/Address_bar/URLs.html b/home/wiki/App/UI/Address_bar/URLs.html
index 894dcce49..750ada12e 100644
--- a/home/wiki/App/UI/Address_bar/URLs.html
+++ b/home/wiki/App/UI/Address_bar/URLs.html
@@ -69,7 +69,7 @@
For example, "w:Earth" will always take you to "en.wikipedia.org/wiki/Earth" from any other wiki. It is only 2 characters longer than "Earth".
- See shortcuts for more information.
+ See shortcuts for more information.
XOWA keyboard shortcuts (advanced)
diff --git a/home/wiki/App/UI/Main_window.html b/home/wiki/App/UI/Main_window.html
index 2441ba000..a0600966b 100644
--- a/home/wiki/App/UI/Main_window.html
+++ b/home/wiki/App/UI/Main_window.html
@@ -126,7 +126,7 @@
Note that you can also press the Go button instead of Enter to select the address.
- There are other formats that can be entered into the address bar. For more information, see App/UI/Address_bar/Shortcuts
+ There are other formats that can be entered into the address bar. For more information, see App/UI/Address_bar/Shortcuts
To select the address bar, press Alt+D.
@@ -256,7 +256,7 @@
The info box is located in the bottom-right hand corner of the screen.
- It displays warnings from the application. It is disabled by default, but can be enabled through Options/Dev
+ It displays warnings from the application. It is disabled by default, but can be enabled through Options: Dev - General
To select the info box, press Ctrl+Alt+N.
diff --git a/home/wiki/App/UI/Tabs.html b/home/wiki/App/UI/Tabs.html
index f0dd2a363..1dec81879 100644
--- a/home/wiki/App/UI/Tabs.html
+++ b/home/wiki/App/UI/Tabs.html
@@ -56,7 +56,7 @@
Tab functionality will be enhanced in later v1.5.* releases.
- Tab configuration is available at Options/Tabs
+ Tab configuration is available at Options/Tabs
- By default, anything that matches a rule (has a score > 0) will be excluded. Note that this exclude number can be raised from 0 to something higher like 100. See Options/Import_Dansguardian
+ By default, anything that matches a rule (has a score > 0) will be excluded. Note that this exclude number can be raised from 0 to something higher like 100. See Options/Import_Dansguardian
- I was planning to do a release tonight, but ran into last-minute issues. I'm going to push for a release tomorrow or possibly next Sunday.
-
-
- Release: NONE (2016-12-25 22:45 Sun)
-
-
- Just a quick note. Due to the holiday season and personal obligations, there is no release this week. There will be a release next week with a new configuration system.
-
- There is no PC release this week. I've been working on the new Configuration system as well as Section editing.
-
-
- The Android version has a minor release.
-
-
- (Android) Remove horizontal scrollbars by hiding Navigation boxes by default
-
-
- This was a change due to the feedback from a Google Play review (which has since been deleted). There's a little more documentation at https://github.com/gnosygnu/xowa/issues/112
-
-
- XOWA Android would show pages which have horizontal scrollbars. They appear mostly because of what's called Navigation boxes ("navboxes") at the bottom of the page. For example, go to https://en.wikipedia.org/wiki/Earth#External_links and see the section called "Articles related to Earth"
-
-
- The Wikipedia Mobile App and the Wikipedia Mobile Site both hide these by default. XOWA Android used to show them by default. This was a deliberate decision on my side, because (a) I generally like to show as much content as possible and (b) I do find them useful.
-
-
- However, after the strongly worded review, I realized that there probably was considerable UI wisdom in hiding them by default. So I changed the behavior of XOWA to follow the same behavior as Wikipedia's Mobile App / site.
-
-
- However, I also left a configuration option to show them by default. To do so, the following would need to be done:
-
-
-
- Open the left side menu and do "XOWA" -> "Settings" -> "XOWA options"
-
-
- Check "Show navboxes"
-
-
- Visit a page like Earth
-
-
-
- Next release: v3.12.4
-
-
- I'm skipping next week due to personal reasons. This means that the next possible release would be Christmas weekend. I'll try to push something out then, but since may rely on a quick "beta" release.
-
-
-
- Wikis: I'm running a little behind on 2016-12 English Wikipedia. I'm hoping to have a version later this week, but there may be a few things to investigate.
-
-
- Options: I'm done with most of the core parts the Options system. I now need to work on migration, which will probably take some time.
-
-
-
- Release: v3.12.1.1 (2016-12-04 22:00 Sun)
-
-
- The PC version is a minor release. It fixes an import issue with English Wikipedia on older machines, has several Scribunto and Wikibase fixes for Russian wikis, and has some page sync issues
+ The PC version is a major release. It adds a new Option system and includes a lot of related changes.
The Android version has no release.
- (Wiki) Publish 2016-11 Dutch and Russian wikis. Also, 2016-11 German Wikipedia
+ (Wiki) Publish 2016-12 Italian and Swahili wikis. Also, 2016-12 English Wikipedia
- As per the section title, 2016-11 Dutch and Russian wikis are up at archive.org. You can check Wiki_setup/Listing or Special:XowaDownloadCentral
+ 2016-12 Italian and Swahili wikis are up at archive.org. 2016-12 English Wikipedia was also pushed out earlier this month.
- (PC) Fix "stalled" English Wikipedia import on older machines
+ (PC) Add new Options system
- This issue was reported in issue 98 and and issue 108.
+ The major change for this release was the Options system. It was a multi-week effort that overhauled various parts of the system. You can try the new Options systems at the Options page
- Due to changes in the English Wikipedia Category system, XOWA needed to import a lot more data. Unfortunately, this caused the English Wikipedia import to stall on older machines. I was unable to reproduce it on my current machine (i7 CPU on either SSD or HDD), but was able to reproduce it on my laptop (Core Duo with HDD).
-
-
- This issue was resolved by adding a new SQL index during the category import. The total time will still be noticeably longer (from 2 hours to 5 hours), but it should complete in the end.
-
-
- (PC) Fix various minor Scribunto and Wikibase errors with Russian Wikipedia including inferred datatype
-
-
- There were a number of minor fixes around the 2016-11 Russian wikis.
-
-
- The most significant one was an issue with Wikidata and missing infobox images. For more detail, you can look at https://lists.wikimedia.org/pipermail/wikidata/2016-November/010019.html . This was fixed for any Russian Wiki imported through Import Online or Import Offline. However, Russian wikis downloaded through Download Central will still be missing images, until the next time I rebuild them.
-
-
- For the other changes, you can take a look at the Scribunto and Wikibase items at Change log/v3.12.1.1
-
-
- (PC) Fix page sync issues when syncing File or Chinese pages with math
-
-
- First, thanks to khanhhung2512 for reporting these issues.
-
-
- XOWA had the following page sync issues:
+ There were a number of reasons for the change:
- Failed when downloading "File:" pages
+ Android compatible: The previous Options system was not Android compatible. It relied on Wikitext (which XOWA Android doesn't support), and had a very desktop-centric UI design (wide tabstrip; hover tooltips). The new Options system addresses these issues and uses a common codebase for both desktop and Android.
- Failed when downloading Chinese pages with Math
+ Multiple wiki support: The previous Options system used one set of options for all wikis. Individual wikis couldn't have options different from another wiki (actually, they could, but in a very indirect way). The new Options system supports multiple wikis out-of-box, though at current, it's only used for one option (variant choice in Chinese / Serbian wikis)
- Always downloaded every page, instead of those listed in the Options page
+ Technical upgrades: The previous Options system was a hodge-podge of Wikitext and XOWA-specific extensions. The new Options systems standardizes data-storage in SQLite, generates pages through one Special extension, uses a good deal of CSS to display HTML, and offers dynamic interaction via AJAX. Overall, it should be a more web-like and pleasant user-experience
- These fixes are included in this release.
+ Because the scope of the change was so sweeping, there may be a number of issues. If you run into problems, please try the following:
+
+
+
+ user_system.gfs: XOWA tries to convert existing options at /xowa/user/anonymous/app/data/cfg/user_system_cfg.gfs. If you're missing an option, you can try checking there
+
+
+ xowa_cfg_os.gfs: XOWA also stores Operating System specific options at /xowa/bin/[OS_NAME]/xowa/cfg/xowa_cfg_os.gfs. The new version now uses a different file: /xowa/user/app/cfg/os.gfs. If you've manually customized options here, you will need to reapply them
+
+
+ Missing options: A handful of options were not converted. For more detail, see Change_log
+
+
+
+ Of course, if you run into issues, please let me know at https://github.com/gnosygnu/xowa/issues I'm hoping though that this will be a pleasant, uneventful change.
- Next release: v3.12.2
+ (PC) Change versioning scheme to semantic versioning
+
+
+ Since the start, XOWA used a date-of-release versioning scheme. For example, version 3.12.2.1 meant the version released in the 3rd year after XOWA's release, in the 12th month and the 2nd week.
+
+
+ XOWA is now adopting a new versioining scheme closer to semantic versioning. Specifically:
+
+
+
+ In the previous scheme, this version would be 4.1.1.1.
+
+
+ In the new scheme, this version is 4.0.0.1701
+
+
+
+ As an overview:
+
+
+
+ The 1st number indicates a major version. For example, 4. This number won't change unless there is a drastically new change, or after there's a lot of significant changes.
+
+
+ The 2nd number indicates a minor version. For example, 0. This number will change whenever there is a new significant feature or change.
+
+
+ The 3rd number indicates a patch version. For example, 0. This number will change whenever there is a new release.
+
+
+ The 4th number indicates a system version. For example, 1701. This number is related to the release date in year / month format: 2017-01.
+
+
+
+ In terms of upgrade strategies:
+
+
+
+ If you're a casual user, you can wait on upgrading until the major version changes. When "5.0" comes out you should probably get it, as it should be significantly different than the current version. This will probably not come out for a year or more.
+
+
+ If you're an active user, you can wait on upgrading until the minor version changes: "4.1", "4.2", "4.3", etc.. Each minor release will have a new significant feature or change. These will probably come out at monthly intervals.
+
+
+ If you're a cutting-edge user, you can upgrade whenever a release is made: "4.0.1", "4.0.2", "4.0.3", etc.. Each patch release will have a number of changes and fixes. These will probably come out ever week.
+
+
+
+ Finally, all releases are considered stable. So, whenever a patch release comes out, it will be promoted to the official download for all new users. If it's safe enough for new users to try, it's definitely safe enough for existing users as well.
+
+
+ (PC) Fix mass parse performance issues when generating English Wikipedia
+
+
+ This was an issue I discovered when generating the 2016-12 English Wikipedia. It takes about 25 hours to dump English Wikipedia on an 8 core machine. Due to recent changes with Embeddable (using XOWA as a MediaWiki parser), this number grew to about 36 hours. In some cases, it even failed with OutOfMemory exceptions.
+
+
+ This build brings the build time back to 25 hours.
+
+
+ Next week: v4.0.1.1701
- Wikis: I'm generating wikis for the 2016-11 Italian wikis. I'll also kick off 2016-12 English Wikipedia as well.
+ Wikis: I'm going to start preparing for the 2017-01 wikis. I'm on vacation for the 3rd and 4th weeks of 2016-01, so I'm going to focus on getting English Wikipedia and then move on to French and German
- Options: I'm almost done rewriting the Options system. I also plan to add an update feature for the desktop app. I'm still planning to do some more work on Page Sync and full-text search, though my time recently has been limited.
+ Download Central and Android: There were a number of issues brought up with Download Central and Android as described here: https://github.com/gnosygnu/xowa/issues/112
+
v2.7.2 now goes back one dump month if the "latest-pages-articles.xml.bz2" is not there. In the case of Japanese Wikipedia, it does this:
@@ -1648,7 +1648,7 @@
I finished uploading the files for English Wikipedia. Note that these files are just like the 2015-04 set, except that the max file size is 1.5 GB instead of 3 GB. Android can't use 3 GB files.
- Unfortunately, right now, there are 3 types of sets for English Wikipedia: v1, v2a and v2b. See App/Import/English_Wikipedia for more details. Users are strongly encouraged to download the new 2015-06 set (v2b), especially if they're going to use Android. However, I will continue to support monthly updates for v1 and v2a over the next year.
+ Unfortunately, right now, there are 3 types of sets for English Wikipedia: v1, v2a and v2b. See App/Import/English_Wikipedia for more details. Users are strongly encouraged to download the new 2015-06 set (v2b), especially if they're going to use Android. However, I will continue to support monthly updates for v1 and v2a over the next year.
For more information on setting up English Wikipedia, see App/Xtn/Android
@@ -2024,7 +2024,7 @@
Release: v2.4.4.1 (2015-04-26 21:55 Sun)
- v2.4.4.1 introduces a multi-wiki search feature. The configuration is a bit difficult, but it should be flexible enough to handle most scenarios. See Options/Search. I also made a few more improvements to the general Search behavior. There are also some important incremental fixes from earlier this week.
+ v2.4.4.1 introduces a multi-wiki search feature. The configuration is a bit difficult, but it should be flexible enough to handle most scenarios. See Options/Search. I also made a few more improvements to the general Search behavior. There are also some important incremental fixes from earlier this week.
For images, the last part of German is uploading, and I plan to upload Czech tonight or tomorrow.
diff --git a/home/wiki/Blog/2016-01.html b/home/wiki/Blog/2016-01.html
index d67475e47..2a3738f67 100644
--- a/home/wiki/Blog/2016-01.html
+++ b/home/wiki/Blog/2016-01.html
@@ -21,48 +21,53 @@
- I was planning to do a release tonight, but ran into last-minute issues. I'm going to push for a release tomorrow or possibly next Sunday.
-
-
- Release: NONE (2016-12-25 22:45 Sun)
-
-
- Just a quick note. Due to the holiday season and personal obligations, there is no release this week. There will be a release next week with a new configuration system.
-
+
+ Release: NONE (2016-12-25 22:45 Sun)
+
+
+ Just a quick note. Due to the holiday season and personal obligations, there is no release this week. There will be a release next week with a new configuration system.
+
+ The major change for this release was the Options system. It was a multi-week effort that overhauled various parts of the system. You can try the new Options systems at the Options page
+
+
+ There were a number of reasons for the change:
+
+
+
+ Android compatible: The previous Options system was not Android compatible. It relied on Wikitext (which XOWA Android doesn't support), and had a very desktop-centric UI design (wide tabstrip; hover tooltips). The new Options system addresses these issues and uses a common codebase for both desktop and Android.
+
+
+ Multiple wiki support: The previous Options system used one set of options for all wikis. Individual wikis couldn't have options different from another wiki (actually, they could, but in a very indirect way). The new Options system supports multiple wikis out-of-box, though at current, it's only used for one option (variant choice in Chinese / Serbian wikis)
+
+
+ Technical upgrades: The previous Options system was a hodge-podge of Wikitext and XOWA-specific extensions. The new Options systems standardizes data-storage in SQLite, generates pages through one Special extension, uses a good deal of CSS to display HTML, and offers dynamic interaction via AJAX. Overall, it should be a more web-like and pleasant user-experience
+
+
+
+ Because the scope of the change was so sweeping, there may be a number of issues. If you run into problems, please try the following:
+
+
+
+ user_system.gfs: XOWA tries to convert existing options at /xowa/user/anonymous/app/data/cfg/user_system_cfg.gfs. If you're missing an option, you can try checking there
+
+
+ xowa_cfg_os.gfs: XOWA also stores Operating System specific options at /xowa/bin/[OS_NAME]/xowa/cfg/xowa_cfg_os.gfs. The new version now uses a different file: /xowa/user/app/cfg/os.gfs. If you've manually customized options here, you will need to reapply them
+
+
+ Missing options: A handful of options were not converted. For more detail, see Change_log
+
+
+
+ Of course, if you run into issues, please let me know at https://github.com/gnosygnu/xowa/issues I'm hoping though that this will be a pleasant, uneventful change.
+
+
+ (PC) Change versioning scheme to semantic versioning
+
+
+ Since the start, XOWA used a date-of-release versioning scheme. For example, version 3.12.2.1 meant the version released in the 3rd year after XOWA's release, in the 12th month and the 2nd week.
+
+
+ XOWA is now adopting a new versioining scheme closer to semantic versioning. Specifically:
+
+
+
+ In the previous scheme, this version would be 4.1.1.1.
+
+
+ In the new scheme, this version is 4.0.0.1701
+
+
+
+ As an overview:
+
+
+
+ The 1st number indicates a major version. For example, 4. This number won't change unless there is a drastically new change, or after there's a lot of significant changes.
+
+
+ The 2nd number indicates a minor version. For example, 0. This number will change whenever there is a new significant feature or change.
+
+
+ The 3rd number indicates a patch version. For example, 0. This number will change whenever there is a new release.
+
+
+ The 4th number indicates a system version. For example, 1701. This number is related to the release date in year / month format: 2017-01.
+
+
+
+ In terms of upgrade strategies:
+
+
+
+ If you're a casual user, you can wait on upgrading until the major version changes. When "5.0" comes out you should probably get it, as it should be significantly different than the current version. This will probably not come out for a year or more.
+
+
+ If you're an active user, you can wait on upgrading until the minor version changes: "4.1", "4.2", "4.3", etc.. Each minor release will have a new significant feature or change. These will probably come out at monthly intervals.
+
+
+ If you're a cutting-edge user, you can upgrade whenever a release is made: "4.0.1", "4.0.2", "4.0.3", etc.. Each patch release will have a number of changes and fixes. These will probably come out ever week.
+
+
+
+ Finally, all releases are considered stable. So, whenever a patch release comes out, it will be promoted to the official download for all new users. If it's safe enough for new users to try, it's definitely safe enough for existing users as well.
+
+
+ (PC) Fix mass parse performance issues when generating English Wikipedia
+
+
+ This was an issue I discovered when generating the 2016-12 English Wikipedia. It takes about 25 hours to dump English Wikipedia on an 8 core machine. Due to recent changes with Embeddable (using XOWA as a MediaWiki parser), this number grew to about 36 hours. In some cases, it even failed with OutOfMemory exceptions.
+
+
+ This build brings the build time back to 25 hours.
+
+
+ Next week: v4.0.1.1701
+
+
+
+ Wikis: I'm going to start preparing for the 2017-01 wikis. I'm on vacation for the 3rd and 4th weeks of 2016-01, so I'm going to focus on getting English Wikipedia and then move on to French and German
+
+
+
\ No newline at end of file
diff --git a/home/wiki/Blog/Archives.html b/home/wiki/Blog/Archives.html
index bbdccfe5f..724db18a2 100644
--- a/home/wiki/Blog/Archives.html
+++ b/home/wiki/Blog/Archives.html
@@ -18,9 +18,29 @@
@@ -246,11 +212,255 @@
The most important category to review is major. The other categories may be skipped due to lower importance (if they were more important, they would be bumped up to major).
- Message: Erreur : le thème « littérature française » du modèle Template:Ébauche n’est pas défini.
+ Message: Erreur : le thème « littérature française » du modèle Template:Ébauche n’est pas défini.
Resolved by: Fix regex pattern for matching end of string.
- Wikibase: Fix a few dozen script errors for ClassCast on fr.w pages.
-
-
-
-
- Resolved by: Support "renderSnaks".
-
-
- Example: Erreur de script: @C:/xowa/bin/any/xowa/xtns/Scribunto/engines/Luaj/MWServer.lua:59 vm error: java.lang.ClassCastException: [Lgplx.Keyval; cannot be cast to java.lang.String.
-
diff --git a/home/wiki/Change_log/2013.html b/home/wiki/Change_log/2013.html
index 5f36f2003..c27e18776 100644
--- a/home/wiki/Change_log/2013.html
+++ b/home/wiki/Change_log/2013.html
@@ -273,7 +273,7 @@
(add) Html: page_id added to HTML output; EX:<!-- page_id=~{page_id} -->.
- (doc) Score: Added note that ImageMagick is required for Score to work {detected by Anselm}. See: Options/Score
+ (doc) Score: Added note that ImageMagick is required for Score to work {detected by Anselm}. See: Options/Score
(add) Translation: Added translations for Simplified Chinese and Traditional Chinese {contributed by zjzengdongyang}. See: Options/Language
@@ -576,7 +576,7 @@
(fix) Import: Import failed to "read from file" if wiki.unzip was present.
@@ -2016,7 +2016,7 @@
(fix) syntaxhighlight and math tags should not allow raw javascript {detected by Schnark}
- (add) Option to disable Javascript See Options
+ (add) Option to disable Javascript See Options
(add) Categories now display in MediaWiki format (Subcategories; Pages; Files); EX:http://en.wikipedia.org/wiki/Category:Terrestrial_planets {requested by Schnark}
@@ -2327,7 +2327,7 @@
- (add) Preliminary support for Scribunto/Lua. See Options/Scribunto
+ (add) Preliminary support for Scribunto/Lua. See Options/Scribunto
(add) Improvements to Schnark's Javascript Timeline {contributed by Schnark}
diff --git a/home/wiki/Change_log/2014.html b/home/wiki/Change_log/2014.html
index 2b17e59d4..7ba9cc499 100644
--- a/home/wiki/Change_log/2014.html
+++ b/home/wiki/Change_log/2014.html
@@ -706,7 +706,7 @@
- Module.Popups: Reduce hide window time from 600 ms back to 400 ms. See: Options/Popups
+ Module.Popups: Reduce hide window time from 600 ms back to 400 ms. See: Options/Popups
Performance: Add option to load html from url instead of from memory. See: Options/Security
@@ -1833,19 +1833,19 @@
- Module.Popups: Add performance optimization for English Wikipedia popups; EX:See "Template keeplist". See: Options/Popups
+ Module.Popups: Add performance optimization for English Wikipedia popups; EX:See "Template keeplist". See: Options/Popups
Module.Popups: Add XowaPopupHistory button at bottom of popup; EX:hover over sundial icon.
- Module.Popups: Increase defaults for number of words shown. See: Options/Popups
+ Module.Popups: Increase defaults for number of words shown. See: Options/Popups
- Module.Popups: Increase hover show time from 400 to 600 ms (affects number of accidental hovers while scrolling through page). See: Options/Popups
+ Module.Popups: Increase hover show time from 400 to 600 ms (affects number of accidental hovers while scrolling through page). See: Options/Popups
@@ -1959,13 +1959,13 @@
Module.Popups: Add wiki domain when hovering over interwiki pages; EX:en.w:Earth -> hover over link to en.q:Earth -> show "Earth wiki:en.wikiquote.org" {suggested by Schnark}. See: https://en.wikipedia.org/wiki/Earth
- Module.Popups: Add option to skip evaluation of long templates; EX:See "Template token max". See: Options/Popups
+ Module.Popups: Add option to skip evaluation of long templates; EX:See "Template token max". See: Options/Popups
- Module.Popups: Add option to show popups in namespaces only; EX:See "Allowed namespaces" {suggested by Schnark}. See: Options/Popups
+ Module.Popups: Add option to show popups in namespaces only; EX:See "Allowed namespaces" {suggested by Schnark}. See: Options/Popups
- Module.Popups: Add option to scan forward additional words to stop at header; EX:See "Scan forward for header" {suggested by Schnark}. See: Options/Popups
+ Module.Popups: Add option to scan forward additional words to stop at header; EX:See "Scan forward for header" {suggested by Schnark}. See: Options/Popups
Scribunto: Handle new package.lua (affects location map not loading on cities / countries); EX:package.lua. See: https://en.wikipedia.org/wiki/Paris
@@ -2215,7 +2215,7 @@
- Gui.Tabs: Fix tab options not restored for Tab Height, Close Visible and Unselected Close Visible. See: Options/Tabs [broken since:start]
+ Gui.Tabs: Fix tab options not restored for Tab Height, Close Visible and Unselected Close Visible. See: Options/Tabs [broken since:start]
Options: Escape HTML characters in <textarea> (affects content code format incorrectly using "<pre>"). See: Options/Wiki/HTML
@@ -2238,7 +2238,7 @@
Javascript: Add option to control default show / hide state of NavFrames. See: Options/Wiki/HTMLDiagnostics/Javascript/NavFrame
- Gui.Tab: Add option to hide tab bar if 1 or 0 tabs {suggested by Schnark}. See: Options/Tabs
+ Gui.Tab: Add option to hide tab bar if 1 or 0 tabs {suggested by Schnark}. See: Options/Tabs
Gui.Url_bar: Add shortcut to open multiple lines in separate tabs; EX:Copy "a\nb" to clipboard -> Ctrl + Enter.
@@ -2258,7 +2258,7 @@
Html.Tidy: Limit tidy / JTidy to page content not entire page (affects one page being rendered incorrectly b/c tidy / JTidy incorrectly merges correct content with correct enclosing HTML). See: https://it.wikiquote.org/wiki/Indro_Montanelli
- Html: Add <xowa_html> node to encapsulate <style> <script> in home wiki. See: Options
+ Html: Add <xowa_html> node to encapsulate <style> <script> in home wiki. See: Options
@@ -2787,7 +2787,7 @@
Gui: Add popup menu for clicking on file. See: Options/Menus
- Gui: Add option for min chars / max chars in tab buttons. See: Options/Tabs
+ Gui: Add option for min chars / max chars in tab buttons. See: Options/Tabs
@@ -2890,19 +2890,19 @@
Gui.Tabs.Buttons: Show url as tooltip.
- Gui.Tabs.Buttons: Add option for place on top. See: Options/Tabs
+ Gui.Tabs.Buttons: Add option for place on top. See: Options/Tabs
- Gui.Tabs.Buttons: Add option for tab height. See: Options/Tabs
+ Gui.Tabs.Buttons: Add option for tab height. See: Options/Tabs
- Gui.Tabs.Buttons: Add option for curved button. See: Options/Tabs
+ Gui.Tabs.Buttons: Add option for curved button. See: Options/Tabs
- Gui.Tabs.Buttons: Add option for close button visible. See: Options/Tabs
+ Gui.Tabs.Buttons: Add option for close button visible. See: Options/Tabs
- Gui.Tabs.Buttons: Add option for unselected close button visible. See: Options/Tabs
+ Gui.Tabs.Buttons: Add option for unselected close button visible. See: Options/Tabs
@@ -2986,7 +2986,7 @@
Gui.Url_bar: Do not lose history page position after editing page; EX:Open page -> Scroll down -> Click link -> Edit -> Click back -> Position should be restored {detected by Schnark}.
- Gui: Fix StackOverflow exception when auto_focus_id is " first_anchor" and exiting app on Help:Options page. See: Options/Scribunto
+ Gui: Fix StackOverflow exception when auto_focus_id is " first_anchor" and exiting app on Help:Options page. See: Options/Scribunto
Html: Remove exit link from upper left hand corner.
@@ -3115,7 +3115,7 @@
Wikidata: Place Statements as first listed section to pseudo-emulate current Wikidata layout. See: https://www.wikidata.org/wiki/Q2
@@ -3754,7 +3754,7 @@
- Scribunto: Add luaj as alternate lua engine. See: Options/Scribunto
+ Scribunto: Add luaj as alternate lua engine. See: Options/Scribunto
@@ -3907,7 +3907,7 @@
Import: Default cache to 100 MB max and 75 MB min. See: Options/Files
Messages: Add "Contatti" message for contactpage in itwiki sidebar. See: https://it.wikipedia.org
@@ -4391,7 +4391,7 @@
Wikisource.Page: Support onlysection; EX:<pages onlysection="a"/>.
- Import.List: Update list of WMF wikis (from 674 to 804); EX:pl.wikivoyage.org. See: Dashboard/Import/Online
+ Import.List: Update list of WMF wikis (from 674 to 804); EX:pl.wikivoyage.org. See: Dashboard/Import/Online
Gui.Url_bar: Open articles with same name as language code; EX:war -> current_wiki/wiki/war, not war.wikipedia.org.
@@ -4556,7 +4556,7 @@
- Gui: Expand url bar abbreviations functionality to support "lang.type:Page"; EX:fr.s:Auteur:Shakespeare. See: App/UI/Address_bar/Shortcuts
+ Gui: Expand url bar abbreviations functionality to support "lang.type:Page"; EX:fr.s:Auteur:Shakespeare. See: App/UI/Address_bar/Shortcuts
- Search: Support search over multiple wikis. See: Options/Search
+ Search: Support search over multiple wikis. See: Options/Search
@@ -2272,7 +2272,7 @@
Wikidata: Use correct namespace / title when looking up wikidata wikis (affects wikidata language links / properties not working for titles in non-canonical namespaces); EX:"Author:A" -> 102,A x> 0,Author:A {detected by anonymous}. See: https://pt.wikisource.org/wiki/Autor:Humberto_de_Campos [broken since:v2.4.2]
- doc: Fix wrong wiki name for Wikidata; EX:Wikidata x> Walloon Wiktionary {detected by anonymous}. See: Dashboard/Import/Online [broken since:v2.4.3]
+ doc: Fix wrong wiki name for Wikidata; EX:Wikidata x> Walloon Wiktionary {detected by anonymous}. See: Dashboard/Import/Online [broken since:v2.4.3]
@@ -2393,7 +2393,7 @@
Language: Show messages for Wikidata codes (affects <some-key> showing up on Wikidata instead of "value"); EX:<Wikibase-entity-item> -> "item" {detected by anonymous}. See: https://www.wikidata.org
File: Download file if not available for offline database users.
diff --git a/home/wiki/Change_log/2016.html b/home/wiki/Change_log/2016.html
index fcaf5fd27..2ced0202d 100644
--- a/home/wiki/Change_log/2016.html
+++ b/home/wiki/Change_log/2016.html
@@ -329,7 +329,7 @@
Resolved by: Invalidate all Scribunto engines across all wikis when disabled.
@@ -2407,7 +2407,7 @@
Core: Parse decimals using US locale, not user locale. Resolves extremely wide pie charts on many de.w pages. {detected by markusmaresch} See: https://de.wikipedia.org/wiki/Hausmannstätten
+
+
\ No newline at end of file
diff --git a/home/wiki/Change_log/v3.7.4.1.html b/home/wiki/Change_log/v3.7.4.1.html
index 832f8acd5..c8f42e9ac 100644
--- a/home/wiki/Change_log/v3.7.4.1.html
+++ b/home/wiki/Change_log/v3.7.4.1.html
@@ -88,7 +88,7 @@
Resolved by: Invalidate all Scribunto engines across all wikis when disabled.
- Navigate to Options and check "Download enabled"
+ Navigate to Options and check "Download enabled"
Restart XOWA and navigate to any page. Any images will be downloaded automatically.
diff --git a/home/wiki/Dev/File/Setup/Windows.html b/home/wiki/Dev/File/Setup/Windows.html
index cd546e225..db1afa7eb 100644
--- a/home/wiki/Dev/File/Setup/Windows.html
+++ b/home/wiki/Dev/File/Setup/Windows.html
@@ -89,7 +89,7 @@
Restart XOWA and navigate to any page. Any images will be downloaded automatically.
diff --git a/home/wiki/Diagnostics.html b/home/wiki/Diagnostics.html
index 81b07edd1..4fe545e04 100644
--- a/home/wiki/Diagnostics.html
+++ b/home/wiki/Diagnostics.html
@@ -40,7 +40,7 @@
Diagnostics/Javascript/NavFrame
+
+
\ No newline at end of file
diff --git a/home/wiki/Diagnostics/Scribunto/TitleBlacklist.html b/home/wiki/Diagnostics/Scribunto/TitleBlacklist.html
index a7054779f..baa15de0b 100644
--- a/home/wiki/Diagnostics/Scribunto/TitleBlacklist.html
+++ b/home/wiki/Diagnostics/Scribunto/TitleBlacklist.html
@@ -22,7 +22,7 @@
- Import: Fix category not building on non-SSD drives. {detected by khanhhung2512 }
+ Wikibase: Fix 'Attached KML error' on many dozen en.w pages. {detected by Ope30}
- Resolved by: Add index to cl_from.
+ Resolved by: Do not cast 'numeric-id' to 'string'; leave as 'int'.
+
+
+ Example: Route map: Attached KML Error: item specified on Wikidata, or in |wikidata=, is not a KML file (P31→Q26267864 not found).
+
- Import: Fix Russian Wikisource build failure.
+ Gui: Allow Ctrl+Insert to be used to copy text. {detected by William}
- Resolved by: Convert null category sortkeys to empty array.
+ Resolved by: Do not override Ctrl+Insert with Ctrl+Minus.
- Import.offline: Do not re-download category dump files when importing wiki (redux). {detected by khanhhung2512 }
+ Gui: Support numpad keys for page find. {detected by William}
- Xtn.Math: Do not try to translate math in variant wikis. {detected by anonymous}
+ Gui: Add option to auto-remember last tab opened.
+
+
+
+
+ Gui: Support Command key on Mac OS X for keyboard shortcuts.
+
+
+
+
+ Html: Remove horizontal scroll bar on some Mac OS X configurations.
- Table_of_contents: Fix missing table of contents on some de.w television series pages. {detected by Ope30}
+ Edit: Add section-editing. {requested by anonymous}
+
+
+
+
+ Cfg: Add better support for Shortcuts.
+
+
+
+
+ Category: Show Hidden Categories in "Hidden" section.
- Resolved by: Ignore TOC magic word on transcluded pages.
-
- Scribunto: Fix script error "Module:Navbox:91 attempt to concatenate nil and string" on many ru.w pages.
+ Gui: Allow navigation to urls with arguments.
- Message: =Module:Navbox:91 attempt to concatenate nil and string
-
-
- Resolved by: Use local language's namespace name not canonical.
-
-
- Example: Russian "Шаблон" not English "Template".
-
- Scribunto: Fix script error 'expandTemplate: template "Россия Москва" does not exist' on many ru.w pages.
+ Mass_parse: Fix memory leak / slow performance due to over-zealous page caching.
- Message: expandTemplate: template "Россия Москва" does not exist
-
-
- Resolved by: Do not convert zero padded numbers to integer.
-
+ Wikibase: Add "fiwikivoyage" to list of known wikis.
+
+
+
+
+ Html: Remove content_editable support.
+
+
+
+ dev
+
+
+
+ Math: Refactor Math classes.
+
+
+
+
+ Mass_parse: Refactor make cmd to merge other wkr tables such as log_basic_temp.
+
+
+
+
+ Gui: Refactor IptKey; in particular, use SWING and SWT constants where possible; also handle modifers.
+
+
+
+
+ Mass_parse: Improve performance when returning Keyvals from Scribunto function.
diff --git a/home/wiki/Help/FAQs.html b/home/wiki/Help/FAQs.html
index a02e19712..c649c2348 100644
--- a/home/wiki/Help/FAQs.html
+++ b/home/wiki/Help/FAQs.html
@@ -66,7 +66,7 @@
Why are language links to other wikis not listed?
- Short answer: Set up the Wikidata wiki (www.wikidata.org). See Dashboard/Import/Online. After you install the Wikidata wiki, language links to other wikis will be listed at the bottom of the article.
+ Short answer: Set up the Wikidata wiki (www.wikidata.org). See Dashboard/Import/Online. After you install the Wikidata wiki, language links to other wikis will be listed at the bottom of the article.
Long answer: See App/Wiki_types/Wikidata
diff --git a/home/wiki/Help/License/Code.html b/home/wiki/Help/License/Code.html
index aaecff64e..2bf42d7d6 100644
--- a/home/wiki/Help/License/Code.html
+++ b/home/wiki/Help/License/Code.html
@@ -17,6 +17,17 @@
- XOWA is free software. The code is open source under the AGPLv3 license, and available to anyone for review or modification. See Help/License/Code for more information as well as https://github.com/gnosygnu/xowa.
+ XOWA is free software. The code is open source under the AGPLv3 license, and available to anyone for review or modification. See Help/License/Code for more information as well as https://github.com/gnosygnu/xowa.
XOWA advocates free content. All documentation and project artifacts are provided under the Creative Commons CC BY-NC-SA license. See Help/License/Docs for more information.
- XOWA values user privacy. It will never collect and upload personal information. It is designed to be run in a standalone environment, without any connection to the internet. See Help/Privacy/Desktop for more information.
+ XOWA values user privacy. It will never collect and upload personal information. It is designed to be run in a standalone environment, without any connection to the internet. See Help/Privacy/Desktop for more information.
- Please note that this program is beta software. Although it is my best hope that you find this program functional and useful, I make no assurances regarding stability or fitness of purpose. For more details, see Help/License/Code.
+ Please note that this program is beta software. Although it is my best hope that you find this program functional and useful, I make no assurances regarding stability or fitness of purpose. For more details, see Help/License/Code.
Release notes
- v3.12.1.1 features the following
+ v4.0.0.1701 features the following:
- (Wiki) Publish 2016-11 Dutch and Russian wikis. Also, 2016-11 German Wikipedia
+ (Wiki) Publish 2016-12 Italian and Swahili wikis. Also, 2016-12 English Wikipedia
- (PC) Fix "stalled" English Wikipedia import on older machines
+ (PC) Add new Options system
- (PC) Fix various minor Scribunto and Wikibase errors with Russian Wikipedia including inferred datatype.
+ (PC) Change versioning scheme to semantic versioning
- (PC) Fix page sync issues when syncing File or Chinese pages with math
+ (PC) Fix mass parse performance issues when generating English Wikipedia
- For more details about this release, please see the blog and the change log.
+ For more details about this release, please see the blog and the change log.
- For more details about the release schedule, please see the release schedule.
-
-
-
+ For more details about the release schedule, please see the release schedule.
New users
@@ -157,7 +154,7 @@
- Feel free to look around during the import process. You can start at Help/Contents. When the process completes, it will open Simple Wikipedia.
+ Feel free to look around during the import process. You can start at Help/Contents. When the process completes, it will open Simple Wikipedia.
@@ -165,16 +162,16 @@
After the setup completes, you can visit these pages:
@@ -189,7 +186,7 @@
After exploring Simple Wikipedia, you may want to import another wiki such as English Wikipedia, French Wiktionary, German Wikisource, Wikidata, Commons, etc.
- To import another wiki, please visit import online.
+ To import another wiki, please visit import online.
- v3.3.4 features an auto-complete address bar. It also has a faster Search system. See App/Search
+ v3.6.3 features a Download page. See Download Central
+
+
+ v3.3.4 features an auto-complete address bar. It also has a faster Search system. See App/Search
@@ -264,13 +264,13 @@
v2.8.1 has a language converter dropdown for the Chinese wikis.
- v2.6.3 uses WebKit for MacOSX. For more info, see Blog
+ v2.6.3 uses WebKit for MacOSX. For more info, see Blog
@@ -280,13 +280,13 @@
- v2.5.4 has changed online file downloads. Among other things, ImageMagick and Inkscape are no longer required. For more info, see Files
+ v2.5.4 has changed online file downloads. Among other things, ImageMagick and Inkscape are no longer required. For more info, see Files
- v2.4.2 has improved Search performance and v2.4.4 has added multi-wiki Search. For more info, see App/Search
+ v2.4.2 has improved Search performance and v2.4.4 has added multi-wiki Search. For more info, see App/Search
- v2.4.1 has introduced major database layout changes. For more info, see Database
+ v2.4.1 has introduced major database layout changes. For more info, see Database
@@ -306,15 +306,15 @@
If the font size is too small, right-click and choose Font Increase
- Find box: Press Ctrl+F on your keyboard. This will show the Find box (in the lower left-hand corner). Type "tips". Notice that the word "Tips" is highlighted above. Note that Alt+P (Previous) and Alt+N (Next) will change search direction. See Find Box for more info.
+ Find box: Press Ctrl+F on your keyboard. This will show the Find box (in the lower left-hand corner). Type "tips". Notice that the word "Tips" is highlighted above. Note that Alt+P (Previous) and Alt+N (Next) will change search direction. See Find Box for more info.
- Address bar: Press Alt+D or Ctrl+L on your keyboard. This will take you to the Address bar at the top of the screen. Type "s.w:Earth" (no quotes) and press Enter. This will open the Simple Wikipedia page for Earth. See Address bar/Shortcuts for more shortcuts.
+ Address bar: Press Alt+D or Ctrl+L on your keyboard. This will take you to the Address bar at the top of the screen. Type "s.w:Earth" (no quotes) and press Enter. This will open the Simple Wikipedia page for Earth. See Address bar/Shortcuts for more shortcuts.
Middle-click in address bar: Copy and paste urls directly into the address bar with the middle mouse button to open the page. For example:
@@ -335,14 +335,14 @@
- Now you can copy and paste any Wikipedia url directly into XOWA and its page will open (and all its images will download.) See Address_bar/URLs for more info
+ Now you can copy and paste any Wikipedia url directly into XOWA and its page will open (and all its images will download.) See Address_bar/URLs for more info
- Middle-click on link: Open a tab in a new link by middle-clicking on it. Try middle-clicking the following: Options
+ Middle-click on link: Open a tab in a new link by middle-clicking on it. Try middle-clicking the following: Options
Right-click: Right click on an image and click save as file
@@ -353,7 +353,7 @@
- Wikidata: If you're seeing {{#property}} in your wikis you should also set up Wikidata. See App/Wiki_types/Wikidata
+ Wikidata: If you're seeing {{#property}} in your wikis you should also set up Wikidata. See App/Wiki_types/Wikidata
Run test pages to make sure that XOWA works on your system.
diff --git a/home/wiki/Options.html b/home/wiki/Options.html
index f951c9db7..f81f60dec 100644
--- a/home/wiki/Options.html
+++ b/home/wiki/Options.html
@@ -5,227 +5,7 @@
Options - XOWA
-
-
-
-
-
-
-
+
@@ -237,366 +17,639 @@ li.active a, li.active a:hover
- An absolute path. Note that you must enter quotes if your path has spaces. For example:
-
-
-
-
- On Linux / Mac OS X: /usr/bin/vlc
-
-
- On Windows: "C:\Program Files\VLC\vlc"
-
-
-
-
- An XOWA relative path. For example:
-
-
-
-
- On Linux / Mac OS X: ~{<>bin_plat_dir<>}vlc/vlc
-
-
- This will expand to /xowa/bin/linux/vlc/vlc
-
-
-
-
- On Windows: ~{<>bin_plat_dir<>}vlc\vlc
-
-
- This will expand to C:\xowa\bin\windows\vlc\vlc
-
-
-
-
- Note that relative paths display their expanded form (/xowa/bin/linux/), not their literal form (~{<>bin_plat_dir<>})
-
-
- i.e.: if you enter ~{<>bin_plat_dir<>} and press save, the text box will show /xowa/bin/linux/, even though the value is saved as ~{<>bin_plat_dir<>}
-
-
-
-
- A binary name, if the binary's directory is defined in your PATH
-
-
-
-
- EX: On a Windows system with a PATH including "C:\Program Files\VLC", a value of vlc is sufficient.
-
-
Note regarding default values:
-
-
- For Linux / Mac OS X systems, the default values may not apply. Please change as necessary on your system
-
-
-
-
- For Windows systems, the default path is defined as cmd and the arg is /c start "~{file}". This attempts to launch the file with the default application defined for the file.
-
-
-
-
- If this does not work properly, please specify the app path
-
- Other content applications take one argument of ~{file} which expands to the local path for the file
-
-
-
-
- EX: The image [[File:A.png]] will produce a ~{file} of /xowa/file/en.wikipedia.org/orig/7/0/1/c/A.png
-
-
-
-
- Customized arguments can be passed depending on the application
-
-
-
-
- EX: VLC takes an argument --no-loop which explicitly instructs VLC not to automatically replay the file. (Clicking on a pronunciation example would cause the short 1 second word to be repeated over and over again).
-
-
- To pass this argument, change the args to --no-loop "~{file}"
-
-
-
-
- ^Launches when clicking on external links . Recommended: Mozilla Firefox
-
-
- ^Launches when clicking on video or audio links . Recommended: VLC
-
-
- ^Launches when clicking on images in Wikimedia Commons . Recommended: GIMP
-
-
- ^Launches when clicking on pdf files . Recommended: Evince
-
-
- ^Launches when clicking on djvu files . Recommended: DjVuLibre
-
-
+
+
+
+
+
+ ImageMagick - Identify
+
+
+
+
+
+
+
+
+
+
+
+
+ Queries image for size (needed for online images; not needed for offline databases) (Recommended: ImageMagick)
+
+
+
+
+
+
+
+
+ ImageMagick - Convert
+
+
+
+
+
+
+
+
+
+
+
+
+ Resizes image (needed for online images; not needed for offline databases) (Recommended: ImageMagick)
+
+
+
+
+
+
+
+
+ Inkscape
+
+
+
+
+
+
+
+
+
+
+
+
+ Converts svg to png (needed for online images; not needed for offline databases) (Recommended: Inkscape)
+
+
+
+
+
+
+
+
+ DjVu converter
+
+
+
+
+
+
+
+
+
+
+
+
+ Converts djvu to png (needed for online images; not needed for offline databases) (Recommended: MikTeX)
+
+
+
diff --git a/home/wiki/Options/Bookmarks.html b/home/wiki/Options/Bookmarks.html
index a4b849167..6175ae279 100644
--- a/home/wiki/Options/Bookmarks.html
+++ b/home/wiki/Options/Bookmarks.html
@@ -262,62 +262,10 @@ li.active a, li.active a:hover
Contents
- ^Enter custom configuration. (default is )
- Note the following:
+
+
+
+
+
+ Window Mode
+
+
+
+
+
+
+
+
+
+
+
+ Choose one of the following:
+
- These scripts will run after the application starts up. They will also run whenever you click Save on this page.
+ previous: window starts at same rect as previous session (default)
- These scripts are intended for advanced users. They are in the format of .gfs statements (for examples, see /xowa/xowa.gfs). Please do not enter scripts unless instructed, or else XOWA may fail to start up.
+ maximized: window always starts maximized
- These scripts are saved to /xowa/user/anonymous/data/cfg/user_custom_cfg.gfs. If XOWA fails to start up, simply delete the file.
+ absolute: window bounds are set to rect below
+
+
+ relative: window starts at full screen, and then adjusted by rect below
+
+
+ default: window starts at default rect (determined by operating system)
-
-
+
+
+
+
+
+
+
+ Window Size
+
+
+
+
+
+
+
+
+
+
+
+ Enter 'x,y,w,h' numbers separated by commas. Note that this setting is used in conjunction with 'Window Mode'
+
+
+
+ absolute: absolute rect of window; EX: 0,0,1280,1024 means x=0 y=0 w=1280 h=1024
+
+
+ relative: relative adjustment to full screen size; EX: 20,20,-20,-20 on an 1280,1024 screen will yield a rect of x=20 y=20 w=1260 h=1004
+
+
+ previous, maximized, default: does nothing
+
+
+
+
+
+
+
+
+
+ Safe Mode
+
+
+
+
+
+
+
+
+
+
+
+ Choose one of the following:
+
+
+
+ checked: prevents window that would be located off screen; EX: x=-9999 or y=9999
+
+
+ unchecked: allows off-screen rect.
+
+
+
+ NOTE: if you create an unviewable rect you will need to edit the options file
+
+
+
+
+ Tabs
+
+
+
+
+
+
+ Startup type
+
+
+
+
+
+
+
+
+
+
+
+ Choose a startup page from one of the following:
+
+
+
+ blank: one tab loads and it is set to blank (Special:XowaDefaultTab)
+
+
+ xowa : one tab loads and it is set to the XOWA home page (home/wiki/Main_Page)
+
+
+ previous: all opened pages from the previous session loads. For example, if "en.w:Earth" and "en.w:Moon" were open when XOWA was last closed, these tabs will be reopened
+
+
+ custom: all pages specified in the custom box will load
+
+
+
+
+
+
+
+
+
+ Custom pages
+
+
+
+
+
+
+
+
+
+
+
+ Specify custom pages to show on startup:
+
+
+
+ This option only applies if custom is selected for type.
+
+
+
+ Also, note the following:
+
+
+
+ Aliases can be used. For example, "en.w:Earth" is a shortcut for "en.wikipedia.org/wiki/Earth"
+
+
+ Multiple pages are separated by new lines. For example, the following will load 2 tabs:
+
+
+
+en.w:Earth
+en.w:Moon
+
+
+
+
+ Advanced
+
+
+
+
+
+
+ Script
+
+
+
+
+
+
+
+
+
+
+
+ Enter custom configuration.
+
+
+
+ These scripts will run after the application starts up. They will also run whenever you click Save on this page.
+
+
+ These scripts are intended for advanced users. They are in the format of .gfs statements (for examples, see /xowa/xowa.gfs). Please do not enter scripts unless instructed, or else XOWA may fail to start up.
+
+
+ These scripts are saved to /xowa/user/anonymous/data/cfg/user_custom_cfg.gfs. If XOWA fails to start up, simply delete the file.
+
- An absolute path. Note that you must enter quotes if your path has spaces. For example:
-
-
-
-
- On Linux / Mac OS X: /usr/bin/vlc
-
-
- On Windows: "C:\Program Files\VLC\vlc"
-
-
-
-
- An XOWA relative path. For example:
-
-
-
-
- On Linux / Mac OS X: ~{<>bin_plat_dir<>}vlc/vlc
-
-
- This will expand to /xowa/bin/linux/vlc/vlc
-
-
-
-
- On Windows: ~{<>bin_plat_dir<>}vlc\vlc
-
-
- This will expand to C:\xowa\bin\windows\vlc\vlc
-
-
-
-
- Note that relative paths display their expanded form (/xowa/bin/linux/), not their literal form (~{<>bin_plat_dir<>})
-
-
- i.e.: if you enter ~{<>bin_plat_dir<>} and press save, the text box will show /xowa/bin/linux/, even though the value is saved as ~{<>bin_plat_dir<>}
-
-
-
-
- A binary name, if the binary's directory is defined in your PATH
-
-
-
-
- EX: On a Windows system with a PATH including "C:\Program Files\VLC", a value of vlc is sufficient.
-
-
Note regarding default values:
-
-
- For Linux / Mac OS X systems, the default values may not apply. Please change as necessary on your system
-
-
-
-
- For Windows systems, the default path is defined as cmd and the arg is /c start "~{file}". This attempts to launch the file with the default application defined for the file.
-
-
-
-
- If this does not work properly, please specify the app path
-
- Other content applications take one argument of ~{file} which expands to the local path for the file
-
-
-
-
- EX: The image [[File:A.png]] will produce a ~{file} of /xowa/file/en.wikipedia.org/orig/7/0/1/c/A.png
-
-
-
-
- Customized arguments can be passed depending on the application
-
-
-
-
- EX: VLC takes an argument --no-loop which explicitly instructs VLC not to automatically replay the file. (Clicking on a pronunciation example would cause the short 1 second word to be repeated over and over again).
-
-
- To pass this argument, change the args to --no-loop "~{file}"
-
-
-
-
- ^Launches when clicking on external links . Recommended: Mozilla Firefox
-
-
- ^Launches when clicking on video or audio links . Recommended: VLC
-
-
- ^Launches when clicking on images in Wikimedia Commons . Recommended: GIMP
-
-
- ^Launches when clicking on pdf files . Recommended: Evince
-
-
- ^Launches when clicking on djvu files . Recommended: DjVuLibre
-
-
+
+
+
+
+
+ ImageMagick - Identify
+
+
+
+
+
+
+
+
+
+
+
+
+ Queries image for size (needed for online images; not needed for offline databases) (Recommended: ImageMagick)
+
+
+
+
+
+
+
+
+ ImageMagick - Convert
+
+
+
+
+
+
+
+
+
+
+
+
+ Resizes image (needed for online images; not needed for offline databases) (Recommended: ImageMagick)
+
+
+
+
+
+
+
+
+ Inkscape
+
+
+
+
+
+
+
+
+
+
+
+
+ Converts svg to png (needed for online images; not needed for offline databases) (Recommended: Inkscape)
+
+
+
+
+
+
+
+
+ DjVu converter
+
+
+
+
+
+
+
+
+
+
+
+
+ Converts djvu to png (needed for online images; not needed for offline databases) (Recommended: MikTeX)
+
- ^Show warnings in info box (default is unchecked)
+
+
+
+
+
+ Show warnings
+
+
+
+
+
+
+
+
+
+
+
+ Show warnings in info box
+
- checked to show warnings in the info box in lower right hand corner
+ checked to show warnings in the info box in lower right hand corner
- unchecked to not show warnings in the info box in lower right hand corner
+ unchecked to not show warnings in the info box in lower right hand corner
-
Warnings are messages which XOWA generates when it encounters situations that are not strictly errors, but appear incorrect. For example, a missing file will generate a warning. Note that if this option is enabled, then the info box must be manually cleared by pressing Ctrl + Alt + C
-
-
- ^Show notes in info box (default is unchecked)
+
+
+ Warnings are messages which XOWA generates when it encounters situations that are not strictly errors, but appear incorrect. For example, a missing file will generate a warning. Note that if this option is enabled, then the info box must be manually cleared by pressing Ctrl + Alt + C
+
+
+
+
+
+
+
+
+ Show notes
+
+
+
+
+
+
+
+
+
+
+
+ Show notes in info box
+
- checked to show notes in the info box in lower right hand corner
+ checked to show notes in the info box in lower right hand corner
- unchecked to not show notes in the info box in lower right hand corner
+ unchecked to not show notes in the info box in lower right hand corner
-
Notes are messages that are informational, but more permanent than status messages. For example, import messages generate notes for each started stage ("deleting directory").
-
-
- ^Log every page visit in a separate log file (default is unchecked)
-
-
- checked: Logs every page visit in a separate log file: C:\xowa\user\anonymous\app\data\history\log_all.csv
-
-
- unchecked Does not log every page visit to a separate log file.
-
-
XOWA currently consolidates visits to the same page as one entry. For example, 3 visits to en.wikipedia.org/wiki/Earth would show up only once with the date being the most recent one. The date for the previous two entries would be lost. This option retains dates for all 3 entries by logging each visit to a separate file.
-
-
+
+
+ Notes are messages that are informational, but more permanent than status messages. For example, import messages generate notes for each started stage ("deleting directory").
+
+
+
+
+ Previous settings
+
+
+
+
+
+
+ Version
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ OS script list
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Recent page
+
+
+
+
+
+
+
+
+
+
+
+ This is a system property. Do not modify.
+
+ Stores most recently viewed page. Used when visiting "Special:XowaCfg" without specifying a grp argument
+
- ^Choose one of the following (default is unchecked)
+
+
+
+
+
+ Retrieval enabled
+
+
+
+
+
+
+
+
+
+
+
+ Choose one of the following:
+
- checked to automatically download images / retrieve images from database
+ checked to automatically download images / retrieve images from database
- ImageMagick and Inkscape must be installed (See Dev/File/Setup)
+ ImageMagick and Inkscape must be installed (See Dev/File/Setup)
- An internet connection must be available, or a local tarball must be set up. (See Archive/Usage/Offline_images)
+ An internet connection must be available, or a local tarball must be set up. (See Archive/Usage/Offline_images)
- unchecked to leave images unprocessed
+ unchecked to leave images unprocessed
-
-
- ^Although files are saved in the bin.sqlite3 database, they are also cached locally at C:\xowa\file. This is done for the following reasons:
+
+
+
+ Cache
+
+
+
+
+
+
+ Minimum disk space used
+
+
+
+
+
+
+
+
+
+
+
+ Enter a minimum size for the cache to use (in MB)
+
+
+ This is an advanced configuration tweak. When the cache reaches its maximum size, it will delete files to free space. It will continue deleting files until the minimum size is reached.
+
+
+ For example:
+
- The HTML browser must display the image: The HTML browser cannot read directly from a sqlite database. The "src" attribute must point to a file resource. (It could take a base64 encoded string, but this has its own complications)
+ If the max is set to 100 MB
- Viewer apps must be able to access the image: Similar to the above, when a file is clicked in the commons wiki, XOWA sends it to an external viewer app. These viewer apps will not be able to access files from the sqlite database or from a base64 encoded string
+ ... and the current size of all files in the cache is 99.9 MB
- Performance: Images will load more quickly if they are already on the file system (as opposed to being continually extracted from the database)
-
-
Some other details worth noting:
-
-
- The cache is stored in C:\xowa\user\user-anonymous.xowa
+ ... and a 200 KB file is added
- This value should not be set any lower than 5 MB (or else all images may not load on a page)
+ Then the cache size will be temporarily 100.1 MB
+
+
+ ... triggering the delete mechanism
+
+
+ ... which will reduce the current size of all files to 75 MB
-
-
- ^Enter a minimum size for the cache to use (in MB) (default is 75) .
- This is an advanced configuration tweak. When the cache reaches its maximum size, it will delete files to free space. It will continue deleting files until the minimum size is reached.
- For example:
-
-
- If the max is set to 100 MB
-
-
- ... and the current size of all files in the cache is 99.9 MB
-
-
- ... and a 200 KB file is added
-
-
- Then the cache size will be temporarily 100.1 MB
-
-
- ... triggering the delete mechanism
-
-
- ... which will reduce the current size of all files to 75 MB
-
-
-
-
- ^Enter a maximum size for the cache to use (in MB) (default is 100) .
-
-
-
- ^Press to reduce the cache to the minimum now (typically 75 MB).
-
- ^Installs the XOWA viewer add-on by running "firefox xowa_viewer.xpi". Note that Firefox should launch after clicking the install link. For more information, see App/Xtn/Browser/XOWA_viewer
-
-
- ^Enter the path where Firefox is installed. (default is firefox) You may need to point this directly to your firefox executable if it doesn't work.
-
- ^Choose one of the following (default is unchecked)
+
+
+
+
+
+ Enabled
+
+
+
+
+
+
+
+
+
+
+
+ Choose one of the following
+
- checked : enables custom HTML page font
+ checked : Enables custom HTML page font
- unchecked : disables custom HTML page font. The HTML page font will be the browser default (Arial 16)
+ unchecked : Disables custom HTML page font. The HTML page font will be the browser default (Arial 16)
- HTML Tidy is a software library whose purpose is to fix invalid HTML. It is enabled on all Wikimedia wikis. Without HTML Tidy, a small percentage of pages will render incorrectly (broken tables; extended bold; horizontal scroll bar; misplaced images), etc. See Diagnostics/HTML_Tidy for examples.
-
+ HTML Tidy is a software library whose purpose is to fix invalid HTML. It is enabled on all Wikimedia wikis. Without HTML Tidy, a small percentage of pages will render incorrectly (broken tables; extended bold; horizontal scroll bar; misplaced images), etc. See Diagnostics/HTML_Tidy for examples.
+
- If you choose to use the tidy binary, please download the appropriate one for your platform from http://tidy.sourceforge.net/
-
-
- If you enable tidy and XOWA shows no HTML, you will need to disable tidy through a text editor: /xowa/user/anonymous/app/data/cfg/xowa_user_cfg.gfs
-
- ^Choose if HTML tidy is enabled (default is checked)
-
-
- ^Choose an HTML tidy engine (default is jtidy)
+
+
+
+
+
+ Enabled
+
+
+
+
+
+
+
+
+
+
+
+ Choose if HTML tidy is enabled
+
+
+
+
+
+
+
+
+ Tidy engine
+
+
+
+
+
+
+
+
+
+
+
+ Choose an HTML tidy engine:
+
- tidy: The same library that is used by WMF wikis. Choose tidy if you want to run the official tidy library that WM uses. Note that you must download the binary if you are on Linux / Mac OS X.
+ tidy: The same library that is used by WMF wikis. Choose tidy if you want to run the official tidy library that WM uses. Note that you must download the binary if you are on Linux / Mac OS X.
- jtidy: A Java implementation of the tidy library. Choose jtidy if you don't want to install a platform specific binary. Note that JTidy is not a 100% implementation of tidy, though it appears to be quite close (at about 95%).
+ jtidy: A Java implementation of the tidy library. Choose jtidy if you don't want to install a platform specific binary. Note that JTidy is not a 100% implementation of tidy, though it appears to be quite close (at about 95%).
- ^XOWA defaults to the following tidy arguments:
+
+
+
+ Tidy binary
+
+
+
+
+
+
+ Process
+
+
+
+
+
+
+
+
+
+
+
+
+ XOWA defaults to the following tidy arguments:
+
--utf8 --force-output y --quiet y --tidy-mark n --doctype '''' --wrap 0 --indent y --quote-nbsp y --literal-attributes y --wrap-attributes n --fix-url n --fix-backslash n --enclose-block-text y -o "~{target}" "~{source}"
-
+-utf8 --force-output y --quiet y --tidy-mark n --doctype '''' --wrap 0 --indent y --quote-nbsp y --literal-attributes y --wrap-attributes n --fix-url n --fix-backslash n --enclose-block-text y -o "~{target}" "~{source}"
- -utf8
+ -utf8
- default is ascii
+ default is ascii
- --force-output y
+ --force-output y
- always generate output; do not fail on error
+ always generate output; do not fail on error
- do not add tidy watermark
+ do not add tidy watermark
- --doctype ''''
+ --doctype ''''
- default is auto (TRANSITIONAL); causes weird quirks with short text lines on some wikis (tr.wikibooks.org)
+ default is auto (TRANSITIONAL); causes weird quirks with short text lines on some wikis (tr.wikibooks.org)
- --wrap 0
+ --wrap 0
- default is 80; do not limit lines to 80 chars
+ default is 80; do not limit lines to 80 chars
- --indent y
+ --indent y
- indent block levels
+ indent block levels
- --quote-nbsp y
+ --quote-nbsp y
- preserve nbsp as entities; do not convert to Unicode character 160
+ preserve nbsp as entities; do not convert to Unicode character 160
- --literal-attributes y
+ --literal-attributes y
- do not alter whitespace chars in attributes
+ do not alter whitespace chars in attributes
- --wrap-attributes n
+ --wrap-attributes n
- do not line-wrap attribute values
+ do not line-wrap attribute values
- --fix-url n
+ --fix-url n
- do not escape invalid chars in uris
+ do not escape invalid chars in uris
- --fix-backslash n
+ --fix-backslash n
- do not change \ to / in URLs
+ do not change \ to / in URLs
- --enclose-block-text y
+ --enclose-block-text y
- always enclose text in element with <p>
+ always enclose text in element with <p>
- ^Choose one of the following: (default is checked)
+
+
+
+
+
+ Prefer HTML Databases for Read tab
+
+
+
+
+
+
+
+
+
+
+
+ Choose one of the following:
+
- checked: (default) Read tab uses HTML databases. Note that this will be faster, but there may be some inaccuracies. (These inaccuracies are being worked on)
+ checked: Read tab uses HTML databases. Note that this will be faster, but there may be some inaccuracies. (These inaccuracies are being worked on)
- unchecked: Read tab uses Wikitext. Note that this will be slower, but more accurate.
+ unchecked: Read tab uses Wikitext. Note that this will be slower, but more accurate.
-
-
- ^Choose one of the following: (default is Shown)
+
+
+
+
+
+
+
+ HTML tab mode
+
+
+
+
+
+
+
+
+
+
+
+ Choose one of the following:
+
- Shown: (default) HTML tab shows actual HTML.
+ Shown: HTML tab shows actual HTML.
- Saved for HTML DB: HTML tab shows HTML as it will be saved for the HTML database. Note that this is for developer purposes only.
+ Saved for HTML DB: HTML tab shows HTML as it will be saved for the HTML database. Note that this is for developer purposes only.
- ^Specify port for HTTP server (default is 8080)
-
-
- ^Specify mode for retrieving files (default is wait)
+
+
+
+
+
+ Port
+
+
+
+
+
+
+
+
+
+
+
+ Specify port for HTTP server
+
+
+
+
+
+
+
+
+ File retrieve mode
+
+
+
+
+
+
+
+
+
+
+
+ Specify mode for retrieving files
+
- wait : Wait for all files to be retrieved before showing page (slow)
+ wait : Wait for all files to be retrieved before showing page (slow)
- skip : Never retrieve files; only files already retrieved will be shown (fast)
+ skip : Never retrieve files; only files already retrieved will be shown (fast)
- async server : Show page immediately, but retrieve files in background. Client will have to manually refresh to show retrieved files (fast)
+ async server : Show page immediately, but retrieve files in background. Client will have to manually refresh to show retrieved files (fast)
- ^Choose one of the following: (default is .gz)
+
+
+
+
+
+ Enter a list of server urls separated by a comma and newline.
+
- text: fastest for reading but has no compression. Simple Wikipedia will be 300 MB
-
-
- gzip: (default) fast for reading and has compression. Simple Wikipedia will be 100 MB
-
-
- bzip2: very slow for reading but has best compression. Simple Wikipedia will be 85 MB (Note: The performance is very noticeable. Please try this with Simple Wikipedia first before using on a large wiki.)
-
-
-
-
- ^Enter a list of server urls separated by a comma and newline.
-
- Note that servers are prioritized from left-to-right. In the default example, your.org will be tried first. If it is offline, then the next server -- dumps.wikimedia.org -- will be tried, etc.
+ Note that servers are prioritized from left-to-right. In the default example, your.org will be tried first. If it is offline, then the next server -- dumps.wikimedia.org -- will be tried, etc.
- ^NOTE 1: this option only applies if the "Custom wiki commands" option is wiki.download,wiki.import (wiki.unzip must be removed)
- Select the method for importing a wiki dump bz2 file. (default is checked)
+
+
+
+
+
+
+
+ Download xowa_common.css
+
+
+
+
+
+
+
+
+
+
+
+ Affects the xowa_common.css file in /xowa/user/anonymous/wiki/wiki_name/html/. Only occurs once when importing a wiki.
+
- checked : import through a native process's stdout. This will be faster, but may not work on all Operating Systems. A 95 MB file takes 85 seconds
+ checked: Downloads xowa_common.css from the Wikimedia servers. Note that this stylesheet will be the latest copy but it may cause unexpected formatting in XOWA.
- unchecked: import though Apache Common's Java bz2 compression library. This will be slower, but will work on all Operating Systems. A 95 MB file takes 215 seconds.
+ unchecked: Copies xowa_common.css from /xowa/bin/any/html/html/import/. Note that this stylesheet is the one XOWA is coded against. It is the most stable, but will not have the latest logo
-
NOTE 2: lbzip2 (Many thanks to Anselm for making this suggestion, as well as compiling the data to support it. See http://sourceforge.net/p/xowa/tickets/263/?limit=10&page=6#f2fb/dcb6) Linux users should consider using lbzip2, as lbzip2 has significant performance differences (30% in many cases).
+
+
+
+
+
+
+
+
+ Unzip bz2 file
+
+
+
+
+
+
+
+
+
+
+
+ Choose one of the following:
+
- install lbzip2
+ checked: the .bz2 file will be unzipped to an .xml file. The import will be faster, but it will use more disk space
+
+
+ unchecked: the .bz2 file will not be unzipped. The import will not be faster, but it will not use more disk space
+
+
+
+ NOTE: When XOWA reads directly from the .bz2 file, the progress percentage will not be accurate. It may hover at 99.99% for several minutes'
+
+
+
+
+
+
+
+
+ Delete XML file after import
+
+
+
+
+
+
+
+
+
+
+
+ (Only relevant if 'Unzip bz2 file' is checked) Choose one of the following:
+
+
+
+ checked: the .xml file is automatically deleted once the import process completes
+
+
+ unchecked: the .xml file is untouched
+
+
+
+
+
+ bzip2 Options
+
+
+
+
+
+
+ Stdout enabled
+
+
+
+
+
+
+
+
+
+
+
+ NOTE: this option only applies if the "Custom wiki commands" option is wiki.download,wiki.import (wiki.unzip must be removed)
+ Select the method for importing a wiki dump bz2 file.
+
+
+
+ checked : import through a native process's stdout. This will be faster, but may not work on all Operating Systems. A 95 MB file takes 85 seconds
+
+
+ unchecked: import though Apache Common's Java bz2 compression library. This will be slower, but will work on all Operating Systems. A 95 MB file takes 215 seconds.
+
+
+
+
+
+
+
+
+
+ Stdout process
+
+
+
+
+
+
+
+
+
+
+
+
+ NOTE: lbzip2 (Many thanks to Anselm for making this suggestion, as well as compiling the data to support it. See http://sourceforge.net/p/xowa/tickets/263/?limit=10&page=6#f2fb/dcb6) Linux users should consider using lbzip2, as lbzip2 has significant performance differences (30% in many cases).
+
- change "Import bz2 by stdout process" to
+ change "Import bz2 by stdout process" to
- lbzip2
+ lbzip2
- -dkc "~{src}"
+ -dkc "~{src}"
-
-
- ^Process used to decompress bz2 by stdout. Recommended: Operating System default
-
-
- ^Select custom commands: (default is wiki.download,wiki.unzip,wiki.import)
- Short version:
+
+
+
+ Apps
+
+
+
+
+
+
+ bz2 app
+
+
+
+
+
+
+
+
+
+
+
+
+ Choose app to decompress bz2 file (Recommended: 7-zip)
+
+
+
+
+
+
+
+
+ gzip app
+
+
+
+
+
+
+
+
+
+
+
+
+ Choose app to decompress gzip file (Recommended: 7-zip)
+
+
+
+
+ Search
+
+
+
+
+
+
+ PageRank iterations
+
+
+
+
+
+
+
+
+
+
+
+ Specify one of the following:
+
- For fast imports, but high disk space usage, use wiki.download,wiki.unzip,wiki.import
+ 0 : (default) page rank is disabled
- For slow imports, but low disk space usage, use wiki.download,wiki.import
-
-
Long version: Enter a list of commands separated by a comma. Valid commands are listed below. Note that simple.wikipedia.org is used for all examples, but the commands apply to any wiki.
-
-
- wiki.download: downloads the wiki data dump from the dump server
+ (number greater than 1): page rank will be calculated until it is finished or maximum number of interations are reached. For more info, see Help/Features/Search/Build
-
-
- A file will be generated in "/xowa/wiki/simple.wikipedia.org/simplewiki-latest-pages-articles.xml.bz2"
-
-
-
-
- wiki.unzip: unzips an xml file from the wiki data dump
-
-
-
-
- A file will be created for "/xowa/wiki/simple.wikipedia.org/simplewiki-latest-pages-articles.xml" (assuming the corresponding .xml.bz2 exists)
-
-
- If this step is omitted, then XOWA will read directly from the .bz2 file. Although this will use less space (no .xml file to unzip), it will be significantly slower. Also, due to a program limitation, the progress percentage will not be accurate. It may hover at 99.99% for several minutes
-
-
-
-
- wiki.import: imports the xml file
-
-
-
-
- A wiki will be imported from "/xowa/wiki/simple.wikipedia.org/simplewiki-latest-pages-articles.xml"
-
- This is the default. Note that this will be the fastest to set up, but will take more space. For example, English Wikipedia will set up in 5 hours and require at least 45 GB of temp space
-
-
-
-
- wiki.download,wiki.import AKA: smallest
-
-
-
-
- This will read directly from the bz2 file. Note that this will use the least disk space, but will take more time. For example, English Wikipedia will set up in 8 hours but will only use 5 GB of temp space
-
-
-
-
- ^Affects the xowa_common.css in /xowa/user/anonymous/wiki/wiki_name/html/. Occurs when importing a wiki. (default is checked)
-
-
- checked : downloads xowa_common.css from the Wikimedia servers. Note that this stylesheet will be the latest copy but it may cause unexpected formatting in XOWA.
-
-
- unchecked: (default) copies xowa_common.css from /xowa/bin/any/html/html/import/. Note that this stylesheet is the one XOWA is coded against. It is the most stable, but will not have the latest logo
-
-
-
-
- ^(Only relevant for wiki.unzip) Choose one of the following: (default is checked)
-
-
- checked : (default) the .xml file is automatically deleted once the import process completes
-
- (number greater than 1): page rank will be calculated until it is finished or maximum number of interations are reached. For more info, see Help/Features/Search/Build
-
-
-
-
- ^ abcEnter a number in MB to represent the cutoff for generating sets of page databases as one file or many files (default is 1500)
- XOWA generates three types of page databases:
-
-
- text: These are Wikitext databases and have entries like ''italics''. They have -text- in their file name.
-
-
- html: These the html-dump databases and have entries like <i>italics</i>. They have -html- in their file name
-
-
- file: These are image databases which have the raw binary images. They have -file- in their file name
-
-
- Different wikis will have different numbers of databases for a given set.
-
-
- For small wikis, XOWA generates one database for the entire wiki. For example, Simple Wikipedia will just have "simple.wikipedia.org-text.xowa". This way is preferred as it is simpler.
-
-
- For large wikis, XOWA generates many databases for the entire wiki. For example, English Wikipedia will have "en.wikipedia.org-text-ns.000.xowa", "en.wikipedia.org-text-ns.000-db.002.xowa", etc. This way is necessary, because some file-systems don't support large databases. For example, creating an "en.wikipedia.org-text.xowa" file will generate a 20 GB file. This 20 GB file will generally fail on flash drives (FAT32), as well as Android (SQLite library allows 2 GB max)
-
-
- These options can force XOWA to generate a wiki using either one database (Simple Wikipedia style) or many databases (English Wikipedia style). It does this by using a cutoff for the XML database dump
- For example, 1500 means that a wiki with a dump file size of 1.5 GB or less will generate a single file. Any wiki with a dump file size larger than 1.5 GB will generate multiple files.
-
-
- If you always want to generate a set with only one file, set the value to a large number like 999,999 (999 GB)
-
-
- If you always want to generate a set with multiple files, set the value to 0.
-
-
- Otherwise, set the value to a cutoff. Wikis below that cutoff will be "single file"; wikis above it will be "multiple files"
-
- ^Choose one of the following: (default is unchecked)
+
+
+
+
+
+ Enabled
+
+
+
+
+
+
+
+
+
+
+
+ Choose one of the following:
+
- checked: import filter system is enabled
+ checked: Import filter system is enabled
- unchecked: (default) import filter system is disabled
+ unchecked: Import filter system is disabled
-
-
- ^Enter the root directory where the filters are located. Note that dansguardian files must be placed within a folder named after wiki. For example, on a Windows system, a phraselist file for simple.wikipedia.org can be placed at C:\xowa\bin\any\xowa\cfg\bldr\filter\simple.wikipedia.org\dansguardian\phraselist1.txt
-
-
- ^Enter the initial score of a page. (default is 0)
+
+
+
+
+
+
+
+ Root directory
+
+
+
+
+
+
+
+
+
+
+
+ Enter the root directory where the filters are located.
+
+
+ Note that dansguardian files must be placed within a folder named after wiki. For example, on a Windows system, a phraselist file for simple.wikipedia.org can be placed at C:\xowa\bin\any\xowa\cfg\bldr\filter\simple.wikipedia.org\dansguardian\phraselist1.txt
+
+
+
+
+
+
+
+
+ Initial page score
+
+
+
+
+
+
+
+
+
+
+
+ Enter the initial score of a page.
+
- For building a wiki where pages matching the filter are removed, choose a score of 0.
+ For building a wiki where pages matching the filter are removed, choose a score of 0.
- For building a wiki where pages matching the filter are kept, choose a positive score like 100.
+ For building a wiki where pages matching the filter are kept, choose a positive score like 100.
-
-
- ^Enter the score which causes the page to be removed from the database. (default is 0)
+
+
+
+
+
+
+
+ Filtered page score
+
+
+
+
+
+
+
+
+
+
+
+ Enter the score which causes the page to be removed from the database.
+
- Any page which has a score higher than the fail score will be removed from the database.
+ Any page which has a score higher than the fail score will be removed from the database.
-
-
- ^Choose if case sensitivity is enabled. (default is unchecked)
+
+
+
+
+
+
+
+ Case sensitive
+
+
+
+
+
+
+
+
+
+
+
+ Choose if case sensitivity is enabled.
+
- If checked, words are matched by case-sensitivity. For example, "< earth >" will match "earth", but not "Earth".
+ If checked, words are matched by case-sensitivity. For example, "< earth >" will match "earth", but not "Earth".
- If unchecked, words are matched regardless of case. For example, "< earth >" will match "earth" and "Earth". Note that this will slow the import process down by 5% - 10%
+ If unchecked, words are matched regardless of case. For example, "< earth >" will match "earth" and "Earth". Note that this will slow the import process down by 5% - 10%
-
-
- ^Choose if a log is enabled. (default is checked)
+
+
+
+
+
+
+
+ Log enabled
+
+
+
+
+
+
+
+
+
+
+
+ Choose if a log is enabled.
+
- If checked, a database called dansguardian_log.sqlite3 will be created at /xowa/wiki/wiki_name/
+ If checked, a database called dansguardian_log.sqlite3 will be created at /xowa/wiki/wiki_name/
- If unchecked, no database will be created
+ If unchecked, no database will be created
- Tooltip captions; EX: Go back one page, Go foward one page, Go to the address in the location bar, etc..
+ Tooltip captions; EX: Go back one page, Go foward one page, Go to the address in the location bar, etc..
- XOWA sidebar; EX: Main page, About, etc..
+ XOWA sidebar; EX: Main page, About, etc..
- XOWA messages: "version" and "build time"
+ XOWA messages: "version" and "build time"
- Note that HTML tab text (Page, Read, Edit, View HTML, Search) uses the language of the underlying wiki.
+ Note that HTML tab text (Page, Read, Edit, View HTML, Search) uses the language of the underlying wiki.
- Translations are only available for English, German, Polish and Chinese. If you can provide translations in your language, please visit XOWA's wiki
+ Translations are only available for English, German, Polish and Chinese. If you can provide translations in your language, please contact me via Help/Feedback
- The home wiki documentation is still changing, so translations will not be available for some time (at least until v2.0+)
+ The home wiki documentation is still changing, so translations will not be available for some time
-
-
+
+
+
+
+
+
+
+ Font name
+
+
+
+
+
+
+
+
+
+
+
+ Enter a font name:
+
+
+
+ The font name must be installed on your machine, such as "Arial", "Courier New", "Liberation Sans"
+
+
+ The font name applies to the Address Bar, Tab Buttons, Search Bar, Find Box, and Progress Text messages
+
- ^Choose one of the following (default is checked)
+
+
+
+
+
+ Enabled
+
+
+
+
+
+
+
+
+
+
+
+ Choose one of the following:
+
- checked to transform <math> sections to images
+ checked to transform <math> sections to images
- unchecked to leave <math> sections as text
+ unchecked to leave <math> sections as text
-
-
- ^Choose one of the following (default is MathJax)
+
+
+
+
+
+
+
+ Renderer
+
+
+
+
+
+
+
+
+
+
+
+ Choose one of the following:
+
- MathJax: use MathJax for <math>. Note that this is faster, does not use any disk space, and requires no additional setup
+ MathJax: use MathJax for <math>. Note that this is faster, does not use any disk space, and requires no additional setup
- LaTeX: use LaTEX for <math>. Note that LaTEX is slower and will use extra disk space. It must also be installed. See App/Xtn/Mediawiki/Math/Setup
+ LaTeX: use LaTEX for <math>. Note that LaTEX is slower and will use extra disk space. It must also be installed. See App/Xtn/Mediawiki/Math/Setup
-
-
- ^Converts dvi to png (needed for LaTEX; not needed for MathJax) . Recommended: MikTeX
-
-
+
+
+
+ LaTeX
+
+
+
+
+
+
+ Tex to dvi
+
+
+
+
+
+
+
+
+
+
+
+
+ Converts tex to dvi (needed for LaTEX; not needed for MathJax) (Recommended: MikTeX)
+
+
+
+
+
+
+
+
+ Dvi to png
+
+
+
+
+
+
+
+
+
+
+
+
+ Converts dvi to png (needed for LaTEX; not needed for MathJax) (Recommended: MikTeX)
+
+ checked: Automatically synchronize page when viewing it
+
+
+ unchecked: (default) Do not automatically synchronize page
+
+
+
+ Other notes:
+
+
+
+ Pages are automatically synchronized based on options for time and scope. The default behavior is to synchronize when first visiting the page, and then every 24 hours afterwards
+
+
+ Automatic synchronization will never occur in the home wiki
+
+
+
+
+
+
+
+
+
+ Time to wait before syncs
+
+
+
+
+
+
+
+
+
+
+
+ Enter the number of minutes to wait before checking for a new update:
+
+
+
+
+
+
+
+
+ Pages to sync
+
+
+
+
+
+
*
-
-
-
-
-
-
-
- Notes
-
-
-
- ^Choose one of the following: (default is unchecked)
+
+
+
+
+
+ Specify specific page titles to sync:
+
- checked: Show "Sync" in sidebar
+ *:Main_Page: means sync all Main_Pages in all wikis
- unchecked: (default) Do not show "Sync" in sidebar
-
-
Other notes:
-
-
- Clicking "Sync" will manually synchronize current page
+ *: is a wildcard and means sync all pages in all wikis
- "Sync" will never show in the home wiki
+ Individual pages can be specified on each line.
-
-
- ^Choose one of the following: (default is unchecked)
-
-
- checked: Automatically synchronize page when viewing it
-
-
- unchecked: (default) Do not automatically synchronize page
-
-
Other notes:
-
-
- Pages are automatically synchronized based on options for time and scope. The default behavior is to synchronize when first visiting the page, and then every 24 hours afterwards
-
-
- Automatic synchronization will never occur in the home wiki
-
-
-
-
- ^Enter the number of minutes to wait before checking for a new update: (default is 1440) [4]
-
-
- ^Specify specific page titles to sync: (default is Main_Page)
-
-
- *:Main_Page: means sync all Main_Pages in all wikis
-
-
- *: is a wildcard and means sync all pages in all wikis
-
-
- Individual pages can be specified on each line.
-
-
For example, the following would only auto-synchronize two pages: the Main_Page and Earth in English Wikipedia:
+
+ For example, the following would only auto-synchronize two pages: the Main_Page and Earth in English Wikipedia:
+
-en.w:Main_Page
+en.w:Main_Page
en.w:Earth
-
- Note that all lines must be separated by a UNIX line ending (ASCII 10) not a Windows line ending (ASCII 13 + ASCII 10)
-
-
+
+ Note that all lines must be separated by a UNIX line ending (ASCII 10) not a Windows line ending (ASCII 13 + ASCII 10)
+
+ Note that changes will apply automatically to new tabs and new pages. However, any currently loaded pages must be reloaded to pick up the new changes.
-
- This page provides options for Popups. Note that configuration changes will apply automatically to new tabs and new pages. However, any currently loaded pages must be reloaded to pick up the new configuration change.
-
-
- You can also test your configuration changes by hovering over this link: XOWA Main Page.
-
+ Automatically show the entire article if article is less than these number of bytes
+ This feature is intended for small articles whose entire text...
+
+
+
+ Will always be parsed quickly
+
+
+ Will generally show in one window without a horizontal scroll bar.
+
+
+
+ It allows a complete preview of small articles without having to click "more" or "all"
+ To deactivate this feature, set the number to -1
+
+
+
+
+
+
+
+
+ Read forward til header
+
+
+
+
+
+
+
+
+
+
+
+ Number of extra words to read forward to look for a header
+ This option tries to stop the popup text right before a header.
+
+
+
+ the advantage is that the popup will not stop a few words short of the header
+
+
+ the disadvantage is that the size of the popup is irregular. i.e.: sometimes it returns 128 words, sometimes 140, sometimes 150, etc
+
+
+
+ To deactivate this option, set it to -1.
+ Technical details follow.
+
+
+
+ The approach works in the following manner:
+
+
+
+ Reads forward an additional # of words
+
+
+ If a header is found within the # of words, it extends the popup text to the last word before the header
+
+
+ If a header is not found, it returns the original # of words
+
+ The initial number of words is read and collects 5 words: 01 02 03 04 05
+
+
+ The parser then reads forward 4 more words: 06 07 ==08== 09
+
+
+ It finds a header at ==08==
+
+
+ It then extends the selction to the word just before the header: 01 02 03 04 05 06 07
+
+
+ Note that if ==08== was just 08, then it would just have returned the original: 01 02 03 04 05
+
+
+
+
+
+
+
+
+
+ Read backward til header
+
+
+
+
+
+
+
+
+
+
+
+ Number of words to read backward to remove header at end
+ This option tries to stop a header from appearing at the end of the popup text.
+
+
+
+ the advantage is that a popup will not end at a header with just a few words after it.
+
+
+ the disadvantage is that sometimes the number of words returned will be less originally requested. i.e.: 128 was requested, but only 112 is returned
+
+
+
+ To deactivate this option, set it to -1
+ Technical details follow.
+
+
+
+ The approach works in the following manner:
+
+
+
+ Reads backwards a # of words from the end of the popup
+
+
+ If a header is found within the # of words, it truncates the output to the text before the header
+
+
+ If a header is not found, it returns the original # of words
+
+ The initial number of words is read and collects 9 words: 01 02 03 04 05 06 07 ==08== 09
+
+
+ The parser then reads backwards 4 words: 06 07 ==08== 09
+
+
+ It finds a header at ==08==
+
+
+ It then truncates the popup to the word just before the header: 01 02 03 04 05 06 07
+
+
+ Note that if ==08== was just 08, then it would just have returned the original: 01 02 03 04 05 06 07 08 09
+
+
+
+
+
+
+
+
+
+ Stop if header is found after
+
+
+
+
+
+
+
+
+
+
+
+ Stops reading if a header is found after # of words
+ This option will stop reading if a header is found after the # of words. It is useful for increasing the probability that a popup will end at a header.
+
+
+
+ the advantage is that a popup can be made to stop at a header. If you never want the popup to show a header, set the value to 1.
+
+
+ the disadvantage is that sometimes the number of words returned will be less originally requested. i.e.: 128 was requested, but only 96 is returned
+
+
+
+ To deactivate this option, set it to -1. This will always show as much content as possible
+ Technical details follow.
+
+ Maximum length of template token (in bytes) to evaluate
+ This option allows faster popups, but at the cost of accuracy:
+
+
+
+ Fast but sometimes inaccurate: For slow machines or wikis that use templates heavily, decrease the number. Note that setting the number to 0 means "never evaluate templates". If popups are slow, try setting the number to 0, and see if the results are satisfactory.
+
+
+ Slow but always accurate: For fast machines or wikis that do not use templates heavily, increase the number. Note that setting the number to 2,147,483,647 means "always evaluate templates". You can also use "-1" as a shortcut for "2,147,483,647". If popups have garbled text or are missing words, try setting the number to -1.
+
+
+
+ A more detailed explanation follows:
+
+
+ Templates are wikitext of the form {{Name|Arg_1|Arg_2|...}}. They are used throughout a wiki to perform functions ranging from unit conversion (like converting kilometers to miles), or generating large pieces of HTML (like rendering entire InfoBoxes). However, these templates are the "slowest" pieces of wikitext to parse, particularly if they call other templates or Scribunto
+
+
+ Ideally, popups should skip templates that produce structural html (like infoboxes), while still trying to render templates that do smaller functions (like converting units). This option attempts a heuristic that says "if the template is long, assume it's an infobox and should be skipped". It counts the total number of bytes in a template, and skips it if it's greater than the max. For example, {{Name|Arg_1}} has a length of 10, and will be skipped if the max length is set to 8. If the max length is set to 16, then the template won't be skipped.
+
+
+ This option is imperfect, but should work well enough on most cases. Note that Navigation Popups does something similar by skipping template text, but without any configuration. (always set to 0).
+
- ^Controls popup functionality (default is checked)
+
+
+
+
+
+ Specifies templates to be shown in popup
+ This is a performance optimization for English Wikipedia. It only evaluates listed templates.
+ The format is as follows
+
- checked to show popups when hovering over links
+ Each rule is in a separate line
- unchecked to not show popups when hovering over links
-
-
-
-
- ^Number of words to show in popup (default is 128)
-
-
-
- For slower machines, decrease the number of words to 32. Note that the number must be greater than 0.
-
-
- For faster machines, increase the number of words as per your liking.
-
-
-
-
- ^Number of additional words to show when "show more" is clicked (default is 192)
-
-
-
- For slower machines, decrease the number of words to 32. Note that the number must be greater than 0.
-
-
- For faster machines, increase the number of words as per your liking.
-
-
-
-
- ^Automatically show the entire article if article is less than these number of bytes (default is -1) (recommended is 4096)
- This feature is intended for small articles whose entire text...
-
-
- Will always be parsed quickly
-
-
- Will generally show in one window without a horizontal scroll bar.
-
-
It allows a complete preview of small articles without having to click "more" or "all"
- To deactivate this feature, set the number to -1
-
-
- ^Number of extra words to read forward to look for a header (default is 32)
- This option tries to stop the popup text right before a header.
-
-
- the advantage is that the popup will not stop a few words short of the header
-
-
- the disadvantage is that the size of the popup is irregular. i.e.: sometimes it returns 128 words, sometimes 140, sometimes 150, etc
-
-
-
To deactivate this option, set it to -1.
- Technical details follow.
-
- The approach works in the following manner:
-
-
- Reads forward an additional # of words
-
-
- If a header is found within the # of words, it extends the popup text to the last word before the header
-
-
- If a header is not found, it returns the original # of words
-
- The initial number of words is read and collects 5 words: 01 02 03 04 05
-
-
- The parser then reads forward 4 more words: 06 07 ==08== 09
-
-
- It finds a header at ==08==
-
-
- It then extends the selction to the word just before the header: 01 02 03 04 05 06 07
-
-
- Note that if ==08== was just 08, then it would just have returned the original: 01 02 03 04 05
-
-
-
-
- ^Number of words to read backward to remove header at end (default is 16)
- This option tries to stop a header from appearing at the end of the popup text.
-
-
- the advantage is that a popup will not end at a header with just a few words after it.
-
-
- the disadvantage is that sometimes the number of words returned will be less originally requested. i.e.: 128 was requested, but only 112 is returned
-
-
To deactivate this option, set it to -1
- Technical details follow.
-
- The approach works in the following manner:
-
-
- Reads backwards a # of words from the end of the popup
-
-
- If a header is found within the # of words, it truncates the output to the text before the header
-
-
- If a header is not found, it returns the original # of words
-
- The initial number of words is read and collects 9 words: 01 02 03 04 05 06 07 ==08== 09
-
-
- The parser then reads backwards 4 words: 06 07 ==08== 09
-
-
- It finds a header at ==08==
-
-
- It then truncates the popup to the word just before the header: 01 02 03 04 05 06 07
-
-
- Note that if ==08== was just 08, then it would just have returned the original: 01 02 03 04 05 06 07 08 09
-
-
-
-
- ^Stops reading if a header is found after # of words (default is 96)
- This option will stop reading if a header is found after the # of words. It is useful for increasing the probability that a popup will end at a header.
-
-
- the advantage is that a popup can be made to stop at a header. If you never want the popup to show a header, set the value to 1.
-
-
- the disadvantage is that sometimes the number of words returned will be less originally requested. i.e.: 128 was requested, but only 96 is returned
-
-
To deactivate this option, set it to -1. This will always show as much content as possible
- Technical details follow.
-
- The following is a simplified example:
-
- Once it finds a header, it checks if it is greater than stop-hdr
+ Each rule has three parts
- ==06== is found, but it is less than 8. The parser continues.
+ Wiki domain: Wiki which will be affected by rule
- ==10== is found, and it is greater than 8. The parser stops there and returns 01 02 03 04 05 ==06== 07 08 09
-
-
-
-
Note the following variations:
-
-
- If stop-hdr was set to 1, then it would have stopped at ==06== and returned 01 02 03 04 05
-
-
- If stop-hdr was set to 14, then it would have returned the entire text: 01 02 03 04 05 ==06== 07 08 09 ==10== 11 12 13 14 15 16
-
-
Note that the the read-bwd setting is still applied after the stop-hdr setting.
-
-
- ^Number of milliseconds to wait before showing popup (default is 600)
-
-
-
- A higher number prevents accidental hovers over links while moving the mouse / scrolling the page
-
-
- A lower number allows faster popup display
-
-
Note that popup data will only be retrieved after the popup starts showing. For example:
-
-
- If the show delay is set to 2 seconds
-
-
- and a popup takes 1 second to retrieve the html
-
-
- then the total time till the popup is visible is 3 seconds, not 2 (2 seconds to wait before showing + 1 second to retrieve data)
-
-
-
-
- ^Number of milliseconds to wait before hiding popup (default is 600)
-
-
-
- A higher number allows the popup to linger longer on the screen before disappearing.
-
-
- A lower number hides the popup faster
-
-
-
-
- ^Maximum width of popup in pixels (default is -1)
-
-
-
- -1 indicates no maximum width
-
-
-
-
- ^Maximum height of popup in pixels (default is -1)
-
-
-
- -1 indicates no maximum height
-
-
-
-
- ^Maximum width of popup in pixels when show all is clicked (default is -1) (recommended is 800)
- This option was added because:
-
-
- The normal popup window is generally smaller (500 pixels)
-
-
- Show all often returns a lot of article text which looks constrained within a 500 pixel window
-
-
- A "Show all" maxiumum width allows for automatic switching to a wider window for the larger article content
-
-
Note that -1 indicates no maximum width, which defaults to about 500 pixels
-
-
- ^Shows popup when link receives focus (tabbed into) (default is false)
- This option allows keyboard users to use popups whenever a link is focused. Specifically:
-
-
- A link can be focused by pressing tab on the keyboard until a dotted focus box surrounds the desired link.
-
-
- A link can be focused by finding and then selecting:
-
-
- Find a word on the page. For example, press Ctrl + F and type "r i b". This will highlight the Scribunto link
-
-
- Press Ctrl + G and then Ctrl + G again. This will focus the Scribunto link and show the popup for it.
-
-
-
-
-
-
- ^Maximum length of template token (in bytes) to evaluate (default is 8192)
- This option allows faster popups, but at the cost of accuracy:
-
-
- Fast but sometimes inaccurate: For slow machines or wikis that use templates heavily, decrease the number. Note that setting the number to 0 means "never evaluate templates". If popups are slow, try setting the number to 0, and see if the results are satisfactory.
-
-
- Slow but always accurate: For fast machines or wikis that do not use templates heavily, increase the number. Note that setting the number to 2,147,483,647 means "always evaluate templates". You can also use "-1" as a shortcut for "2,147,483,647". If popups have garbled text or are missing words, try setting the number to -1.
-
-
-
- A more detailed explanation follows:
-
-
-
- Templates are wikitext of the form {{Name|Arg_1|Arg_2|...}}. They are used throughout a wiki to perform functions ranging from unit conversion (like converting kilometers to miles), or generating large pieces of HTML (like rendering entire InfoBoxes). However, these templates are the "slowest" pieces of wikitext to parse, particularly if they call other templates or Scribunto
-
-
- Ideally, popups should skip templates that produce structural html (like infoboxes), while still trying to render templates that do smaller functions (like converting units). This option attempts a heuristic that says "if the template is long, assume it's an infobox and should be skipped". It counts the total number of bytes in a template, and skips it if it's greater than the max. For example, {{Name|Arg_1}} has a length of 10, and will be skipped if the max length is set to 8. If the max length is set to 16, then the template won't be skipped.
-
-
- This option is imperfect, but should work well enough on most cases. Note that Navigation Popups does something similar by skipping template text, but without any configuration. (always set to 0).
-
-
-
- ^Specifies templates to be shown in popup (default is see below)
- This is a performance optimization for English Wikipedia. It only evaluates listed templates.
- The format is as follows
-
-
- Each rule is in a separate line
-
-
- Each rule has three parts
-
-
- Wiki domain: Wiki which will be affected by rule
-
-
- Keep-names: Names of templates which will be shown in popup. Note that these names:
+ Keep-names: Names of templates which will be shown in popup. Note that these names:
- Are semi-colon separated (;)
+ Are semi-colon separated (;)
- Match any case of the title. For example, "NAme", matches "NAME", "name", "naME", etc.
+ Match any case of the title. For example, "NAme", matches "NAME", "name", "naME", etc.
- Match space or underscore. For example, "two_words" matches "two_words" and "two words"
+ Match space or underscore. For example, "two_words" matches "two_words" and "two words"
- Have one of the following three match patterns
+ Have one of the following three match patterns
- Exact name: For example, "name" matches only "name", and all lowercase/uppercase variants
+ Exact name: For example, "name" matches only "name", and all lowercase/uppercase variants
- Name at start: For example, "name*" will match anything starting with "name" such as "Names"
+ Name at start: For example, "name*" will match anything starting with "name" such as "Names"
- Name at end: For example, "*name" will match anything ending with "name" such as "Fullname"
+ Name at end: For example, "*name" will match anything ending with "name" such as "Fullname"
- Unless-names: Names of templates which should not be included, even if the keep-name is matched. For example, en.wikipedia.org|name*|name_to_always_skip will match any template that starts with "name" unless the template is named "name_to_always_skip". Note that unless-names have the same rules as keep-names (semi-colon separator; wildcards)
-
+ Unless-names: Names of templates which should not be included, even if the keep-name is matched. For example, en.wikipedia.org|name*|name_to_always_skip will match any template that starts with "name" unless the template is named "name_to_always_skip". Note that unless-names have the same rules as keep-names (semi-colon separator; wildcards)
-
To disable this option, replaces the keep-names with a *. For example: en.wikipedia.org|*|
+
+
+ To disable this option, replaces the keep-names with a *. For example: en.wikipedia.org|*|
+
- ^Restrict popups to certain namespaces (default is )
- This option allows popups to be suppressed for namespaces that would ordinarily generate no content. For example, Portal pages are often contained in a table / div, whereas Module pages are code.
- Note the following:
+
+
+
+ Advanced
+
+
+
+
+
+
+ Allowed namespaces
+
+
+
+
+
+
+
+
+
+
+
+ Restrict popups to certain namespaces
+ This option allows popups to be suppressed for namespaces that would ordinarily generate no content. For example, Portal pages are often contained in a table / div, whereas Module pages are code.
+ Note the following:
+
- Only namespace names are valid. See the table below for examples of valid names
+ Only namespace names are valid. See the table below for examples of valid names
- Multiple names must be separated with the pipe character (|). For example, (Main)|Help
+ Multiple names must be separated with the pipe character (|). For example, (Main)|Help
- Namespaces names are the canonical English names of the namespace, except for "(Main)"
+ Namespaces names are the canonical English names of the namespace, except for "(Main)"
- Non-English names will work, but are not supported. For example, Aide would only allow the Help namespace in French wikis, wheras Help will allow the Help namespace across all wikis.
+ Non-English names will work, but are not supported. For example, Aide would only allow the Help namespace in French wikis, wheras Help will allow the Help namespace across all wikis.
- Invalid names are ignored
+ Invalid names are ignored
- Deactivate this feature by blanking the field
+ Deactivate this feature by blanking the field
- ^Ignore html elements that have the following ids (default is coordinates)
- This feature is intended for English Wikipedia which has a {{Coordinates}} tag at the top of most geographical articles (for example, North Pole)
- Without this option, a Coordinates span would be visible in the top right of the popup, which....
-
-
- Counts against the popup's number of words
-
-
- Does not provide significant summary information for the article
-
-
Usage notes:
-
-
- Any HTML element with a listed id will not be shown in the popup. For example, <span id='coordinates'>0 N 90 E</span> will not show b/c the html element (span) has a listed id (coordinates)
-
-
- To add multiple ids, separate ids with the | character. For example, coordinates|some_other_id.
-
-
- Listed ids are case-insensitive if ASCII, but case-sensitive otherwise. There is no difference between coordinates and Coordinates. There is a difference between é and É
-
-
- To deactivate this feature, set the value to (empty)
-
-
-
-
-
- ^Number of bytes to read for each pass (default is 1024)
- This number represents the number of bytes the popup parser reads at a time. For example, it will read the first 1024 bytes of the article, and if it doesn't find 64 words, it continues to read sections of 1024 bytes until it does.
-
-
-
- Lower numbers may be better for slower machines. Note that the number must be greater than 0.
-
-
- Higher numbers may be better for faster machines. Experiment as necessary.
-
-
-
-
- ^Maximum number of bytes to read (default is 32768)
-
+
+
+
+
+
+
+
+ Ignore HTML elements with the following ids
+
+
+
+
+
+
+
+
+
+
- This number represents the maximum number of bytes the popup parser reads before it gives up. Note that if the parser gives up, then no text will be returned for the preview.
-
-
- This setting should only apply to badly formatted articles. For example consider a page that has a comment with 100,000 5 letter words (<!-- 100,000 5 letter words -->). This page will be considered to have 0 words, even though it has a page length of 500,000. Rather than read the entire 500,000 bytes, the popup parser will stop after 32,768.
+ Ignore html elements that have the following ids
+ This feature is intended for English Wikipedia which has a {{Coordinates}} tag at the top of most geographical articles (for example, North Pole)
+ Without this option, a Coordinates span would be visible in the top right of the popup, which....
- Lower numbers may be better for slower machines, but it would have a higher chance of returning empty popups. Note that the number must be greater than 0.
+ Counts against the popup's number of words
- Higher numbers may be better for faster machines. To force the popup parser to read the entire page until it finds the minimum number of words, set the value to a high number like 2,147,483,647
+ Does not provide significant summary information for the article
-
-
- ^Set the HTML format of the popup window. (default is See HTML format default )
- This controls the actual HTML that is generated in the popup window. Note the following:
+
+ Usage notes:
+
- The format is basically text substitution, with anything between ~{ and } substituted for the current page values.
+ Any HTML element with a listed id will not be shown in the popup. For example, <span id='coordinates'>0 N 90 E</span> will not show b/c the html element (span) has a listed id (coordinates)
- This is only provided for experimental / testing purposes. The format may change in future versions.
+ To add multiple ids, separate ids with the | character. For example, coordinates|some_other_id.
- To modify this value do the following:
-
-
- Backup your xowa_user_cfg.gfs: /xowa/user/anonymous/app/data/cfg/xowa_user_cfg.gfs
-
-
- Edit this page
-
-
- Find the commented table rows / cells and uncomment them
-
-
- Save the page. You will now see an editable textarea with the format
-
-
- Make any changes to the editable textarea and click Save. Hover over a link to view the results.
-
-
+ Listed ids are case-insensitive if ASCII, but case-sensitive otherwise. There is no difference between coordinates and Coordinates. There is a difference between é and É
-
- When you're done, you should restore your original copy of xowa_user_cfg.gfs. If you don't restore your copy, you will end up keeping your custom change, and will never pick up any future fixes / changes to the format.
-
-
+
+ To deactivate this feature, set the value to (empty)
+
+
+
+
+
+
+
+
+
+ Number of bytes to read each pass
+
+
+
+
+
+
+
+
+
+
+
+ Number of bytes to read for each pass
+ This number represents the number of bytes the popup parser reads at a time. For example, it will read the first 1024 bytes of the article, and if it doesn't find 64 words, it continues to read sections of 1024 bytes until it does.
+
+
+
+ Lower numbers may be better for slower machines. Note that the number must be greater than 0.
+
+
+ Higher numbers may be better for faster machines. Experiment as necessary.
+
+
+
+
+
+
+
+
+
+ Maximum number of bytes to read
+
+
+
+
+
+
+
+
+
+
+
+ Maximum number of bytes to read
+
+
+ This number represents the maximum number of bytes the popup parser reads before it gives up. Note that if the parser gives up, then no text will be returned for the preview.
+
+
+ This setting should only apply to badly formatted articles. For example consider a page that has a comment with 100,000 5 letter words (<!-- 100,000 5 letter words -->). This page will be considered to have 0 words, even though it has a page length of 500,000. Rather than read the entire 500,000 bytes, the popup parser will stop after 32,768.
+
+
+
+ Lower numbers may be better for slower machines, but it would have a higher chance of returning empty popups. Note that the number must be greater than 0.
+
+
+ Higher numbers may be better for faster machines. To force the popup parser to read the entire page until it finds the minimum number of words, set the value to a high number like 2,147,483,647
+
- checked to process through lilypond binary (lilypond must be installed and its path must be set: Options/Apps
+ checked to process through lilypond binary (lilypond must be installed and its path must be set: Options/Apps
- unchecked to render text only
+ unchecked to render text only
-
-
- ^Converts Lilypond to music scores / midi files . Recommended: Lilypond
-
-
- ^Converts ABC notation to Lilypond . Recommended: Lilypond
-
- luaj: lua code will be processed through the luaj jar at /bin/any/java/luaj/.
+ luaj: lua code will be processed through the luaj jar at /bin/any/java/luaj/.
- lua : lua code will be processed through the lua binary at /bin/os_name/lua/.
+ lua : lua code will be processed through the lua binary at /bin/os_name/lua/.
-
Note for Lua engine users:
+
+
+ Note for Lua engine users:
+
- executable permissions: Linux / Mac OS X users may need to grant execute permission to the Lua binary. To ensure proper setup, please do the following:
+ executable permissions: Linux / Mac OS X users may need to grant execute permission to the Lua binary. To ensure proper setup, please do the following:
- NTFS partitions: Linux users with NTFS partitions will need to run a command like the following:
+ NTFS partitions: Linux users with NTFS partitions will need to run a command like the following:
- sudo mount -t ntfs -o rw,auto,user,fmask=0022,dmask=0000 /dev/whatever /mnt/whatever
+ sudo mount -t ntfs -o rw,auto,user,fmask=0022,dmask=0000 /dev/whatever /mnt/whatever
- ^Path to Lua binary. Only applies to the luaengine.
-
-
- ^Choose one of the following (default is unchecked)
-
-
- checked to output Lua send / recv statements to a log file (/xowa/user/anonymous/app/tmp/log)
-
-
- unchecked to output nothing
-
-
-
-
- ^# of milliseconds before canceling Lua call (default is 4000)
-
-
- ^# of milliseconds before checking for timeout. (default is 1) For example, with a timeout of 4000:
+
+
+
+ Lua options
+
+
+
+
+
+
+ Lua path
+
+
+
+
+
+
+
+
+
+
+
+
+ Path to Lua binary. Only applies to the luaengine.
+
+
+
+
+
+
+
+
+ Lua timeout
+
+
+
+
+
+
+
+
+
+
+
+ # of milliseconds before canceling Lua call
+
+
+
+
+
+
+
+
+ Lua timeout polling
+
+
+
+
+
+
+
+
+
+
+
+ # of milliseconds before checking for timeout. For example, with a timeout of 4000:
+
- A timeout polling of 1 will check roughly 4000 times before timing out.
+ A timeout polling of 1 will check roughly 4000 times before timing out.
- A timeout polling of 1000 will check roughly 4 times before timing out.
+ A timeout polling of 1000 will check roughly 4 times before timing out.
-
This setting should be left at 1. It is meant to "tweak" certain outlier situations should they arise.
-
-
- ^# of milliseconds before entering timeout poll (default is 250) This setting should be left at 250 (or higher). It is also meant to "tweak" certain outlier situations.
- Background:
+
+
+ This setting should be left at 1. It is meant to "tweak" certain outlier situations should they arise.
+
+
+
+
+
+
+
+
+ Lua timeout busy wait
+
+
+
+
+
+
+
+
+
+
+
+ # of milliseconds before entering timeout poll This setting should be left at 250 (or higher). It is also meant to "tweak" certain outlier situations.
+ Background:
+
- On Windows, a sleep call can take 15 ms. This could potentially cause each Lua call to take 15 ms.
+ On Windows, a sleep call can take 15 ms. This could potentially cause each Lua call to take 15 ms.
- The busy wait is a primitive way to limit a wait to 1 ms (or less) before entering a more expensive sleep
+ The busy wait is a primitive way to limit a wait to 1 ms (or less) before entering a more expensive sleep
- A higher timeout busy wait value is more performant, but the disadvantage is that the UI will be locked up for longer
+ A higher timeout busy wait value is more performant, but the disadvantage is that the UI will be locked up for longer
- For example, a busy wait of 250 means that the code will loop for 250 milliseconds before entering a sleep.
+ For example, a busy wait of 250 means that the code will loop for 250 milliseconds before entering a sleep.
- For sub-second values, this freezing will be unnoticeable
+ For sub-second values, this freezing will be unnoticeable
- ^Choose one of the following: (default is checked)
+
+
+
+
+
+ Enabled
+
+
+
+
+
+
+
+
+
+
+
+ Choose one of the following:
+
- checked: Enable scripting for a wiki. Script files are placed in /wiki/wiki_name/bin/any/script/
+ checked: Enable scripting for a wiki. Script files are placed in /wiki/wiki_name/bin/any/script/
- unchecked: (default) Disable scripting for a wiki
+ unchecked: Disable scripting for a wiki
- This page provides options for Search. Note that configuration changes will apply automatically to new searches. However, any currently loaded searches must be reloaded to pick up the new configuration change.
-
- ^Enter number of results to show per page: (default is 20) .
-
-
- ^Choose one of the following: (default is checked) .
- checked: XOWA continues while database searches are done in the background. These searches return results faster, especially for big queries.
+ checked: Search suggest enabled (typing in search box will dynamically retrieve suggestions)
- unchecked: XOWA waits until the database search completes. This will often be slower, but will be more stable than background searches.
+ unchecked: Search suggest disabled
-
-
- ^Choose one of the following: (default is checked)
+
+
+
+
+
+
+
+ Max results
+
+
+
+
+
+
+
+
+
+
+
+ Maximum number of search suggestions
+
+
+
+
+ Special:Search
+
+
+
+
+
+
+ Results per page
+
+
+
+
+
+
+
+
+
+
+
+ Enter number of results to show per page
+
+
+
+
+
+
+
+
+ Run database search in background
+
+
+
+
+
+
+
+
+
+
+
+ Choose one of the following:
+
- checked: Search will automatically append wildcard if no wildcards are present. For example:
+ checked: XOWA continues while database searches are done in the background. These searches return results faster, especially for big queries.
+
+
+ unchecked: XOWA waits until the database search completes. This will often be slower, but will be more stable than background searches.
+
+
+
+
+
+
+
+
+
+ Auto-wildcard
+
+
+
+
+
+
+
+
+
+
+
+ Choose one of the following:
+
+
+
+ checked: Search will automatically append wildcard if no wildcards are present. For example:
- Earth will become Earth*
+ Earth will become Earth*
- Ea*rth will stay Ea*rth b/c it already has a wildcard
+ Ea*rth will stay Ea*rth b/c it already has a wildcard
- unchecked: Search will not apply any automatic behavior
+ unchecked: Search will not apply any automatic behavior
-
-
- ^Enter default args for every search: (default is ) . Examples include:
+
+
+
+
+
+
+
+ Default url search arguments
+
+
+
+
+
+
+
+
+
+
+
+ Enter default args for every search. Examples include:
+
- ns*=1 will search across all namespaces (current default is to search main namespace only)
+ ns*=1 will search across all namespaces (current default is to search main namespace only)
- ns0=1&ns14=1 will search across the main (0) and category (14) namespaces
+ ns0=1&ns14=1 will search across the main (0) and category (14) namespaces
-
-
- ^Enter wikis to search: (default is <any>|<self>) .
+
- Line 1 means "For English Wikipedia, seach all English wikis, such as English Wiktionary, English Wikisource, English Wikivoyage, etc."
+ Line 1 means "For English Wikipedia, seach all English wikis, such as English Wiktionary, English Wikisource, English Wikivoyage, etc."
- Line 2 means "For English Wiktionary, search all Wiktionarys, such as English Wiktionary, French Wiktionary, German Wiktionary, etc."
+ Line 2 means "For English Wiktionary, search all Wiktionarys, such as English Wiktionary, French Wiktionary, German Wiktionary, etc."
- Line 3 means "For French Wikivoyage and English Wikivoyage, search the current wiki and English Wikipedia"
+ Line 3 means "For French Wikivoyage and English Wikivoyage, search the current wiki and English Wikipedia"
- Line 4 means "For any wiki, search only the current wiki"
-
-
The multi-wikis criteria has the following format:
-
-
- Line-based: Each line represents a separate rule. A wiki will be compared against the rule, and if it matches, only that rule will apply. If it doesn't match, it goes on to the next line.
-
-
- Match: The match part is the text before the first pipe (|). Think of this as "when in this wiki...". This can be a wiki domain (en.wikipedia.org), a languages wildcard (en.*), a type wildcard (*.wikipedia) or the reserved word <any>). In addition, multiple terms can be chained together (en.wikipedia.org,fr.wikipedia.org).
-
-
- Include: Think of this as "...search these wikis". This can use any term as Match (domain, wildcard, reserved word) but can also use the reserved words: <self>, <same_lang><same_type>
-
-
Terms:
-
-
- <any>: matches any wiki. For example, in en.wikipedia.org, any wiki is matched, including home, en.wikipedia.org, fr.wiktionary.org, de.wikisource.org, etc..
-
-
- <self>: matches only the current wiki. For example, in en.wikipedia.org, only en.wikipedia.org is matched.
-
-
- <same_lang>: matches wikis with the same language. For example, in en.wikipedia.org, en.wiktionary.org, en.wikisource.org, etc. are matched. However, fr.wiktionary.org and de.wikisource.org are not matched.
-
-
- <same_type>: matches wikis with the same type. For example, in en.wikipedia.org, fr.wikipedia.org, de.wikipedia.org, ru.wikipedia.org, etc. are matched. However, en.wiktionary.org, en.wikisource.org, etc. are not matched.
-
-
- {language}.*: matches all wikis of that language. For example, "en.*" will match en.wikipedia.org, en.wiktionary.org, en.wikisource.org, etc regardless of the current wiki
-
-
- *.{type}: matches all wikis of that type. For example, "*.wikipedia" will match en.wikipedia.org, fr.wikipedia.org, de.wikipedia.org, etc
+ Line 4 means "For any wiki, search only the current wiki"
-
-
- ^Enter sorting-order for multiple wikis: (default is <any>|<self>,*.wikipedia,*.wikivoyage,*.wiktionary,*.wikisource,*.wikiquote,*.wikibooks,*.wikiversity,*.wikinews ) . The sort criteria has the following format:
+
+ The multi-wikis criteria has the following format:
+
- Line-based: Each line represents a separate rule. A wiki will be compared against the rule, and if it matches, only that rule will apply. If it doesn't match, it goes on to the next line.
+ Line-based: Each line represents a separate rule. A wiki will be compared against the rule, and if it matches, only that rule will apply. If it doesn't match, it goes on to the next line.
- Match: The match part is the text before the first pipe (|). Think of this as "when in this wiki...". This can be a wiki domain (en.wikipedia.org), a languages wildcard (en.*), a type wildcard (*.wikipedia) or the reserved word <any>). In addition, multiple terms can be chained together (en.wikipedia.org,fr.wikipedia.org).
+ Match: The match part is the text before the first pipe (|). Think of this as "when in this wiki...". This can be a wiki domain (en.wikipedia.org), a languages wildcard (en.*), a type wildcard (*.wikipedia) or the reserved word <any>). In addition, multiple terms can be chained together (en.wikipedia.org,fr.wikipedia.org).
- Sort: Think of this as "...sort according to following order".
-
-
- For example, consider if the following wikis are searched: en.wikipedia.org and en.wiktionary.org. Since en.wikipedia.org matches *.wikipedia.org, it will be sorted before en.wiktionary.org (which matches *.wiktionary.org)
+ Include: Think of this as "...search these wikis". This can use any term as Match (domain, wildcard, reserved word) but can also use the reserved words: <self>, <same_lang><same_type>
-
-
+
+ Terms:
+
+
+
+ <any>: matches any wiki. For example, in en.wikipedia.org, any wiki is matched, including home, en.wikipedia.org, fr.wiktionary.org, de.wikisource.org, etc..
+
+
+ <self>: matches only the current wiki. For example, in en.wikipedia.org, only en.wikipedia.org is matched.
+
+
+ <same_lang>: matches wikis with the same language. For example, in en.wikipedia.org, en.wiktionary.org, en.wikisource.org, etc. are matched. However, fr.wiktionary.org and de.wikisource.org are not matched.
+
+
+ <same_type>: matches wikis with the same type. For example, in en.wikipedia.org, fr.wikipedia.org, de.wikipedia.org, ru.wikipedia.org, etc. are matched. However, en.wiktionary.org, en.wikisource.org, etc. are not matched.
+
+
+ {language}.*: matches all wikis of that language. For example, "en.*" will match en.wikipedia.org, en.wiktionary.org, en.wikisource.org, etc regardless of the current wiki
+
+
+ *.{type}: matches all wikis of that type. For example, "*.wikipedia" will match en.wikipedia.org, fr.wikipedia.org, de.wikipedia.org, etc
+
+ Enter sorting-order for multiple wikis: <any>|<self>,*.wikipedia,*.wikivoyage,*.wiktionary,*.wikisource,*.wikiquote,*.wikibooks,*.wikiversity,*.wikinews }}. The sort criteria has the following format:
+
+
+
+ Line-based: Each line represents a separate rule. A wiki will be compared against the rule, and if it matches, only that rule will apply. If it doesn't match, it goes on to the next line.
+
+
+ Match: The match part is the text before the first pipe (|). Think of this as "when in this wiki...". This can be a wiki domain (en.wikipedia.org), a languages wildcard (en.*), a type wildcard (*.wikipedia) or the reserved word <any>). In addition, multiple terms can be chained together (en.wikipedia.org,fr.wikipedia.org).
+
+
+ Sort: Think of this as "...sort according to following order".
+
+
+ For example, consider if the following wikis are searched: en.wikipedia.org and en.wiktionary.org. Since en.wikipedia.org matches *.wikipedia.org, it will be sorted before en.wiktionary.org (which matches *.wiktionary.org)
+
- ^Choose one of the following: (default is checked)
-
+
+
+
+
+
+ Enabled
+
+
+
+
+
+
+
+
+
+
+
+ Choose one of the following:
+
- checked: Enables search suggestions in address bar; typing in the address bar will show suggestions in a drop-down list.
+ checked: Enables search suggestions in address bar; typing in the address bar will show suggestions in a drop-down list.
- unchecked: Disables search suggestions in address bar; typing in the address bar will not show suggestions.
+ unchecked: Disables search suggestions in address bar; typing in the address bar will not show suggestions.
-
-
- ^Maximum number of results to retrieve: (default is 10) (recommended is 100)
- This option limits the maximum number of results. For example, a setting of 10 with a search term of "earth" will retrieve the top 10 pages with the word "earth" in the title.
+
+
+
+
+
+
+
+ Max results
+
+
+
+
+
+
+
+
+
+
+
+ Maximum number of results to retrieve:
+ This option limits the maximum number of results. For example, a setting of 10 with a search term of "earth" will retrieve the top 10 pages with the word "earth" in the title.
+
- For slower machines, decrease the number of words to 1. Note that the number must be greater than 0.
+ For slower machines, decrease the number of words to 1. Note that the number must be greater than 0.
- For faster machines, increase the number of words as per your liking.
+ For faster machines, increase the number of words as per your liking.
-
-
- ^Choose one of the following: (default is checked)
-
+
+
+
+
+
+
+
+ Auto-wildcard
+
+
+
+
+
+
+
+
+
+
+
+ Choose one of the following:
+
- checked: Automatically adds a wildcard to every search suggestion. For example, "earth" will becomes "earth*" and match "Earth", "History of Earth", and "Earthquake". Note that the wildcard can be disabled by adding a space. For example, "earth " will match "Earth" and "History of Earth" but not "Earthquake".
+ checked: Automatically adds a wildcard to every search suggestion. For example, "earth" will becomes "earth*" and match "Earth", "History of Earth", and "Earthquake". Note that the wildcard can be disabled by adding a space. For example, "earth " will match "Earth" and "History of Earth" but not "Earthquake".
- unchecked: Does not add a wildcard to every search suggestion. "earth" will only "Earth" and "History of Earth"
+ unchecked: Does not add a wildcard to every search suggestion. "earth" will only "Earth" and "History of Earth"
- For the main namespace, enter in "0"
+ For the main namespace, enter in "0"
- For all namespaces, enter in "*".
+ For all namespaces, enter in "*".
- For specific namespaces, enter in the ids separated by a comma. For example, to search the Main, Wikipedia, Category, and Portal namespaces enter in "0,4,14,100"
+ For specific namespaces, enter in the ids separated by a comma. For example, to search the Main, Wikipedia, Category, and Portal namespaces enter in "0,4,14,100"
-
-
- ^Maximum number of results to show in visible area: (default is 10) (recommended is 25)
- This option limits the maximum number of results shown on screen. This visible-rows number can be made less than max-results. For example:
+
+
+
+
+
+
+
+ Visible rows
+
+
+
+
+
+
+
+
+
+
+
+ Maximum number of results to show in visible area:
+ This option limits the maximum number of results shown on screen. This visible-rows number can be made less than max-results. For example:
+
- A max-results of 100 and a visible-rows of 25 will show results #1-25 in the drop-down list, while results #26-100 can be seen using the drop-down list's scroll bar.
+ A max-results of 100 and a visible-rows of 25 will show results #1-25 in the drop-down list, while results #26-100 can be seen using the drop-down list's scroll bar.
- A max-results of 25 and a visible-rows of 25 will always show all results on screen. The drop-down list will not have a scroll bar
+ A max-results of 25 and a visible-rows of 25 will always show all results on screen. The drop-down list will not have a scroll bar
-
-
- ^Number of rows to move when pressing page-up or page-down (default is 5)
-
-
-
- ^Define symbols for address-bar searches: (default is )
- This is an advanced option which allows custom definition of symbols for search terms. For more information on search queries, see App/Search Note the following details:
-
-
- "\s" means space
-
-
- "\0" means disabled
-
-
- Only one symbol can be defined for each type. In other words, there can't be two "and" symbols (+, &)
-
-
- Entering in the wrong syntax will disable some if not all symbols. If you run into issues, copy and paste the excerpt below.
-
- ^Choose one of the following: (default is checked)
-
-
- checked: Search suggest enabled (typing in search box will dynamically retrieve suggestions)
-
-
- unchecked: Search suggest disabled
-
-
-
-
- ^Maximum number of search suggestions; (default is 10)
-
-
- ^Choose one of the following: (default is AllPages)
-
-
- AllPages_v2: Search suggestions will return titles beginning with search term
-
-
-
-
- EX: "Earth" will return "Earth" and "Earthquake" but not "History of Earth"
-
-
-
-
- Search : Search suggestions will return titles that have the word. Also allows extended search syntax (See App/Search)
-
-
-
-
- EX: "Earth" will return "Earth" and "History of Earth" but not "Earthquake"
-
-
-
-
- AllPages (obsolete): Search suggestions will return titles beginning with search term
-
-
-
-
- Similar to AllPages_v2, but returns less accurate results (though it is slightly faster)
-
-
-
-
- ^Only applicable when search mode is "AllPages" (default is 1000)
- Set number of pages to look-ahead. Used with Max results and AllPages minimum length. For example:
-
-
- Setting look-ahead to 0 will scan the next 10 titles after "Earth" and return the 1st 10 restuls that have a page length > Minimum length
-
-
- Setting look-ahead to 10,000 will scan the next 10,000 titles after "Earth" and return the 1st 10 results that have a page length > Minimum length
-
-
-
-
- ^Only applicable when search mode is "AllPages" (default is 10000)
- Set minimum length needed for a page to be in a result. Used with AllPages look-ahead. See example for AllPages look-ahead
-
-
- ^Choose one of the following: (default is unchecked)
-
-
- checked: search suggest will log activity (for development purposes only)
-
-
- unchecked: search suggest will not log activity
-
-
-
-
+
+
+
+
+
+
+
+ Page up / Page down increment
+
+
+
+
+
+
+
+
+
+
+
+ Number of rows to move when pressing page-up or page-down
+
- ^Choose if Javascript enabled: (default is checked)
+
+
+
+
+
+ Web access enabled
+
+
+
+
+
+
+
+
+
+
+
+ Choose if XOWA is allowed to access the Web:
+
- checked to enable JavaScript. Note that this will allow you to use the functions listed at Diagnostics/Javascript/All
+ checked: Allow web access.
- unchecked to disable JavaScript. Only JavaScript specified by XOWA will run
+ unchecked: Forbid web access. XOWA will not connect to the internet under any circumstances. This is equivalent to pulling the network cable for XOWA only.
-
-
- XOWA uses JavaScript for certain functionality such as MathJax, sortable, collapsible, and reference tooltips. Unfortunately, JavaScript can also be a vector of attack. Although XOWA scrubs pages to eliminate embedded JavaScript, it is possible for malicious JavaScript to be injected into a Wiki page that evades XOWA's code. For those concerned about security, the safest approach would be to disable JavaScript entirely.
-
-
-
-
- ^Choose if XOWA is allowed to access the Web: (default is checked)
+
+ Note that this may cause the app to not behave properly. For example:
+
- checked to allow web access.
+ Images will not download, even if "Retrieve files" is checked
- unchecked to forbid web access. XOWA will not connect to the internet under any circumstances. This is equivalent to pulling the network cable for XOWA only.
-
-
Note that this may cause the app to not behave properly. For example:
-
-
- Images will not download, even if "Retrieve files" is checked
+ Import links on Import/List will not work
- Import links on Import/List will not work
+ Download dump status on Wiki/Maintenance will not work
- Download dump status on Wiki/Maintenance will not work
-
-
- etc..
-
-
Also, note that this only controls XOWA's access to the internet. Viewer apps may still access the internet. For example, clicking on an external link will still launch a "Web browser". If you have VLC set up to play media files, it may access the internet when you click on a media file. A PDF app may try to update itself when you click on a PDF file. For more information, see Help/Privacy
-
-
- ^Choose if logs are enabled: (default is checked)
-
-
- checked to enable logs. XOWA logs application activity for diagnostic purposes. Note that these logs are never shared or uploaded. See Help/Privacy for more info
-
-
- unchecked to disable logs. No messages will be written to the log. You can check by going to Help -> System Data -> Session Log
+ etc..
-
-
- ^Choose if page history is enabled: (default is checked)
+
+ Also, note that this only controls XOWA's access to the internet. Viewer apps may still access the internet. For example, clicking on an external link will still launch a "Web browser". If you have VLC set up to play media files, it may access the internet when you click on a media file. A PDF app may try to update itself when you click on a PDF file.
+
- checked to enable page history. XOWA stores viewed pages for the Page History page (History -> Show). Note that this history is never shared or uploaded. See Help/Privacy for more info
+ checked: Enable JavaScript. Note that this will allow you to use the functions listed at Diagnostics/Javascript/All
- unchecked to disable page history. No pages will be stored in page history. You can check by going to Help -> System Data -> Page History
+ unchecked: Disable JavaScript. Only JavaScript specified by XOWA will run
-
-
- ^Choose if bookmarks are enabled: (default is checked)
+
+
+
+ Privacy
+
+
+
+
+
+
+ Logs enabled
+
+
+
+
+
+
+
+
+
+
+
+ Choose if logs are enabled:
+
- checked to enable bookmarks. XOWA adds bookmarks whenever the user chooses "Bookmark this page". Note that these bookmarks are never shared or uploaded. See Help/Privacy for more info
+ checked: Enable logs. XOWA logs application activity for diagnostic purposes. Note that these logs are never shared or uploaded. See Help/Privacy for more info
- unchecked to disable adding bookmarks. No bookmarks will be be added, even if the user clicks "Bookmark this page". You can check by clicking "Bookmark this page" and then clicking "Show all bookmarks"
+ unchecked: Disable logs. No messages will be written to the log. You can check by going to Help -> System Data -> Session Log
-
-
- ^Choose how HTML is loaded into the browser: (default is mem) (recommended is url) This is a performance optimization with privacy implications
+
+
+
+
+
+
+
+ Bookmarks enabled
+
+
+
+
+
+
+
+
+
+
+
+ Choose if bookmarks are enabled:
+
- mem: Loads HTML through memory by calling browser.setText(html). For unknown reasons, SWT / XULRunner uses more memory when loading HTML by setText -- as much as 5 - 10 MB for a page like en.w:Earth.
+ checked: Enable bookmarks. XOWA adds bookmarks whenever the user chooses "Bookmark this page". Note that these bookmarks are never shared or uploaded. See Help/Privacy for more info
- url: Loads HTML through the file system by calling browser.setUrl(file, html). This call uses less memory, but requires writing the HTML to disk. (see /xowa/user/anonymous/app/tmp/html) Although setting HTML via disk is theoretically slower than memory, the time difference is not noticeable. This may be more of an issue for users with privacy concerns. For more info on the latter, see Help/Privacy.
+ unchecked: Disable adding bookmarks. No bookmarks will be be added, even if the user clicks "Bookmark this page". You can check by clicking "Bookmark this page" and then clicking "Show all bookmarks"
-
Note that mem is currently the default, but url will be made the default in a future release.
-
-
+
+
+
+
+
+
+
+
+ History enabled
+
+
+
+
+
+
+
+
+
+
+
+ Choose if page history is enabled:
+
+
+
+ checked: Enable page history. XOWA stores viewed pages for the Page History page (History -> Show). Note that this history is never shared or uploaded. See Help/Privacy for more info
+
+
+ unchecked: Disable page history. No pages will be stored in page history. You can check by going to Help -> System Data -> Page History
+
+
+
+
+
+
+
+
+
+ Log all page history
+
+
+
+
+
+
+
+
+
+
+
+ Log every page visit in a separate log file
+
+
+
+ checked: Logs every page visit in a separate log file: C:\xowa\user\anonymous\app\data\history\log_all.csv
+
+
+ unchecked Does not log every page visit to a separate log file.
+
+
+
+ XOWA currently consolidates visits to the same page as one entry. For example, 3 visits to en.wikipedia.org/wiki/Earth would show up only once with the date being the most recent one. The date for the previous two entries would be lost. This option retains dates for all 3 entries by logging each visit to a separate file.
+
+
+
+
+
+
+
+
+ Load HTML to browser method
+
+
+
+
+
+
+
+
+
+
+
+ Choose how HTML is loaded into the browser: This is a performance optimization with privacy implications
+
+
+
+ mem: Load HTML through memory by calling browser.setText(html). For unknown reasons, SWT / XULRunner uses more memory when loading HTML by setText -- as much as 5 - 10 MB for a page like en.w:Earth.
+
+
+ url: Load HTML through the file system by calling browser.setUrl(file, html). This call uses less memory, but requires writing the HTML to disk. (see /xowa/user/anonymous/app/tmp/html) Although setting HTML via disk is theoretically slower than memory, the time difference is not noticeable. This may be more of an issue for users with privacy concerns. For more info on the latter, see Help/Privacy.
+
+
+
+ Note that mem is currently the default, but url will be made the default in a future release.
+
+ Import a wiki from an online Wikimedia dump server
+
+
+
+
+
+
+
+
+ Import Offline
+
+
+
+
+
+
+
+
+
+
+
+ Import a wiki from an offline dump (or by using a script)
+
+
+
+
+
+
+
+
+ Wiki Maintenance
+
+
+
+
+
+
+
+
+
+
+
+ View a list of your wikis and update selected ones
+
+
+
+
+
+
+
+
+ Image Databases
+
+
+
+
+
+
+
+
+
+
+
+ View a list of all available image dumps
+
+
+
+
+
+
+
+
+ Session Log
+
+
+
+
+
+
+
+
+
+
+
+ View the log file
+
+
+
+
+
+
+
+
+ Application Config
+
+
+
+
+
+
+
+
+
+
+
+ View the main config file
+
+
+
+
+
+
+
+
+ Language Config
+
+
+
+
+
+
+
+
+
+
+
+ View the language's config file for the current wiki
+
+
+
+
+
+
+
+
+ Page History
+
+
+
+
+
+
+
+
+
+
+
+ View the page history file
+
+
+
+
+ Font
+
+
+
+
+
+
+ Increase Font Size
+
+
+
+
+
+
+
+
+
+
+
+ Increase size of Window and HTML font.
+
+
+
+
+
+
+
+
+ Decrease Font Size
+
+
+
+
+
+
+
+
+
+
+
+ Decrease size of Window and HTML font.
+
+
+
+
+
+
+
+
+ Reset Font Size
+
+
+
+
+
+
+
+
+
+
+
+ Reset font to default size
+
+
+
+
+ Page View
+
+
+
+
+
+
+ Read Page
+
+
+
+
+
+
+
+
+
+
+
+ Read page
+
+
+
+
+
+
+
+
+ Edit Page
+
+
+
+
+
+
+
+
+
+
+
+ Edit page's wikitext
+
+
+
+
+
+
+
+
+ View HTML
+
+
+
+
+
+
+
+
+
+
+
+ View page's HTML
+
+
+
+
+
+
+
+
+ View HTML
+
+
+
+
+
+
+
+
+
+
+
+ View page's HTML
+
+
+
+
+
+
+
+
+ Refresh Page
+
+
+
+
+
+
+
+
+
+
+
+ Refresh page content by reparsing only
+
+
+
+
+
+
+
+
+ Reload Page
+
+
+
+
+
+
+
+
+
+
+
+ Reload page content by retrieving data and reparsing
+
+
+
+
+
+
+
+
+ Save As
+
+
+
+
+
+
+
+
+
+
+
+ Save current page to an HTML file
+
+
+
+
+
+
+
+
+ Print
+
+
+
+
+
+
+
+
+
+
+
+ Print current page. See Help:Printing
+
+
+
+
+ Page Edit
+
+
+
+
+
+
+ Save Page and Read
+
+
+
+
+
+
+
+
+
+
+
+ Save wikitext and switch to the Read view
+
+
+
+
+
+
+
+
+ Save Page (draft)
+
+
+
+
+
+
+
+
+
+
+
+ Save wikitext and continue editing
+
+
+
+
+
+
+
+
+ Focus Edit Box
+
+
+
+
+
+
+
+
+
+
+
+ Switch keyboard focus to the edit box
+
+
+
+
+
+
+
+
+ Preview
+
+
+
+
+
+
+
+
+
+
+
+ Preview wikitext
+
+
+
+
+
+
+
+
+ Expand Templates
+
+
+
+
+
+
+
+
+
+
+
+ Expand all templates using the text in the edit box (developer usage only)
+
+
+
+
+
+
+
+
+ Expand Templates
+
+
+
+
+
+
+
+
+
+
+
+ Expand all templates using the text in the edit box (developer usage only)
+
+
+
+
+
+
+
+
+ Show Current HTML
+
+
+
+
+
+
+
+
+
+
+
+ Show current HTML (with javascript changes) (developer usage only)
+
+
+
+
+
+
+
+
+ Run XOWA Script
+
+
+
+
+
+
+
+
+
+
+
+ Run XOWA script using the text in the edit box(developer usage only)
+
+
+
+
+ Page Selection
+
+
+
+
+
+
+ Select All
+
+
+
+
+
+
+
+
+
+
+
+ Select all text on current page
+
+
+
+
+
+
+
+
+ Copy
+
+
+
+
+
+
+
+
+
+
+
+ Copy selected text or url to clipboard
+
+
+
+
+
+
+
+
+ Save File As
+
+
+
+
+
+
+
+
+
+
+
+ Save selected image to a file (currently available by right-clicking on an image)
+
+
+
+
+ Browser
+
+
+
+
+
+
+ Focus URL Bar
+
+
+
+
+
+
+
+
+
+
+
+ Switch keyboard focus to the url bar
+
+
+
+
+
+
+
+
+ Focus URL Bar
+
+
+
+
+
+
+
+
+
+
+
+ Switch keyboard focus to the url bar
+
+
+
+
+
+
+
+
+ Go to the Address
+
+
+
+
+
+
+
+
+
+
+
+ Go to the Address in the Location Bar
+
+
+
+
+
+
+
+
+ Paste and Go
+
+
+
+
+
+
+
+
+
+
+
+ Paste the current clipboard text into the address bar and go
+
+
+
+
+
+
+
+
+ Paste and Go
+
+
+
+
+
+
+
+
+
+
+
+ Paste the current clipboard text into the address bar and go
+
+
+
+
+
+
+
+
+ Paste and Show In New Tab
+
+
+
+
+
+
+
+
+
+
+
+ Paste the current clipboard text into the address bar and show in new tab
+
+
+
+
+
+
+
+
+ Restore page url
+
+
+
+
+
+
+
+
+
+
+
+ Restore original url for page to the address box
+
+
+
+
+
+
+
+
+ Focus Search Box
+
+
+
+
+
+
+
+
+
+
+
+ Switch keyboard focus to the search box
+
+
+
+
+
+
+
+
+ Search
+
+
+
+
+
+
+
+
+
+
+
+ Search for pages using the text in the search box
+
+
+
+
+
+
+
+
+ Focus HTML Browser
+
+
+
+
+
+
+
+
+
+
+
+ Switch keyboard focus to the HTML box
+
+
+
+
+
+
+
+
+ Focus HTML Browser
+
+
+
+
+
+
+
+
+
+
+
+ Switch keyboard focus to the HTML box
+
+
+
+
+
+
+
+
+ Focus HTML Browser
+
+
+
+
+
+
+
+
+
+
+
+ Switch keyboard focus to the HTML box
+
+
+
+
+
+
+
+
+ Focus HTML Browser
+
+
+
+
+
+
+
+
+
+
+
+ Switch keyboard focus to the HTML box
+
+
+
+
+
+
+
+
+ Focus or unfocus selection's anchor
+
+
+
+
+
+
+
+
+
+
+
+ Focus or unfocus the anchor that spans the current selection.
+
+
+ This command is meant to be used for keyboard navigation. Try the following steps:
+
+
+
+ Press Ctrl+F
+
+
+ Type unique letters for a link (try r i b)
+
+
+ Press Ctrl+G
+
+
+ Press Ctrl+G: the link underneath the highlighted letters will now be selected
+
+
+
+ You can now do the following:
+
+
+
+ Press enter and the link will open in the current tab
+
+
+ If Popups is configured to show on focus, a popup will show
+
+
+ Use a "right-click-mouse" keystroke (for example, AutoHotKey on Windows)
+
+
+
+
+
+
+
+
+
+ Find
+
+
+
+
+
+
+
+
+
+
+
+ Show the find box
+
+
+
+
+
+
+
+
+ Find
+
+
+
+
+
+
+
+
+
+
+
+ Show the find box and paste current clipboard text
+
+
+
+
+
+
+
+
+ Hide
+
+
+
+
+
+
+
+
+
+
+
+ Hide the find box
+
+
+
+
+
+
+
+
+ Find
+
+
+
+
+
+
+
+
+
+
+
+ Find text on the page using the text in the find box
+
+
+
+
+
+
+
+
+ Find Next
+
+
+
+
+
+
+
+
+
+
+
+ Find the next occurrence. Also switch default find direction to forward.
+
+
+
+
+
+
+
+
+ Find Previous
+
+
+
+
+
+
+
+
+
+
+
+ Find the previous occurrence. Also switch default find direction to reverse.
+
+
+
+
+
+
+
+
+ Toggle Case Sensitivity
+
+
+
+
+
+
+
+
+
+
+
+ Toggle case sensitivity for the search ("Find" vs "find")
+
+
+
+
+
+
+
+
+ Toggle Wrap Search
+
+
+
+
+
+
+
+
+
+
+
+ Toggle search wrap settings (whether a search stops at the end of the page, or wraps back to the beginning)
+
+
+
+
+
+
+
+
+ Focus Status Box
+
+
+
+
+
+
+
+
+
+
+
+ Switch keyboard focus to the status box
+
+
+
+
+
+
+
+
+ Show Progress Messages
+
+
+
+
+
+
+
+
+
+
+
+ Pop up window with most recent progress messages
+
+
+
+
+
+
+
+
+ Show Progress Messages
+
+
+
+
+
+
+
+
+
+
+
+ Pop up window with most recent progress messages
+
+
+
+
+
+
+
+
+ Focus Messages Box
+
+
+
+
+
+
+
+
+
+
+
+ Switch keyboard focus to the messages box
+
+
+
+
+
+
+
+
+ Clear Messages
+
+
+
+
+
+
+
+
+
+
+
+ Clear messages box
+
+
+
+
+ Tabs
+
+
+
+
+
+
+ New Tab
+
+
+
+
+
+
+
+
+
+
+
+ Open a new tab
+
+
+
+
+
+
+
+
+ Open Link in New Tab
+
+
+
+
+
+
+
+
+
+
+
+ Open the selected link in a new tab
+
+
+
+
+
+
+
+
+ Open Link in New Tab and Follow
+
+
+
+
+
+
+
+
+
+
+
+ Open the selected link in a new tab and switch to it.
+
+
+
+
+
+
+
+
+ Open Link in New Tab and Follow
+
+
+
+
+
+
+
+
+
+
+
+ This command is meant to be used for keyboard navigation. Try the following steps:
+
+
+
+ Press Ctrl+F
+
+
+ Type unique letters for a link (try r i b)
+
+
+ Press Ctrl+G
+
+
+ Press Ctrl+F: the link underneath the highlighted letters will now open
+
+
+
+
+
+
+
+
+
+ Select Previous Tab
+
+
+
+
+
+
+
+
+
+
+
+ Select previous tab as current tab
+
+
+
+
+
+
+
+
+ Select Previous Tab
+
+
+
+
+
+
+
+
+
+
+
+ Select previous tab as current tab
+
+
+
+
+
+
+
+
+ Select Next Tab
+
+
+
+
+
+
+
+
+
+
+
+ Select next tab as current tab
+
+
+
+
+
+
+
+
+ Select Next Tab
+
+
+
+
+
+
+
+
+
+
+
+ Select next tab as current tab
+
+
+
+
+
+
+
+
+ Select Tab #1
+
+
+
+
+
+
+
+
+
+
+
+ Select tab #1 as current tab
+
+
+
+
+
+
+
+
+ Select Tab #2
+
+
+
+
+
+
+
+
+
+
+
+ Select tab #2 as current tab
+
+
+
+
+
+
+
+
+ Select Tab #3
+
+
+
+
+
+
+
+
+
+
+
+ Select tab #3 as current tab
+
+
+
+
+
+
+
+
+ Select Tab #4
+
+
+
+
+
+
+
+
+
+
+
+ Select tab #4 as current tab
+
+
+
+
+
+
+
+
+ Select Tab #5
+
+
+
+
+
+
+
+
+
+
+
+ Select tab #5 as current tab
+
+
+
+
+
+
+
+
+ Select Tab #6
+
+
+
+
+
+
+
+
+
+
+
+ Select tab #6 as current tab
+
+
+
+
+
+
+
+
+ Select Tab #7
+
+
+
+
+
+
+
+
+
+
+
+ Select tab #7 as current tab
+
+
+
+
+
+
+
+
+ Select Tab #8
+
+
+
+
+
+
+
+
+
+
+
+ Select tab #8 as current tab
+
+
+
+
+
+
+
+
+ Select Tab #9
+
+
+
+
+
+
+
+
+
+
+
+ Select tab #9 as current tab
+
+
+
+
+
+
+
+
+ Move Tab Left
+
+
+
+
+
+
+
+
+
+
+
+ Move current tab to the left
+
+
+
+
+
+
+
+
+ Move Tab Right
+
+
+
+
+
+
+
+
+
+
+
+ Move current tab to the right
+
+
+
+
+
+
+
+
+ Close Tab
+
+
+
+
+
+
+
+
+
+
+
+ Close current
+
+
+
+
+
+
+
+
+ Close Other Tabs
+
+
+
+
+
+
+
+
+
+
+
+ Close all tabs except for the current one
+
+
+
+
+
+
+
+
+ Close Tabs to the Left
+
+
+
+
+
+
+
+
+
+
+
+ Close all tabs to the left of the current tab
+
+
+
+
+
+
+
+
+ Close Tabs to the Right
+
+
+
+
+
+
+
+
+
+
+
+ Close all tabs to the right of the current tab
+
+
+
+
+
+
+
+
+ Undo Close Tab
+
+
+
+
+
+
+
+
+
+
+
+ Restore last closed tab
+
+
+
+
+
+
+
+
+ Pin Toggle
+
+
+
+
+
+
+
+
+
+
+
+ Pin / Unpin current tab
+
+
+
+
+ HTML
+
+
+
+
+
+
+ Toggle HTML Tidy
+
+
+
+
+
+
+
+
+
+
+
+ Enable / Disable HTML Tidy
+
+
+
+
+ Net
+
+
+
+
+
+
+ Offline
+
+
+
+
+
+
+
+
+
+
+
+ Disable internet connectivity. XOWA will not connect to the internet for any reason. Note that some functions will not work (for example, Help:Import_from_list)
+
- ^Specify a startup type (default is xowa) Choose from one of the following:
+
+
+
+
+
+ Window Mode
+
+
+
+
+
+
+
+
+
+
+
+ Choose one of the following:
+
- blank: one tab loads and it is set to blank (Special:XowaDefaultTab)
+ previous: window starts at same rect as previous session (default)
- xowa : one tab loads and it is set to the XOWA home page (home/wiki/Main_Page)
+ maximized: window always starts maximized
- previous: all opened pages from the previous session loads. For example, if "en.w:Earth" and "en.w:Moon" were open when XOWA was last closed, these tabs will be reopened
+ absolute: window bounds are set to rect below
- custom: all pages specified in the custom box will load
+ relative: window starts at full screen, and then adjusted by rect below
+
+
+ default: window starts at default rect (determined by operating system)
-
-
- ^Specify custom pages to show on startup (default is ) This option only applies if custom is selected for type.
- Note the following:
+
+
+
+
+
+
+
+ Window Size
+
+
+
+
+
+
+
+
+
+
+
+ Enter 'x,y,w,h' numbers separated by commas. Note that this setting is used in conjunction with 'Window Mode'
+
- Aliases can be used. For example, "en.w:Earth" is a shortcut for "en.wikipedia.org/wiki/Earth"
+ absolute: absolute rect of window; EX: 0,0,1280,1024 means x=0 y=0 w=1280 h=1024
- Multiple pages are separated by new lines. For example, the following will load 2 tabs:
+ relative: relative adjustment to full screen size; EX: 20,20,-20,-20 on an 1280,1024 screen will yield a rect of x=20 y=20 w=1260 h=1004
+
+
+ previous, maximized, default: does nothing
+
+
+
+
+
+
+
+
+
+ Safe Mode
+
+
+
+
+
+
+
+
+
+
+
+ Choose one of the following:
+
+
+
+ checked: prevents window that would be located off screen; EX: x=-9999 or y=9999
+
+
+ unchecked: allows off-screen rect.
+
+
+
+ NOTE: if you create an unviewable rect you will need to edit the options file
+
+
+
+
+ Tabs
+
+
+
+
+
+
+ Startup type
+
+
+
+
+
+
+
+
+
+
+
+ Choose a startup page from one of the following:
+
+
+
+ blank: one tab loads and it is set to blank (Special:XowaDefaultTab)
+
+
+ xowa : one tab loads and it is set to the XOWA home page (home/wiki/Main_Page)
+
+
+ previous: all opened pages from the previous session loads. For example, if "en.w:Earth" and "en.w:Moon" were open when XOWA was last closed, these tabs will be reopened
+
+
+ custom: all pages specified in the custom box will load
+
+
+
+
+
+
+
+
+
+ Custom pages
+
+
+
+
+
+
+
+
+
+
+
+
+ Specify custom pages to show on startup:
+
+
+
+ This option only applies if custom is selected for type.
+
+
+
+ Also, note the following:
+
+
+
+ Aliases can be used. For example, "en.w:Earth" is a shortcut for "en.wikipedia.org/wiki/Earth"
+
+
+ Multiple pages are separated by new lines. For example, the following will load 2 tabs:
-en.w:Earth
+en.w:Earth
en.w:Moon
-
-
-
+
+
+
+ Advanced
+
+
+
+
+
+
+ Script
+
+
+
+
+
+
+
+
+
+
+
+
+ Enter custom configuration.
+
+
+
+ These scripts will run after the application starts up. They will also run whenever you click Save on this page.
+
+
+ These scripts are intended for advanced users. They are in the format of .gfs statements (for examples, see /xowa/xowa.gfs). Please do not enter scripts unless instructed, or else XOWA may fail to start up.
+
+
+ These scripts are saved to /xowa/user/anonymous/data/cfg/user_custom_cfg.gfs. If XOWA fails to start up, simply delete the file.
+
- ^Draw button with curve. (default is unchecked)
+
+
+ NOTE: The underlying tab widget (SWT CTabFolder) does not allow other border embellishments.
+
+
+
+
+
+
+
+
+ Close button visible
+
+
+
+
+
+
+
+
+
+
+
+ Choose whether to show the close button
+
- checked to draw tab button with curve on right side
+ checked: show the close button on all tabs
- unchecked to draw tab button as rounded rect
+ unchecked: hide the close button on all tabs
-
NOTE: The underlying tab widget (SWT CTabFolder) does not allow other border embellishments.
-
-
- ^Choose whether to show the close button (default is checked)
+
+
+ NOTE: This setting overrides Unselected close button visible
+
+
+
+
+
+
+
+
+ Unselected close button visible
+
+
+
+
+
+
+
+
+
+
+
+ Choose whether to show the close button on unselected tabs
+
- checked to show the close button on all tabs
+ checked: show the close button on unselected tabs.
- unchecked to hide the close button on all tabs
+ unchecked: hide the close button on unselected tabs. The close button will still show for the selected tab.
-
NOTE: This setting overrides Unselected close button visible
-
-
- ^Choose whether to show the close button on unselected tabs (default is checked)
+
+
+ NOTE: This setting is overriden by Close button visible
+
+
+
+
+ Title
+
+
+
+
+
+
+ Max chars
+
+
+
+
+
+
+
+
+
+
+
+ Enter a maximum number of characters for the title:
+
- checked to show the close button on unselected tabs.
+ This setting limits the maximum width of a tab: i.e.: I don't want my tabs to be wider than this.
- unchecked to hide the close button on unselected tabs. The close button will still show for the selected tab.
-
-
NOTE: This setting is overriden by Close button visible
-
-
- ^Select a maximum number of characters for the title (default is 40)
-
-
- This setting limits the maximum width of a tab: i.e.: I don't want my tabs to be wider than this.
-
-
- If the setting is -1 or the title has less characters than the min, the title will be unchanged
+ If the setting is -1 or the title has less characters than the min, the title will be unchanged
- For example, a maximum of 5 and a title of "A" will show as "A"
+ For example, a maximum of 5 and a title of "A" will show as "A"
- Otherwise, the text is truncated to the maximum, and an ellipsis of "..." will be added
+ Otherwise, the text is truncated to the maximum, and an ellipsis of "..." will be added
- For example, a maximum of 5 and a title of "Maximum" will show as "Maxim..."
+ For example, a maximum of 5 and a title of "Maximum" will show as "Maxim..."
-
-
- ^Select a minimum number of characters for the title (default is -1)
+
+
+
+
+
+
+
+ Min chars
+
+
+
+
+
+
+
+
+
+
+
+ Enter a minimum number of characters for the title:
+
- This setting generate a standard minimum width: i.e.: I want my tabs to be at least this wide.
+ This setting generate a standard minimum width: i.e.: I want my tabs to be at least this wide.
- It works best with fixed width fonts. For other fonts, the results will be imprecise.
+ It works best with fixed width fonts. For other fonts, the results will be imprecise.
- If the setting is -1 or the title has more characters than the min, the title will be unchanged
+ If the setting is -1 or the title has more characters than the min, the title will be unchanged
- For example, a minimum of 5 and a title of "Minimum" will show as "Minimum"
+ For example, a minimum of 5 and a title of "Minimum" will show as "Minimum"
- Otherwise, spaces will be padded on to the end of the title to reach the minimum.
+ Otherwise, spaces will be padded on to the end of the title to reach the minimum.
- For example, a minimum of 5 and a title of "A" will show as "A "
+ For example, a minimum of 5 and a title of "A" will show as "A "
- ^Controls the appearance of the Talk tab (right of Page tab) (default is Show as blue link)
+
+
+
+
+
+ Talk namespace
+
+
+
+
+
+
+
+
+
+
+
+ Controls the appearance of the Talk tab (right of Page tab):
+
- XOWA shows a Talk tab just like any other MediaWiki wiki
+ XOWA shows a Talk tab just like any other MediaWiki wiki
- However, the default wiki dumps (pages-articles) do not have the Talk namespace. In these situations, the Talk tab is non-functional.
+ However, the default wiki dumps (pages-articles) do not have the Talk namespace. In these situations, the Talk tab is non-functional.
- Some users may object to the continual presence of a non-functional tab. As such, the following options have been provided:
+ Some users may object to the continual presence of a non-functional tab. As such, the following options have been provided:
- Hide : Hide the tab if the namespace is missing. This is non-standard MediaWiki behavior, but is not distracting.
+ Hide : Hide the tab if the namespace is missing. This is non-standard MediaWiki behavior, but is not distracting.
- Show as red link : Show the tab with a red color. This is standard MediaWiki behavior, but some users may find the red link distracting.
+ Show as red link : Show the tab with a red color. This is standard MediaWiki behavior, but some users may find the red link distracting.
- Show as blue link : Show the tab with a blue color. This is non-standard MediaWiki behavior. It is not distracting but some users may object to the presence of a non-functional link.
+ Show as blue link : Show the tab with a blue color. This is non-standard MediaWiki behavior. It is not distracting but some users may object to the presence of a non-functional link.
-
-
- ^ abChoose one of the following. (default is unchecked) [desktop] (default is checked) [server]
+
+
+
+
+
+
+
+ Show home menu in sidebar (desktop)
+
+
+
+
+
+
+
+
+
+
+
+ Choose one of the following.
+
- checked : to show XOWA menu in sidebar (has XOWA Main Page, About, Help, Page History, Bookmarks, Options
+ checked : to show XOWA menu in sidebar (has XOWA Main Page, About, Help, Page History, Bookmarks, Options
- unchecked : to hide XOWA menu in sidebar
+ unchecked : to hide XOWA menu in sidebar
-
-
- ^Enter a format for pages whose content is entirely source code (default is <pre>~{page_text}</pre>) Applicable pages include:
+
+
+
+
+
+
+
+ Show home menu in sidebar (server)
+
+
+
+
+
+
+
+
+
+
+
+ Choose one of the following.
+
- MediaWiki:Common.css
+ checked : to show XOWA menu in sidebar (has XOWA Main Page, About, Help, Page History, Bookmarks, Options
- MediaWiki:*.js
-
-
- Module:*
-
-
The purpose of this option is to control the behavior of the pre when the page has source code with long lines. Example behaviors include:
-
-
- Horizontal scroll bar at bottom of html window: <pre>~{page_text}</pre>
-
-
- Horizontal scroll bar at bottom of pre: <pre style='overflow:auto'>~{page_text}</pre>
-
- ^Choose one of the following (default is unchecked)
-
-
- checked : if no alt is specified, caption will be used
-
-
- unchecked : if no alt is specified, a blank will be used (i.e.: alt will be empty)
+ unchecked : to hide XOWA menu in sidebar
-
-
- ^Collapsible settings only apply to the current viewing of the page. This setting is not stored for each page. For example, if you are viewing "Page_A", you set your table of contents (TOC) setting to unchecked (always show), and you click "hide":
+
+
+
+ Content
+
+
+
+
+
+
+ Content code format
+
+
+
+
+
+
+
+
+~{page_text}
+
+
+
+
+
+
+ Enter a format for pages whose content is entirely source code:
+
+
+ Applicable pages include:
+
- Click a link -> Press back -> TOC is shown, not hidden
+ MediaWiki:Common.css
- Exit XOWA -> Reopen XOWA -> Go to "Page_A" -> TOC is shown, not hidden
-
-
Saving the hide/show setting on a page by page basis will be supported in a future version, but probably not anytime soon.
-
-
- ^Controls the appearance of the Talk tab (right of Page tab) (default is Show as blue link)
+
+
+
+
+
+ Talk namespace
+
+
+
+
+
+
+
+
+
+
+
+ Controls the appearance of the Talk tab (right of Page tab):
+
- XOWA shows a Talk tab just like any other MediaWiki wiki
+ XOWA shows a Talk tab just like any other MediaWiki wiki
- However, the default wiki dumps (pages-articles) do not have the Talk namespace. In these situations, the Talk tab is non-functional.
+ However, the default wiki dumps (pages-articles) do not have the Talk namespace. In these situations, the Talk tab is non-functional.
- Some users may object to the continual presence of a non-functional tab. As such, the following options have been provided:
+ Some users may object to the continual presence of a non-functional tab. As such, the following options have been provided:
- Hide : Hide the tab if the namespace is missing. This is non-standard MediaWiki behavior, but is not distracting.
+ Hide : Hide the tab if the namespace is missing. This is non-standard MediaWiki behavior, but is not distracting.
- Show as red link : Show the tab with a red color. This is standard MediaWiki behavior, but some users may find the red link distracting.
+ Show as red link : Show the tab with a red color. This is standard MediaWiki behavior, but some users may find the red link distracting.
- Show as blue link : Show the tab with a blue color. This is non-standard MediaWiki behavior. It is not distracting but some users may object to the presence of a non-functional link.
+ Show as blue link : Show the tab with a blue color. This is non-standard MediaWiki behavior. It is not distracting but some users may object to the presence of a non-functional link.
-
-
- ^ abChoose one of the following. (default is unchecked) [desktop] (default is checked) [server]
+
+
+
+
+
+
+
+ Show home menu in sidebar (desktop)
+
+
+
+
+
+
+
+
+
+
+
+ Choose one of the following.
+
- checked : to show XOWA menu in sidebar (has XOWA Main Page, About, Help, Page History, Bookmarks, Options
+ checked : to show XOWA menu in sidebar (has XOWA Main Page, About, Help, Page History, Bookmarks, Options
- unchecked : to hide XOWA menu in sidebar
+ unchecked : to hide XOWA menu in sidebar
-
-
- ^Enter a format for pages whose content is entirely source code (default is <pre>~{page_text}</pre>) Applicable pages include:
+
+
+
+
+
+
+
+ Show home menu in sidebar (server)
+
+
+
+
+
+
+
+
+
+
+
+ Choose one of the following.
+
- MediaWiki:Common.css
+ checked : to show XOWA menu in sidebar (has XOWA Main Page, About, Help, Page History, Bookmarks, Options
- MediaWiki:*.js
-
-
- Module:*
-
-
The purpose of this option is to control the behavior of the pre when the page has source code with long lines. Example behaviors include:
-
-
- Horizontal scroll bar at bottom of html window: <pre>~{page_text}</pre>
-
-
- Horizontal scroll bar at bottom of pre: <pre style='overflow:auto'>~{page_text}</pre>
-
- ^Choose one of the following (default is unchecked)
-
-
- checked : if no alt is specified, caption will be used
-
-
- unchecked : if no alt is specified, a blank will be used (i.e.: alt will be empty)
+ unchecked : to hide XOWA menu in sidebar
-
-
- ^Collapsible settings only apply to the current viewing of the page. This setting is not stored for each page. For example, if you are viewing "Page_A", you set your table of contents (TOC) setting to unchecked (always show), and you click "hide":
+
+
+
+ Content
+
+
+
+
+
+
+ Content code format
+
+
+
+
+
+
+
+
+~{page_text}
+
+
+
+
+
+
+ Enter a format for pages whose content is entirely source code:
+
+
+ Applicable pages include:
+
- Click a link -> Press back -> TOC is shown, not hidden
+ MediaWiki:Common.css
- Exit XOWA -> Reopen XOWA -> Go to "Page_A" -> TOC is shown, not hidden
-
-
Saving the hide/show setting on a page by page basis will be supported in a future version, but probably not anytime soon.
-
-
- ^Enter multiple language codes separated by a semi-colon. See Options/Language for a full list of valid language codes. (default is en)
- The text languages are used for the following:
+
+
+
+
+
+ Text languages
+
+
+
+
+
+
+
+
+
+
+
+ Enter multiple language codes separated by a semi-colon. See Options/Language for a full list of valid language codes.
+ The text languages are used for the following:
+
- The overview for the article's label, description and alias. For example, a value of "en" on Earth's Wikidata page will generate an article title of "Earth" and corresponding English text for everything before the Table of Contents.
+ The overview for the article's label, description and alias. For example, a value of "en" on Earth's Wikidata page will generate an article title of "Earth" and corresponding English text for everything before the Table of Contents.
- The entity name for claims and properties. For example, a language of "en" will generate "astronomical body" and "Sun" for claim P397
+ The entity name for claims and properties. For example, a language of "en" will generate "astronomical body" and "Sun" for claim P397
-
Note that multiple languages allow searching for a preferred language first. For example, a value of "de;en" will search for the German text first. If one is not found, it will then use the English text.
-
-
- ^Enter a wiki code. (default is enwiki)
- The wiki code is used to create a hyperlink for the article title. For example, a wiki code of "enwiki" on Earth's Wikidata page creates a hyperlink to English Wikipedia's Earth article.
-
-
- ^Enter multiple language codes separated by a semi-colon. (default is en;de;es;fr;it;nl;pl;ru;sv)
- The sort languages are used to sort the Link, Label, Description and Alias list. For example, sort languages of "en;de;fr" will place the English, German and French entries at the top of the list, and then sort everything else afterwards alphabetically.
-
+ Note that multiple languages allow searching for a preferred language first. For example, a value of "de;en" will search for the German text first. If one is not found, it will then use the English text.
+
+
+
+
+
+
+
+
+ Sort languages
+
+
+
+
+
+
+
+
+
+
+
+ Enter multiple language codes separated by a semi-colon.
+ The sort languages are used to sort the Link, Label, Description and Alias list. For example, sort languages of "en;de;fr" will place the English, German and French entries at the top of the list, and then sort everything else afterwards alphabetically.
+
+
+
+
+
+
+
+
+ Link wiki
+
+
+
+
+
+
+
+
+
+
+
+ Enter a wiki code.
+ The wiki code is used to create a hyperlink for the article title. For example, a wiki code of "enwiki" on Earth's Wikidata page creates a hyperlink to English Wikipedia's Earth article.
+
+ Tooltip captions; EX: Go back one page, Go foward one page, Go to the address in the location bar, etc..
+
+
+ XOWA sidebar; EX: Main page, About, etc..
+
+
+ XOWA messages: "version" and "build time"
+
+
+
+
+ Note that HTML tab text (Page, Read, Edit, View HTML, Search) uses the language of the underlying wiki.
+
+
+ Translations are only available for English, German, Polish and Chinese. If you can provide translations in your language, please contact me via Help/Feedback
+
+
+ The home wiki documentation is still changing, so translations will not be available for some time
+
+
+
+
+
+
+
+
+
+ Font name
+
+
+
+
+
+
+
+
+
+
+
+ Enter a font name:
+
+
+
+ The font name must be installed on your machine, such as "Arial", "Courier New", "Liberation Sans"
+
+
+ The font name applies to the Address Bar, Tab Buttons, Search Bar, Find Box, and Progress Text messages
+
- The font name must be installed on your machine, such as "Arial", "Courier New", "Liberation Sans"
+ checked: Show link at the bottom as page_name. EX: Main_Page
- The font name applies to the Address Bar, Tab Buttons, Search Bar, Find Box, and Progress Text messages
-
-
- To change the fonts for the menu, you will need to do it through your Operating System. SWT does not support customizable fonts for menus: https://bugs.eclipse.org/bugs/show_bug.cgi?id=29899
+ unchecked: Show link at the bottom as wiki_name/wiki/page_name. EX: simple.wikipedia.org/wiki/Main_Page
- ^Installs the XOWA viewer add-on by running "firefox xowa_viewer.xpi". Note that Firefox should launch after clicking the install link. For more information, see App/Xtn/Browser/XOWA_viewer
-
-
- ^Enter the path where Firefox is installed. (default is firefox) You may need to point this directly to your firefox executable if it doesn't work.
-
Find your wiki in the list
diff --git a/home/wiki/Wiki_setup/Arabic_wikis.html b/home/wiki/Wiki_setup/Arabic_wikis.html
index 297d79e91..21c471469 100644
--- a/home/wiki/Wiki_setup/Arabic_wikis.html
+++ b/home/wiki/Wiki_setup/Arabic_wikis.html
@@ -359,7 +359,7 @@
Find your wiki in the list
diff --git a/home/wiki/Wiki_setup/Czech_wikis.html b/home/wiki/Wiki_setup/Czech_wikis.html
index ab5d53990..3dc29933a 100644
--- a/home/wiki/Wiki_setup/Czech_wikis.html
+++ b/home/wiki/Wiki_setup/Czech_wikis.html
@@ -359,7 +359,7 @@
Find your wiki in the list
diff --git a/home/wiki/Wiki_setup/Dutch_wikis.html b/home/wiki/Wiki_setup/Dutch_wikis.html
index cc881de1f..6cc9bace6 100644
--- a/home/wiki/Wiki_setup/Dutch_wikis.html
+++ b/home/wiki/Wiki_setup/Dutch_wikis.html
@@ -362,7 +362,7 @@
Find your wiki in the list
diff --git a/home/wiki/Wiki_setup/English_wikis.html b/home/wiki/Wiki_setup/English_wikis.html
index 37eae31b0..99bb77cbc 100644
--- a/home/wiki/Wiki_setup/English_wikis.html
+++ b/home/wiki/Wiki_setup/English_wikis.html
@@ -101,7 +101,7 @@
4.1en.wikipedia.org
Find your wiki in the list
diff --git a/home/wiki/Wiki_setup/German_wikis.html b/home/wiki/Wiki_setup/German_wikis.html
index 3d952c30a..cbd09ef2b 100644
--- a/home/wiki/Wiki_setup/German_wikis.html
+++ b/home/wiki/Wiki_setup/German_wikis.html
@@ -101,112 +101,106 @@
4.1de.wikipedia.org
Find your wiki in the list
diff --git a/home/wiki/Wiki_setup/Italian_wikis.html b/home/wiki/Wiki_setup/Italian_wikis.html
new file mode 100644
index 000000000..a5f9a1a87
--- /dev/null
+++ b/home/wiki/Wiki_setup/Italian_wikis.html
@@ -0,0 +1,1521 @@
+
+
+
+
+ Wiki setup/Italian wikis - XOWA
+
+
+
+
+
+
+
+
+
Wiki setup/Italian wikis
+
+
From XOWA: the free, open-source, offline wiki application
+
+
+
+
+ Overview
+
+
+ This page describes how to set up Italian wikis on your machine. The following two options are available:
+
+
+ Download pre-built wikis from archive.org
+
+
+
+ Faster: The build process is skipped completely. All you have to do is download the wikis
+
+
+ Simpler: The wikis are pre-compiled HTML, so you don't have to set-up Wikidata or other pre-requisites. Since the wiki is just being downloaded, not built, there are less things that can go wrong
+
+
+ Less recent: The wikis need to be manually generated and uploaded by me. If you find that the wikis below are out of date, you can create an issue at github.org or try building them yourself.
+
+
+
+ Build wikis using the database dumps at wikimedia.org
+
+
+
+ Slower: It takes an extra few hours to build the wiki
+
+
+ Slightly harder: These wikis work best with Wikidata on your machine. See App/Wiki types/Wikidata. In additon, the build process may not work on certain low-end machines like Raspberry Pi
+
+ In the Available table, add any of the following task names
+
+
+
+
+
+
+ Italiano Wikipedia - Articles (2016-12) [8.39 GB]
+
+
+
+
+
+
+
+
+ Italiano Wikipedia - Images (2016-12) [23.53 GB]
+
+
+
+
+
+
+
+
+ Italiano Wiktionary - Articles (2016-12) [517.24 MB]
+
+
+
+
+
+
+
+
+ Italiano Wiktionary - Images (2016-12) [121.34 MB]
+
+
+
+
+
+
+
+
+ Italiano Wikisource - Articles (2016-12) [889.2 MB]
+
+
+
+
+
+
+
+
+ Italiano Wikisource - Images (2016-12) [674.26 MB]
+
+
+
+
+
+
+
+
+ Italiano Wikivoyage - Articles (2016-12) [43.94 MB]
+
+
+
+
+
+
+
+
+ Italiano Wikivoyage - Images (2016-12) [2.74 GB]
+
+
+
+
+
+
+
+
+ Italiano Wikiquote - Articles (2016-12) [109.67 MB]
+
+
+
+
+
+
+
+
+ Italiano Wikiquote - Images (2016-12) [256.57 MB]
+
+
+
+
+
+
+
+
+ Italiano Wikibooks - Articles (2016-12) [68.82 MB]
+
+
+
+
+
+
+
+
+ Italiano Wikibooks - Images (2016-12) [371.55 MB]
+
+
+
+
+
+
+
+
+ Italiano Wikiversity - Articles (2016-12) [23.50 MB]
+
+
+
+
+
+
+
+
+ Italiano Wikiversity - Images (2016-12) [75.16 MB]
+
+
+
+
+
+
+
+
+ Italiano Wikinews - Articles (2016-12) [58.41 MB]
+
+
+
+
+
+
+
+
+ Italiano Wikinews - Images (2016-12) [76.60 MB]
+
+
+
+
+
+
+ In the Queue table, click the Play button
+
+
+ Wait for the Queue to process. When it is done, enter the wiki URL in the bar. For example, it.wikipedia.org
+
+
+
+ Manual
+
+
+
+ Download the urls below. Note that they are listed in two formats:
+
+
+ Urls by wiki / type: In case you want only one wiki (wiktionary) or one type (articles)
+
+
+ All urls (for copying into a download manager)
+
+
+
+
+ Unzip them and move the .xowa file to the proper wiki directory. For example, for it.wikipedia.org, move the files to C:\xowa\wiki\it.wikipedia.org
+
+
+ Start XOWA and enter the wiki URL in the bar. For example, it.wikipedia.org
+
+
+
+ Build wikis using the database dumps at wikimedia.org
+
+
+
\ No newline at end of file
diff --git a/home/wiki/Wiki_setup/Listing.html b/home/wiki/Wiki_setup/Listing.html
index d112a82dd..d487b7d65 100644
--- a/home/wiki/Wiki_setup/Listing.html
+++ b/home/wiki/Wiki_setup/Listing.html
@@ -43,19 +43,25 @@
Wiki setup/Spanish wikis
Find your wiki in the list
diff --git a/home/wiki/Wiki_setup/Russian_wikis.html b/home/wiki/Wiki_setup/Russian_wikis.html
index 438caea4d..037ab4a69 100644
--- a/home/wiki/Wiki_setup/Russian_wikis.html
+++ b/home/wiki/Wiki_setup/Russian_wikis.html
@@ -388,7 +388,7 @@
Find your wiki in the list
diff --git a/home/wiki/Wiki_setup/Simple_wikis.html b/home/wiki/Wiki_setup/Simple_wikis.html
index 2e0283917..e30c7dcdb 100644
--- a/home/wiki/Wiki_setup/Simple_wikis.html
+++ b/home/wiki/Wiki_setup/Simple_wikis.html
@@ -185,7 +185,7 @@
Find your wiki in the list
diff --git a/home/wiki/Wiki_setup/Spanish_wikis.html b/home/wiki/Wiki_setup/Spanish_wikis.html
index 53025afa8..ff6cf023a 100644
--- a/home/wiki/Wiki_setup/Spanish_wikis.html
+++ b/home/wiki/Wiki_setup/Spanish_wikis.html
@@ -388,7 +388,7 @@
Find your wiki in the list
diff --git a/home/wiki/Wiki_setup/Swahili_wikis.html b/home/wiki/Wiki_setup/Swahili_wikis.html
new file mode 100644
index 000000000..975f387b0
--- /dev/null
+++ b/home/wiki/Wiki_setup/Swahili_wikis.html
@@ -0,0 +1,477 @@
+
+
+
+
+ Wiki setup/Swahili wikis - XOWA
+
+
+
+
+
+
+
+
+
Wiki setup/Swahili wikis
+
+
From XOWA: the free, open-source, offline wiki application
+
+
+
+
+ Overview
+
+
+ This page describes how to set up Swahili wikis on your machine. The following two options are available:
+
+
+ Download pre-built wikis from archive.org
+
+
+
+ Faster: The build process is skipped completely. All you have to do is download the wikis
+
+
+ Simpler: The wikis are pre-compiled HTML, so you don't have to set-up Wikidata or other pre-requisites. Since the wiki is just being downloaded, not built, there are less things that can go wrong
+
+
+ Less recent: The wikis need to be manually generated and uploaded by me. If you find that the wikis below are out of date, you can create an issue at github.org or try building them yourself.
+
+
+
+ Build wikis using the database dumps at wikimedia.org
+
+
+
+ Slower: It takes an extra few hours to build the wiki
+
+
+ Slightly harder: These wikis work best with Wikidata on your machine. See App/Wiki types/Wikidata. In additon, the build process may not work on certain low-end machines like Raspberry Pi
+
+ Wait for the Queue to process. When it is done, enter the wiki URL in the bar. For example, sw.wikipedia.org
+
+
+
+ Manual
+
+
+
+ Download the urls below. Note that they are listed in two formats:
+
+
+ Urls by wiki / type: In case you want only one wiki (wiktionary) or one type (articles)
+
+
+ All urls (for copying into a download manager)
+
+
+
+
+ Unzip them and move the .xowa file to the proper wiki directory. For example, for sw.wikipedia.org, move the files to C:\xowa\wiki\sw.wikipedia.org
+
+
+ Start XOWA and enter the wiki URL in the bar. For example, sw.wikipedia.org
+
+
+
+ Build wikis using the database dumps at wikimedia.org
+
+
+
\ No newline at end of file
diff --git a/home/wiki/Wiki_setup/Swedish_wikis.html b/home/wiki/Wiki_setup/Swedish_wikis.html
index 368ffbd2e..367802864 100644
--- a/home/wiki/Wiki_setup/Swedish_wikis.html
+++ b/home/wiki/Wiki_setup/Swedish_wikis.html
@@ -388,7 +388,7 @@