打开/关闭菜单
打开/关闭外观设置菜单
打开/关闭个人菜单
未登录
未登录用户的IP地址会在进行任意编辑后公开展示。

帮助:移动优化:修订间差异

来自陋室
删除的内容 添加的内容
XP-jia留言 | 贡献
update
Maintenance script留言 | 贡献
补充移动优化验证步骤
 
(未显示2个用户的4个中间版本)
第1行: 第1行:
本指南介绍如何优化MediaWiki页面布局,特别是在移动设备上的显示效果。
本指南介绍如何优化 MediaWiki 页面布局,特别是在移动设备上的显示效果。


== 📏 宽度 vs 高度 ==
== 📏 宽度 vs 高度 ==
网页布局通常涉及'''宽度'''和'''高度''':
网页布局通常涉及 '''宽度'' '''高度'':
* 当'''高度'''超出屏幕显示范围时,会出现'''上下滚动条''',但这通常不影响阅读。
* 当 '''高度'' 超出屏幕显示范围时,会出现 '''上下滚动条'',但这通常不影响阅读。
* 当'''宽度'''超出屏幕显示范围时,会出现'''左右滚动条''',这会导致阅读困难,因为用户需要不断左右滑动才能阅读完整内容。
* 当 '''宽度'' 超出屏幕显示范围时,会出现 '''左右滚动条'',这会导致阅读困难,因为用户需要不断左右滑动才能阅读完整内容。


由于现代网页主要采用'''横向排版''',应尽量避免'''页面元素超出屏幕宽度''',尤其是在移动设备上。
由于现代网页主要采用 '''横向排版'',应尽量避免 '''页面元素超出屏幕宽度'',尤其是在移动设备上。


== 📱 移动设备屏幕特性 ==
== 📱 移动设备屏幕特性 ==
移动设备屏幕宽度通常在'''320px至414px'''之间(不考虑像素密度)。虽然手机物理分辨率越来越高,但网页显示仍受限于设备可视区域:
移动设备屏幕宽度通常在 '''320px 414px'''之间(不考虑像素密度)。虽然手机物理分辨率越来越高,但网页显示仍受限于设备可视区域:
* '''桌面端'''屏幕宽度一般不低于'''1024px'''
*'' 桌面端 '''屏幕宽度一般不低于''1024px'''*'' 移动端 '''理想内容宽度应控制在''≤414px''',避免横向滚动
* '''移动端'''理想内容宽度应控制在'''≤414px''',避免横向滚动


== 🎯 常见屏幕分辨率 ==
== 🎯 常见屏幕分辨率 ==
MediaWiki站点访问设备的典型分辨率分布:
MediaWiki 站点访问设备的典型分辨率分布:
{| class="wikitable"
{| class="wikitable"
|-
|-
! 设备类型 !! 常见屏幕宽度
! 设备类型 || 常见屏幕宽度
|-
|-
| 桌面端 || ≥ 1024px
| 桌面端 || ≥ 1024px
第29行: 第28行:


=== 📊 表格响应式优化 ===
=== 📊 表格响应式优化 ===
表格是MediaWiki中常见元素,但容易导致移动端横向滚动。推荐使用响应式表格:
表格是 MediaWiki 中常见元素,但容易导致移动端横向滚动。推荐使用响应式表格:


<syntaxhighlight lang="html">
<syntaxhighlight lang="html">
第35行: 第34行:
{| class="wikitable"
{| class="wikitable"
|-
|-
! 标题1
! 标题 1
! 标题2
! 标题 2
|-
|-
| 内容1
| 内容 1
| 内容2
| 内容 2
|}
|}
</div>
</div>
</syntaxhighlight>
</syntaxhighlight>


或者使用CSS实现:
或者使用 CSS 实现:
<syntaxhighlight lang="css">
<syntaxhighlight lang="css">
.mw-responsive-table {
.mw-responsive-table {
第53行: 第52行:
</syntaxhighlight>
</syntaxhighlight>


🔹 '''效果''':桌面端保持原宽度,移动端变为可横向滚动,不撑破页面布局。
🔹 '''效果'':桌面端保持原宽度,移动端变为可横向滚动,不撑破页面布局。


=== 📐 自适应元素设计 ===
=== 📐 自适应元素设计 ===
对于图片、容器等定宽元素,使用MediaWiki的CSS类实现自适应:
对于图片、容器等定宽元素,使用 MediaWiki CSS 类实现自适应:


<syntaxhighlight lang="html">
<syntaxhighlight lang="html">
<div class="mw-mobile-responsive" style="max-width: 600px; margin: 0 auto;">
<div class="mw-mobile-responsive" style="max-width: 600px; margin: 0 auto;">
[[File:示例图片.jpg|alt=示例|600px]]
[[File: 示例图片.jpg|alt = 示例 | 600px]]
</div>
</div>
</syntaxhighlight>
</syntaxhighlight>


🔹 '''效果''':
🔹 '''效果'':
* '''桌面端''':保持600px宽度
* '''桌面端'':保持 600px 宽度
* '''移动端''':自动调整为100%宽度
* '''移动端'':自动调整为 100% 宽度


=== 🎨 使用多列模板 ===
=== 🎨 使用多列模板 ===
MediaWiki的Columns模板可以帮助创建响应式多列布局:
MediaWiki Columns 模板可以帮助创建响应式多列布局:


<syntaxhighlight lang="wikitext">
<syntaxhighlight lang="wikitext">
第77行: 第76行:
|gap=1em
|gap=1em
|
|
* [[页面1]]
* [[页面 1]]
* [[页面2]]
* [[页面 2]]
* [[页面3]]
* [[页面 3]]
* [[页面4]]
* [[页面 4]]
}}
}}
</syntaxhighlight>
</syntaxhighlight>


