编辑“︁内容撰写指南”︁

本页面介绍在 Robuddy Wiki 中撰写词条内容的方法。

== 创建页面 ==
在左侧的搜索框搜索新词条，如果该词条没有被创建，点击下方“创建或编辑页面”就可以创建属于你的词条啦
{{Note|创建词条的时候，请加上分类（参见首页的六大板块），例如，您的机器人项目可以在源代码编辑器任意位置加上<nowiki>
[[Category:机器人博物馆]]
</nowiki>}}

{{Warning|建议注册账号后再编辑，以保护您对所创作内容的知识产权}}
== 编辑方式 ==

点击页面顶部的标签切换：
{{Note|编辑时请先点击「显示预览」再保存}}
{| class="wikitable"
! !! 可视化编辑 !! 源代码编辑
|-
| 入口 || 点击「编辑」标签 || 点击「编辑源代码」标签
|-
| 适合 || 新手、日常编辑 || 熟悉语法的用户
|-
| 特点 || 所见即所得 || 灵活度高
|}
[[Category:帮助文档]]

== Wikitext 简明简介 ==
'''Wikitext''' 是维基百科及其姊妹项目使用的标记语言，用于格式化文本、插入链接、表格、图片等。  

它比 HTML 更易读，且支持丰富的'''内容结构'''。

== 常用语法速查表 ==
{| class="wikitable" style="width:100%;"
|+ Wikitext 常用语法示例
! 功能 !! 输入（Wikitext） !! 输出（效果）
|-
| 斜体 || <nowiki>''斜体''</nowiki> || ''斜体''
|-
| 粗体 || <nowiki>'''粗体'''</nowiki> || '''粗体'''
|-
| 粗斜体 || <nowiki>'''''粗斜体'''''</nowiki> || '''''粗斜体'''''
|-
| 二级标题 || <nowiki>== 标题 ==</nowiki> || <span style="color:#666;">（生成章节标题）</span>
|-
| 三级标题 || <nowiki>=== 标题 ===</nowiki> || <span style="color:#666;">（生成子章节标题）</span>
|-
| 无序列表 || <nowiki>* 项目一</nowiki><br><nowiki>* 项目二</nowiki><br><nowiki>** 子项目</nowiki> || 
* 项目一
* 项目二
** 子项目
|-
| 有序列表 || <nowiki># 第一步</nowiki><br><nowiki># 第二步</nowiki><br><nowiki>## 子步骤</nowiki> || 
# 第一步
# 第二步
## 子步骤
|-
| 内部链接 || <nowiki>[[模板使用指南]]</nowiki> || [[模板使用指南]]
|-
| 内部链接（别名） || <nowiki>[[条目名称|显示文字]]</nowiki> || [[模板使用指南|模板]]
|-
| 外部链接 || <nowiki>[https://example.com 显示文字]</nowiki> || [https://example.com 示例]
|-
| 外部链接（裸） || <nowiki>https://example.com</nowiki> || https://example.com
|-
| 脚注引用 || <nowiki><ref>来源内容</ref></nowiki> || <span style="color:#666;">（生成脚注标号）</span>
|-
| 显示脚注 || <nowiki><references /></nowiki> || <span style="color:#666;">（列出所有脚注）</span>
|-
| 签名+时间戳 || <nowiki>~~~~</nowiki> || <span style="color:#666;">（仅用于讨论页）</span>
|-
| 注释（隐藏） || <nowiki><!-- 注释 --></nowiki> || <span style="color:#666;">（不显示）</span>
|-
! colspan="3" | 表格
|-
| 表格示例 || <nowiki>
{| class="wikitable"
|+ 标题
! 列1 !! 列2
|-
| 单元格1 || 单元格2
|}</nowiki> || 
{| class="wikitable"
|+ 标题
! 列1 !! 列2
|-
| 单元格1 || 单元格2
|}
|}
{{Note|更多帮助可查阅[https://www.mediawiki.org/wiki/Help:Wikitext_examples/zh Wikipedia官网文档]和[https://workingwithmediawiki.com/book/chapter4.html#magicparlabel-948 Working With Wiki]。}}
== 本网站的模板 ==
[[模板使用指南]]
{| class="wikitable"
!模板
!用途
!文档
|-
|<nowiki>{{Infobox|...}}</nowiki>
|零件/项目信息卡片
|[[Template:Infobox/doc|查看]]
|-
|<nowiki>{{Warning|文字}}</nowiki>
|⚠️ 注意事项提示
|[[Template:Warning/doc|查看]]
|-
|<nowiki>{{Note|文字}}</nowiki>
|💡 补充说明提示
|[[Template:Note/doc|查看]]
|-
|<nowiki>{{Danger|文字}}</nowiki>
|🚨 危险警告
|[[Template:Danger/doc|查看]]
|-
|<nowiki>{{Reflist}}</nowiki>
|📖 参考来源列表
|[[Template:Reflist/doc|查看]]
|-
|<nowiki>{{SpecBox|名称=...|参数1=...}}</nowiki>
|📦 元件参数卡片
|[[Template:SpecBox/doc|查看]]
|-
|<nowiki>{{VersionBox|标题=...|内容=...}}</nowiki>
|🔄 版本迭代卡片
|[[Template:VersionBox/doc|查看]]
|-
|<nowiki>{{TeamCard|姓名=...}}</nowiki>
|👥 成员展示卡片
|[[Template:TeamCard/doc|查看]]
|-
|<nowiki>{{RobotModules|名称=...|前缀=...}}</nowiki>
|🤖 系统分解图（自动链接子页面）
|[[Template:RobotModules/doc|查看]]
|}





== 上传 CAD 模型 ==

Robuddy 支持直接上传 STEP、IGES、BREP 等三维 CAD 格式，并在页面中嵌入 3D 预览。

=== 支持的格式 ===
{| class="wikitable"
! 格式 !! 扩展名 !! 说明
|-
| STEP || .step / .stp || 通用三维交换格式（推荐）
|-
| IGES || .iges / .igs || 传统曲面交换格式
|-
| BREP || .brep || OpenCASCADE 原生边界表示
|}

=== 上传步骤 ===

# 点击待编辑页面左侧边栏的「'''上传文件'''」，或直接访问 [[Special:上传文件]]。
# 选择本地的 CAD 文件（如 <code>我的机器人.STEP</code>）。
# '''文件名默认'''：使用 <code>项目名-零件名.格式</code>，例如 <code>机器人大赛-第二十二届-Line-大车.STEP</code>，便于后续引用。
# 填写文件描述（可选），点击「上传文件」。

=== 在页面中嵌入 3D 预览 ===

上传成功后，在页面源代码中插入 <code>&lt;cadviewer&gt;</code> 标签：

<syntaxhighlight lang="html">
<cadviewer file="机器人大赛-第二十二届-Line-大车.STEP" width="800" height="600"></cadviewer>
</syntaxhighlight>

参数说明：
* <code>file</code>：上传的文件名（不含 <code>File:</code> 前缀）
* <code>width</code>：预览窗口宽度（像素），建议 600–800
* <code>height</code>：预览窗口高度（像素），建议 400–600

{{Warning|上传文件命名后不可随意修改，引用的文件名必须完全一致（含大小写和扩展名），否则 3D 预览无法加载。}}

=== 常见问题 ===
* 如果 3D 预览加载失败，检查文件名是否与上传时完全一致。
* 文件大小不宜超过 50MB，过大文件在浏览器端可能加载不出来。
* STEP 格式兼容性最好，推荐优先使用。


== 参考 ==
<references />

[[Category:帮助文档]]