ReedenReeden
电子书扩展

富文本脚注

使用标准 EPUB 3 或 Reeden 集中式结构制作可打开的脚注

富文本脚注让读者在正文中点击脚注标记,并查看包含段落、强调或链接的说明内容。

点击正文脚注标记后在当前阅读页打开脚注卡片

优先使用 EPUB 3 标准脚注

新制作的 EPUB 3 应优先使用标准 epub:type 语义:

XHTML 根节点需要声明 EPUB namespace:

<html
  xmlns="http://www.w3.org/1999/xhtml"
  xmlns:epub="http://www.idpf.org/2007/ops">

正文与脚注可以写成:

<p>
  正文<a epub:type="noteref" href="#note-1">[1]</a>
</p>

<aside epub:type="footnote" id="note-1">
  <p>脚注正文。</p>
</aside>

href="#note-1" 必须指向脚注元素的 id="note-1"。

也认 ARIA 写法:引用写 role="doc-noteref",脚注写 role="doc-footnote"。

尾注(epub:type="endnote" 或 role="doc-endnote")点击时同样弹出,但尾注本来就排在章末,正文里不会把它藏起来。

制作集中式脚注列表

使用集中放在章节末尾的脚注列表时,可以使用 Reeden class:

<p>
  正文<a class="reeden-footnote" href="#note-1">[1]</a>
</p>

<ol class="reeden-footnote-content">
  <li class="reeden-footnote-item" id="note-1">
    <p>脚注正文。</p>
  </li>
</ol>

三个 class 的职责分别是:

class作用
reeden-footnote标记正文中的脚注引用
reeden-footnote-content包裹集中式脚注列表
reeden-footnote-item标记一条带 id 的脚注内容

脚注内容可以包含普通的 XHTML 富文本。引用与内容建议放在同一 XHTML 文件中。

图片弹注

注文很短、只有一句话时,可以用一张小图标当注号,注文直接写在图片的 alt 里:

<p>
  正文<img class="reeden-footnote" src="../Images/note.png" alt="这里是注文。" />
</p>
  • 图片自己或它的上级元素带 reeden-footnote(或 duokan-footnote)class 即可,点图标弹出 alt 里的文字
  • 没给宽高、原图不超过 200 像素的图标,会自动按一个字的大小显示;原图更大时按普通插图处理,需要自己用 CSS 定尺寸
  • 图片放在指向脚注的链接里时,弹出的是链接指向的脚注内容

读者看到的效果

读者点注号后弹出注释卡片,卡片外观(纸片、气泡、便签、经典)由读者在阅读页「更多设置 → 查词与弹注 → 弹注样式」里选,书里不用写样式。

读者也可以在阅读页「书籍样式」里打开:

  • 「页底脚注」:注释排在引用所在页的底部,放不下时续到下一页
  • 「显示章末注释」:注释原文保留在章节末尾,点注号仍可弹出

常见问题

点击后没有找到脚注

检查引用是否为带 href 的 a 元素、href 中 # 后的片段是否与脚注 id 完全一致,并确认 id 在当前文件中唯一。只给无链接的 span 添加 class 不会建立脚注关联。

脚注内容直接出现在正文中

  • 确认脚注项具有标准 epub:type="footnote",或者使用了完整的 Reeden 集中式脚注结构
  • 用 epub:type="footnote" 时,只有被本章某个引用指向的脚注才会从正文藏起来;没有任何引用指向它时会留在正文里
  • 尾注(endnote)本来就显示在正文里
  • 读者打开了「书籍样式 → 显示章末注释」

不要用 CSS 把脚注内容永久设为 display: none,否则脚注内容无法显示。

兼容写法

规范写法兼容写法
reeden-footnoteduokan-footnote
reeden-footnote-contentduokan-footnote-content
reeden-footnote-itemduokan-footnote-item

相关文档