查看“︁帮助:图片指南”︁的源代码

本指南将帮助您在 MediaWiki 中上传、插入和管理图片，以丰富页面内容并提升读者的阅读体验。

== 📤 上传图片 ==

在将图片插入页面之前，您需要先将其上传到 Wiki 服务器。

=== 上传步骤 ===
# ''' 访问上传页面 '''：在页面左侧的 "工具箱" 中，点击 "[[Special:Upload | 上传文件]]" 链接。
# ''' 选择文件 '''：点击 "浏览" 按钮（不同浏览器中此按钮名称可能不同），在您的计算机上选择要上传的图片文件。
# ''' 填写文件信息 '''：
  ''' 目标文件名 '''：为文件取一个''' 有描述性 '''的名字（例如：<code>Sunflower_field.jpg</code> 而非 <code>IMG_001.jpg</code>），上传后''' 无法更改 '''。
  ''' 摘要 '''：提供文件的详细描述，包括''' 图片来源、作者、版权状态 '''等信息。
  ''' 许可协议 '''：选择合适的许可协议。
* ''' 上传文件 '''：点击 "上传文件" 按钮。如果文件较大，上传可能需要一些时间。

=== 上传前注意事项 ===
* 确保图片为 ''' 最终格式 '''，并确认其呈现效果符合预期。
* 使用 ''' 描述性强的文件名 '''，便于后续查找和管理。
* 确认您拥有图片的版权或上传许可，并 ''' 在摘要中明确说明来源 '''。

== 🖋️ 在页面中插入图片 ==

上传图片后，您可以在页面中使用 Wikitext 语法或可视化编辑器插入它。

=== 基本语法 ===
显示图像的基本语法是：
<syntaxhighlight lang="wikitext">
[[File: 文件名。扩展名 | 选项 | 标题]]
</syntaxhighlight>

=== 常用选项与参数详解 ===
以下选项可按任意顺序组合，用管道符号 <code>|</code> 分隔：

{| class="wikitable"
|-
! 参数类型 || 选项 || 说明与示例
|-
| rowspan="3" | ''' 格式 ''' || <code>border</code> || 为图片添加边框
|-
| <code>frameless</code> || 无框显示
|-
| <code>thumb</code> 或 <code>thumbnail</code> || ''' 缩略图 ''' 格式，自动添加边框并在下方显示标题
|-
| rowspan="4" | ''' 尺寸 ''' || <code>{宽度} px</code> || 按指定宽度缩放（如 <code>300px</code>），高度自动按比例调整
|-
| <code>x {高度} px</code> || 按指定高度缩放（如 <code>x200px</code>）
|-
| <code>{宽度} x {高度} px</code> || 同时指定宽高（如 <code>300x200px</code>）
|-
| <code>upright</code> || 根据用户偏好调整尺寸，适用于高度大于宽度的图片，常与 <code>thumb</code> 联用
|-
| rowspan="4" | ''' 对齐 ''' || <code>left</code> || 图片 ''' 左浮动 '''，文字环绕其右侧
|-
| <code>right</code> || 图片 ''' 右浮动 '''，文字环绕其左侧
|-
| <code>center</code> || 图片 ''' 居中 ''' 显示，无文字环绕
|-
| <code>none</code> || 无特殊对齐
|-
| rowspan="2" | ''' 链接 ''' || <code>link = 目标 </code> || 更改图片点击后的链接目标（页面标题或 URL），例如 <code>link = 首页 </code> 或 <code>link=https://example.com</code>
|-
| <code>link=</code> || （空值）使图片 ''' 不可点击 '''
|-
| ''' 无障碍 ''' || <code>alt = 替代文本 </code> || 为视觉障碍用户提供 ''' 替代文本 ''' 描述
|}

=== 完整示例 ===
<syntaxhighlight lang="wikitext">
[[File:Example.jpg|thumb|right|300px|alt = 一朵向日葵 | 向日葵田，摄于夏季。]]
</syntaxhighlight>
此代码效果：在页面 ''' 右侧 ''' 显示一个宽 '''300 像素 ''' 的 ''' 缩略图 '''，并带有 ''' 替代文本 ''' 和 ''' 图片描述 '''。

== 🎞️ 创建图片画廊 ==

