Hướng dẫn:Câu hỏi thường gặp
Immediate help- mediawiki-l, the MediaWiki mailing list.
- #mediawiki connect - the IRC channel.
- Support desk
| Frequently asked questions (FAQ) about MediaWiki usage. If your question is neither answered here nor in the technical MediaWiki documentation or the MediaWiki user documentation, then please ask in a support venue. | 
|
Cơ bản
MediaWiki, Wikimedia, Wikipedia và wiki có gì khác nhau?
Câu hỏi này thường được hỏi nhất; hãy xem bài Sự khác biệt giữa Wikipedia, Wikimedia, MediaWiki và wiki để biết câu trả lời chi tiết.
Tôi muốn dùng MediaWiki để (làm gì đó) được chứ?
MediaWiki là một phần mềm miễn phí và tự do: bạn có thể dùng MediaWiki cho bất kì mục đích gì mà không bị giới hạn về mặt pháp lý. Cũng xin lưu ý rằng, điều kiện bản quyền trên chỉ áp dụng cho chính phần mềm MediaWiki mà thôi. Điều này có nghĩa là mặc dù nhiều wiki cấp phép cho nội dung của họ theo giấy phép cho phép, bạn không có nghĩa vụ cấp phép cho nội dung được gửi đến wiki của bạn theo bất kỳ cách cụ thể nào. Và đương nhiên rằng, MediaWiki là một dự án được tạo ra nhằm hỗ trợ các trang giống như Wikipedia nên vì vậy chúng tôi vẫn khuyến khích bạn đặt toàn bộ nội dung bạn tạo ra dưới bản quyền tự do. Nhưng tóm lại, bạn không nhất thiết phải làm điều này.
Bạn có thể chỉnh sửa chính phần mềm MediaWiki theo ý bạn nhưng bạn vẫn có vài giới hạn mà chúng tôi cân nhắc bạn nên xem qua. Truy cập bản quyền GNU GPL phiên bản 2 đầy đủ để xem thêm thông tin. Vì MediaWiki được cung cấp miễn phí, không có bảo hành, trong phạm vi luật pháp hiện hành cho phép.
Làm thế nào tôi tạo được một bản wiki?
Tạo một wiki có nghĩa là cài đặt MediaWiki trên một máy chủ và có quyền truy cập để quản lý nó. There are different options, depending on your level of expertise:
- To create a wiki on your own server, follow the Installation guide.
- Some hosts offer one-click installs, or allow creating a wiki on-request. See Hosting services for different options.
This site (MediaWiki.org) or the Wikimedia Foundation does not allow individuals to create wikis.
Cài đặt và tuỳ chỉnh
Tôi có thể tải xuống MediaWiki ở đâu?
Bấm vào đây để tải về các phiên bản ổn định của MediaWiki. Các bản tải về được nén lại dưới định dạng .tar, .gz. MediaWiki cũng có thể được lấy trực tiếp từ kho lưu trữ Git của chúng tôi.
Làm cách nào để cài đặt MediaWiki?
Việc cài đặt MediaWiki mất khoảng 10 đến 30 phút và bao gồm việc tải lên/sao chép tệp và chạy tập lệnh trình cài đặt để định cấu hình phần mềm. Xem Hướng dẫn:Cài đặt, nơi bạn cũng sẽ tìm thấy yêu cầu hệ thống tối thiểu.
Làm cách nào để cài đặt MediaWiki bằng gói cài đặt?
Nhiều bản phân phối Linux cung cấp MediaWiki ở định dạng đóng gói cho phiên bản phân phối đó. Nhóm phát triển MediaWiki giới thiệu bạn đến bản phân phối Linux của bạn để được hỗ trợ cài đặt, cấu hình hoặc sử dụng chúng. Các cộng đồng và công ty cá nhân duy trì các gói như vậy nên cung cấp hướng dẫn cài đặt.
Hãy cảnh báo rằng các bản phân phối của bên thứ ba có thể là phiên bản cũ hơn, vì vậy hãy chú ý đến thông tin tương thích cho các hướng dẫn và tiện ích mở rộng.
- Xem thêm: Software bundles
Tôi có thể cài đặt nhiều wiki trên một máy chủ bằng MediaWiki
Có thể cài đặt nhiều hơn một wiki trên máy chủ với điều kiện:
- Bạn cài đặt nhiều phiên bản mediaWiki (chẳng hạn như với gói phần mềm như Bitnami MediaWiki Stack); trong các thư mục khác nhau; một cho mỗi wiki
Hoặc
- Bạn sử dụng các cơ sở dữ liệu khác nhau cho mỗi wiki
Hoặc
- Bạn sử dụng tiền tố cơ sở dữ liệu khác nhau cho mỗi wiki (đối với Postgres, bạn có thể đạt được hiệu quả tương tự bằng cách sử dụng các lược đồ và người dùng khác nhau) If you want to use the same
LocalSettings.phpfile for both, you must ensure $wgServer is dynamically set to the correct value.
Để biết thông tin về hai tùy chọn sau, hãy xem $wgDBname và $wgDBprefix tương ứng.
Để biết thêm thông tin về việc thiết lập một gia đình wiki (wikifarm), hãy xem Manual:Wiki family.
Làm cách nào để tôi cài đặt một wiki hiện có, như Wikipedia hoặc Wiktionary?
Phương pháp chính (nhưng không chắn là dễ nhất) là nhập các bài viết. Xem Nhập wiki, bên dưới.
(Bạn có thể tìm thấy các phương pháp không liên quan đến MediaWiki, chẳng hạn như Xowa và Kiwix tại w:Wikipedia:Tải xuống cơ sở dữ liệu).
MediaWiki có yêu cầu truy cập shell không?
Shell access (SSH) is not required for installing MediaWiki, but it is highly recommended. Without shell access, it may even be difficult for you to get a backup of your wiki, or to upgrade to a new version. Some maintenance tasks are not possible at all without shell access. Many major extensions work best with shell access.
Làm cách nào để cài đặt tiện ích mở rộng?
Xem Hướng dẫn sử dụng: Tiện ích mở rộng để biết thông tin về cài đặt và viết tiện ích mở rộng. Xem Thể loại:Tiện ích mở rộng để tìm các tiện ích mở rộng hiện có.
Làm cách nào để thêm không gian tên bổ sung?
Xem Tạo không gian tên tùy chỉnh.
Làm cách nào để kích hoạt tải lên tập tin?
Tải lên tập tin là một tính năng thường được sử dụng của MediaWiki, nhưng bị tắt theo mặc định trong tất cả các phiên bản phát hành hiện tại.
Để kích hoạt chúng, trước tiên hãy đặt thư mục tải lên (mặc định là images) có thể ghi bởi máy chủ web (chmod -R 777 ./images hoặc cho phép người dùng Apache ghi vào nmáy chủ v.v.) sau đó đặt $wgEnableUploads thành true trong LocalSettings.php.
Nếu bạn gặp lỗi "không tải được mkdir" khi cố tải lên, điều đó có thể có nghĩa là có vấn đề về quyền.
- Xem thêm: Manual:Configuring file uploads
Làm cách nào để cho phép tải lên các định dạng bổ sung?
MediaWiki yêu cầu các định dạng tải lên tệp được phép phải được chỉ định bằng cách sử dụng chỉ định cấu hình $wgFileExtensions.
Thông thường, chỉ định này nằm trong LocalSettings.php trong thư mục gốc của cài đặt MediaWiki của bạn.
Ví dụ: để mở rộng tải lên tệp PDF, hãy thêm phần sau vào LocalSettings.php:
$wgFileExtensions[] = 'pdf';
Để mở rộng tải lên nhiều loại tệp, hãy sử dụng cú pháp sau:
$wgFileExtensions = array_merge( $wgFileExtensions, [ 'pdf', 'txt', 'mp3' ] );
- Xem thêm: Manual:Configuring file uploads
Làm cách nào để bật nhúng các công thức toán học?
MediaWiki cho phép nhúng các công thức toán học. Xem Mở rộng:Math để biết hướng dẫn thiết lập hoàn chỉnh.
Làm cách nào để đặt múi giờ cho MediaWiki của tôi?
- Xem Manual:Timezone.
Làm cách nào để xóa một trang đã được lưu trong bộ nhớ cache?
Để xóa một trang đã được lưu trong bộ nhớ cache, chẳng hạn như khi thực hiện các thay đổi đối với thanh điều hướng, hãy thêm &action=purge vào cuối URL động của trang.
Ví dụ https://www.mediawiki.org/w/index.php?title=Main_Page&action=purge
Hoặc ?action=purge vào cuối URL dạng ngắn của trang:
Ví dụ https://www.mediawiki.org/wiki/Main_Page?action=purge
- Xem thêm: Manual:Purge, Manual:Parameters to index.php
Làm cách nào để tắt hoàn toàn bộ nhớ đệm?
Thêm vào tệp LocalSettings.php của bạn những dòng sau:
$wgParserCacheType = CACHE_NONE;
$wgCachePages = false;
"Tập tin bị hỏng hoặc có phần mở rộng không hợp lệ"
Một số người dùng đã báo cáo rằng sau khi thêm định dạng tệp vào danh sách tiện ích mở rộng được phép, đã xảy ra lỗi. Thông báo lỗi tương tự như sau:
- The file is corrupt or has an incorrect extension. Please check the file and upload again.
- Đặt giá trị $wgMimeDetectorCommand, ví dụ: với Unix hoặc Linux, điều này sẽ là:
$wgMimeDetectorCommand = "file --brief --mime";
- Xem thêm: Manual:MIME type detection
Người dùng ban đầu không được trình cài đặt tạo ra hoặc không phải là quản trị viên
Đôi khi, trình cài đặt không tạo được người dùng mặc định hoặc bảng người dùng bị mất vì lý do nào đó. Có một số lựa chọn để giải quyết vấn đề này:
maintenance/createAndPromote.php
- Execute
maintenance/createAndPromote.php --username <new user name> --password <password for that user>from the shell.
Thêm --bureaucrat vào dòng lệnh nếu bạn muốn người dùng đó trở thành hành chính viên, ngoài việc trở thành quản trị viên.
Thao tác này sẽ tạo người dùng mới và thăng cấp họ lên quản trị viên.
Để được trợ giúp, hãy chạy tập lệnh với tham số --help.
Thay đổi cơ sở dữ liệu
- Đăng ký tài khoản mới bằng phương pháp thông thường (Special:UserLogin).
- Kiểm tra ID người dùng thông qua API.
- Execute the following SQL statement against the database:
INSERT INTO user_groups ( ug_user, ug_group ) VALUES ( <id>, 'bureaucrat' ), ( <id>, 'sysop' );
<id>ở trên sẽ được thay thế bằng ID người dùng thích hợp mà bạn có thể thấy trên trang tùy chọn của người dùng.- Lưu ý: nếu
$wgDBprefixđược xác định trongLocalSettings.php, hãy thêm giá trị của nó vào tên bảng. Ví dụ: nếu$wgDBprefixlà "XYZ", thì tên bảng sẽ sử dụng làXYZuser_groups
Temporarily let everyone assign rights to promote your initial user
 Cảnh báo: | Bạn không nên để người ngoài truy cập wiki của bạn trong khi bạn làm việc này, nếu bạn sử dụng phương thức này. Phương pháp này có thể khiến wiki của bạn tạm thời dễ bị tấn công trong khi bạn thực hiện quy trình. |
