Manual:Interface/Sidebar/zh

MediaWiki:Sidebar定义导航栏，该导航栏提供指向Wiki中最重要位置的链接，并为站点管理员提供了一个添加永久链接集合的位置. 例如，大多数维基将链接到其社群讨论页面和一些有用的工具.

Monobook 和 Vector 皮肤将导航栏与搜索栏和工具箱一起放在左上角（从右到左的语言为右上角），但是该位置可能在其他皮肤上有所不同. 此侧边栏不会向移动站点的用户显示.

自定义侧边栏
要在维基上自定义MediaWiki:Sidebar，您首先要以拥有“编辑用户界面”权限的用户身份登录 - 对管理员来说，该权限已默认被开启. （关于指定用户组或用户权限的信息，参看. ）

然后，使用你的 wiki 上的一个页面链接，但是要把地址栏/URL里你的 wiki 页面标题替换成 （如  ）然后加载那个页面 - 现在你应该看得到侧边栏当前的内容. （如果你使用长 URL，可能需要使用语法 //yourdomain/yourwiki/index.php?title=MediaWiki:Sidebar&action=edit）

如果侧边栏的内容已被修改，只需点击“编辑”或“编辑源代码”链接，否则你可能需要通过点击“创建”或“创建源代码”链接先创建页面.

注意：如果你需要创建一个新页面，编辑时将在编辑器中显示侧边栏的默认内容. 为了成功创建MediaWiki:Sidebar页面，您需要在保存之前更改内容.

以下是一个侧边栏的示例代码：
 * navigation
 * mainpage|Accueil
 * Special:RecentChanges|Recent changes
 * new heading
 * portal-url|Forums
 * https://www.mediawiki.org|MediaWiki home

本示例将产生以下侧边栏：

标题
导航栏可以分为几个部分，每个部分都有自己的标题. 每个部分的标题均取自第一级列表元素（上例中为“导航”和“新标题”）.

如果此文本与接口消息的名称（MediaWiki名称空间中该标题的现有页面）相对应，则该页面的文本用作标签； 否则，标题标题按原样使用.

为确保使用国际化版本，可以使用

** randompage-url|

