Difference between revisions of "The Wiki"
m |
(→Cirrus Search: add link to search manual and give an example of a filtered search) |
||
| (9 intermediate revisions by 4 users not shown) | |||
| Line 16: | Line 16: | ||
* [[How to write a vote]] | * [[How to write a vote]] | ||
* [[Wiki Editing]] | * [[Wiki Editing]] | ||
| + | |||
| + | == Equipment Labels == | ||
| + | |||
| + | https://wiki.pumpingstationone.org/Template:EquipmentPage | ||
== Extra Features == | == Extra Features == | ||
| Line 23: | Line 27: | ||
The [[user:wikibot]] makes [[Special:Contributions/Wikibot | edits]] to the wiki automatically, making simple cleanups and doing link verification. It's running based off the Pywikibot software. | The [[user:wikibot]] makes [[Special:Contributions/Wikibot | edits]] to the wiki automatically, making simple cleanups and doing link verification. It's running based off the Pywikibot software. | ||
| − | === | + | === Cirrus Search === |
| + | |||
| + | The default search in mediawiki does exact matching, but doesn't to lexicographical searches. We have [https://www.mediawiki.org/wiki/Extension:CirrusSearch Cirrus Search] installed, along with indexing daemons that run nightly on the mediawiki server. | ||
| − | + | Cirrus Search has a very detailed [https://www.mediawiki.org/wiki/Help:CirrusSearch manual]. You may be interested in the [https://www.mediawiki.org/wiki/Help:CirrusSearch#Filters filtering] section. It explains how to search in only a set of pages. For example, typing ''-intitle:Meeting foo'' in to the search bar will search for ''foo'' in all the pages except for ones with ''Meeting'' in the title. | |
=== Visual Editor === | === Visual Editor === | ||
| Line 31: | Line 37: | ||
The [http://www.mediawiki.org/wiki/VisualEditor Visual Editor] Is a feature Media Wiki has been working on for a while, but still isn't perfect. Most notably it breaks pretty hard on Equipment Pages. | The [http://www.mediawiki.org/wiki/VisualEditor Visual Editor] Is a feature Media Wiki has been working on for a while, but still isn't perfect. Most notably it breaks pretty hard on Equipment Pages. | ||
| − | + | The [http://www.mediawiki.org/wiki/Parsoid parsoid daemon] is currently offline | |
== Technical == | == Technical == | ||
| Line 41: | Line 47: | ||
* Nightly dumps are publicly available: [https://wiki.pumpingstationone.org/dumps/ PS1 Wiki Dumps] | * Nightly dumps are publicly available: [https://wiki.pumpingstationone.org/dumps/ PS1 Wiki Dumps] | ||
* [[Upgrading Mediawiki]] | * [[Upgrading Mediawiki]] | ||
| + | |||
| + | === LDAP Authentication === | ||
| + | |||
| + | The LdapAuthentication plugin hasn't had a real update since 2012. I needed to make this change: https://www.mediawiki.org/w/index.php?title=Topic:Sl9i17el9a1g9tv1&topic_showPostId=sm0okbrd7fjrprxb#flow-post-sm0okbrd7fjrprxb to get the plugin to work again. | ||
| + | |||
| + | === Mediawiki Job Queue === | ||
| + | |||
| + | The mediawiki [https://www.mediawiki.org/wiki/Manual:Job_queue Job Queue] handles things like propagating template changes, link changes, search changes, etc. These operations can be slow, and the wiku runs 1 job per pageload. There is also a systemd timer that clears the job queue during off peak hours. | ||
| + | |||
| + | === Page Caching === | ||
| + | |||
| + | We have a few types of cacheing enabled in mediawiki. We have APC object and ond opcode cacheing enabled. | ||
| + | |||
| + | We also have a mediawiki file cacheing enabled. The file cache only takes affect for non logged in users, and non special pages. | ||
| + | |||
| + | === Troubleshooting Common Issues === | ||
| + | * '''"Wiki uses cookies to log in users. You have cookies disabled. Please enable them and try again."''' This issue seems to appear randomly every once in a while, even if users have cookies enabled in their browsers, they still can't login (and basically no one can login or edit any pages at that point). We're not sure what the root cause is yet, but [http://stackoverflow.com/questions/16127882/how-can-i-fix-the-mediawiki-error-wiki-uses-cookies-to-log-in-users-you-have-c this StackOverflow answer] points to some potential solutions. | ||
| + | ** If you want to get it working right now, just SSH into wiki.ad.pumpingstationone.org as root and run <code>systemctl restart php-fpm</code> to just restart mediawiki. Generally, that gets things working properly again, at least for a little while. | ||
== Allowed File types == | == Allowed File types == | ||
| Line 47: | Line 71: | ||
Find the $wgFileExtensions variable and make whatever changes you see fit. | Find the $wgFileExtensions variable and make whatever changes you see fit. | ||
| + | |||
| + | [[Category:WikiGnomes]] | ||
Latest revision as of 15:58, 18 July 2017
What is the wiki
A wiki a collaborative editing environment that all PS:One member's have access to.
We use it for
- Votes/Vote proposals
- Meeting Agendas/ Meeting Notes
- Recording Policies
- Hosting the Bylaws
- Note Taking
- Systems Documentation
Wiki Usage Guides
Equipment Labels
https://wiki.pumpingstationone.org/Template:EquipmentPage
Extra Features
WikiBot
The user:wikibot makes edits to the wiki automatically, making simple cleanups and doing link verification. It's running based off the Pywikibot software.
Cirrus Search
The default search in mediawiki does exact matching, but doesn't to lexicographical searches. We have Cirrus Search installed, along with indexing daemons that run nightly on the mediawiki server.
Cirrus Search has a very detailed manual. You may be interested in the filtering section. It explains how to search in only a set of pages. For example, typing -intitle:Meeting foo in to the search bar will search for foo in all the pages except for ones with Meeting in the title.
Visual Editor
The Visual Editor Is a feature Media Wiki has been working on for a while, but still isn't perfect. Most notably it breaks pretty hard on Equipment Pages.
The parsoid daemon is currently offline
Technical
The wiki is running MediaWiki's wiki software, the same as WikiPedia, along with some 3rd party extensions.
- Hosted at https://wiki.pumpingstationone.org
- The wiki lives on wiki.ad.pumpingstationone.org under
/srv/http/wiki.pumpingstationone.org/. - Nightly dumps are publicly available: PS1 Wiki Dumps
- Upgrading Mediawiki
LDAP Authentication
The LdapAuthentication plugin hasn't had a real update since 2012. I needed to make this change: https://www.mediawiki.org/w/index.php?title=Topic:Sl9i17el9a1g9tv1&topic_showPostId=sm0okbrd7fjrprxb#flow-post-sm0okbrd7fjrprxb to get the plugin to work again.
Mediawiki Job Queue
The mediawiki Job Queue handles things like propagating template changes, link changes, search changes, etc. These operations can be slow, and the wiku runs 1 job per pageload. There is also a systemd timer that clears the job queue during off peak hours.
Page Caching
We have a few types of cacheing enabled in mediawiki. We have APC object and ond opcode cacheing enabled.
We also have a mediawiki file cacheing enabled. The file cache only takes affect for non logged in users, and non special pages.
Troubleshooting Common Issues
- "Wiki uses cookies to log in users. You have cookies disabled. Please enable them and try again." This issue seems to appear randomly every once in a while, even if users have cookies enabled in their browsers, they still can't login (and basically no one can login or edit any pages at that point). We're not sure what the root cause is yet, but this StackOverflow answer points to some potential solutions.
- If you want to get it working right now, just SSH into wiki.ad.pumpingstationone.org as root and run
systemctl restart php-fpmto just restart mediawiki. Generally, that gets things working properly again, at least for a little while.
- If you want to get it working right now, just SSH into wiki.ad.pumpingstationone.org as root and run
Allowed File types
log in to wiki.ad.pumpingstationone.org and edit /srv/http/wiki.pumpingstationone.org/LocalSettings.php
Find the $wgFileExtensions variable and make whatever changes you see fit.