如何在MediaWiki中实现点击链接直接打开内部PDF文件？

我来帮你搞定这个问题！在MediaWiki里，默认的[[File:test.pdf]]确实会跳转到文件的描述页面，不过有几种简单的方法能让用户点击后直接打开PDF文件，下面给你逐一说明：

1. 用Media:前缀替换File: #

这是最快捷的原生方法，不需要改配置。把原来的[[File:test.pdf]]改成[[Media:test.pdf]]，点击这个链接就会直接触发浏览器打开或下载PDF（具体行为取决于用户的浏览器设置）。

如果想自定义显示文本，还可以写成：

[[Media:test.pdf|点击直接打开测试PDF]]

这样页面上会显示“点击直接打开测试PDF”，点击后直接指向PDF文件本身。

2. 手动构造文件的直接URL链接 #

如果你知道PDF文件在服务器上的实际存储路径（MediaWiki默认会把文件存在/images/目录下，文件名会经过哈希重命名，比如test.pdf可能对应/images/8/8a/test.pdf），可以直接用外部链接格式：

[http://localhost/mediawiki/images/8/8a/test.pdf 直接打开PDF]

不过这种方法的缺点是，当文件被重新上传或文件名哈希变化时，链接会失效，不如Media:前缀的方法稳定。

3. 修改配置全局生效 #

要是你希望所有PDF文件的[[File:...]]链接都默认直接打开，不用每次修改语法，可以编辑MediaWiki根目录下的LocalSettings.php文件，添加以下配置：

方法A：禁用媒体查看器对PDF的处理 #

// 确保PDF被识别为允许的文件类型（如果没加过的话）
$wgFileExtensions[] = 'pdf';
// 关闭默认的媒体查看器中转页面
$wgMediaViewerEnableByDefault = false;
// 对PDF文件禁用媒体查看器
$wgMediaViewerDisableForTypes = [ 'application/pdf' ];

方法B：通过钩子强制修改PDF链接目标 #

如果上面的方法不生效，可以用钩子拦截文件链接，强制指向文件的直接URL：

$wgHooks['LinkBegin'][] = function( &$skin, &$target, &$text, &$customAttribs, &$query, &$options, &$ret ) {
    // 检查是否是文件命名空间下的PDF文件
    if ( $target instanceof Title && $target->getNamespace() === NS_FILE && $target->getExtension() === 'pdf' ) {
        $file = wfFindFile( $target );
        if ( $file && $file->exists() ) {
            // 生成指向文件直接URL的链接
            $ret = Html::element( 'a', [
                'href' => $file->getFullURL(),
                'title' => $text ?? $target->getText()
            ], $text ?? $target->getText() );
            return false; // 阻止默认的链接生成逻辑
        }
    }
    return true;
};

添加这段代码后，所有[[File:xxx.pdf]]的链接都会自动变成指向PDF文件本身的直接链接，无需手动修改每个链接。

4. 借助扩展增强功能 #

如果需要更灵活的PDF处理（比如嵌入PDF到页面内、自定义打开行为），可以考虑安装MediaWiki的PDFEmbed扩展，不过如果只是单纯需要直接打开PDF，前面的原生方法已经足够好用了。

注意事项 #

最后提一句：用户浏览器的设置会决定是直接打开PDF还是下载它，这部分是客户端层面的控制，MediaWiki这边没法强制，但我们能确保链接指向的是PDF文件本身，而不是中转的描述页面。

内容的提问来源于stack exchange，提问作者Konrad