增量阅读附加组件luoliyan/incremental-reading: Anki add-on providing incremental reading features

[kunpeng9]

描述错误 对错误是什么的清晰而简洁的描述。 繁殖 重现行为的步骤： 1转到“…” 2单击“…” 三。向下滚动到“…” 4见错误 预期行为 对你期望发生的事情的清晰而简洁的描述。 截图 如果适用，添加屏幕截图来帮助解释您的问题。 规格（请填写以下信息）： -操作系统：[例如Windows，iOS，Ubuntu] -Anki版本[例如v2.0.52、v2.1.5] -增量读取版本[例如v0.5.3-beta] 附加上下文 在此处添加有关该问题的任何其他上下文。

Describe the bug A clear and concise description of what the bug is. To Reproduce Steps to reproduce the behavior:

1. Go to '...'
2. Click on '....'
3. Scroll down to '....'
4. See error Expected behavior A clear and concise description of what you expected to happen. Screenshots If applicable, add screenshots to help explain your problem. Specs (please complete the following information):

• OS: [e.g. Windows, iOS, Ubuntu]
• Anki Version [e.g. v2.0.52, v2.1.5]
• Incremental Reading Version [e.g. v0.5.3-beta] Additional context Add any other context about the problem here.

Note: Version 4 of the add-on is only available for Anki 2.1+. Some features will be missing from the earlier versions.

注意: 该附加组件的版本 4 仅适用于 Anki 2.1 + 。早期版本中将缺少一些特性。

Introduction 引言

This is a rewrite of the Incremental Reading add-on, which aims to provide features that support incremental reading in Anki. The idea of working with long-form content within a spaced-repetition program appears to have originated with SuperMemo, which offers an elaborate implementation of the technique (see their help article for more information). This add-on for Anki is comparatively bare-bones, providing a minimal set of tools for iterating over long texts and creating new flashcards from existing ones. For an overview of these features, see below.

这是对增量阅读附加组件 (Incremental Reading add-on) 的重写，该组件旨在提供支持 Anki 增量阅读的特性。在一个间隔重复的程序中处理长形式内容的想法似乎源于 SuperMemo，它提供了一个详细的技术实现(更多信息请参阅他们的帮助文章)。Anki 的这个附加组件是相对简单的，它提供了一个最小的工具集，用于迭代长文本并从现有文本创建新的抽认卡。有关这些特性的概述，请参阅以下内容。

• Version 4: 第四版:GitHub, issue tracker 发行跟踪器, discussion board 讨论板
• Version 3: 第三版:GitHub, discussion board 讨论板
• Version 2: 第二版:AnkiWeb, GitHub, manual 手册

Main Features 主要特点

• Import content from web feeds (RSS/Atom), webpages, or Pocket (v4 only) 从 web 提要 (RSS/Atom)、 web 页面或 Pocket (仅 v4) 导入内容
• Extract selected text into a new card by pressing 通过按压将选定的文本提取到新卡片中 x
• Highlight selected text by pressing 按下高亮显示选定的文本 h
• Remove selected text by pressing 按删除选定的文本 z
• Undo changes to the text by pressing 按 “撤消” 对文本的更改 u
• Apply rich text formatting while reading 阅读时应用格式文本格式
• Create custom shortcuts to quickly add cards 创建自定义快捷方式以快速添加卡片
• Maintain scroll position and zoom on a per-card basis 在每张卡片上保持滚动位置和缩放
• Rearrange cards in the built-in organiser 在内置的组织者中重新排列卡片
• Control the scheduling of incremental reading cards 控制增量读卡的调度
• Limit the width of cards (useful on large screens) (v4 only) 限制卡片的宽度 (只适用于大屏幕)(v4)

New to Version 4 新版本 4

