Extension:Ext/Tutorials

Extension:Ext/Tutorials 是一个 MediaWiki 扩展，旨在为 MediaWiki 站点提供一个结构化的教程系统。它允许管理员和编辑人员创建交互式、分步骤的教程，引导用户学习如何使用站点的各种功能，或者介绍特定主题。本文将深入探讨该扩展的功能、安装、配置、创建教程以及最佳实践，旨在为初学者提供全面的指导。

简介

在大型 MediaWiki 站点上，新用户往往需要一段时间才能熟悉平台的功能和操作。 Extension:Ext/Tutorials 通过提供引导式学习体验，有效地降低了学习曲线。教程可以包括文本、图像、视频，以及直接在 Wiki 页面上执行的操作，例如编辑、创建页面或使用特殊页面。

安装

安装 Extension:Ext/Tutorials 相对简单，遵循标准的 MediaWiki 扩展安装流程即可：

1. 从外部链接下载最新的扩展包。 (注意：替换 "some-user" 为实际的 GitHub 用户名) 2. 将下载的扩展文件夹上传到 MediaWiki 站点的 `extensions/` 目录下。 3. 编辑 `LocalSettings.php` 文件，添加以下行：

  ```php
  wfLoadExtension( 'ExtTutorials' );
  ```

4. 保存 `LocalSettings.php` 文件。 5. 运行 MediaWiki 的更新脚本，以完成安装：

  ```
  php maintenance/update.php
  ```

配置

安装完成后，需要配置 Extension:Ext/Tutorials 以满足您的站点需求。主要的配置选项位于 `LocalSettings.php` 文件中。部分常用的配置包括：

`$EGExtTutorialsNamespace`: 定义教程的命名空间。默认值为 "Tutorial"。可以根据您的站点情况进行修改。建议使用一个专门的命名空间，例如 "指南" 或 "帮助"。参见命名空间。
`$EGExtTutorialsTutorialPath`: 定义教程文件的存储路径。默认值为 "extensions/ExtTutorials/tutorials"。
`$EGExtTutorialsShowSidebar`: 控制是否在侧边栏显示教程链接。默认为 true。
`$EGExtTutorialsAdminGroup`: 定义拥有创建和编辑教程权限的用户组。默认值为 "sysop"。参见用户组。

创建教程

Extension:Ext/Tutorials 教程由一系列步骤组成，每个步骤定义了一个特定的任务或信息。教程文件使用一种简单的文本格式编写，并存储在 `$EGExtTutorialsTutorialPath` 定义的目录中。

一个典型的教程文件结构如下：

``` Tutorial:MyTutorial

步骤 1: 介绍

这是教程的第一步，介绍教程的目的和内容。

步骤 2: 创建页面

在本步骤中，我们将学习如何创建一个新的页面。点击这里创建新页面

步骤 3: 编辑页面

现在，我们来编辑刚创建的页面。点击这里编辑页面

步骤 4: 保存页面

最后，保存对页面的更改。 ```

`Tutorial:MyTutorial` 定义了教程的名称。
`=== 步骤 X: 标题 ===` 定义了每个步骤的标题。
教程内容使用标准的 MediaWiki 语法编写。
可以使用内部链接链接指向其他 Wiki 页面或特殊页面。

教程元素

Extension:Ext/Tutorials 支持多种教程元素，以增强交互性和学习体验：

文本：用于提供信息和解释。
图像：用于可视化说明。使用
File:Image.jpg
Caption
插入图像。
链接：用于指向其他 Wiki 页面或外部资源。
表：用于组织数据。使用 {| class="wikitable" ... } 创建表格。
代码：用于展示代码示例。使用 ``` 标记代码块。
操作指令：用于引导用户执行特定操作。例如：点击这里创建新页面。

高级功能

条件步骤：允许根据用户的操作或状态显示或隐藏某些步骤。
变量：允许在教程中存储和使用变量。
JavaScript 集成：允许在教程中执行 JavaScript 代码，以实现更高级的交互功能。

最佳实践

保持教程简短明了：每个步骤应该专注于一个特定的任务或概念。
使用清晰的语言：避免使用技术术语或行话。
提供足够的上下文信息：确保用户了解每个步骤的目的和意义。
使用图像和视频：可视化说明可以帮助用户更好地理解内容。
测试教程：在发布之前，务必测试教程，确保所有步骤都正确无误。
定期更新教程：随着站点的变化，教程也需要定期更新，以保持准确性。

教程管理

Extension:Ext/Tutorials 提供了一些工具来管理教程：

特殊页面 Special:Tutorials：列出所有可用的教程。
教程编辑器：允许管理员和编辑人员创建和编辑教程文件。
版本控制：所有教程文件都使用 MediaWiki 的版本控制系统进行管理，可以追溯历史版本并恢复到之前的状态。

与其他扩展的集成

Extension:Ext/Tutorials 可以与其他 MediaWiki 扩展集成，以提供更丰富的功能。例如：

Extension:VisualEditor：可以使用 VisualEditor 编辑教程文件。
Extension:CodeMirror：可以使用 CodeMirror 编辑代码示例。
Extension:Multimedia：可以使用 Multimedia 扩展插入视频和音频文件。

故障排除

教程无法显示：检查 `$EGExtTutorialsNamespace` 和 `$EGExtTutorialsTutorialPath` 配置是否正确。确保教程文件已上传到正确的目录。
教程步骤无法执行：检查操作指令的链接是否正确。确保用户具有执行操作的权限。
教程显示错误信息：检查教程文件是否存在语法错误。

进一步学习

MediaWiki 手册：外部链接
Extension:Ext/Tutorials GitHub 仓库：外部链接 (注意：替换 "some-user" 为实际的 GitHub 用户名)
MediaWiki 论坛：外部链接

立即开始交易

注册 IQ Option （最低存款 $10）开设 Pocket Option 账户（最低存款 $5）

加入我们的社区

订阅我们的 Telegram 频道 @strategybin 获取： ✓ 每日交易信号 ✓ 独家策略分析 ✓ 市场趋势警报 ✓ 新手教育资源

Extension:Ext/Tutorials

Contents