根据上述输入( 表1)，我们确定了6个可以在基于web的界面上编辑文档时实时使用的评估:可读性、复杂语言、被动语态、文本结构、词汇密度或多样性以及以人为本的语言。对于这些评估，我们将在下面描述其包含的基本原理。

可读性评估一篇文章的阅读难度，通常以“阅读评分”的形式呈现[ 9］．在许多卫生扫盲指南中，年级阅读分数被认为是一个有用的工具[ 8， 9， 39]，并广泛用于卫生知识普及研究(参见，例如，[ 5])。使用多种可读性公式评估健康信息[ 40， 41］．我们确定了官样文章的简单度量(SMOG) [ 42]作为SHeLL健康素养编辑器最合适的可读性公式。这是唯一的可读性公式，阅读评分假设读者对文本有完全的理解[ 40］．例如，烟雾指数假设一个八年级的读者在一篇八年级阅读水平的文章的多项选择理解测试中得分为100%。相比之下，Flesch Reading Ease假设八年级的读者在同一篇文章的多项选择理解测试中可以正确回答75% [ 43］．Flesch Kincaid是另一个广泛使用的可读性公式，它假设35%的理解是基于完形填空而不是多项选择题[ 44］．因此，与其他常见的可读性公式相比，烟雾指数对年级阅读分数的估计更为保守[ 40， 44， 45］．其他研究表明，在文本的随机抽样中，烟雾评估也更加一致，并且对格式差异不太敏感[ 40］．为符合澳洲的建议，我们选择了八年级或更低的阅读成绩[ 8］．

所有卫生知识普及指南都强调需要使用简单的日常语言，并尽量减少医学术语( 表1)．在某些情况下，可能需要使用医学术语，应该用更简单的词来定义和解释。同样，首字母缩写词也经常被认为是技术术语，应该在第一时间定义[ 28］．

使用主动语态是一项重要建议，可提高健康信息的理解和采取行动的便利性[ 7］．被动语态指的是强调动作接受者的语法结构(例如，“验血是医生要求的”)，而主动语态则强调执行动作的实体(“医生要求验血”)。

段落和句子的结构是影响文本复杂性的一个因素，根据以下几个准则( 表1)．例如，“健康素养在线”建议每段不超过3行[ 27］．同样，美国通俗语言指南建议段落长度在3至8句话之间，不超过150个单词[ 26］．《简明语言指南》也建议不要“句子中充斥着从属从句和例外”[ 26］．的A1面板中描述了一个例子 图1，其中三个从属子句划线并编号。可以通过减少从属从句的数量和替换表示例外的词语( 图1，面板A2)。

最后，问题理解辅助的“工作记忆过载”评估( 表1；［ 36)建议不要使用双重措辞和复杂的问题。例如，“你认为饮食和运动对控制糖尿病和心血管疾病有效吗?”是一个双重问题。这些反应可能涉及饮食、运动或两种类型的干预，也可能涉及糖尿病、心血管疾病或两种情况。

词汇密度是评估性语言架构的一个组成部分( 表1；［ 25])。然而，尽管词汇密度和多样性是常见的计算语言评估，但在健康环境中尚未得到广泛研究[ 14， 46］．词汇密度衡量的是文本中“实词”和“功能词”的比例。实义词告诉我们一篇文章是关于什么的(名词、形容词、大多数动词和大多数副词)。虚词是那些带有语法意义的词。因此，词汇密度越高的文本，表达的意思就越简洁。例如，比较图B1和B2中的句子 图1．Panel B1的句子词汇密度更高，实词比为5，虚词比为1，而Panel B2的句子实词比为6，虚词比为4。从概念上讲，卫生信息材料的词汇密度较低可能是有益的，因为这种写作风格更能体现英语口语(词汇密度得分通常在1.5到2之间)而不是书面英语(通常在3到6之间)[ 47］．这与建议以“对话语气”写作的卫生扫盲指南一致[ 26， 27］．

词汇多样性衡量的是一篇文章中独特词汇的比例。词汇多样性越高，说明文本词汇量越大[ 48］．词汇多样性较高的文本可能会对同一个概念使用更多的单词，例如“癌症”、“癌”和“肿瘤”。词汇多样性低的文本可能只是指“癌症”。

广泛建议卫生信息部门对卫生服务采取以人为本的方针[ 49， 50］．语言可以对人们如何理解他们的状况、他们的待遇以及他们在社区中的地位产生持久的影响。以人为本的语言寻求减少指责、污名化和评判，鼓励准确、自主、尊重和包容[ 51］．

SHeLL健康素养编辑器提供了一个基于SMOG公式的整体年级阅读分数，四舍五入到最接近的整数( 图2)．烟雾公式根据每个句子中多音节单词的比例(>2个音节)来估计年级阅读分数。The Editor使用开源英语词典计算音节数，该词典提供了超过11.5万个单词的音节数[ 52］．如果一个给定的单词没有在字典中列出，则根据元音和辅音的模式来估计音节数。为了确保呈现给用户的烟雾评分的准确性，将自动计算与使用不包含模糊音节计数的散文文本(例如，可以发音为单个字母或单个单词的数字和首字母缩写，例如，“WHO”代表世界卫生组织)手动计算的分数进行了比较。

为了帮助用户，SHeLL健康素养编辑器会标记文本中导致烟雾计算较高的单词(即>2音节的单词)。编辑器还会标记超过20个单词的句子。这句话的长度是根据其他卫生扫盲建议选择的[ 27］．

我们确定了一些资源，为复杂的语言提供了更简单的替代方案，包括疾病控制和预防中心的公共卫生传播日常词汇，它是专门为解决卫生传播中的卫生素养需求而开发的[ 22］．来自这些资源的词库条目被整理到一个数据库中，其中列出了单词、相关的字符串搜索，以及一个包含可能替代选项的伴随词库条目。用户可以通过将鼠标悬停在单词( 图2)．

用户最多可以输入5个单词，如果他们认为读者熟悉这些术语，这些单词将被排除在复杂的语言评估之外。这一特性为用户提供了灵活性，同时也试图阻止用户豁免 所有来自复杂语言评估的行话。排除单词的最大数量将随着用户反馈的收集而进一步细化。

此外，“编辑器”还根据来自不同英语来源(学习材料、小说、期刊和杂志、非虚构作品、广播、英语口语、文件和电视)的超过2.7亿单词的数据库中的词频来识别英语语言中不常见的单词。[ 53］．该数据库是专门设计来识别对英语作为第二语言学习的人最有用的单词。例如，它的作者声称，最常用的2800个单词为学习者提供了90%的普通英语文本[ 53］．该评估还使用spaCy经过训练的命名实体识别模型来防止命名实体(如公司、位置、组织、语言、国家和时间段)被标记为不常见。

首字母缩写被认为是由至少两个大写字母组成的，或者大写字母之间有句号。小写字母是允许的，因为这是卫生领域的常见做法(例如，SHeLL代表悉尼卫生扫盲实验室)。

总体“文本复杂性”分数是根据三种复杂语言评估(“同义词典”、“首字母缩略词”或“罕见词”)中任何一种标记的单词所占的比例计算得出的。由于这是一项新的客观评估，因此没有可用的指标。

SHeLL健康读写编辑器识别动词“to be”(如“is”、“were”)和过去分词(如“delivered”、“given”)的模式，表示被动语态。用户可以阅读被动语态的简要说明，包括将被动语态结构转换为主动语态的实例。

SHeLL健康素养编辑器通过标记超过8句话或超过150个单词的段落来提供关于段落长度的指导。该标准也与美国普通语言指南的建议一致[ 26］．

根据“问题理解辅助”的“工作记忆过载”评估，“编辑”将复杂问题定义为包含至少12个单词和超过2个连词(“for”、“and”、“nor”、“but”、“or”、“yet”和“so”)的问题( 表1；［ 36])。在此过程中，该标志旨在识别双重问题或复杂问题的潜在实例，但应仅将其视为复杂问题的代理。

SHeLL健康读写编辑器使用有关词性的信息来确定一个单词是否满足功能或内容角色。介词(如in、on)、代词(如she、them)、限定词(如the、a)、连词(如and、that)和助词(如is、got、do)被归类为虚词;所有其他词性都被归类为实义词。然后计算每个子句实词与功能词的比率[ 47］．

SHeLL健康素养编辑器计算词汇多样性的非标准化和标准化评估。非标准化评估，或“类型-标记比率”，是唯一单词与总单词的比率。类型-令牌比与文本长度相关[ 14］．词汇语篇多样性的测量[ 54]是一个标准化的类型-标记比率，它通过平均文本中连续单词字符串的类型-标记比率来调整文本长度。在不同长度的文本中，词汇文本多样性的测量更稳定[ 54， 55］．

SHeLL健康知识编辑器借鉴了以人为本语言的峰体指导，涵盖多种疾病:糖尿病、痴呆症、慢性疼痛、癌症和精神健康(包括与创伤知情护理一致的语言)[ 30.- 35］．随着其他健康状况的语言指南的出现，可以将这些指南纳入编辑器。该功能标记了文本中包含容易识别的非以人为中心的语言示例的部分;例如，指南建议使用“患有X疾病的人”而不是“患者”。值得注意的是，这个特性并不全面，因为以人为本指南的某些方面要求作者考虑的方面比可以使用字符串搜索功能识别的单个单词或短语更广泛。

我们实现了4个功能来帮助易用性:“文本准备”模式;按重要性排序(评估的层次);将修改后的文本导出为Word文档的功能;并将评估摘要导出为PDF格式。此外，在可能的情况下，用户指示和反馈的框架已对编辑器的预期用途及其评估设定了明确的期望。

为可读性评估准备文本是计算年级阅读分数的一个重要方面。然而，当为了评估目的而必须删除或修改文本(如标题)但最终包含在文件中时，这种准备工作可能会很麻烦。为了减轻这种负担，SHeLL Health Literacy Editor允许用户在无需编辑文本本身的情况下，指示要从可读性计算中排除哪些文本段。常用文本准备决定被设置为默认设置[ 41］．例如，默认情况下，编辑器不会计算短项目符号(少于4个单词)、少于4个单词的标题或url。即使结尾没有句号，项目符号也被认为是一个“句子”。

SHeLL健康状况读写编辑器使用不同颜色的不透明矩形框(“突出显示”)标记文本的部分( 图1)．每种颜色代表不同的评估。优先级高的评估覆盖了优先级低的评估。这种层次结构优先考虑对复杂语言的指导，其次是被动语态、可读性和复杂结构。用户可以打开或关闭评估，以查看重叠的高亮部分。为了避免过多的新用户，默认情况下只有3个排名最高的评估是有效的:复杂语言、被动语态和可读性。

用户可以将文本副本导出为Word文档或“摘要文件”，该文件提供所有客观评估和关于文本准备决策的信息，包括从复杂语言评估中排除的最多5个单词。

我们预计用户可能需要指导才能正确解释编辑器的反馈。例如，存在这样一种风险，即用户可能觉得需要从文本中删除所有突出显示的内容，以便简化任务被认为是“完成的”。为了减轻学生的沮丧情绪并设定现实的期望，编者的提示和说明强调可能会有一些高亮的单词，并且尽量使文本简单(例如，以8级或更低的水平为目标)。