Skip to content

目前的问题和需要优化的部分 - Current issues and things that need optimization #1

@Ikutsu

Description

@Ikutsu

中文

目前问题:

  1. 少量太长的文件,最后一点点被截断,受限于 gemini 2.0 flash --> 后续会换 2.5 pro
  2. 少量自定义格式难以使用正则替换使其兼容 docusaurus 引擎,目前手动修正了几个 --> 后续换 vitepress/next.js 灵活并且宽容一些
  3. 所有标题链接 (带#号的)失效,因为翻译后名字完全对不上 --> 还在找办法
  4. 正则替换脚本无法保证替换后格式正常 -->需要优化脚本或者利用其他库辅助(通过AST之类)

需要优化:

  1. 翻译质量需要提升 --> 后续替换2.5 pro 预计会提升,还可以通过优化提示词实现
  2. 基于 Writerside (如Kotlin, Ktor) 的 markdown 自定义组件可以重新实现,目前是通过替换成现有类似的组件(如 ul,li)导致显示效果变差 --> 后续更换网站框架可以拥有更多组件和自定义选项
  3. 文档的样式需要优化,现在有出现一些溢出画面的部分(特别是Kotlin)--> 更换框架会更容易处理
  4. 翻译脚本可以统一,并且工作流可以拆分出一些单语言单独运行

English

Current Issues:

  1. A small number of large files get truncated at the end due to Gemini 2.0 Flash limitations --> Will switch to 2.5 Pro in the future
  2. Some custom formats are difficult to make compatible with the Docusaurus engine using regex replacements, currently fixed a few manually --> Will switch to VitePress/Next.js which are more flexible and forgiving
  3. All heading links (with #) are broken because the title don't match after translation --> Still looking for a solution
  4. Regex replacement scripts cannot guarantee proper formatting after replacement --> Need to optimize scripts or use other libraries for assistance (through AST, etc.)

Need optimization:

  1. Translation quality needs improvement --> Switching to 2.5 Pro should help, can also optimize prompts
  2. Custom Markdown components based on Writerside (like Kotlin, Ktor) need reimplementation, currently replaced with similar existing components (like ul, li) resulting in poorer display quality --> Switching frameworks will provide more components and customization options
  3. Document styling needs optimization, some content overflows the viewport (especially for Kotlin) --> Changing frameworks will make this easier to handle
  4. Translation scripts can be unified, and workflows can be split to run individually for single languages

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No fields configured for Bug.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions