Difference between revisions of "MediaWiki/archive/customizing"

Latest revision as of 00:35, 15 December 2017

Navigation

{{#lst:MediaWiki|navbar}}: customization

Links

MediaWiki Customization at mediawiki.org

Articles

extensions: custom coding using MW's built-in extensibility
user-group security

Managed Customization

MediaWiki will include the contents of mediawiki:Common.css, if found, in the CSS code it uses for defining the appearance of its pages. (The initial character in "Common" does not seem to be case-sensitive, even if the site has the initial-caps flag turned off.)

Code Notes

(From Woozle 20:59, 15 Jun 2005 (CDT). Eventually to be given their own section, I expect.)

Everything obviously starts with index.php.
For the purpose of displaying a page (not saving changes or doing anything else), this calls $wgArticle->view(), in Article.php (line 699)
$wgArticle->view() appears to be able to provide a few other formats besides the regular view (including difference engine and displaying redirections as subtitles), but I'm ignoring that for now
$wgOut seems to be the object which accumulates text to be output, via various methods:
- $wgOut->addWikiText(...)
- $wgOut->addHTML(...)
- $wgOut->addPrimaryWikiText() # Display content and save to parser cache
- $wgOut->addWikiText() # Display content, don't attempt to save to parser cache
- $wgOut->setPageTitle()
- $wgOut->transformBuffer(); # Put link titles into the link cache
- $wgOut->addMetaTags(); # Add link titles as META keywords
...and then it does these two lines:
- $this->viewUpdates(); (found at line 1926 -- doesn't do much)
- wfProfileOut( $fname );
It's not clear whether the navbar has already been pulled in by the time we hit viewUpdates -- possibly transformBuffer does it? The comment makes it sound like that, but the name "transformBuffer" in that case is not very descriptive. The code in there should probably be examined.

@@ Line 1: / Line 1: @@
-[[Techniques]]:
+==Navigation==
-Software: [[MediaWiki]]: [[MediaWiki:Customization|Customization]]
+<section begin=navbar />{{#lst:MediaWiki|navbar}}: [[MediaWiki customization|customization]]<section end=navbar />
-===Modifying the Menus===
-The text which shows up in the menu bar (at left in monobook) may be
+==Links==
-edited through the wiki itself. What you need to know is the name for
+* [http://www.mediawiki.org/wiki/Customization MediaWiki Customization] at mediawiki.org
-each link. To edit the contents, you navigate to the page named
+==Articles==
-'''MediaWiki:''linkname'''''. You will need to be a sysop in order to
+* [[/menus]]
-edit the text. To get a list of links and other text which can be
+* [[/new navbox]]
-customized, go to [[Special:Allpages]] (on the wiki in question),
+* [[/new Special page]]
-select "MediaWiki" from the "namespaces" drop-down, and press "Go".
+* [[/outward-looking]]
+* [[/searchbox]]
+* [[/URLs]]
+Related:
+* {{l/same|extensions}}: custom coding using MW's built-in extensibility
+* {{l/same|user-group security}}
+==Managed Customization==
+MediaWiki will include the contents of [[mediawiki:Common.css]], if found, in the CSS code it uses for defining the appearance of its pages. (The initial character in "Common" does not seem to be case-sensitive, even if the site has the initial-caps flag turned off.)
+==Code Notes==
+''(From [[User:Woozle|Woozle]] 20:59, 15 Jun 2005 (CDT). Eventually to be given their own section, I expect.)''
+*Everything obviously starts with [[MediaWiki/files/index.php|index.php]].
+*For the purpose of displaying a page (not saving changes or doing anything else), this calls $wgArticle->view(), in [[MediaWiki/files/Article.php|Article.php]] (line 699)
+*$wgArticle->view() appears to be able to provide a few other formats besides the regular view (including difference engine and displaying redirections as subtitles), but I'm ignoring that for now
+*$wgOut seems to be the object which accumulates text to be output, via various methods:
+**$wgOut->addWikiText(...)
+**$wgOut->addHTML(...)
+**$wgOut->addPrimaryWikiText() # Display content and save to parser cache
+**$wgOut->addWikiText() # Display content, don't attempt to save to parser cache
+**$wgOut->setPageTitle()
+**$wgOut->transformBuffer(); # Put link titles into the link cache
+**$wgOut->addMetaTags(); # Add link titles as META keywords
+*...and then it does these two lines:
+**$this->viewUpdates(); ''(found at line 1926 -- doesn't do much)''
+**wfProfileOut( $fname );
+*It's not clear whether the navbar has already been pulled in by the time we hit viewUpdates -- possibly transformBuffer does it? The comment makes it sound like that, but the name "transformBuffer" in that case is not very descriptive. The code in there should probably be examined.