• Compatible with Anki 2.1 兼容 Anki 2.1
• Import single webpages (汇入单一网页 (Alt 谷丙转氨酶 + 3)
• Import web feeds (导入网页订阅 (Alt 谷丙转氨酶 + 4)
• Import Pocket articles (进口口袋物品 (Alt 谷丙转氨酶 + 5)
• Apply bold, italics, underline or strikethrough ( 应用粗体、斜体、下划线或删除线 (Ctrl 1. Ctrl+B, I, U, or ，或 S)
• Toggle formatting on and off ( 打开和关闭格式设置 (Ctrl 1. Ctrl+Shift 转移 + O)
• Choose maximum width of cards (see options: 选择卡片的最大宽度 (参见选项: Alt 谷丙转氨酶 + 1)
• Control initial scheduling of extracts (see options: 控制提取物的初始调度 (参见选项: Alt 谷丙转氨酶 + 1)

New to Version 3 第三版新增

• Remove unwanted text with a single key-press (使用单个按键删除不需要的文本 (z)
• Multi-level undo, for reverting text changes (多级撤消，用于恢复文本更改 (u)
• New options to control how text is extracted: 控制文本提取方式的新选项:
  • Open the full note editor for each extraction (slow), or simply a title entry box (fast) 为每个提取打开完整的笔记编辑器 (慢) ，或者只打开一个标题条目框 (快)
  • Extract selected text as HTML (retain color and formatting) or plain text (remove all formatting) 提取所选文本为 HTML (保留颜色和格式) 或纯文本 (删除所有格式)
  • Choose a destination deck for extracts 选择一个目标甲板提取
• New options for several aspects of zoom and scroll functionality: 缩放和滚动功能的几个新选项:
  • Zoom Step 缩放步骤 (the amount that magnification changes when zooming in or out) (放大或缩小时放大倍数的变化)
  • General Zoom 极速将军 (the zoom level for the deck browser and overview screens) (甲板浏览器和概览屏幕的缩放级别)
  • Line Step 第一步 (the amount the page moves up or down when the Up or Down direction keys are used) (当使用向上或向下方向键时，页面向上或向下移动的量)
  • Page Step 页步骤 (same as above, but with the (与上述相同，但 Page Up 页面向上 and 及 Page Down 翻页 keys) )
• Highlighting: 重点介绍:
  • Both the background color and text color used for highlighting can be customized 用于高亮显示的背景颜色和文本颜色都可以定制
  • A drop-down list of available colors is provided 提供了可用颜色的下拉列表
  • A preview is now displayed when selecting highlight colors 选择高亮颜色时会显示一个预览
  • The colors applied to text extracted with 应用于用 x can now be set independently 现在可以独立设置
• Quick Keys 快速键
  • A list of all existing Quick Keys is now shown, to allow easy modification 现在显示了所有现有 Quick Keys 的列表，以便于修改
  • Unwanted Quick Keys can be easily deleted 不需要的快速键可以很容易地删除
  • A plain text extraction option has also been added 还添加了纯文本提取选项
• All options have been consolidated into a single tabbed dialog 所有选项都合并为一个单一的选项卡对话框

Screenshots 屏幕截图

Note: These are fairly outdated.

注意: 这些都是相当过时的。

Installation 安装

You will first need to have Anki installed. Download the relevant installer here.

你首先需要安装 Anki。在这里下载相关的安装程序。

To install through Anki, navigate to Tools → Add-ons → Get Add-ons..., and enter the code 935264945. To install manually, download the GitHub repository (here) and place the ir folder into your add-ons folder.

通过 Anki 安装，导航到 Tools → Add-ons → Get Add-ons... ，然后输入代码 935264945。要手动安装，请下载 GitHub 存储库 (这里) 并将 ir 文件夹放入您的 add-ons 文件夹。

Usage 用法

Experimentation should lead to a pretty quick understanding of how the add-on works. If in doubt, start with the following:

实验应该可以让你很快理解附加组件的工作原理。如果有疑问，从以下几点开始:

1. Create a new IR note with an article you want to study (the easiest way to do this is to import a webpage, by pressing 用你想学的文章创建一个新的注释 (最简单的方法是导入一个网页，点击 Alt 谷丙转氨酶 + 3 while on the deck overview screen) 而在甲板概览屏幕)
2. Set up a shortcut for creating regular Anki cards from IR cards (press 建立一个快捷方式创建常规 Anki 卡从红外卡 (按 Alt 谷丙转氨酶 + 1, or go to the menu, then go to the Quick Keys tab) ，或转到菜单，然后转到快速键标签)
3. Review the IR card that was created, and extract any text you find interesting (by selecting the text and pressing 查看已创建的 IR 卡片，并提取任何您感兴趣的文本 (通过选择文本和按 x)
4. Choose 精明选择_Soon 很快_ or 或_Later 再见_ when you want to move to the next card (which will be a portion of text you extracted) 当您想移动到下一张卡片 (这将是您提取的文本的一部分)
5. Whenever you want to create a regular Anki note, simply select the desired text and use the shortcut you created earlier 无论何时你想创建一个常规的 Anki 笔记，只需选择想要的文本，并使用您早先创建的快捷方式

Outdated instructions can be found here. They were written for v2, but the basic behaviour of the add-on is still similar.

过时的说明可以在这里找到。它们是为 v2 编写的，但是附加组件的基本性能仍然相似。

Support 支持

If any issues are encountered, please post details to the Anki add-ons forum. It’s best if you post in the existing thread (here) so I receive an email notification. Otherwise, note an issue or make a pull request on GitHub.

如果遇到任何问题，请在 Anki 附加组件论坛发布详细信息。最好是你在现有的线程 (这里) 张贴，以便我收到一个电子邮件通知。否则，在 GitHub 上记录一个问题或者发出一个 pull 请求。

Please include the following information in your post:

请在你的邮件中包括以下信息:

• The version of Anki you are using (e.g., v2.1.0-beta5; can be found in Help → About...) 您正在使用的 Anki 版本 (例如，v2.1.0-beta5; 可以在 Help → About... 中找到)
• The version of IR you are using (this can be found in Read → About...) 您正在使用的 IR 版本 (这可以在 Read → About... 中找到)
• The operating system you are using 您正在使用的操作系统
• Details of the problem 问题的详情
• Steps needed to reproduce the problem 重现问题所需的步骤

License 许可证

Multiple people have contributed to this add-on, and it’s somewhat unclear who to credit for which changes and which licenses to apply.

很多人都为这个附加组件做出了贡献，但是还不清楚应该把哪些变化归功于谁，以及应该申请哪些许可。

Tiago Barroso appears to have initiated the project, and he has stated that he releases all of his add-ons under the ISC license. Frank Kmiec later vastly expanded the add-on, but it’s unclear which license his changes were released under. Presuming he didn’t specify one, the AnkiWeb terms and conditions suggest they were automatically released under the AGPL v3. Aleksej’s changes to Frank’s version are multi-licensed under the GPL and ISC licenses.

蒂亚戈 · 巴罗佐似乎是这个项目的发起人，他声明他在 ISC 许可下释放了所有附加组件。Frank Kmiec 后来极大地扩展了这个附加组件，但不清楚他的改动是以哪个许可证发布的。假设他没有指定一个，AnkiWeb 的条款和条件表明它们是在 AGPL v3 下自动发布的。Aleksej 对 Frank 版本的修改是在 GPL 和 ISC 许可下多重许可的。

For the sake of simplicity, my changes are also released under the ISC license. For each author, I have placed a copyright lines where appropriate, with what I believe are correct dates. If I have made a mistake in this respect, please let me know.

为了简单起见，我的更改也是在 ISC 许可下发布的。对于每一位作者，我都在适当的地方加上了版权限制，以及我认为正确的日期。如果我在这方面犯了错误，请让我知道。

Frank Raiser released an Anki 1 add-on under a similar name, but it doesn’t appear to share any code with the current project and functions quite differently. For more information, see Anki Incremental Reading.

Frank Raiser 发布了一个名字相似的 Anki 1 附加组件，但是它似乎没有与当前项目和功能共享任何代码。有关更多信息，请参见 Anki Incremental Reading。 https://github.com/luoliyan/incremental-reading