Phương pháp này về cơ bản liên quan đến việc cho phép tất cả người dùng tạm thời sửa đổi quyền của người dùng để thăng cấp quyền của một người dùng
- Đăng ký tài khoản mới bằng phương pháp thông thường (Special:UserLogin).
Hãy đăng nhập bằng tài khoản đó.
- Thêm dòng sau vào cuối
LocalSettings.php$wgGroupPermissions['user']['userrights'] = true;
- Đi tới special:userrights và thêm người dùng bạn vừa tạo vào các nhóm Quản trị viên và Hành chính viên.
- Xóa dòng
$wgGroupPermissions['user']['userrights'] = true;khỏi LocalSettings.php của bạn. Bước này rất quan trọng, vì cho đến khi bạn xóa nó, bất kỳ ai cũng có thể thay đổi quyền cuả người dùng, và điều này thật tồi tệ.
Làm cách nào để đặt lại mật khẩu của người dùng MediaWiki ?
Làm cách nào để tạo liên kết interwiki trong wiki của tôi?
- Xem Manual:Interwiki.
Làm cách nào để làm để các URL gốc của tôi ngắn hơn?
(ví dụ: /wiki/Article_Name thay vì /w/index.php?title=Article_Name)
- Xem Manual:Short URL.
Làm cách nào để tổ chức các trang thành các thư mục con như /wiki/subir/PageName?
Tải xuống và sử dụng toàn bộ MediaWiki.org có miễn phí không?
Đúng, nó miễn phí theo định nghĩa của Phần mềm miễn phí. Xem Project:Bản quyền để biết các vấn đề cấp phép liên quan đến nội dung bằng văn bản của trang web này.
Làm cách nào để quản lý quyền của người dùng?
Xem Manual:User rights để biết thông tin chung. Xem Manual:Preventing access để biết các phương pháp nhằm hạn chế quyền truy cập.
Làm cách nào để ngăn chặn người dùng vô danh chỉnh sửa bất kỳ trang nào?
Phương pháp được đề xuất là bằng cách thay đổi giá trị của tùy chọn cấu hình $wgGroupPermissions.
Chỉnh sửa LocalSettings.php và thêm dòng:
$wgGroupPermissions['*']['edit'] = false;
Nếu bạn sử dụng Extension:AbuseFilter, bất kỳ quản trị viên nào cũng có thể tạm thời tắt khả năng chỉnh sửa của IP nếu cần.
- Xem thêm: Ngăn chặn truy cập, Manual:User rights
Làm cách nào để ngăn người dùng vô danh đọc bất kỳ trang nào?
- Thêm phần này vào cuối
LocalSettings.php:
$wgGroupPermissions['*']['read'] = false;
Xem thêm Manual:$wgWhitelistRead. Xem Hướng dẫn:Ngăn chặn truy cập#Hạn chế xem tất cả các trang để biết thêm thông tin.
Làm cách nào để hạn chế việc tạo tài khoản?
- Thêm phần này vào cuối
LocalSettings.php:
$wgGroupPermissions['*']['createaccount'] = false;
Xem Hướng dẫn:Ngăn chặn truy cập#Hạn chế tạo tài khoản để biết thêm thông tin.
Làm cách nào để tôi yêu cầu người dùng chỉ định địa chỉ email khi đăng ký tài khoản?
Làm cách nào để đặt MediaWiki vào chế độ Chỉ đọc?
| Phiên bản MediaWiki: | ≥ 1.5 |
- Xem Manual:$wgReadOnly.
Làm cách nào để thay đổi tùy chọn người dùng mặc định?
| Phiên bản MediaWiki: | ≥ 1.4 |
Tùy chọn người dùng mặc định của MediaWiki nằm ở MainConfigSchema.php Không chỉnh sửa tệp đó, chỉ sử dụng nó để tham khảo.
Giả sử bạn muốn ẩn các chỉnh sửa nhỏ trong các thay đổi gần đây theo mặc định. MainConfigSchema.php có dạng:
public const DefaultUserOptions = [
...
'hideminor' => 0,
...
]
Để thay đổi tùy chọn, hãy đặt tùy chọn này vào LocalSettings.php của bạn:
$wgDefaultUserOptions["hideminor"] = 1;
Để thay đổi không gian tên mặc định sẽ được tìm kiếm, trong bất kỳ phiên bản nào của MediaWiki, hãy đặt $wgNamespacesToBeSearchedDefault trong LocalSettings.php thành một mảng ánh xạ không gian tên thành các giá trị boolean. Ví dụ: để tìm kiếm không gian tên chính và không gian tên thể loại, hãy sử dụng:
$wgNamespacesToBeSearchedDefault = [
NS_MAIN => true,
NS_CATEGORY => true,
];
Trong một số trường hợp, sau khi bạn thay đổi tùy chọn người dùng mặc định, bạn cũng có thể muốn thay đổi tùy chọn người dùng của tất cả các tài khoản người dùng hiện có.
Nếu vậy, hãy sử dụng tập lệnh userOptions.php trong thư mục maintenance.
Sử dụng tùy chọn --dry cho lần chạy đầu tiên, đánh giá tác động và bắt đầu từ đó. (--dry không ghi cơ sở dữ liệu)
php userOptions.php --dry --nowarn hideminor --old 0 --new 1
Ngoài ra, hãy luôn sao lưu cơ sở dữ liệu của bạn trước khi thực hiện những loại thay đổi này (bạn không cần phải làm như vậy nếu bạn chỉ đang sử dụng --dry).
- Xem thêm: Manual:$wgDefaultUserOptions
Làm cách nào để MediaWiki chạy nhanh hơn?
How do MediaWiki and GDPR go together?
Nâng cấp
- Xem Manual:Upgrading.
Di chuyển
Có thể chuyển wiki của tôi sang một máy chủ khác không?
Có Nó nên được thực hiện. Về bản chất, bạn sẽ sao lưu cài đặt cũ của mình và sau đó "khôi phục" nó vào máy chủ mới. Cuối cùng, bạn sẽ phải thực hiện các sửa đổi bổ sung để cập nhật cấu hình wiki để mọi thứ hướng đến vị trí mới.
Làm cách nào để chuyển wiki của tôi sang một máy chủ khác?
Làm theo hướng dẫn tại Manual:Moving a wiki.
Thay đổi giao diện
Làm cách nào để thay đổi biểu trưng?
 Caution: | Đừng chỉ ghi đè logo mặc định được cài đặt đi kèm với MediaWiki (/resources/assets/wiki.png); tệp này sẽ được ghi đè khi bạn nâng cấp. |
