Difference between revisions of "MediaWiki/archive/customizing"

from HTYP, the free directory anyone can edit if they can prove to me that they're not a spambot
Jump to navigation Jump to search
(everything?)
 
(41 intermediate revisions by 6 users not shown)
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. A list of link names may be found in Language.php, and
+
* [[/new navbox]]
possibly elsewhere.
+
* [[/new Special page]]
 +
* [[/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.

Latest revision as of 00:35, 15 December 2017

Navigation

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

Links

Articles

Related:

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.