链接
二级列表元素是链接（在上面的示例中为"mainpage|mainpage"），其格式为： ** target|link text


 * target
 * The link target can be the name of an interface message (page in the MediaWiki namespace) or wiki page, or an external link. In either case, the link can be internal, interwiki, or external. In some cases (such as links with the "&" character), an interface message is necessary. The link target cannot be made dependent on the interface language set in the preferences.


 * Algorithm followed:
 * Get the target text.
 * If there is an existing or default interface message with that name, use the content of that message instead of the target text.
 * If the output from the previous step is a valid URL (beginning with http:// or other URL protocol), the link will point to that URL.
 * Else, it will treat it as the link target of a wikilink (linking to that page name or interwiki).
 * In case it would end up linking to '-', the whole entry is removed from the sidebar (that's useful for removing an entry on all languages by changing the message holding the link).


 * Examples:
 * " " uses the text of MediaWiki:Portal-url (which contains "").
 * " " links to Special:RecentChanges, since there is no interface message of that name.
 * " " links to w:Foo for the same reason.
 * " " links to https://www.mediawiki.org for the same reason.


 * link text
 * The link text can be the name of an interface message (page in the MediaWiki namespace) or plain text.
 * If the link text is the name of an existing or default interface message, the content of that message will be used. MediaWiki will check for localized versions; for example, if the current language is fr (French) and the link text is the interface message "forum", it will check for "forum/fr" before using "forum".
 * Otherwise, the link text is used as the target as-is.
 * Notice that the link text is not optional as in normal wiki links. If the link text is missing, the item is ignored.


 * Examples:
 * uses MediaWiki:Mainpage (which contains "").
 * uses "Recent changes", since there is no interface message of that name.

Order of elements
By default, the sidebar consists of elements in this order: navigation, search, toolbox, languages. The order can be changed (in MediaWiki 1.13+) by adding special keywords (SEARCH, TOOLBOX and LANGUAGES) to MediaWiki:Sidebar using the heading syntax. For example, the following code moves the search box to the top of the sidebar:
 * SEARCH
 * navigation
 * mainpage|mainpage
 * Special:Recentchanges|Recent changed
 * new heading
 * portal-url|portal
 * https://www.mediawiki.org|MediaWiki home

Tooltips and Accesskey
If you add an item to the sidebar, it will have no tooltip associated. But you can create such a tooltip by doing the following:
 * create a wiki page named "MediaWiki:Tooltip-n- "
 * and put the tooltip in that page.

Accesskeys can also be created by doing the following:


 * create a wiki page named "MediaWiki:Accesskey-n- "
 * and put the accesskey in that page.

Example:


 * uses MediaWiki:Tooltip-n-mainpage-description and MediaWiki:Accesskey-n-mainpage-description.

翻译
You can translate the strings, which you use, by editing the according pages in the MediaWiki namespace.

Example: The string, which will replace the item named "mainpage", is taken from MediaWiki:Mainpage. To set/change this text for users, who display your wiki in German, you can put the according text on the page MediaWiki:Mainpage/de.

That way you can easily translate these texts through the MediaWiki interface.

Please note that MediaWiki will by default use the content of the Sidebar page in that language, which corresponds to the default language of your wiki. So, if your wiki e.g. uses French as its default language, edit MediaWiki:Mainpage/fr in order to show a modified sidebar to all users, who have not changed their language setting and to all anonymous users.

For more advanced translation, see.

Advanced customization
The sidebar can be fully customized by implementing JavaScript or Cascading Style Sheets, or by editing the PHP files directly. Before using these methods, note that:
 * JavaScript is fragile: it will not work for users with JavaScript disabled, and scripts frequently fail in different browsers or skins.
 * Editing the PHP files can easily cause unexpected errors, and your changes will be lost in the next update unless you manually change the new files.

Force UI-messages to follow content
Some pages should sometimes follow the content language, especially for multilingual sites. This can be controlled with the setting. Each message overridden in this way must be explicitly given, for example to let the sidebar link to versions given by the content language for the main page and the portal page add the following to


 * code

用 JavaScript 添加或移除工具部分
The toolbox, which appears under the search bar, is a dynamic element and cannot be easily customized without the use of skinning extensions (otherwise it requires programming in PHP.) If you still want to do so, you can copy, creating a new skin. You can then make a custom skin to generate these links in your preferred fashion.

下面是另一个 JavaScript 解决方案.

该方案对整个 MediaWiki 网站都有效，这段脚本必须要拷贝到 MediaWiki:Common.js（MediaWiki:Common.js 对于 MediaWiki 1.9 版本或以上可见. ）

For this solution to work only for a specific user, add this script to Special:MyPage/common.js (or the JS page for the user's current skin, such as Special:MyPage/monobook.js).

Now simply configure which link should appear in which section. You also can remove some links if you want to.


 * code


 * 用法
 * has to be customized for adding or removing links in specific sections:



 If you want to restrict the modification of the links to a specific user group (e.g. bureaucrat), change: to
 * Restricting modifications to specific usergroups

For restricting the modifications to IPs instead of a specific user group, use

Add or remove toolbox sections (PHP)
You can add in your file LocalSettings.php the hook described on this page. With this, you can modify via MediaWiki:Sidebar the links in the toolbox panel (remove some links, change their name) and add custom links (e.g. add the "Recent changes" link there instead of the navigation panel.

Make expanding/collapsing sidebar for all users (Monobook skin only)
If you use the Monobook skin and don't want to miss the expandable menu bar from e.g. Vector skin, paste the following code into MediaWiki:Monobook.js of your wiki.

Sidebar width in Monobook skin (CSS)
You can change the width of your sidebar by adding the following CSS rules to your MediaWiki:Monobook.css; note that this is an article, not a file. This changes the width to 15em, the actions position and portlet width should be an em or so less, so I've set them to 14em in this example.

Change sidebar content when logged in (PHP)
You can modify the sidebar using a hook. Create a small extension of your own or put the code directly into your LocalSettings.php file.

Some example code adding a 'navigation' sidebar block with a login link for logged out users.

Parser functions in sidebar
Although it is not exactly recommended, the sidebar does support parser functions (such as ParserFunctions), provided the  is outside the parser function, and the parser function does not span multiple lines. For example:
 * Heading

works. However the following would not work since the parser function spans multiple lines:
 * Heading

Changes not showing up
MediaWiki aggressively caches content if possible, which often causes the navigation bar to persist after changes. Purging the cache of affected pages should correct the situation. To perform a mass-purge of all caches at once, touch the  file or truncate the   table in your database (you may have to do both).

You also need to have set to.

If you are a user or average wiki admin, you will not be able to do the advanced stuff above to get changes to show up. If purging does not work either, you can sometimes still see CSS changes right away in preview (especially when changing your personal CSS). For example; changing the sidebar width, padding, or margins. Changes can take awhile to show up after saving though. If nothing shows up after awhile you may need to contact the overall wiki, or wiki farm, sysop.

Lowercase link labels
If your links are not being capitalized as intended, try adding spaces around the bar character; for example: ** http://www.example.com/download.php?file=44555 | Download

Sections disappear or show unexpected content
If a section does not display or displays unexpected content, check that the header text isn't the name of an interface message by searching Special:AllMessages. If it is, use a different header text, or create a new interface message and use it.

For example, if you want to use "Sidebar" as header text, create the interface message "MediaWiki:Sidebar-header" containing only "Sidebar". Then, use  as header.

Sections are not displayed if there are no links of the form  (e.g. when the target was forgotten).

Broken links after updating Special:Version
This will happen e.g., each time there are newer translations for your site language's sidebar items. One could add new redirect pages each time, but a better solution would be to use one's own sidebar item names instead of trying to keep track of the current MediaWiki translations.

Ancient versions of MediaWiki
If you have a pre-release version of 1.5 Beta, or earlier, it is still possible in some cases to edit the sidebar:
 * Prior to 1.5 branching (between rev:9150 and rev:9177) the message utilized was briefly MediaWiki:Navbar.
 * Before this, version 1.4 had (from rev:5528 to rev:9150) a global variable, titled.

另见

 * w:User:Mike Dillon/Sidebar
 * User:Goldbishop/Sidebar (updated for MW 1.19)
 * - Unsupported PHP modifying hacks that used to be on this page
 * w:User:Mike Dillon/Sidebar
 * User:Goldbishop/Sidebar (updated for MW 1.19)
 * - Unsupported PHP modifying hacks that used to be on this page
 * - Unsupported PHP modifying hacks that used to be on this page