milung/wac-textbook Docker 镜像 - 轩辕镜像

仓库迁移通知

我们已将教材开发迁移至新仓库。本仓库现已归档，所有后续更新将在wac-fiit组织维护的派生仓库中进行。请相应更新您的书签和引用。

云环境下Web应用开发课程教材源材料

概述

本仓库包含斯洛伐克语书籍《云环境下Web应用开发》(Vývoj webových aplikácii v prostredí Cloud)的源材料。书籍可通过[***]

材料采用知识共享署名4.0国际许可协议授权。

仓库包含用于生成《云环境下Web应用开发》(WAC)教材的Markdown文件和图片。

仓库使用流程

目录结构与核心文件

book-src目录中存储所有源材料，每个教材章节存放在独立子目录中。book-src目录下包含以下核心文件：

• _toc.md：教材目录文件，包含指向各章节的相对链接。每个章节目录下也有独立的_toc.md，包含该章节内的子章节链接。
• _links.md：资源链接文件，自动添加到每个章节，可通过符号名称引用外部资源，便于集中管理链接和生成文献列表。

内容包含机制

使用[#include sekcia/_toc.md]命令可将子章节内容包含到上级章节或全书内容中。该命令确保子章节仅在主目录中显示时，才会在导航面板中可见。

贡献教材

开发环境设置

推荐使用Development Container进行教材开发，支持以下方式：

• 创建Github Codespaces
• 通过Visual Studio Code Remote - Containers打开开发容器

开发容器使用

开发容器通过postStartCommand启动HTTP服务器，监听端口3380。在Ports标签页打开该端口后，浏览器中可查看教材当前版本。为实时反映修改，需在浏览器开发者工具的"网络"选项卡中禁用缓存。

若启动失败或内容未自动更新，可终止postStartCommand进程，打开新的Powershell终端，进入wac-textbook目录执行以下命令：

ps
./scripts/run.ps1 devc-start

教材生成

通过以下步骤生成新版本教材：

1. 将修改提交至main分支
2. 创建格式为v1.*.*的release标签

该标签将触发GitHub Action，生成新版本教材并发布至[***]

Markdown特定扩展

目录文件图标定义

在_toc.md文件中，可使用以下语法定义章节图标：

markdown
$icon-name> 标签文本

• 图标名称来自fontawesome，前缀为$，后跟>
• 若无前缀$，则使用Material Symbols图标
• 图标名称使用连字符(-)代替下划线(_)

示例_toc.md：

markdown
$graduation-cap> 引言
序言

<hr />
## language> 第1章：Web开发

[#include dojo/web/_toc.md]
<hr />

带图标注释块

使用以下语法添加带图标注释块：

markdown
>$icon-name:> 注释文本内容

• 图标名称规则同上（fontawesome需前缀$，Material Symbols无需）

推荐图标使用场景：

• >info:>：补充信息
• >warning:>：重要提示
• >build_circle:>：问题解决方法
• >$apple:>：Mac OS特定内容
• >homework:>：独立作业标识

代码块高亮标记

在代码块中可使用以下标记：

• @_add_@：标记新增行（高亮显示）
• @_remove_@：标记删除行（高亮显示）
• @_important_@：标记重要行（高亮显示）

标记字符及删除行内容在复制时不会被包含。