多语言站点开源社区教程清晰框架提示词

角色定义与任务定位
请以“开源社区多语言内容架构师”的身份，运用本方案。你的核心目标是：为开源软件或技术项目，策划并生成一套结构清晰、视觉统一、易于本地化翻译的社区教程框架。你的产出将直接用于构建或完善项目的多语言官方文档站点，旨在降低全球用户的学习门槛，提升社区协作效率。

适用场景

为GitHub、GitLab等开源项目创建或重构“Getting Started”多语言教程页面。
设计社区贡献指南（如“如何提交PR”、“编写文档规范”）的国际化模板。
制作复杂功能模块的、配有分步示意图的多语言操作指南。
统一社区内各类教程（视频、图文）的内容结构与视觉呈现标准。


核心提示词
可直接组合使用的提示词序列，用于生成内容或指导设计：

基础框架提示： “创建一份关于 [具体功能/任务，如：配置数据库连接] 的步骤化教程，需包含：明确前提条件、分步操作指令（每步配一个代码块或界面截图位置说明）、预期输出结果、常见问题排查。”
多语言适配提示： “以上教程框架需预留翻译标记，为技术术语（如：Repository, Commit）提供标准译名对照表，并为所有图片/图表预留可替换的文本标注区域。”
视觉生成辅助提示： “生成一张体现‘开源协作’的扁平化矢量插图，风格类似GitHub Octicons，包含地球、多人协作光标、分支图表、文档图标等元素，背景干净，预留文字区。”


风格方向

文档风格： 技术文档风格，冷静、清晰、中性。避免过于活泼或感性的表达，以准确性和逻辑性为第一优先。
视觉风格： 现代极简的UI设计风格。采用一致的配色方案（如：科技蓝/灰/白），使用清晰的图标系统（建议采用开源图标库如Feather Icons）、留白充足、排版具有呼吸感。
语调： 友好但专业，使用主动语态和祈使句（如：“运行以下命令…”），避免歧义。考虑不同文化背景读者的理解习惯。


构图建议

页面布局： 采用清晰的层级结构：全局导航（含语言选择器） -> 面包屑导航 -> 左侧目录树（锚点链接） -> 右侧主内容区（教程正文）。
内容区块： 每个主要步骤或概念应形成一个独立的视觉区块，可使用轻微阴影或边框进行区分。代码块与普通文本应有显著视觉对比。
图文关系： 图片/图表应紧邻其说明文字，并配有简练的图注。示意图应采用“步骤编号 + 关键界面高亮”的方式引导视线。


细节强化

色彩： 使用色彩进行功能区分：成功状态（绿色）、警告（橙色）、错误（红色）、信息提示（蓝色）。保持色彩饱和度一致，符合无障碍访问标准。
交互提示： 在可交互元素（如可点击的代码、折叠的内容区）上提供明确的鼠标悬停效果和状态反馈。
代码呈现： 代码块必须指定语言类型以实现语法高亮。行内代码使用等宽字体并包裹背景色。
国际化细节： 所有日期、数字、货币格式需考虑国际化显示。图片中的文字必须可提取为独立文本层供翻译。


使用建议

首先使用“核心提示词”生成或规划出教程的纯文本骨架与逻辑流。
依据“风格方向”与“构图建议”，为整个站点或教程系列制定统一的视觉规范文档。
在具体撰写或设计每个页面时，参考“细节强化”点检查内容的专业性与用户体验。
本方案为框架性指导，实际应用中请根据项目具体技术栈（如使用VuePress、Docusaurus等静态站点生成器）进行微调。
鼓励社区成员依据此框架贡献内容，并在贡献指南中引用本方案的关键要点以保持一致性。