Repository navigation
docs: 重构自述文件定位与结构 - #63
Merged
Merged
Conversation
- 头部定位从「读英文」扩展为「任何应用、任何语言」,覆盖反向外译等场景 - 新增「它解决什么问题」「为什么不是网页翻译」两节,先讲清价值再列功能 - 功能按使用价值分组,安装与上手前置,架构与构建后置 - 修正支持语言数(11 → 12,与 SUPPORTED_LANGUAGES 一致) - 补充位置记忆、液态玻璃材质、历史分组展示等已上线能力 - 中英文两版结构与章节一一对应
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
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.
改动目的
原自述文件的头部定位是「看到不认识的英文,Ctrl+C」,把项目窄化成了「读英文」这一种场景。实际上它适用于任何语言、任何应用、任何可复制的文字。
主要改动
1. 重新定位头部
2. 按热门开源项目的叙事结构重排
参考 Pot、OpenAI Translator、Immersive Translate、CopyTranslator、espanso 等项目的组织方式,从「功能罗列」改为「价值递进」:
3. 应用场景扩展
明确列出七类真实场景,包含此前完全没提的反向输出(中文写完译成英文再粘贴到邮件/Issue)。
4. 修正事实错误
SUPPORTED_LANGUAGES实际含简体中文、繁體中文、English、日本語、한국어、Français、Deutsch、Español、Русский、Português、Italiano、العربية)5. 中英文同步
两版章节结构一一对应(各 12 个二级章节),英文版按英文技术写作习惯行文而非直译。
校验