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 />
-==Modifications==
-===Modifying the Menus===
+==Links==
-The text which shows up in the menu bar (at left in monobook) may be
+* [http://www.mediawiki.org/wiki/Customization MediaWiki Customization] at mediawiki.org
-edited through the wiki itself. What you need to know is the name for
+==Articles==
-each link. To edit the contents, you navigate to the page named
+* [[/menus]]
-'''MediaWiki:''linkname'''''. You will need to be a sysop in order to
+* [[/new navbox]]
-edit the text. To get a list of links and other text which can be
+* [[/new Special page]]
-customized, go to [[Special:Allpages]] (on the wiki in question),
+* [[/outward-looking]]
-select "MediaWiki" from the "namespaces" drop-down, and press "Go".
+* [[/searchbox]]
-====Questions====
+* [[/URLs]]
-*Where does the text for the corresponding pop-up hint come from, and
-can it be modified?
+Related:
-*Can more links be added to the existing navigation box?
+* {{l/same|extensions}}: custom coding using MW's built-in extensibility
-*How do you add another box? (e.g. to have links back to the site of
+* {{l/same|user-group security}}
-which the wiki is a companion)
+==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
+''(From [[User:Woozle|Woozle]] 20:59, 15 Jun 2005 (CDT). Eventually to be given their own section, I expect.)''
-be given their own section, I expect.)''
+*Everything obviously starts with [[MediaWiki/files/index.php|index.php]].
-*Everything obviously starts with [[MediaWikiDoc: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)
-*For the purpose of displaying a page (not saving changes or doing
+*$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
-anything else), this calls $wgArticle->view(), in
+*$wgOut seems to be the object which accumulates text to be output, via various methods:
-[[MediaWikiDoc: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
+**$wgOut->addPrimaryWikiText() # Display content and save to parser cache
-cache
+**$wgOut->addWikiText() # Display content, don't attempt to 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
@@ Line 40: / Line 34: @@
 **$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
+*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.
-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.