如何将“打印版本”添加到 MediaWiki 导航菜单

在 MediaWiki 导航中添加“可打印版本”选项

使用 PHP 修改 MediaWiki 侧边栏配置的服务器端脚本。

<?php
// Load MediaWiki's core files
if ( !defined( 'MEDIAWIKI' ) ) {
    die( 'This script must be run from within MediaWiki.' );
}

// Hook into the Sidebar generation
$wgHooks['SkinBuildSidebar'][] = function ( &$sidebar, $skin ) {
    // Add the "Printable version" link below "Random page"
    $sidebar['navigation'][] = [
        'text' => 'Printable version',
        'href' => $skin->msg( 'printable' )->inContentLanguage()->text(),
        'id' => 'n-printable-version'
    ];
    return true;
};

// Save this script in a custom extension or LocalSettings.php
?>

使用 MediaWiki 侧边栏配置添加新链接

手动编辑 MediaWiki:Timeless 主题中的侧边栏页面的方法。

* navigation
 mainpage|mainpage-description
 recentchanges-url|recentchanges
 randompage-url|randompage
 printable-version|Printable version
* SEARCH
* TOOLBOX
// Save changes in the MediaWiki:Sidebar special page.
// Ensure "printable-version" message key is properly defined.

动态前端 JavaScript 解决方案

使用 JavaScript 的客户端脚本动态添加“可打印版本”选项。

document.addEventListener('DOMContentLoaded', function () {
    const navList = document.querySelector('.mw-portlet-navigation ul');
    if (navList) {
        const printableItem = document.createElement('li');
        printableItem.id = 'n-printable-version';
        const link = document.createElement('a');
        link.href = window.location.href + '?printable=yes';
        link.textContent = 'Printable version';
        printableItem.appendChild(link);
        navList.appendChild(printableItem);
    }
});

侧边栏修改的单元测试

PHP 单元测试以验证后端的“可打印版本”集成。

use PHPUnit\Framework\TestCase;

class SidebarTest extends TestCase {
    public function testPrintableVersionLinkExists() {
        $sidebar = []; // Simulate Sidebar data structure
        $skinMock = $this->createMock(Skin::class);
        $callback = $GLOBALS['wgHooks']['SkinBuildSidebar'][0];
        $this->assertTrue($callback($sidebar, $skinMock));
        $this->assertArrayHasKey('Printable version', $sidebar['navigation']);
    }
}
// Run using PHPUnit to ensure robust testing.

关于 MediaWiki 定制的常见问题

1. 如何编辑 MediaWiki 侧边栏？
2. 您可以通过修改 MediaWiki:Sidebar 页面来编辑侧边栏。使用类似命令 * navigation 和 option|label 定义新链接。
3. 什么是“永恒”主题？它对定制有何影响？
4. Timeless 主题是具有响应式设计的现代 MediaWiki 皮肤。侧边栏更改等自定义可能需要额外的测试以确保它们正确显示。
5. 是否可以为新的侧边栏选项添加本地化？
6. 是的，您可以使用 $skin->msg() 获取菜单项的本地化标签，确保与多语言 wiki 的兼容性。
7. 我可以在不修改后端代码的情况下添加新功能吗？
8. 是的，前端 JavaScript 解决方案例如使用 document.createElement() 允许您动态添加链接或功能，而无需更改后端。
9. 如何测试新的侧边栏功能？
10. 使用 PHP 单元测试或 PHPUnit 等测试框架，模拟侧边栏修改以确保它们按预期工作。

完善您的 MediaWiki 导航

在 MediaWiki 导航中添加“可打印版本”选项可为您的 wiki 带来更高的可用性和组织性。通过此处详细介绍的方法（从 PHP 脚本到 JavaScript），所有管理员都可以轻松且有效地进行自定义。

通过优先考虑本地化和主题兼容性，您的 wiki 成为不同受众的可靠资源。这些增强功能不仅改进了功能，还提供了用户友好的体验，体现了一个维护良好且易于访问的平台。 🌟