跳转到内容

文字排版

文字排版不止包含现实的纸制出版物,也包含数字内容的展示。 良好的排版能够提升内容的可读性和用户体验。Solsynth Works 制定了一套文字排版标准, 以确保所有产品和文档在视觉和功能上都达到一致的高质量水平。

  • 使用易读的无衬线字体作为主要字体,如 Solar Network 的品牌标志性字体是 Nunito, 对于 CJK 语言字体,可以使用 Noto Sans 系列的字体作为补充。
  • 避免使用过多不同的字体,通常不超过两种字体(标题和正文)以保持一致性。
  • 对于要使用衬线体的场景,不要将无衬线体和衬线体混用在同一视觉可观测到的平面上。
  • 正文字体大小建议在 16px 至 18px 之间,以确保良好的可读性。
  • 标题字体大小应根据层级进行调整,确保层次分明。
  • 行距建议设置不建议太大,避免太多留白造成空间浪费和不连贯。
  • 在不同段落之间可以添加字体大小的 2x 到 3x 的间距,以区分内容块。
  • 在中文中使用非 CJK 语言的字符时,前后应当添加空格。
    • 这是一个 Solsynth Works 标准的例子。我们的稳定性达到了 100%,真是可喜可贺!
    • 这是一个Solsynth Works标准的例子。我们的稳定性达到了100%,真是可喜可贺!
  • 注意有大小写区分的语言(如英文)时,对品牌名称使用正确的拼写。
    • Solian / Solar Network / iPhone / iOS / macOS
    • solian / solar network / Iphone / ios / MacOS
    • 对于没有明确定义的品牌名称,使用每个单词首字母大写的形式。
    • Open Source / Pull Request / Code Review / Android
    • open source / pull request / code review / android
  • 使用简洁明了的语言,避免复杂的句子结构。
  • 避免使用过多的专业术语,确保内容对广泛受众,在首次提及到专业术语时确保有清晰的解释, 同时对外来词建议在首次提及处后添加括号来说明其在原语言的原文。
  • 如果使用敬语,确保整篇文章都使用敬语。若使用非敬语,则整篇文章都使用非敬语,避免混用。
  • 使用适当的标点符号,根据句子主要语言来选择中英文标点符号,避免混用。
  • 因为 Emojis 在不同平台和设备上的显示效果不一致,并且大多数都不可爱, 此建议在正式文档中避免使用 Emojis, 转而使用 颜文字(Kanmoji)或者 ASCII 艺术来表达情感或强调内容。

大多数 Solsynth Works 的文档和内容都采用 Markdown 格式进行撰写。 因为 Markdown 语言特殊的特性,需要额外空格才会视为一个段落进行换行。 因此,在不实用 Soft Break 的情况下,请确保源文件每行不要超过 80 个字符, 最多不得超过在 14 inch 屏幕上启用 VS Code 默认的左右侧栏时的编辑器长度。 同时,请确保不同语法之间留有一个空行,以确保渲染效果正确与源文件清晰可读。