前阵子帮一个亲子阅读小程序做内容接入,编辑把《三字经》全文和一份网上找的白话翻译一起传了上来,准备第二天上线。我随手翻到《增广贤文》的目录页,简介写着“精选四十条”,列表却显示六十一篇。
编辑愣了几秒,说简介是从旧版文案复制过来的。内容产品最怕这种“看起来差不多”的差错:读者不会逐条数,但一旦发现,信任就掉一截。
下面拿数据鱼API的「蒙学经典文库」服务当例子。它收录五部蒙学读物,提供统计、分页、详情、搜索和随机抽取,适合用来说明内容上架前该校哪些地方。
第一道:版本口径先写清楚
文库的说明里有一句很关键的话:“文本以通行整理本为准,个别字句版本有异;释义为白话参考。”这句话不是免责套话,而是内容策略:它承认不同版本存在异文,也承认白话释义不是标准答案。
上架前要做的,是在产品里把这句话变成用户能看懂的表达。比如书籍详情页加一行“原文以通行整理本为底本,个别字句与其他版本可能不同”,释义区标注“参考译文”。如果你们的用户是语文老师或国学机构,异文反而可能是卖点,可以做成对照阅读;如果用户是低龄儿童家长,就别把不同版本堆在一起,容易造成“到底哪个对”的焦虑。
第二道:目录数字以 stats 为准,不从简介里抠
这是最容易翻车的一道。数据鱼API的 stats 返回五部书和各自条目数:三字经 93、千字文 63、弟子规 89、朱子家训 31、增广贤文 61,总计 337。books 里的 intro 是文案,可能带历史表述;count 才是结构化数据。
《增广贤文》就是现成的例子:简介说“精选四十条”,count 是 61。两个数字都可能是真的——简介描述的是某个版本的选目,接口收录的是另一个范围。但对产品来说,目录页、进度条、“共 N 篇”的文案必须统一用 count,否则用户读到第 41 篇时会以为内容重复了。
书目 book 标识 条目数 备注
三字经 sanzijing 93 传统蒙学识字读本
千字文 qianziwen 63 千字不重复的识字长文
弟子规 dizigui 89 行为规范类蒙学
朱子家训 zhuzi 31 篇幅较短的家训
增广贤文 zengguang 61 简介中的“四十条”是文案口径
第三道:分页和详情,别假设 id 连续
text 端点必须传 book,page 从 1 开始,page_size 默认 20;detail 要传 book 和 id,文档写明 id 从 1 开始。注意,id 是书内序号,不是全局主键。做收藏、笔记、进度同步时,键要写成“书名 + id”,只存 id 会在换书后串内容。
分页也有个坑:page_size 没有在文档里标最大值,只给了默认 20。做移动端列表,20 条一页够用;做全文导出,不要循环翻到几千页,直接按书取完再本地缓存。缓存键同样要带书名和版本号,文库更新后旧缓存要能失效。
第四道:搜索和随机,先把边界写进交互
搜索的 keyword 必填,最长 30 个字符。做搜索框时,前端要限制长度并去掉首尾空格;用户输入“性本善”能命中,输入一整段话就该提示缩短,而不是把长字符串直接发出去。
随机端点适合做“每日一句”,数据鱼API的 random 支持 count 默认 1,范围 1 到 10;seed 是随机种子,相同种子得到相同结果,取值应为不超过 10 位的非负整数。这个设计很实用:用日期做种子,当天所有用户看到同一句;第二天换种子,自然轮换。别忘了把种子一起存下来,用户反馈“昨天那句找不到了”时还能复现。
第五道:白话释义的版权,别一并搬走
原文是公版,不代表围绕原文的一切都公版。现代人写的白话翻译、注释、赏析、插画,都可能单独享有著作权。文库说明里写的是“释义为白话参考”,这句话给了你使用边界,也提醒你:商业产品里大规模复制某家出版社的译注,风险不在原文,在译注。
稳妥的做法是:原文直接用,释义要么自己组织编辑重写,要么取得授权,要么只做“关键词注释”而不整段翻译。产品页标注底本与释义来源,既是对读者负责,也是给自己留证据。
收束:先校内容,再谈功能
这五道校对做完,再接功能会顺很多:目录用 stats,正文用 text,单篇用 detail,搜索限制 30 字,每日一句用日期做 seed。数据鱼API的蒙学经典文库把结构化的部分做好了,版本判断和版权边界仍然要人来定。
蒙学产品卖的不是“把书扫描上网”,而是“帮家长选对版本、读懂原意”。接口能省掉录入,省不掉校对。
以上书目、条目数与参数说明,整理自数据鱼API「蒙学经典文库」接口的公开文档;文中产品与编辑场景为虚构示例,原文版本与释义版权请按实际授权情况处理。