=== ✏️ 编辑最佳实践 ===
=== ✏️ 编辑最佳实践 ===
* 编辑时使用'''显示预览'''功能检查效果
* 编辑时使用 '''显示预览'' 功能检查效果
* 在'''编辑摘要'''中简要描述修改内容
* 在 '''编辑摘要'' 中简要描述修改内容
* 使用'''显示更改'''对比版本差异
* 使用 '''显示更改'' 对比版本差异


=== 📱 移动端皮肤配置 ===
=== 📱 移动端皮肤配置 ===
在<code>LocalSettings.php</code>中设置移动端皮肤:
<code>LocalSettings.php</code > 中设置移动端皮肤:
<syntaxhighlight lang="php">
<syntaxhighlight lang="php">
$wgDefaultMobileSkin = 'minerva';
$wgDefaultMobileSkin = 'minerva';
第98行: 第97行:
=== 🧪 移动端效果测试 ===
=== 🧪 移动端效果测试 ===
在桌面浏览器中测试移动端显示:
在桌面浏览器中测试移动端显示:
1. 右键点击页面,选择'''审查元素'''
# 右键点击页面,选择 '''审查元素''
2. 点击'''设备模拟'''图标(手机/平板)
# 点击 '''设备模拟'' 图标(手机/平板)
3. 选择不同设备分辨率测试显示效果
# 选择不同设备分辨率测试显示效果


== 🔧 高级布局调整 ==
== 🔧 高级布局调整 ==


=== 页面宽度全局调整 ===
=== 页面宽度全局调整 ===
通过修改MediaWiki皮肤CSS调整整体宽度:
通过修改 MediaWiki 皮肤 CSS 调整整体宽度:
<syntaxhighlight lang="css">
<syntaxhighlight lang="css">/* 在 MediaWiki:Common.css 中添加 */#globalWrapper {
/* 在MediaWiki:Common.css中添加 */
#globalWrapper {
max-width: 1200px;
max-width: 1200px;
margin: 0 auto;
margin: 0 auto;
第122行: 第119行:
=== 图片响应式处理 ===
=== 图片响应式处理 ===
<syntaxhighlight lang="wikitext">
<syntaxhighlight lang="wikitext">
[[File:示例.jpg|frameless|600px|class=responsive-img|alt=替代文本]]
[[File: 示例.jpg|frameless|600px|class=responsive-img|alt = 替代文本]]
</syntaxhighlight>
</syntaxhighlight>

== 测试与验证 ==

* 在桌面浏览器开发者工具中启用设备模拟,分别测试 320px、375px 和 414px 宽度,确保关键内容不会横向溢出。
* 参考 [[MediaWiki:Common.css]] 中的全局响应式样式,如果需自定义可在 [[MediaWiki:Common.js]] 或 [[MediaWiki:Common.css]] 添加局部规则。
* 完成修改后,利用 [[Help:快速指南]] 中的预览与显示更改功能验证在移动/桌面视图的实际表现。


== ❗ 常见问题与解决 ==
== ❗ 常见问题与解决 ==
第133行: 第136行:
|-
|-
| 表格横向滚动
| 表格横向滚动
| 添加<code>class="table-responsive"</code>
| 添加 <code>class="table-responsive"</code>
|-
|-
| 图片超出边界
| 图片超出边界
| 设置<code>max-width: 100%</code>
| 设置 <code>max-width: 100%</code>
|-
|-
| 代码块溢出
| 代码块溢出
| 使用<code>&lt;syntaxhighlight&gt;</code>标签
| 使用 <code><syntaxhighlight></code > 标签
|}
|}


== 🔚 总结 ==
== 🔚 总结 ==
通过上述优化方法,可以显著改善MediaWiki页面在移动端的阅读体验:
通过上述优化方法,可以显著改善 MediaWiki 页面在移动端的阅读体验:
* 使用'''响应式表格'''和'''自适应布局'''
* 使用 '''响应式表格'' '''自适应布局''
* 合理配置'''移动端皮肤'''
* 合理配置 '''移动端皮肤''
* 充分利用'''预览和测试'''工具
* 充分利用 '''预览和测试'' 工具
* 遵循MediaWiki编辑最佳实践
* 遵循 MediaWiki 编辑最佳实践


