Merged
Conversation
Expanded and clarified the Skript basic and advanced tutorials, including detailed explanations of syntax, types, and usage patterns. Improved structure, added practical examples, and enhanced guidance for beginners and advanced users. Updated images and reorganized content for better readability and learning progression.
There was a problem hiding this comment.
Pull request overview
This PR provides a comprehensive revision and expansion of the Skript tutorial documentation in Chinese. The changes transform the documentation from an "unreadable" state to a well-structured, comprehensive learning resource for both beginners and advanced users.
Key Changes:
- Corrected erroneous examples and added Java fundamentals to lower the barrier to entry
- Expanded practice exercises with more reference code examples
- Updated diagrams and restructured content layout to improve readability and learning flow
- Standardized formatting to avoid irregular use of italics and quotes in headings
Reviewed changes
Copilot reviewed 3 out of 4 changed files in this pull request and generated 3 comments.
| File | Description |
|---|---|
skript.md |
Updated introduction, added detailed download links for Skript core, addons, scripts, and snippets; improved performance explanation section |
basic-tutorials.md |
Massively expanded from basic concepts to detailed tutorials covering events, commands, variables, arrays, loops, and functions with multiple practice exercises |
advanced-tutorials.md |
Enhanced skript-reflect documentation with better Java basics explanation, improved examples, and clearer structure for advanced topics |
_images/SkriptBasic1.png |
Added new screenshot image for documentation |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
docs-java/process/maintenance/lang/skript/advanced-tutorials.md
Outdated
Show resolved
Hide resolved
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
wling-art
approved these changes
Dec 21, 2025
Dreeam-qwq
added
the
type: documentation
wling-art
pushed a commit
to wling-art/NitWikit
that referenced
this pull request
Feb 1, 2026
* [feat]Revise Skript tutorials and enhance documentation Expanded and clarified the Skript basic and advanced tutorials, including detailed explanations of syntax, types, and usage patterns. Improved structure, added practical examples, and enhanced guidance for beginners and advanced users. Updated images and reorganized content for better readability and learning progression. * [修复] 修复构建 修复构建 * Update docs-java/process/maintenance/lang/skript/basic-tutorials.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Update docs-java/process/maintenance/lang/skript/advanced-tutorials.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * 🎨 文档格式化
wling-art
added a commit
that referenced
this pull request
Feb 3, 2026
* 🎨 重命名并迁移文档路径结构 * 📝 暂存-1 * 🔧 修复构建 * 📝 更新文档 * ✨ 添加 starlight-scroll-to-top * 💄 增加内容宽度 * ✨ 更新时间/贡献者显示 * 📝 添加 Bedrock 版服务器的快速开始链接卡片 * 迁移基岩版板块 * ♻️ 迁移 Tabs * ♻️ 迁移 DocCardList * 📝 修复 java 安装标题问题 * 清理无用章节 * 完成 什么是卡顿？ * 完成 服务端结构 * 完成 什么是乱码？ * 完成 什么是命名空间？ * 完成 什么是启动脚本？ * 完成 什么是 NBT？ * 完成 什么是权限？ * 完成 java basics 部分 & 修复构建 * 完成 general、about * 合并 Java 进阶知识的维护章节到进阶知识 维护章节语义不明确，包含了和服务器维护无关的东西，如资源包，反作弊，脚本语言等，直接放到进阶知识里比较好 * 修复构建 * 更改 `怎么让大佬帮我性能分析` 文档名 * 🔥 移除 Dropdown * ⬆️ 升级依赖 * 🔧 更新 GitHub 链接并移除 Sidebar 组件 * 🔧 更新图标 * 🔧 更新主题颜色变量 * [修订] 修订 Skript 教程并完善文档 (#43) * [feat]Revise Skript tutorials and enhance documentation Expanded and clarified the Skript basic and advanced tutorials, including detailed explanations of syntax, types, and usage patterns. Improved structure, added practical examples, and enhanced guidance for beginners and advanced users. Updated images and reorganized content for better readability and learning progression. * [修复] 修复构建 修复构建 * Update docs-java/process/maintenance/lang/skript/basic-tutorials.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Update docs-java/process/maintenance/lang/skript/advanced-tutorials.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * 🎨 文档格式化 * 对 Skript 教程的进一步修辞，格式调整 (#44) * 调整拼写，大小写 * 改正 Javadoc 的拼写 Javadoc 为一个专有名词 * 一些修辞调整和杂项修改 更符合阅读逻辑和体验 * 优化例子内的 Java 代码 * 修改标题层级，和练习 2 并列 * 将 Skript 代码块的语言改为 Python 以支持语法高亮 Prism 没支持 Skript 代码的语法高亮。另外 Skript 的代码语法很接近 Python 的，就改成 Python 了 除非以后我们要自己实现 Skript，Kether 等脚本语言的语法高亮 * 使用 Paper 的 Javadoc 并修复链接 * 调整格式 * Revert `将 Skript 代码块的语言改为 Python 以支持语法高亮` * 🔧 补齐折叠属性 * 🐛 修复 tailwindcss 覆盖样式 * 🎨 赞助列表自适应列 * refactor: 优化赞助者卡片组件，集成 DaisyUI 样式框架 (#5) * 🔧 移除 --host 参数 * 🎨 使用 router 过渡访问 * 🎨 添加 hero 页背景渐变 参考：https://github.com/sibiraj-s/ngx-editor/blob/master/docs/src/assets/landing.css * 🎨 添加平滑滚动跳转效果 * 🔧 run prettier * 📝 恢复 markdown 格式 --------- Co-authored-by: Dreeam <61569423+Dreeam-qwq@users.noreply.github.com> Co-authored-by: Radiation-pi <96102795+Radiation-pi@users.noreply.github.com> Co-authored-by: Ziphyrien <111620796+Ziphyrien@users.noreply.github.com>
wling-art
added a commit
to HanSiqi2008/NitWikit
that referenced
this pull request
Feb 3, 2026
* 🎨 重命名并迁移文档路径结构 * 📝 暂存-1 * 🔧 修复构建 * 📝 更新文档 * ✨ 添加 starlight-scroll-to-top * 💄 增加内容宽度 * ✨ 更新时间/贡献者显示 * 📝 添加 Bedrock 版服务器的快速开始链接卡片 * 迁移基岩版板块 * ♻️ 迁移 Tabs * ♻️ 迁移 DocCardList * 📝 修复 java 安装标题问题 * 清理无用章节 * 完成 什么是卡顿？ * 完成 服务端结构 * 完成 什么是乱码？ * 完成 什么是命名空间？ * 完成 什么是启动脚本？ * 完成 什么是 NBT？ * 完成 什么是权限？ * 完成 java basics 部分 & 修复构建 * 完成 general、about * 合并 Java 进阶知识的维护章节到进阶知识 维护章节语义不明确，包含了和服务器维护无关的东西，如资源包，反作弊，脚本语言等，直接放到进阶知识里比较好 * 修复构建 * 更改 `怎么让大佬帮我性能分析` 文档名 * 🔥 移除 Dropdown * ⬆️ 升级依赖 * 🔧 更新 GitHub 链接并移除 Sidebar 组件 * 🔧 更新图标 * 🔧 更新主题颜色变量 * [修订] 修订 Skript 教程并完善文档 (Cubic-Project#43) * [feat]Revise Skript tutorials and enhance documentation Expanded and clarified the Skript basic and advanced tutorials, including detailed explanations of syntax, types, and usage patterns. Improved structure, added practical examples, and enhanced guidance for beginners and advanced users. Updated images and reorganized content for better readability and learning progression. * [修复] 修复构建 修复构建 * Update docs-java/process/maintenance/lang/skript/basic-tutorials.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Update docs-java/process/maintenance/lang/skript/advanced-tutorials.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * 🎨 文档格式化 * 对 Skript 教程的进一步修辞，格式调整 (Cubic-Project#44) * 调整拼写，大小写 * 改正 Javadoc 的拼写 Javadoc 为一个专有名词 * 一些修辞调整和杂项修改 更符合阅读逻辑和体验 * 优化例子内的 Java 代码 * 修改标题层级，和练习 2 并列 * 将 Skript 代码块的语言改为 Python 以支持语法高亮 Prism 没支持 Skript 代码的语法高亮。另外 Skript 的代码语法很接近 Python 的，就改成 Python 了 除非以后我们要自己实现 Skript，Kether 等脚本语言的语法高亮 * 使用 Paper 的 Javadoc 并修复链接 * 调整格式 * Revert `将 Skript 代码块的语言改为 Python 以支持语法高亮` * 🔧 补齐折叠属性 * 🐛 修复 tailwindcss 覆盖样式 * 🎨 赞助列表自适应列 * refactor: 优化赞助者卡片组件，集成 DaisyUI 样式框架 (Cubic-Project#5) * 🔧 移除 --host 参数 * 🎨 使用 router 过渡访问 * 🎨 添加 hero 页背景渐变 参考：https://github.com/sibiraj-s/ngx-editor/blob/master/docs/src/assets/landing.css * 🎨 添加平滑滚动跳转效果 * 🔧 run prettier * 📝 恢复 markdown 格式 --------- Co-authored-by: Dreeam <61569423+Dreeam-qwq@users.noreply.github.com> Co-authored-by: Radiation-pi <96102795+Radiation-pi@users.noreply.github.com> Co-authored-by: Ziphyrien <111620796+Ziphyrien@users.noreply.github.com>
wling-art
added a commit
that referenced
this pull request
Feb 3, 2026
* Update pcl.md 剔除一个危险的，不具有普适性的操作 * 更换 NitWikit 文档框架 (#55) * 🎨 重命名并迁移文档路径结构 * 📝 暂存-1 * 🔧 修复构建 * 📝 更新文档 * ✨ 添加 starlight-scroll-to-top * 💄 增加内容宽度 * ✨ 更新时间/贡献者显示 * 📝 添加 Bedrock 版服务器的快速开始链接卡片 * 迁移基岩版板块 * ♻️ 迁移 Tabs * ♻️ 迁移 DocCardList * 📝 修复 java 安装标题问题 * 清理无用章节 * 完成 什么是卡顿？ * 完成 服务端结构 * 完成 什么是乱码？ * 完成 什么是命名空间？ * 完成 什么是启动脚本？ * 完成 什么是 NBT？ * 完成 什么是权限？ * 完成 java basics 部分 & 修复构建 * 完成 general、about * 合并 Java 进阶知识的维护章节到进阶知识 维护章节语义不明确，包含了和服务器维护无关的东西，如资源包，反作弊，脚本语言等，直接放到进阶知识里比较好 * 修复构建 * 更改 `怎么让大佬帮我性能分析` 文档名 * 🔥 移除 Dropdown * ⬆️ 升级依赖 * 🔧 更新 GitHub 链接并移除 Sidebar 组件 * 🔧 更新图标 * 🔧 更新主题颜色变量 * [修订] 修订 Skript 教程并完善文档 (#43) * [feat]Revise Skript tutorials and enhance documentation Expanded and clarified the Skript basic and advanced tutorials, including detailed explanations of syntax, types, and usage patterns. Improved structure, added practical examples, and enhanced guidance for beginners and advanced users. Updated images and reorganized content for better readability and learning progression. * [修复] 修复构建 修复构建 * Update docs-java/process/maintenance/lang/skript/basic-tutorials.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Update docs-java/process/maintenance/lang/skript/advanced-tutorials.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * 🎨 文档格式化 * 对 Skript 教程的进一步修辞，格式调整 (#44) * 调整拼写，大小写 * 改正 Javadoc 的拼写 Javadoc 为一个专有名词 * 一些修辞调整和杂项修改 更符合阅读逻辑和体验 * 优化例子内的 Java 代码 * 修改标题层级，和练习 2 并列 * 将 Skript 代码块的语言改为 Python 以支持语法高亮 Prism 没支持 Skript 代码的语法高亮。另外 Skript 的代码语法很接近 Python 的，就改成 Python 了 除非以后我们要自己实现 Skript，Kether 等脚本语言的语法高亮 * 使用 Paper 的 Javadoc 并修复链接 * 调整格式 * Revert `将 Skript 代码块的语言改为 Python 以支持语法高亮` * 🔧 补齐折叠属性 * 🐛 修复 tailwindcss 覆盖样式 * 🎨 赞助列表自适应列 * refactor: 优化赞助者卡片组件，集成 DaisyUI 样式框架 (#5) * 🔧 移除 --host 参数 * 🎨 使用 router 过渡访问 * 🎨 添加 hero 页背景渐变 参考：https://github.com/sibiraj-s/ngx-editor/blob/master/docs/src/assets/landing.css * 🎨 添加平滑滚动跳转效果 * 🔧 run prettier * 📝 恢复 markdown 格式 --------- Co-authored-by: Dreeam <61569423+Dreeam-qwq@users.noreply.github.com> Co-authored-by: Radiation-pi <96102795+Radiation-pi@users.noreply.github.com> Co-authored-by: Ziphyrien <111620796+Ziphyrien@users.noreply.github.com> * 🐛 修正 README 错误内容 (#56) * 🐛 修正 README 中的 NitWikit 横幅图片路径 * 📝 修改本地预览步骤并移除过时的部署测试网站指令 * 🐛 修正 NitWikit 横幅图片路径 * 🔧 更新构建输出目录至 ./build (#57) --------- Co-authored-by: MrlingXD <90316914+wling-art@users.noreply.github.com> Co-authored-by: Dreeam <61569423+Dreeam-qwq@users.noreply.github.com> Co-authored-by: Radiation-pi <96102795+Radiation-pi@users.noreply.github.com> Co-authored-by: Ziphyrien <111620796+Ziphyrien@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
对 Skript 基础与高级教程进行了全面扩展与内容优化，主要包括：
修改了错误的例子，新增了一些对 Java 的基础知识补充，提升初学者引导，降低入门难度
补充例子和练习，提供更多 Skript 可参考的代码；
更新配图示例并重构内容排布，强化可读性与学习路径连贯性；
按照格式规范进行格式修改，避免在标题中大量使用斜体和引用等不规范用法。
至此，Skript 部分已经处于可读状态。
[TODO] Skript Addon 的编写和一些好用的 Skript 片段以供参考