要在一个区域集中展示多张图片，可以使用 <code><nowiki><gallery></nowiki></code> 标签。

<syntaxhighlight lang="wikitext">
<gallery>
File:Example1.jpg | 图 1 说明
File:Example2.jpg | 图 2 说明
File:Example3.jpg | 图 3 说明，说明中可包含 [[链接]]。
</gallery>
</syntaxhighlight>

''' 注意 '''：画廊内的图片只需写 <code>File:</code> 和文件名，无需双方括号，图片说明可选。

== 📄 文件描述页与管理 ==

每个上传的文件都有一个对应的 "文件描述页"，页面名称为 <code>File: 文件名 </code>。

=== 文件描述页内容 ===
文件描述页包含：
* ''' 图片预览 ''' 及分辨率信息。
* 文件描述页的 '''wikitext 内容 '''。
* ''' 文件历史 '''：记录所有上传版本。
* ''' 文件用途 '''：列出所有使用该文件的页面。
* ''' 元数据 '''：如图片的 EXIF 信息。

=== 管理图片 ===
* ''' 编辑描述页 '''：您可以编辑文件描述页，以更新图片的描述、来源或分类信息。请注意，这 ''' 不会修改图片文件本身 '''。
* ''' 更新图片 '''：要替换图片文件，请到 "文件历史" 部分上传新版本。
* ''' 分类图片 '''：在文件描述页（或上传时的摘要）中添加分类标签，例如 <code><nowiki>[[Category: 植物图片]]</nowiki></code>，以便于管理。

== ✅ 支持的图片格式 ==

MediaWiki 默认支持以下图片格式：
* <code>.jpg</code> 或 <code>.jpeg</code>：适用于照片等有损压缩的位图图像。
* <code>.png</code>："便携式网络图形" 格式的位图图像，支持无损压缩和透明背景。
* <code>.gif</code>：支持简单动画的位图图像。
* <code>.webp</code>：支持有损和无损压缩的新型格式，压缩率较高。

其他可能支持的格式（可能需要额外配置）包括：
* <code>.svg</code>：可缩放矢量图形格式。
* <code>.tiff</code>：标签图像文件格式，常用于高分辨率照片。

== 🛠️ 图片管理与维护 ==

=== 特殊页面 ===
通过 "[[Special:Upload | 特殊页面]]" （在 "工具" 中）可以访问以下有用的页面：
* ''' 新文件 '''：查看最新上传的文件。
* ''' 文件列表 '''：列出所有已上传的文件。
* ''' 未使用文件 '''：查找未被任何页面引用的文件，这些文件可能是清理的候选。

=== 管理员配置 ===
* ''' 文件上传开关与限制 '''：站点管理员需要在 <code>LocalSettings.php</code> 中配置文件上传功能，并可设置文件 ''' 大小限制 ''' 和 ''' 允许的文件类型 '''。
* ''' 图形库 '''：如需服务器端图像大小调整等功能，需要配置如 GD2 或 ImageMagick 等图形库。

== ⚠️ 重要注意事项 ==

* ''' 版权问题 '''：确保您上传的图片 ''' 没有版权争议 '''，遵守相关法律法规。明确说明图片来源和授权方式。
* ''' 文件命名 '''：使用 ''' 描述性强的文件名 '''，避免使用泛泛或无意义的名称（如 <code>image1.jpg</code>）。
* ''' 图片优化 '''：在上传前，考虑 ''' 压缩图片 ''' 以减少文件大小，提高页面加载速度。
* ''' 替代文本 '''：为图片提供有意义的 <code>alt</code> 文本，以提升 ''' 无障碍访问 ''' 体验。

== 🚀 进阶技巧 ==

* 使用可视化编辑器插入和编辑图片通常更简单，特别是对于不熟悉语法的用户。
* 通过 <code>link</code> 参数可以将图片链接到其他页面或外部网站，创造更丰富的交互体验。
* 利用 ''' 分类 ''' 功能可以高效地组织和管理大量图片。

通过以上指南，您可以有效地上传、使用和管理 MediaWiki 中的图片，使您的页面内容更加生动和丰富。

== 📖 参阅 ==

* [[Help: 快速指南]]
* [[Help: 编辑页面]]
* [[Help: 格式化文本]]
{{Template: 站点帮助文档}}