记住:在编辑过程中随时预览移动端效果,确保所有用户都能获得良好的阅读体验!
记住:在编辑过程中随时预览移动端效果,确保所有用户都能获得良好的阅读体验!


<includeonly>[[Category:帮助文档]]</includeonly>
{{Template: 站点帮助文档}}
<noinclude>
{{Template:站点帮助文档}}
</noinclude>

2025年12月26日 (五) 21:12的最新版本

本指南介绍如何优化 MediaWiki 页面布局,特别是在移动设备上的显示效果。

📏 宽度 vs 高度

网页布局通常涉及 宽度高度

  • 高度 超出屏幕显示范围时,会出现 上下滚动条,但这通常不影响阅读。
  • 宽度 超出屏幕显示范围时,会出现 左右滚动条,这会导致阅读困难,因为用户需要不断左右滑动才能阅读完整内容。

由于现代网页主要采用 横向排版,应尽量避免 页面元素超出屏幕宽度,尤其是在移动设备上。

📱 移动设备屏幕特性

移动设备屏幕宽度通常在 320px 至 414px之间(不考虑像素密度)。虽然手机物理分辨率越来越高,但网页显示仍受限于设备可视区域:

  • 桌面端 屏幕宽度一般不低于1024px* 移动端 理想内容宽度应控制在≤414px,避免横向滚动

🎯 常见屏幕分辨率

MediaWiki 站点访问设备的典型分辨率分布:

设备类型 常见屏幕宽度
桌面端 ≥ 1024px
平板设备 600px - 1024px
手机端 320px - 414px

✅ 移动端优化策略

📊 表格响应式优化

表格是 MediaWiki 中常见元素,但容易导致移动端横向滚动。推荐使用响应式表格:

<div class="table-responsive">
{| class="wikitable"
|-
! 标题 1
! 标题 2
|-
| 内容 1
| 内容 2
|}
</div>

或者使用 CSS 实现:

.mw-responsive-table {
  width: 100%;
  overflow-x: auto;
  display: block;
}

🔹 '效果:桌面端保持原宽度,移动端变为可横向滚动,不撑破页面布局。

📐 自适应元素设计

对于图片、容器等定宽元素,使用 MediaWiki 的 CSS 类实现自适应:

<div class="mw-mobile-responsive" style="max-width: 600px; margin: 0 auto;">
[[File: 示例图片.jpg|alt = 示例 | 600px]]
</div>

🔹 '效果

  • '桌面端:保持 600px 宽度
  • '移动端:自动调整为 100% 宽度

🎨 使用多列模板

MediaWiki 的 Columns 模板可以帮助创建响应式多列布局:

{{Columns
|count=2
|width=300px
|gap=1em
|
* [[页面 1]]
* [[页面 2]] 
* [[页面 3]]
* [[页面 4]]
}}

✏️ 编辑最佳实践

  • 编辑时使用 '显示预览 功能检查效果
  • 在 '编辑摘要 中简要描述修改内容
  • 使用 '显示更改 对比版本差异

📱 移动端皮肤配置

LocalSettings.php 中设置移动端皮肤:

$wgDefaultMobileSkin = 'minerva';
$wgMFEnableDesktopResources = true;

🧪 移动端效果测试

在桌面浏览器中测试移动端显示:

  1. 右键点击页面,选择 '审查元素
  2. 点击 '设备模拟 图标(手机/平板)
  3. 选择不同设备分辨率测试显示效果

🔧 高级布局调整

页面宽度全局调整

通过修改 MediaWiki 皮肤 CSS 调整整体宽度:

/* 在 MediaWiki:Common.css 中添加 */#globalWrapper {
  max-width: 1200px;
  margin: 0 auto;
}
@media screen and (max-width: 768px) {
  #globalWrapper {
    max-width: 100%;
    padding: 0 10px;
  }
}

图片响应式处理

[[File: 示例.jpg|frameless|600px|class=responsive-img|alt = 替代文本]]

测试与验证

  • 在桌面浏览器开发者工具中启用设备模拟,分别测试 320px、375px 和 414px 宽度,确保关键内容不会横向溢出。
  • 参考 MediaWiki:Common.css 中的全局响应式样式,如果需自定义可在 MediaWiki:Common.jsMediaWiki:Common.css 添加局部规则。
  • 完成修改后,利用 Help:快速指南 中的预览与显示更改功能验证在移动/桌面视图的实际表现。

❗ 常见问题与解决

问题 解决方案
表格横向滚动 添加 class="table-responsive"
图片超出边界 设置 max-width: 100%
代码块溢出 使用 <syntaxhighlight> 标签

🔚 总结

通过上述优化方法,可以显著改善 MediaWiki 页面在移动端的阅读体验:

  • 使用 响应式表格自适应布局
  • 合理配置 '移动端皮肤
  • 充分利用 '预览和测试 工具
  • 遵循 MediaWiki 编辑最佳实践

记住:在编辑过程中随时预览移动端效果,确保所有用户都能获得良好的阅读体验!