Logo xuất hiện ở phía trên bên trái của mỗi trang được xác định bởi dòng cấu hình $wgLogos trong tập tin LocalSettings.php. MediaWiki installations prior to MediaWiki 1.35.0, used $wgLogo.
Có hai cách để thay đổi logo:
- Tải ảnh lên wiki của bạn bằng giao diện tải lên tệp thông thường. Điều này cho phép logo được thay thế dễ dàng, vì vậy bạn có thể cần khoá trang nếu bạn sử dụng phương pháp này.
- The resulting logo path will be .
"{$wgUploadPath}/6/62/mylogo.png";
- The resulting logo path will be
- Tải hình ảnh lên máy chủ của bạn bằng các phương tiện khác (chẳng hạn như FTP).
- The resulting logo URL will be .
$wgLogos = "{$wgScriptPath}/mylogo.jpg";
- (Trong ví dụ này, hình ảnh nằm trong cùng thư mục với tệp
LocalSettings.php.)
- The resulting logo URL will be
Then, modify the $wgLogos array in LocalSettings.php.
It should look something like:
$wgLogos = [
'1x' => "$wgResourceBasePath/resources/assets/change-your-logo.svg"
'icon' => "$wgResourceBasePath/resources/assets/change-your-logo-icon.svg"
];
Replace the paths above with the appropriate new logo path.
Nếu bạn muốn thay đổi logo chỉ trong các trang cụ thể, hãy ghi đè lên thuộc tính hình ảnh nền #p logo của css hoặc sử dụng tiện ích mở rộng của bên thứ ba như Extension:LogoFunctions.
Làm cách nào để sửa CSS của wiki?
Bạn không nên chỉnh sửa trực tiếp các tập tin CSS (chẳng hạn như common.css) vì nó sẽ làm cho việc nâng cấp khó khăn hơn nếu bạn cần áp dụng các tùy chỉnh của mình mỗi khi bạn nâng cấp phần mềm. Thay vào đó, bạn cần chỉnh sửa một trang wiki có tên MediaWiki:Common.css nếu bạn muốn áp dụng các thay đổi CSS của mình cho tất cả các skin hoặc trang wiki có tên MediaWiki:Vector.css nếu bạn muốn áp dụng các tùy chỉnh chỉ cho giao diện Vector.
Nội dung của các trang MediaWiki:Common.css và MediaWiki:Vector.css luôn ghi đè lên các kiểu CSS mặc định được chỉ định trong các tệp giao diện.
Làm cách nào để ẩn thanh công cụ dẫn hướng dọc trái?
Nói cách khác, làm thế nào để bạn làm cho phần nội dung chính chiếm 100% màn hình, ẩn logo, hộp công cụ, điều hướng và công cụ tìm kiếm?
Để ẩn vĩnh viễn, hãy sao chép và dán phần sau đây vào trang MediaWiki:Common.css
#column-content { margin: 0 0 .6em 0; }
#content { margin: 2.8em 0 0 0; }
#p-logo, .generated-sidebar, #p-lang, #p-tb, #p-search { display:none; }
#p-cactions { left: .1em; }
Thay vào đó, để ẩn thanh công cụ khi người dùng nhấn F11, hãy nhập phần này vào MediaWiki:Common.js trên wiki của bạn:
document.onkeydown = function( e ) {
if( e == null ) e = event
if( testKey( e, 122 ) ) { //F11
appendCSS('#column-content {margin: 0 0 .6em 0;} #content {margin: 2.8em 0 0 0;} #p-logo, .generated-sidebar, #p-lang, #p-tb, #p-search {display:none;} #p-cactions {left: .1em;} #footer {display:none;}');
return false;
}
}
function testKey( e, intKeyCode ) {
if( window.createPopup )
return e.keyCode == intKeyCode
else
return e.which == intKeyCode
}
Làm cách nào để ẩn các thể loại ở cuối mỗi trang?
Bạn có thể ẩn hiển thị các thể loại trên mỗi trang bằng cách sửa đổi MediaWiki:Common.css và thêm:
.catlinks { display: none; }
How do I customize the link-URL of the site-logo in the top left corner of all pages that activates when the site-logo is clicked upon?
By default, clicking the site-logo takes you to the main site-page. If you want to change which internal site-page is the "main" site-page, edit MediaWiki:Mainpage.
To make the link of the site-logo link externally to any other arbitrary URL, you can use jQuery code within MediaWiki:Common.js:
$("a.mw-wiki-logo").attr("href", "http://www.example.com");
$("a.mw-wiki-logo").attr("title", "Go to example.com website");
How do I change the icon in the browser's address line (favicon)?
- Simply upload your favicon.ico to the root of your domain/subdomain, make sure file name is in lower case and its name is favicon.ico
- Alternatively edit the $wgFavicon setting in LocalSettings.php and add
$wgFavicon = "$wgScriptPath/path/to/your/favicon.ico";
See Manual:$wgFavicon for more details.
Tip: The favicon image should be either 16 x 16 pixels or 32 x 32 pixels.
Rewrite Rule
If you are using a rewrite rule in .htaccess to remove "index.php" from the URL, you will also need to add an exception for .ico files. Simply add the following rule to your .htaccess:
RewriteRule .*\.ico$ - [L]
This rule must appear before the index.php rule.
Case sensitivity
When uploading the favicon file, be sure the filename is in lowercase. (That is, "favicon.ico", not "Favicon.ico".) A lot of servers (e.g., those on UNIX-like operating systems) will not be able to find the file unless its name is in lowercase.
How do I customize the navigation bar?
The contents of the navigation bar which appears to the left of each page using the Vector or the Monobook skin are determined by the MediaWiki:Sidebar page there on your wiki. For information on customising these, please see Manual:Interface/Sidebar.
How do I put a text message (sitenotice) on every page?
Put a text in the MediaWiki:Sitenotice page. It will be displayed on top of every article page.
You can also add text to MediaWiki:Anonnotice to create a message that only displays for logged-out users. It is often a good idea to transclude the site notice on the anon notice to make sure that logged-out users still get the information on the site notice.
How do I change which page is the main page?
By default, MediaWiki looks for a page with the title Main Page and serves this as the default page. This can be changed by altering the contents of MediaWiki:Mainpage to point to a different title. If this does not change the 'Main Page' link included on the sidebar at install time, edit MediaWiki:Sidebar.
How do I change the Main Page title?
Simply click on the "Move" tab, and move the page to the desired page title.
Usually you also want to change which page is the configured as "main page".
How do I hide the main page title?
The displayed title of the main page can be changed using the MediaWiki messages MediaWiki:mainpage-title and MediaWiki:mainpage-title-loggedin (for logged-out and logged-in users respectively). The main page title can be hidden by setting both messages to empty (or only either of them if the title should still be displayed to logged-out or logged-in users).
How can I hide the table of contents?
The table of contents (TOC) is automatically shown once there are four or more headings in the article. There are multiple ways to hide it.
- For one page
- Place the magic word
__NOTOC__in the page's wikitext.
- For all pages
- Install Extension:NoTOC
- or
- Add the following rule to MediaWiki:Common.css:
.toc, #toc { display: none; }
- Per user
- Users can add the same CSS rule to their common.css personal stylesheet.
How do I change the interface text?
Interface text is altered using the MediaWiki namespace. For each deviation from the default in the site language there is a page MediaWiki:Englishmessagename, and for each deviation from the default in each other language a page MediaWiki:Englishmessagename/languagecode. (Since release 1.9 there are no pages for messages equal to the default.). On creation of a page the edit box autofills with the default. When creating a page to override the default it is useful to first save the default version, to allow diffs with it. See also Help:System message.
- For a list of system messages, see Special:Allmessages
- To switch off the MediaWiki namespace, see the $wgUseDatabaseMessages configuration setting
- To remove the Privacy policy or Disclaimers links at the bottom of each page, set the content of pages MediaWiki:Privacy or MediaWiki:Disclaimers respectively to a single hyphen (
-).
How do I edit error messages?
Special:Allmessages contains a complete list of messages (error or otherwise), that can be edited.
You may also add ?uselang=qqx or &uselang=qqx to a URL which will display the name of each messages in the interface.
How do I change the interface language?
To change the default interface language, alter the value of $wgLanguageCode in LocalSettings.php, for example
$wgLanguageCode = "fr";
You may also need to bypass your browser's cache to see the changes.
The new default interface language will be applied to all users who haven't ever customised it.
If you want to provide users the possibility to create and choose pages and interface elements in languages other than the default one of the wiki, you need the Dịch extension, which can make your wiki multilingual.
If you want to change the language settings for all existing users, use the userOptions.php maintenance script. For instance, to have all users with English set use French instead, run:
php userOptions.php language --old en --new fr
How do I remove the article/edit etc tabs?
For a little more control see: User:Subfader/Hide_page_tabs
Edit MediaWiki:Common.css on your wiki, and add this:
li#ca-edit { display: none; }
See the page source for the various #ca-* ids used in the content tabs.
How do I add/remove tabs throughout my wiki?
How do I remove a tab on only one page?
| Phiên bản MediaWiki: | ≥ 1.9 |
For example, to remove the Discussion (talk) page tab from the Main Page, on the MediaWiki:Common.css page add:
body.page-Main_Page li#ca-talk { display: none !important; }
To modify MediaWiki:Common.css you must be an Interface administrator.
- See also: Manual:Hide page tabs
How do I remove a tab on all pages
| Phiên bản MediaWiki: | ≥ 1.9 |
For example, to remove the Discussion (talk) page tab on all wikipages, on the MediaWiki:Common.css page add:
#ca-talk { display:none!important; }
Other tabs to remove are #ca-history, #ca-viewsource, #ca-view (Read tab), #ca-nstab-main (Page tab).
Other drop down menu items you can remove are #ca-watch, #ca-move, #ca-delete.
To modify MediaWiki:Common.css you must be an Interface administrator.
How do I remove the "Talk for this IP" link at the top right (e.g. when $wgDisableAnonTalk is true)?
One option is to hide the link using the following CSS in the wiki page MediaWiki:Common.css in your wiki:
#p-personal #pt-anonuserpage {
display: none;
}
How do I remove the "Create an Account or Login" link at the top right of the screen?
To remove the login / create account links from the personal_urls you can use this code in your LocalSettings.php to hook in and remove them:
$wgHooks['SkinTemplateNavigation::Universal'][] = function ( $skinTemplate, &$links ) {
unset( $links['user-menu']['login'] );
unset( $links['user-menu']['login-private'] );
unset( $links['user-menu']['createaccount'] );
};
How can I suppress actions and special pages?
To disable a specific special page (such as Special:SpecialPages), you may use:
$wgSpecialPages['Name'] = DisabledSpecialPage::getCallback( 'Name', 'message' );
where Name is the canonical (English) name of the special page to disable, and message is the message to be shown to users when they try to access the special page.
To disable an action (such as edit), you may use:
$wgActions['edit'] = false;
See API:Restricting API usage to disable an API module.
This is only the basic usages. Usually you may want to disable special pages, actions or API modules conditionally.
How do I change the footer?
How can I edit / remove the Powered by MediaWiki image (and possible other images) from the footer?
You can hide the Powered by MediaWiki image by adding the following to your wiki's MediaWiki:Common.css:
#footer-poweredbyico { display: none; }
If you want to remove it completely, you can use $wgFooterIcons to remove it using this in your LocalSettings.php:
unset( $wgFooterIcons['poweredby'] );
Note that this will also remove other powered-by icons, e.g. also the one coming from BlueSpice.
If you wish to change the icon images, urls, alt text, or add new icons please see $wgFooterIcons' documentation.
How do I add a reply link to default signature tildes (~~~~) template?
Install DiscussionTools to enable automatic reply links on talk pages.
How can I change what the <title> of each page is? Where do I make changes?
Most of the text that you want to change can be found in the namespace of MediaWiki.
In order to change titles, texts, announcements, etc., go to Special:AllMessages, where you will see the text associated with the pages you wish to change. You need to log in as an administrator to edit the protected entries in the MediaWiki namespace.
If you want to change the title in your browser, you need to edit MediaWiki:Pagetitle. Go there and edit it just like you would any other page in your wiki.
In recent versions of MediaWiki, MediaWiki:Pagetitle is $1 - {{SITENAME}} by default. If {{SITENAME}} is producing the wrong text for you, you need to set $wgSitename in your LocalSettings.php.
Don't forget to clear your browser cache after you change your settings.
Does MediaWiki automatically capitalize the first letter of $wgSitename?
Yes. This can be changed using the $wgCapitalLinks configuration setting.
How do I make external links open in a new window?
How can I suppress MediaWiki from formatting URLs, tags, etc?
Put "<nowiki></nowiki>" tags around the URL or tag.
Example:
svn co <nowiki>http://svn.example.com/myproject/</nowiki>
Produces:
svn co http://svn.example.com/myproject/
How can I force users to preview before they save?
How do I add more buttons on the edit page?
How can I get more special characters or tags clickable on the edit page?
For adding more selectable special characters, etc., below the edit field, see Extension:CharInsert.
How can I use a different skin on my wiki?
See Hướng dẫn sử dụng:$wgDefaultSkin for more information on configuring your default skin.
How do I disable external links from showing in the printable version of a page?
Edit the page MediaWiki:Print.css on your wiki and add the following code there:
#content a.external.text:after,
#content a.external.autonumber:after {
content: none;
}
This will override the styles defined in the CSS files coming with the MediaWiki source code. For more information, see Manual:CSS.
If instead you want to have the external links underlined in the printable version, then also add the following code:
#content a.external {
text-decoration: underline !important;
}
How do I print footnotes at the bottom of each printed page?
Try this StackOverflow solution: Printed HTML per-page footnotes
How do I change the text of the article (page name) tab of my wiki's main page?
To change the text of the tab, as one example used in Wikipedia, you first open the page "MediaWiki:Mainpage-nstab".
After you've done that, click Edit and type in the edit box the text you want to be seen later on the main page - that's it. Don't forget to save the page as well.
How do I change the background color?
To change the background color of the MediaWiki interface outside of the page content and tabs, add the following CSS to the MediaWiki page [[MediaWiki:Common.css]]:
/* Changes the background color of the bottom and left of each page, up to behind half of the logo: */
body {
background: red;
}
/* Changes the background color behind the top half of the logo and at top of each page: */
#mw-page-base {
background: red;
}
This will change the background color outside of the tabs, search, and page content to red. See Manual:CSS for more information.
How do I load external fonts?
This example refers to Google Fonts, a repository of free open-source fonts that you can use with MediaWiki.
Go to https://fonts.google.com/, find fonts that you like, and select them by clicking the "plus" (+) icon.
Select one or more fonts to be added.
Click the tab for the pop-up notification, and then select "@IMPORT". Copy and paste the resulting CSS into [[MediaWiki:Common.css]]. The examples below use Noto Sans and Noto Serif. They are default fonts for Android operating system and have good support for Unicode text.
@import url( 'https://fonts.googleapis.com/css?family=Noto+Sans|Noto+Serif' );
/* Changes the default font used for MediaWiki to Noto Sans (does not include headings or monospaced text): */
body {
font-family: "Noto Sans", sans-serif;
}
/* Changes the default font used for MediaWiki headings to Noto Serif: */
#content h1,
#content h2 {
font-family: "Noto Serif", serif;
}
How to hide the "Your edit was saved" notification?
Edit the wiki page MediaWiki:Common.css on your wiki to include the line .postedit {display: none;}. See Manual:Interface/Stylesheets for more information.
Basic usage
How do I edit a page?
To edit a page, simply click the edit link that appears on each page. Using the default Vector skin, this is in the form of a tab at the top of the page. A form will appear, containing the existing markup. When you have finished making modifications, click the Save button to commit your changes.
- See also: Help:Biên tập trang
How do I create a new page?
There are several ways to create a new page:
- Create a link to the page on another page, then click on the red link which appears
- Browse to the intended location of the page, e.g.
http://www.example.com/index.php?title=New_pageand click on the "Edit", "Create" or "Create source" link.
On some wikis, a failed search for a page will contain a link which allows you to edit that page.
- See also: Help:Tạo trang mới
How do I delete an old version of a page?
Old versions of page data are retained in the database and can be accessed via the page history features. This is useful for reviewing changes and correcting or reverting undesirable ones, but in some cases, administrators might want to make this information unavailable, for legal reasons, or to reduce the size of the database.
- Administrators can delete an old revision of a page by deleting the page, and then selectively undeleting revisions to be kept
- You can enable the core RevisionDelete feature that allows privileged users to remove single revisions from page histories.
- The
maintenance/deleteOldRevisions.phpmaintenance script can mass-delete all old revisions of pages and their associated text records.
- See also: Manual:Removing embarrassment
How do I use oversight/delete revisions in the page history?
- See: RevisionDelete
You can also delete a page, and then restore only the revisions you want.
Are there any editing tutorials available?
There are several editing tutorials available, mostly on Wikimedia sister projects, such as Wikipedia. There are also markup references, etc. available on Meta.
- The page Help:Biên tập trang on this site
- The How to edit a page guide on the English Wikipedia
How do I view the printable form of a page?
MediaWiki includes stylesheets which automatically style a page appropriately when it is printed; using the print or print preview function within your browser ought to render the page in a printable form.
You can also view this printable form using the printable version link in the sidebar under Toolbox or Print/export if using the Collection extension.
How do I use templates?
- See Help:Templates
Can I use media (images, video, audio, etc.) from Wikimedia Commons in my installed version of MediaWiki?
Yes, this is encouraged through the use of Manual:$wgUseInstantCommons.
- See also: InstantCommons
How do I use a template as a signature?
When you look at your preferences, you see a check box for "raw signature." But the field will only take a certain number of characters. What if you want more?
You will need to create two pages, possibly in your userspace.
- Create the first page (FIRST PAGE)
- Go to your preferences, check "raw signature" and put {{FIRST PAGE}} in the signature. Lưu tùy chọn
- Create a second page (SECOND PAGE) (possibly a sub-page of the first)
- Go back to the first page (FIRST PAGE) and do {{SECOND PAGE}}
- Go to the second page (SECOND PAGE) and place the code you wish to have for your signature.
If you don't have this structure, you will still be inserting all your signature code into the raw code wherever your signature is used, because the software will insert "SUBST" in your preferences. You may not mind this, in which case you only need one page. If you want the raw code to only display {{FIRST PAGE}}, which looks a lot cleaner, then you need to use the two-page structure.
How do I add the sandbox functionality to my installation of the wiki?
In wiki terms, a sandbox is simply a "play pen"; a page which users can mess about in. This is an ordinary page created in the normal manner, and can be located wherever you like. There is no special sandbox functionality built into MediaWiki.
Users often inquire about the Wikipedia sandboxes, which seem to be self-emptying. This is not quite correct; there are a number of volunteers who run bots to clean these up and return them to a certain state at regular time intervals.
See also Extension:SandboxLink which will add a link to user's personal sandbox (i.e. a subpage of personal user page) to personal tools menu.
How do I make my wiki serve all languages?
- To allow user to switch the language of the interface, see Extension:UniversalLanguageSelector
- To allow translation of pages and of the custom interface (like the sidebar), use the Translate extension; there's extensive documentation.
Wiki importing
Importing from MediaWiki XML dumps
Importing from other types of wiki software
Importing from other types of files
There are a variety of tools available to help convert content from HTML (and other formats) to MediaWiki markup.
- Developer and SysAdmin tools
- HTML::WikiConverter::MediaWiki - a Perl module for converting from HTML to MediaWiki markup.
- Wikificator - a JavaScript MediaWiki extension that converts XHTML to MediaWiki markup.
- The Edit.php and importImages.php maintenance scripts can be used to import text and images into MediaWiki.
- End-user tools
- wikEd - a text editor for MediaWiki that can import HTML (including Microsoft Word-generated HTML.)
- Instructions
Templates imported from other wikis (such as Wikipedia) don't work for me
You probably need to install some extensions used on the source wiki, such as Scribunto, TemplateStyles, ParserFunctions or sometimes Cite. Also, make sure that you copied all site CSS and JavaScript required by the template.
Customising further
I want to have multiple wikis, but only require registration once
- If you're starting from scratch or you're switching from one wiki to multiple, you can use $wgSharedDB and $wgSharedTables to have all wikis share the
usertable of the "main" wiki.
You can share other tables as well, as long as they don't contain any data dependent on non-shared tables or data specific to one wiki. See Manual:Shared database for examples and more information.
- If your wikis are already established and you want to switch to a single sign-on, you can use the CentralAuth extension.
It has a few more features than a shared user table, but it's more difficult to configure and it's tailored toward a Wikimedia-style setup. However, it is easier than attempting to completely merge multiple user tables into one.
How can I allow use of HTML tags?
See Manual:$wgRawHtml as well as Manual:$wgGroupPermissions và Manual:Preventing access.
| Caution: | This can be easily abused to attack users |
See HTML restriction for ways to make this safer.
How do I fix problems or add features to MediaWiki?
The basic steps to improving MediaWiki (that is, becoming a MediaWiki developer) are:
- Install Git
- Download the Git "clone" of the MediaWiki source code
- Get a server, a database, and PHP running on your computer (this can be annoying, so please ask for help if something isn't working)
- Get MediaWiki running on your computer off that Git checkout (can be annoying as well, so, ditto)
- Fix the problem or add the feature you were thinking of
- Edit the source code of the relevant file(s) to fix the problem
- Follow Gerrit/Tutorial
How do I run a bot?
- See: Manual:Bots
You might want to use the Pywikibot framework.
How do I change noindex nofollow
Set $wgNoFollowLinks = false; in LocalSettings.php
How do I add meta tags?
The OutputPage class includes an addMeta method which can be used to add meta tags. The RequestContext can be used to get the relevant OutputPage object.
$out->addMeta ( 'description', 'This is a meta description.' );
Why...?
…is the Help namespace empty?
The Help namespace currently ships in a blank state. It's up to you how much or how little help you give to your site visitors and whether this relates to other aspects of your site. Obviously you can easily link your visitors to help resources elsewhere.
We don't currently have a clean, internationalised set of help pages under a free license. However, if you want to copy in some help information onto your site, about how to use a wiki (a MediaWiki powered wiki) you are free to copy the Help:Mục lục from this wiki. This set of pages have been deliberately created for this purpose, with wiki-neutral information, and no license restrictions. See Project:Trợ giúp thuộc về Phạm vi công cộng.
…are some of my images not showing up after an upgrade?
Several users have reported that, following an upgrade or a moving of their wiki, several images fail to be shown inline.
The files exist, and the image description pages show a MIME type of unknowncode>/unknown and, in some cases, a warning about potentially dangerous files.
To fix this, run the maintenance/rebuildImages.php script from the command line.
This will set MIME information for each file in the database.
MediaWiki 1.21 and newer implements responsive images.
Due to a bug, if the server locale is set to one that uses commas instead of dots for representing a decimal point, images may not render on some browsers/devices.
This can be confirmed by inspecting a thumbnail of a medium or big image on a page with the browser tools, looking at the HTML code, and see if the srcset attribute contains commas instead of dots when representing the 1.5x value.
…are all PNG files not being turned into thumbnails?
After upgrading to a more recent version of PHP, it is possible a different MimeMagic.php function is being used to detect file MIME types, particularly the built-in PHP function mime_content_type, which fails to detect PNG files. Search the web for mime_content_type png for information on fixing this bug at the PHP level, possibly by editing your magic.mime file.
See File is corrupt or has an invalid extension for more info.
…can't I download MediaWiki 1.43?
MediaWiki 1.43 is in a development state at present, and has not been packaged into a general release. The code can be downloaded from Git if desired. Or, if you want the latest development version packaged as an archive, get it at mediawiki-master.tar.gz (GitHub).
…doesn't this work? It works on Wikipedia!
Wikipedia and other Wikimedia web sites use the current version of the code in development; at present, this is MediaWiki 1.44.0-wmf.8 (f08e6b3), pulled from the current development branch. Coupled with the use of several extensions, this means that functionality between these wikis and your particular setup may differ.
- To obtain the current development code, read Download from Git
- To check what version a Wikimedia wiki is running, as well as what extensions are installed, visit the Special:Version page for that wiki
- You may also be missing several Tiện ích mở rộng that are installed on Wikipedia, see #Templates imported from other wikis (such as Wikipedia) don't work for me
…do I get a 403 Forbidden error after setting permissions on my Fedora system?
Fedora enables SELinux by default. Instructions for setting SELinux permissions for MediaWiki are available.
…do I get Installing some external dependencies (e.g. via composer) is required?
Many hosting providers only handle zip archives, and we only provide gz compressed tar archives, thus the archives has to be recompressed before uploading. This should not be a hurdle, but it seems like some archive tools occasionally fail to include all files in large archives. When this happen the vendor folder is left out, leaving the user with the rather non-explanatory error message.
Use a command line tool when recompressing the tar archive into a zip archive.
…do I get logged out constantly?
This is probably related to cookies or session data. See Log in problems for information.
If this is happening constantly to all users, it probably means that caching is misconfigured. Setting $wgSessionCacheType = CACHE_DB; can be used to determine if caching is the cause of the problem. If that solves the problem, you should still investigate what is wrong with your caching configuration.
…is it a good idea to keep user accounts?
 | Các phần của trang này (những phần liên quan đến Manual edits to rev_user fields in the database; MediaWiki uses the actor table now) đã lỗi thời. |
At many times you just want to remove a user account out of the wiki either because it belonged to a spammer account or you just feel like it. The appropriate choice is to block the account or rename it if needed. Here is why:
Do I just remove this row from the user table?
Rob Church posted the following regarding this issue on the wikitech-l mailing list:
If the user has made edits, then removing rows from theusertable cause theoretical loss of referential integrity.Now, to be honest with you, I can't think of any conditions where this would cause an actual problem; "undefined behaviour" is the phrase we use.
What I'd suggest doing, to be on the safe side, is running a couple of quick updates against the database:
What this will do is cause MediaWiki to treat the revisions as having been made anonymously when generating things like page histories, which should eliminate any problems caused by these routines attempting to check user details from other tables.
If the user has caused log entries, i.e. rows in the
loggingtable, or uploaded images, then the situation becomes trickier, as you'll have to start mopping up all the rows everywhere and it could become a bit of a mess, so if the user's done anything other than edit, I would strongly recommend just blocking them indefinitely.If the username is offensive or undesirable, then you could consider renaming it using the RenameUser extension.
Another option is to give Admins the 'hideuser' right, and indefinitely block the user with the Hide username from edits and lists option selected.
Extension:UserMerge is also useful.
…is the number of pages so low on Special:Statistics?
By default, $wgArticleCountMethod is set to link.
This means the number of "Content pages" on the Special:Statistics page only counts pages which include at least one internal link.
This can be changed by setting $wgArticleCountMethod to any.
Afterwards, run updateArticleCount.php and/or initSiteStats.php.
(On Wikimedia websites, initSiteStats.php is run on the 1st and 15th of each month.)
There might still be wrong behavior, see for example phab:T212706.
Anti-spam
How do I use $wgSpamRegex to block more than one string?
$wgSpamRegex is a powerful filter for page content. Adding multiple items to the regex, however, can be awkward. Consider this snippet:
$wgSpamRegexLines[] = 'display\s*:\s*none';
$wgSpamRegexLines[] = 'overflow\s*:\s*auto';
[...]
$wgSpamRegex = '/(' . implode( '|', $wgSpamRegexLines ) . ')/i';
This example code allows convenient addition of additional items to the regex without fiddling about each time. It also demonstrates two popular filters, which block some of the most common spam attacks.
- See also: Extension:SpamRegex
Are there additional ways to fight spam?
See Manual:Combating spam for an overview of anti-spam measures such as Captcha, content filtering and restricting edition.
Anti-vandalism
See Manual:Combating vandalism for hints and suggestions on how to deal with wiki vandalism.
Where now?
I've found a bug or have a feature request. Where do I post it?
Bugs and feature requests should be posted on Phabricator. See How to report a bug.
I'm getting a strange error. What now?
- See if it is covered by Manual:Errors and Symptoms
- Try to find out more about the problem, see Manual:How to debug
- Xem đề mục bên dưới để biết thông tin về cách liên hệ với nhà phát triển và những người dùng có hiểu biết khác.
I tried that but it didn't work
- I had a problem, I came to this page and it told me how to fix it. But it didn't work, the problem is still there!!!!
Nine times out of ten this is because you didn't clear your cache. The simple test for this is to request a page that hasn't been requested before. Select the part of the URL in the address bar that contains the page title (e.g. Main_Page). Twiddle your fingers on the keyboard for a while, hit enter. Check if the problem is on that page too.
MediaWiki uses both a server-side cache and a client-side cache, so clearing your browser cache is often not enough. See the relevant entry above for more details.
Here are some other things to check:
- Were you editing the right file? Try inserting some garbage into the file you edited, does it break anything?
- A great debugging tool in this case is to create a file called phpinfo.php, containing only
<?php phpinfo() ?>.
- A great debugging tool in this case is to create a file called phpinfo.php, containing only
Upload it into your web directory and invoke it with your browser. Check the document root and the path to php.ini.
- Were you editing the right part of the file?
Did you create a duplicate entry in php.ini? Add new settings to the end of LocalSettings.php, not to the beginning.
- If you created a .htaccess, are you sure AllowOverrides is on?
Ask your hosting provider.
I have a question not answered here. Where do I go next?
If you've exhausted the FAQ above, please try the following:
- Check the other sources of help on this site
- Search the rest of this site
- Search the web
- See the section below for information on how to contact developers and other knowledgeable users.
Still no luck. Where can I ask for help?
See the support venues listed on Liên lạc.