Differences

This shows you the differences between two versions of the page.

--- tool:software:mediawiki [2020/08/04 21:46] – [Skins] Added notes on various skins rjt
+++ mediawiki [2024/05/20 20:51] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
 ====== MediaWIki ======
-===== Theming =====
+===== Using =====
+Notes from a regular user's perspective.
+==== Signature ====
+<code>&mdash;[[User:Rylie_James_Thomas|rjt]]&nbsp;([[User_talk:Rylie_James_Thomas|talk]])</code>
+<code>—&nbsp;[[User:Rjt|rjt]]&nbsp;([[User_talk:Rjt|talk]])</code>
+==== See Also ====
+  * https://en.wikipedia.org/wiki/Help:Searching#Search_string_syntax
+===== Running =====
+Note's from an admin's perspective.
+==== Setup ====
+  * https://www.mediawiki.org/wiki/Manual:$wgAllowDisplayTitle
+  * https://www.mediawiki.org/wiki/Manual:$wgCategoryMagicGallery
+=== Interwiki ===
+Like [[Dokuwiki]], Mediawiki has a dedicated syntax for interwiki links. Practically, they're a quick way to link to other sites, so useful for one's you link to often.
+  * https://www.mediawiki.org/wiki/Extension:Interwiki
+  * https://www.mediawiki.org/wiki/Manual:Interwiki
+  * https://www.mediawiki.org/wiki/Manual:Guide_to_setting_up_interwiki_linking
+The easiest way to add links is to use the included Interwiki extension, which requires a little manual setup: Just add these lines to your LocalSettings.php file
+<code php>
+wfLoadExtension( 'Interwiki' );
+$wgGroupPermissions['sysop']['interwiki'] = true;
+</code>
+If you want to add little icons before/after links like in Dokuwiki, you can use the [[CSS]] '':before'' or '':after''
+=== Search ===
+The default Mediawiki search is pretty shit. Autocomplete doesn't work unless you get the page name right (including case), and it seems to miss stuff in the results page.
+  * https://www.mediawiki.org/wiki/Category:Search_extensions
+  * Wikipedia uses: [[ https://www.mediawiki.org/wiki/Extension:CirrusSearch|CirrusSearch]], which makes use of Elasticsearch.
+  * https://www.mediawiki.org/wiki/Extension:SearchExtraNS
+==== Templates ====
+Templates are a really useful tool for inserting information on multiple pages. They can be simple---like insert a single word; or complex---like the 'infoboxes' you see on [[Wikipedia]] pages, and even using conditional statements.
+  * https://www.mediawiki.org/wiki/Help:Templates/en
+  * https://www.mediawiki.org/wiki/Transclusion
+  * https://template.miraheze.org/wiki/Miraheze_Template_Wiki
+To save people the hassle of having to copy+paste the template text each time, you can add a button to the editor:
+  * https://www.mediawiki.org/wiki/Extension:InsertTemplate
+And include 'template data' into your templates so they'll show up.
+  * https://www.mediawiki.org/wiki/Extension:TemplateData
+=== Infobox ===
+==== Theming ====
 There are a few different ways to theme MediaWiki.
   * The most complex is to create a //skin//. This is the base that determines the appearance of the wiki.
   * Next is a //theme//. Themes are applied on top of skins, and a theme will rely on a particular skin. They change less, but can still do a lot.
-  * The other option is to just insert a little bit of custom CSS for basic changes; chanign text properties and such.
+  * The other option is to add CSS rules directly to the page ''MediaWiki:Common.css'', which will apply to all skins and themes, and ''MediaWiki:[theme].css'' if you want to limit it to a particular theme.
-I've made one basic theme for the Game Making Tools Wiki, which works with the [[git>wikimedia/mediawiki-skins-Vector|Vector]] skin, but would like to work on a fresh skin with nice, clear, basic markup :)
+My theme for the [[game_making_tools#Wiki|Game Making Tools Wiki]] is built on top of the Timeless skin. [[tildegit>rjt/mediawiki-theme-timeless-gmt]]. For some reason on this wiki theme's don't work, so I use the ''Common.css'' file :/
-==== Skins ====
+My theme for the [[videogame_interface_wiki]] is built on <del>the new Vector 2022 skin, but it's arse and breaks often. I'm going to switch to</del> Timeless <del>for that one</del> too.
-Mediawiki skins are way too complicated, I think I've given up on ever creating one. The best option seems to be creating //themes//, which are used to modify //skins//.
-Looking for Mediawiki skins is annoying! MediaWiki's wiki has [[https://www.mediawiki.org/wiki/Category:All_skins a section that collects some together]], but there's no gallery of screenshots.
+=== Skins ===
-=== Notes ===
+Mediawiki skins are way too complicated, I think I've given up on ever creating one.
-With a bias towards finding a new skin for [[project:game_making_tools]]'s wiki. Looking for something with a narrower reading area((default skins expand to fill width of the browser window, and are fiddlier than they should be to fix)), produces nice markup, and uses ''grid''.
+Just looking for Mediawiki skins is annoying! MediaWiki's wiki has [[https://www.mediawiki.org/wiki/Category:All_skins|a section that collects some together]], but there's no gallery of screenshots.
+== Notes ==
+These notes are from when I was looking for a new skin for [[Game Making Tools]]'s wiki (ended up going with Timeless). Looking for something with a narrower reading area((default skins expand to fill width of the browser window, and are fiddlier than they should be to fix)), produces nice markup, and uses ''grid''.
   * [[https://www.mediawiki.org/wiki/Skin:Timeless|Timeless]] - I like that the search input in prominent, responsive, already included with MediaWiki (have to activate), narrower content section, I have themed this in the past.\\ NB: [[https://www.mediawiki.org/wiki/Skin:Timeless-DarkCSS|Dark version]]
@@ Line 24: / Line 94: @@
   * [[https://www.mediawiki.org/wiki/Skin:Nostalgia|Nostalgia]] - Like earlier wiki engines.
   * [[https://www.mediawiki.org/wiki/Skin:Pivot|Pivot]] - Could be a good base for themeing.
+  * [[https://www.mediawiki.org/wiki/Skin:Foreground|Foreground]] - Another one that might be a good fit. Not so keen on not having sidebar/s.((This is the innocuous-looking line that's making this {{tagpage>external-edit-only}}))
-== Vetoed ==
+Vetoed:
   * [[https://www.mediawiki.org/wiki/Skin:Tweeki|Tweeki]] - Bootstrap.
@@ Line 33: / Line 104: @@
-=== See Also ===
+== See Also ==
   * https://www.mediawiki.org/wiki/Manual:Skinning_Part_1
   * [[https://wikiapiary.com/wiki/Skin:Skins|Skins]] section on Wikiapiary. Data on skin usage across different Mediawiki wikis.
-===== Extensions =====
+=== Themes ===
+The documentation on using themes is terrible: https://www.mediawiki.org/wiki/Extension:Theme
+Here's what you need to do:
+In ''LocalSettings.php'' set:
+  * ''wfLoadExtension( 'Theme' );''
+  * ''$wgDefaultTheme = [theme];''
+In ''extensions/Theme/extension.json'' you need two sections, which you probably have to create:
+<code json>
+"ThemeModules": {
+	"[skin]": [ "[theme]" ]
+},
+</code>
+and in the resourcemodules section:
+<code json>
+"themeloader.skins.[skin].[theme]": {
+	"styles": {
+		"[skin]/[theme]/[theme].css": {
+			"media": "screen"
+		}
+	}
+}
+</code>
+The path/file in the 'styles' bit points to your CSS file.
+When you refer to your skin in these files use lowercase.
+==== Extensions ====
   * https://www.mediawiki.org/wiki/Extension:CategoryTree
   * https://www.mediawiki.org/wiki/Extension:SyntaxHighlight
@@ Line 45: / Line 151: @@
   * https://www.mediawiki.org/wiki/Extension:MsCatSelect
   * https://www.mediawiki.org/wiki/Extension:OpenID
+  * https://www.mediawiki.org/wiki/Extension:Tabs
+  * https://www.mediawiki.org/wiki/Extension:ArticleCreationWorkflow
+  * https://www.mediawiki.org/wiki/Extension:3D
+  * https://www.mediawiki.org/wiki/Extension:Page_Forms
-===== See Also =====
+===== See Also ====
   * [[https://www.mediawiki.org/|mediawiki.org]]
-{{tag>wiki theming}}
+{{tag>external-edit-only theming wiki}}