MediaWiki:Common: Difference between revisions
Jump to navigation
Jump to search
(→Common.css: forgot to update this for the icon customizations and BSL popups) |
m (let's just use links to real files so we don't need to tell ValExtLinks to ignore the link errors) |
||
(13 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
The purpose of [[MediaWiki:Common.css]] and [[MediaWiki:Common.js]] is to augment the MediaWiki CSS and JS code in a way that is effective for all users. Note that changes to [[MediaWiki:Vector.css]] and [[MediaWiki:Vector.js]] override these general changes for anyone using the default Vector skin. On top of ''that'' come any changes made to users' local vector.css and vector.js pages. | The purpose of [[MediaWiki:Common.css]] and [[MediaWiki:Common.js]] is to augment the MediaWiki CSS and JS code in a way that is effective for all users. Note that changes to [[MediaWiki:Vector.css]] and [[MediaWiki:Vector.js]] override these general changes for anyone using the default Vector skin. On top of ''that'' come any changes made to users' local vector.css and vector.js pages. | ||
Following are all the features of the CSS and JS pages in the order in which they occur. | |||
==Common.css== | ==Common.css== | ||
*Common.css mainly contains fixes for annoying glitches in MediaWiki's appearance or behavior, and minor style tweaks (these are all more or less borrowed from Wikipedia). | *Common.css mainly contains fixes for annoying glitches in MediaWiki's appearance or behavior, and minor style tweaks (these are all more or less borrowed from Wikipedia). | ||
* | *In amidst those are various classes declared for message box templates such as [[Template:Fmbox]] and [[Template:Divhide]]. | ||
*There are also classes set up for use by TOC (table of contents) mods such as [[Template:TOCnonum]] and [[Template:TOClimit]]. | |||
* | |||
* | *Also in this medley of tweaks is a modified fix brought over from WP for the annoyingly small font size that MediaWiki uses for monospaced text with the <nowiki><code>, <tt>, and <pre></nowiki> tags. | ||
*Next are several icon customizations: | *Next are several icon customizations: | ||
**A custom [http://www.example.com external link arrow] | **A custom [http://www.example.com external link arrow] replaces the default one ([[Image:MediaWiki default external link icon.png]]); the box element has been removed, making it visually less cluttered and easier to read. | ||
**External links which use HTTPS are modified to use the [ | **External links which use HTTPS are modified to use the [https://www.example.com same arrow] as HTTP links instead of the distracting and unnecessary padlock icon. | ||
**Interwiki links get a [[ | **External links to other subdomains on Oni2.net get a [http://iritscen.oni2.net sideways arrow]. | ||
**External links that specifically go to movie files get a [http://geyser.oni2.net/genesis/E3_1998/Oni_Trailer_(E3_1998).mov movie icon]. | |||
**External links that specifically go to sound files get a [http://geyser.oni2.net/oni1/music/09-Ambient_Suite.mp3 sound icon]. | |||
**Interwiki links get a [[wp:Green_Arrow|green arrow]] to show that they point to a fellow wiki (by default MediaWiki shows no outbound arrow at all for interwiki links, ambushing the reader with a site change when they click it). | |||
**Links formatted as if they're external, but which point back to this wiki, get a looping arrow [http://wiki.oni2.net/Main_Page like this]. | **Links formatted as if they're external, but which point back to this wiki, get a looping arrow [http://wiki.oni2.net/Main_Page like this]. | ||
* | *Lastly, two classes are provided for use by [[Template:Hover]] in providing popup text/images behind page text. | ||
==Common.js== | ==Common.js== | ||
*Common.js allows for a user to add an "&withJS=MediaWiki:__.js" to a URL in order to view that page with a custom JS file that normally does not load for you (untested, so this documentation may be incorrect). | *Common.js allows for a user to add an "&withJS=MediaWiki:__.js" to a URL in order to view that page with a custom JS file that normally does not load for you (untested, so this documentation may be incorrect). | ||
* | *When someone visits the Main Page, the browser is told to focus on the go/search box so that the user can immediately start typing a search term or page name. | ||
* | *If the user is on the advanced search page, [[MediaWiki:Common.js/search.js]] is imported in order to modify the page. It adds a dropdown menu that lets you pick another search engine in place of the barely useable built-in one. | ||
* | *Various fixes for Internet Explorer (long obsolete). | ||
* | *Support for hover tables, a half-finished feature. A hover table can display a description of whichever cell is pointed to. The feature is demonstrated in its unfinished state [[User:Iritscen/HoverTableDemo|here]]. | ||
*Next is an even more unfinished feature called hover GIFs, which are GIFs that only animate when hovered over. | *Next is an even more unfinished feature called hover GIFs, which are GIFs that only animate when hovered over. This is accomplished by swapping between a still image and a GIF. However, this method does not work as currently coded because it merely changes the suffix of an image between .gif and .jpg; since images are stored in various unpredictable sub-directories on the server, the entire path for both images would need to be hardcoded in order to perform a successful swap. These paths could be supplied using an approach similar to the hover table class "hovertable_descrip" if one was determined to make this feature work. | ||
*The | *The NavFrame class from Common.css is used to create the collapsible tables upon which [[Template:Divhide|divhide]] boxes are built. | ||
* A function called ModifySidebar() is made available for customizing the items listed in the sections on the left of all wiki pages. See Iritscen's [[User:Iritscen/vector.js|custom JS page]] for a sample usage. | * A function called ModifySidebar() is made available for customizing the items listed in the sections on the left of all wiki pages. See Iritscen's [[User:Iritscen/vector.js|custom JS page]] for a sample usage. | ||
** Parameter 1: The string "add", "remove", or "sep" (which adds a separator line, however the line is currently not displaying for some reason). | ** Parameter 1: The string "add", "remove", or "sep" (which adds a separator line, however the line is currently not displaying for some reason). | ||
** Parameter 2: The name of the section | ** Parameter 2: The name of the section: "navigation", "languages" (not displayed on this wiki), or "toolbox". | ||
** Parameter 3: The display name of the URL you will be adding. | ** Parameter 3: The display name of the URL you will be adding. | ||
** Parameter 4: The full URL of the wiki page to add (this should allow | ** Parameter 4: The full URL of the wiki page to add (this should allow external links as well). | ||
*Next are an untested fix for table sorting and a tweak to the Upload page for unregistered users (does this do anything?). | *Next are an untested fix for table sorting and a tweak to the Upload page for unregistered users (does this do anything?). | ||
*Finally, there is code to allow | *Finally, there is code to allow tables to automatically sort themselves by a given column when the page is loaded. This is utilized in several places on the wiki. To make an autosort table, first the table must be declared with the class "wikitable". Next, as part of the same class declaration, you must also add in "sortable" to enable MediaWiki's built-in sortable column feature. Finally add the third class "autosort" to trigger this feature. By default, the table will be sorted by column 1, but you can specify another column by declaring a fourth class for the table called "by-column-''x''", where 'x' is a number from 1 to 9. See [[Oni 2 (Angel Studios)/Levels]] for a sample usage of this feature. | ||
[[Category:Policies and documentation]] | [[Category:Policies and documentation]] |
Latest revision as of 14:47, 24 March 2024
The purpose of MediaWiki:Common.css and MediaWiki:Common.js is to augment the MediaWiki CSS and JS code in a way that is effective for all users. Note that changes to MediaWiki:Vector.css and MediaWiki:Vector.js override these general changes for anyone using the default Vector skin. On top of that come any changes made to users' local vector.css and vector.js pages.
Following are all the features of the CSS and JS pages in the order in which they occur.
Common.css
- Common.css mainly contains fixes for annoying glitches in MediaWiki's appearance or behavior, and minor style tweaks (these are all more or less borrowed from Wikipedia).
- In amidst those are various classes declared for message box templates such as Template:Fmbox and Template:Divhide.
- There are also classes set up for use by TOC (table of contents) mods such as Template:TOCnonum and Template:TOClimit.
- Also in this medley of tweaks is a modified fix brought over from WP for the annoyingly small font size that MediaWiki uses for monospaced text with the <code>, <tt>, and <pre> tags.
- Next are several icon customizations:
- A custom external link arrow replaces the default one (); the box element has been removed, making it visually less cluttered and easier to read.
- External links which use HTTPS are modified to use the same arrow as HTTP links instead of the distracting and unnecessary padlock icon.
- External links to other subdomains on Oni2.net get a sideways arrow.
- External links that specifically go to movie files get a movie icon.
- External links that specifically go to sound files get a sound icon.
- Interwiki links get a green arrow to show that they point to a fellow wiki (by default MediaWiki shows no outbound arrow at all for interwiki links, ambushing the reader with a site change when they click it).
- Links formatted as if they're external, but which point back to this wiki, get a looping arrow like this.
- Lastly, two classes are provided for use by Template:Hover in providing popup text/images behind page text.
Common.js
- Common.js allows for a user to add an "&withJS=MediaWiki:__.js" to a URL in order to view that page with a custom JS file that normally does not load for you (untested, so this documentation may be incorrect).
- When someone visits the Main Page, the browser is told to focus on the go/search box so that the user can immediately start typing a search term or page name.
- If the user is on the advanced search page, MediaWiki:Common.js/search.js is imported in order to modify the page. It adds a dropdown menu that lets you pick another search engine in place of the barely useable built-in one.
- Various fixes for Internet Explorer (long obsolete).
- Support for hover tables, a half-finished feature. A hover table can display a description of whichever cell is pointed to. The feature is demonstrated in its unfinished state here.
- Next is an even more unfinished feature called hover GIFs, which are GIFs that only animate when hovered over. This is accomplished by swapping between a still image and a GIF. However, this method does not work as currently coded because it merely changes the suffix of an image between .gif and .jpg; since images are stored in various unpredictable sub-directories on the server, the entire path for both images would need to be hardcoded in order to perform a successful swap. These paths could be supplied using an approach similar to the hover table class "hovertable_descrip" if one was determined to make this feature work.
- The NavFrame class from Common.css is used to create the collapsible tables upon which divhide boxes are built.
- A function called ModifySidebar() is made available for customizing the items listed in the sections on the left of all wiki pages. See Iritscen's custom JS page for a sample usage.
- Parameter 1: The string "add", "remove", or "sep" (which adds a separator line, however the line is currently not displaying for some reason).
- Parameter 2: The name of the section: "navigation", "languages" (not displayed on this wiki), or "toolbox".
- Parameter 3: The display name of the URL you will be adding.
- Parameter 4: The full URL of the wiki page to add (this should allow external links as well).
- Next are an untested fix for table sorting and a tweak to the Upload page for unregistered users (does this do anything?).
- Finally, there is code to allow tables to automatically sort themselves by a given column when the page is loaded. This is utilized in several places on the wiki. To make an autosort table, first the table must be declared with the class "wikitable". Next, as part of the same class declaration, you must also add in "sortable" to enable MediaWiki's built-in sortable column feature. Finally add the third class "autosort" to trigger this feature. By default, the table will be sorted by column 1, but you can specify another column by declaring a fourth class for the table called "by-column-x", where 'x' is a number from 1 to 9. See Oni 2 (Angel Studios)/Levels for a sample usage of this feature.