{"id":13857084,"url":"https://github.com/jdlorimer/incremental-reading","last_synced_at":"2025-04-09T20:05:30.929Z","repository":{"id":44364135,"uuid":"78341218","full_name":"jdlorimer/incremental-reading","owner":"jdlorimer","description":"Anki add-on providing incremental reading features","archived":false,"fork":false,"pushed_at":"2022-10-09T19:01:02.000Z","size":2190,"stargazers_count":218,"open_issues_count":40,"forks_count":40,"subscribers_count":21,"default_branch":"master","last_synced_at":"2025-04-09T20:05:27.325Z","etag":null,"topics":["addon","anki","flashcards","incremental","learning","reading","study-aid"],"latest_commit_sha":null,"homepage":"https://ankiweb.net/shared/info/935264945","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jdlorimer.png","metadata":{"files":{"readme":"README.html","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-01-08T12:25:12.000Z","updated_at":"2025-02-28T18:08:43.000Z","dependencies_parsed_at":"2023-01-19T16:40:20.585Z","dependency_job_id":null,"html_url":"https://github.com/jdlorimer/incremental-reading","commit_stats":null,"previous_names":["jdlorimer/incremental-reading","luoliyan/incremental-reading"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jdlorimer%2Fincremental-reading","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jdlorimer%2Fincremental-reading/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jdlorimer%2Fincremental-reading/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jdlorimer%2Fincremental-reading/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jdlorimer","download_url":"https://codeload.github.com/jdlorimer/incremental-reading/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248103871,"owners_count":21048245,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["addon","anki","flashcards","incremental","learning","reading","study-aid"],"created_at":"2024-08-05T03:01:25.311Z","updated_at":"2025-04-09T20:05:30.901Z","avatar_url":"https://github.com/jdlorimer.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"\u003cstrong\u003e\u003ci\u003e2021 Project Status: Active development will resume on Saturday the 27th of February.\u003c/i\u003e\u003c/strong\u003e\n\n\u003ca href=\"https://travis-ci.org/luoliyan/incremental-reading\"\u003e\u003cimg src=\"https://travis-ci.org/luoliyan/incremental-reading.svg?branch=master\" alt=\"Build Status\" /\u003e\u003c/a\u003e\n\n\n\u003cb\u003eNote:\u003c/b\u003e Version 4 of the add-on is only available for Anki 2.1+. Some features will be missing from the earlier versions.\n\n\u003cb\u003e\u003ci\u003eIntroduction\u003c/i\u003e\u003c/b\u003e\n\nThis is a rewrite of the \u003ca href=\"https://github.com/aleksejrs/anki-2.0-vsa-and-ire\"\u003eIncremental Reading add-on\u003c/a\u003e, 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 \u003ca href=\"https://www.supermemo.com/help/read.htm\"\u003ehelp article\u003c/a\u003e 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.\n\n\u003cul\u003e\u003cli\u003eVersion 4: \u003ca href=\"https://github.com/luoliyan/incremental-reading\"\u003eGitHub\u003c/a\u003e, \u003ca href=\"https://github.com/luoliyan/incremental-reading/issues\"\u003eissue tracker\u003c/a\u003e, \u003ca href=\"https://anki.tenderapp.com/discussions/add-ons/9054-incremental-reading-add-on-discussion-support\"\u003ediscussion board\u003c/a\u003e\u003c/li\u003e\u003cli\u003eVersion 3: \u003ca href=\"https://github.com/luoliyan/incremental-reading/tree/legacy\"\u003eGitHub\u003c/a\u003e, \u003ca href=\"https://anki.tenderapp.com/discussions/add-ons/9054-incremental-reading-add-on-discussion-support\"\u003ediscussion board\u003c/a\u003e\u003c/li\u003e\u003cli\u003eVersion 2: \u003ca href=\"https://ankiweb.net/shared/info/355348508\"\u003eAnkiWeb\u003c/a\u003e, \u003ca href=\"https://github.com/aleksejrs/anki-2.0-vsa-and-ire\"\u003eGitHub\u003c/a\u003e, \u003ca href=\"https://luoliyan.github.io/incremental-reading\"\u003emanual\u003c/a\u003e\u003c/li\u003e\u003c/ul\u003e\n\u003cb\u003e\u003ci\u003eMain Features\u003c/i\u003e\u003c/b\u003e\n\n\u003cul\u003e\u003cli\u003eImport content from web feeds (RSS/Atom), webpages, or Pocket (\u003cb\u003ev4 only\u003c/b\u003e)\u003c/li\u003e\u003cli\u003eExtract selected text into a new card by pressing \u003ccode\u003e\u003cb\u003ex\u003c/b\u003e\u003c/code\u003e\u003c/li\u003e\u003cli\u003eHighlight selected text by pressing \u003ccode\u003e\u003cb\u003eh\u003c/b\u003e\u003c/code\u003e\u003c/li\u003e\u003cli\u003eRemove selected text by pressing \u003ccode\u003e\u003cb\u003ez\u003c/b\u003e\u003c/code\u003e\u003c/li\u003e\u003cli\u003eUndo changes to the text by pressing \u003ccode\u003e\u003cb\u003eu\u003c/b\u003e\u003c/code\u003e\u003c/li\u003e\u003cli\u003eApply rich text formatting while reading\u003c/li\u003e\u003cli\u003eCreate custom shortcuts to quickly add cards\u003c/li\u003e\u003cli\u003eMaintain scroll position and zoom on a per-card basis\u003c/li\u003e\u003cli\u003eRearrange cards in the built-in organiser\u003c/li\u003e\u003cli\u003eControl the scheduling of incremental reading cards\u003c/li\u003e\u003cli\u003eLimit the width of cards (useful on large screens) (\u003cb\u003ev4 only\u003c/b\u003e)\u003c/li\u003e\u003c/ul\u003e\n\u003cb\u003eNew to Version 4\u003c/b\u003e\n\n\u003cul\u003e\u003cli\u003eCompatible with Anki 2.1\u003c/li\u003e\u003cli\u003eImport single webpages (\u003ccode\u003e\u003cb\u003eAlt\u003c/b\u003e\u003c/code\u003e+\u003ccode\u003e\u003cb\u003e3\u003c/b\u003e\u003c/code\u003e)\u003c/li\u003e\u003cli\u003eImport web feeds (\u003ccode\u003e\u003cb\u003eAlt\u003c/b\u003e\u003c/code\u003e+\u003ccode\u003e\u003cb\u003e4\u003c/b\u003e\u003c/code\u003e)\u003c/li\u003e\u003cli\u003eImport Pocket articles (\u003ccode\u003e\u003cb\u003eAlt\u003c/b\u003e\u003c/code\u003e+\u003ccode\u003e\u003cb\u003e5\u003c/b\u003e\u003c/code\u003e)\u003c/li\u003e\u003cli\u003eApply bold, italics, underline or strikethrough (\u003ccode\u003e\u003cb\u003eCtrl\u003c/b\u003e\u003c/code\u003e+\u003ccode\u003e\u003cb\u003eB\u003c/b\u003e\u003c/code\u003e, \u003ccode\u003e\u003cb\u003eI\u003c/b\u003e\u003c/code\u003e, \u003ccode\u003e\u003cb\u003eU\u003c/b\u003e\u003c/code\u003e, or \u003ccode\u003e\u003cb\u003eS\u003c/b\u003e\u003c/code\u003e)\u003c/li\u003e\u003cli\u003eToggle formatting on and off (\u003ccode\u003e\u003cb\u003eCtrl\u003c/b\u003e\u003c/code\u003e+\u003ccode\u003e\u003cb\u003eShift\u003c/b\u003e\u003c/code\u003e+\u003ccode\u003e\u003cb\u003eO\u003c/b\u003e\u003c/code\u003e)\u003c/li\u003e\u003cli\u003eChoose maximum width of cards (see options: \u003ccode\u003e\u003cb\u003eAlt\u003c/b\u003e\u003c/code\u003e+\u003ccode\u003e\u003cb\u003e1\u003c/b\u003e\u003c/code\u003e)\u003c/li\u003e\u003cli\u003eControl initial scheduling of extracts (see options: \u003ccode\u003e\u003cb\u003eAlt\u003c/b\u003e\u003c/code\u003e+\u003ccode\u003e\u003cb\u003e1\u003c/b\u003e\u003c/code\u003e)\u003c/li\u003e\u003c/ul\u003e\n\u003cb\u003eNew to Version 3\u003c/b\u003e\n\n\u003cul\u003e\u003cli\u003eRemove unwanted text with a single key-press (\u003ccode\u003e\u003cb\u003ez\u003c/b\u003e\u003c/code\u003e)\u003c/li\u003e\u003cli\u003eMulti-level undo, for reverting text changes (\u003ccode\u003e\u003cb\u003eu\u003c/b\u003e\u003c/code\u003e)\u003c/li\u003e\u003cli\u003eNew options to control how text is extracted:\u003cul\u003e\u003cli\u003eOpen the full note editor for each extraction (slow), or simply a title entry box (fast)\u003c/li\u003e\u003cli\u003eExtract selected text as HTML (retain color and formatting) or plain text (remove all formatting)\u003c/li\u003e\u003cli\u003eChoose a destination deck for extracts\u003c/li\u003e\u003c/ul\u003e\u003c/li\u003e\u003cli\u003eNew options for several aspects of zoom and scroll functionality:\u003cul\u003e\u003cli\u003e\u003ci\u003eZoom Step\u003c/i\u003e (the amount that magnification changes when zooming in or out)\u003c/li\u003e\u003cli\u003e\u003ci\u003eGeneral Zoom\u003c/i\u003e (the zoom level for the deck browser and overview screens)\u003c/li\u003e\u003cli\u003e\u003ci\u003eLine Step\u003c/i\u003e (the amount the page moves up or down when the Up or Down direction keys are used)\u003c/li\u003e\u003cli\u003e\u003ci\u003ePage Step\u003c/i\u003e (same as above, but with the \u003ccode\u003e\u003cb\u003ePage Up\u003c/b\u003e\u003c/code\u003e and \u003ccode\u003e\u003cb\u003ePage Down\u003c/b\u003e\u003c/code\u003e keys)\u003c/li\u003e\u003c/ul\u003e\u003c/li\u003e\u003cli\u003eHighlighting:\u003cul\u003e\u003cli\u003eBoth the background color and text color used for highlighting can be customized\u003c/li\u003e\u003cli\u003eA drop-down list of available colors is provided\u003c/li\u003e\u003cli\u003eA preview is now displayed when selecting highlight colors\u003c/li\u003e\u003cli\u003eThe colors applied to text extracted with \u003ccode\u003e\u003cb\u003ex\u003c/b\u003e\u003c/code\u003e can now be set independently\u003c/li\u003e\u003c/ul\u003e\u003c/li\u003e\u003cli\u003eQuick Keys\u003cul\u003e\u003cli\u003eA list of all existing Quick Keys is now shown, to allow easy modification\u003c/li\u003e\u003cli\u003eUnwanted Quick Keys can be easily deleted\u003c/li\u003e\u003cli\u003eA plain text extraction option has also been added\u003c/li\u003e\u003c/ul\u003e\u003c/li\u003e\u003cli\u003eAll options have been consolidated into a single tabbed dialog\u003c/li\u003e\u003c/ul\u003e\n\u003cb\u003e\u003ci\u003eScreenshots\u003c/i\u003e\u003c/b\u003e\n\n\u003cb\u003eNote:\u003c/b\u003e These are fairly outdated.\n\n\u003cimg src=\"https://raw.githubusercontent.com/luoliyan/incremental-reading/master/screenshots/extraction-and-highlighting.png\" alt=\"Screenshot #1\" /\u003e\u003cimg src=\"https://raw.githubusercontent.com/luoliyan/incremental-reading/master/screenshots/highlighting-tab.png\" alt=\"Screenshot #2\" /\u003e\u003cimg src=\"https://raw.githubusercontent.com/luoliyan/incremental-reading/master/screenshots/quick-keys-tab.png\" alt=\"Screenshot #3\" /\u003e\n\n\u003cb\u003e\u003ci\u003eInstallation\u003c/i\u003e\u003c/b\u003e\n\nYou will first need to have Anki installed. Download the relevant installer \u003ca href=\"http://ankisrs.net\"\u003ehere\u003c/a\u003e.\n\nTo install through Anki, navigate to Tools → Add-ons → Get Add-ons..., and enter the code \u003ccode\u003e935264945\u003c/code\u003e. To install manually, download the GitHub repository (\u003ca href=\"https://github.com/luoliyan/incremental-reading-for-anki/archive/master.zip\"\u003ehere\u003c/a\u003e) and place the \u003ccode\u003eir\u003c/code\u003e folder into your add-ons folder.\n\n\u003cb\u003e\u003ci\u003eUsage\u003c/i\u003e\u003c/b\u003e\n\nExperimentation should lead to a pretty quick understanding of how the add-on works. If in doubt, start with the following:\n\n\u003col\u003e\u003cli\u003eCreate a new IR note with an article you want to study (the easiest way to do this is to import a webpage, by pressing \u003ccode\u003e\u003cb\u003eAlt\u003c/b\u003e\u003c/code\u003e+\u003ccode\u003e\u003cb\u003e3\u003c/b\u003e\u003c/code\u003e while on the deck overview screen)\u003c/li\u003e\u003cli\u003eSet up a shortcut for creating regular Anki cards from IR cards (press \u003ccode\u003e\u003cb\u003eAlt\u003c/b\u003e\u003c/code\u003e+\u003ccode\u003e\u003cb\u003e1\u003c/b\u003e\u003c/code\u003e, or go to the menu, then go to the Quick Keys tab)\u003c/li\u003e\u003cli\u003eReview the IR card that was created, and extract any text you find interesting (by selecting the text and pressing \u003ccode\u003e\u003cb\u003ex\u003c/b\u003e\u003c/code\u003e)\u003c/li\u003e\u003cli\u003eChoose \u003ci\u003eSoon\u003c/i\u003e or \u003ci\u003eLater\u003c/i\u003e when you want to move to the next card (which will be a portion of text you extracted)\u003c/li\u003e\u003cli\u003eWhenever you want to create a regular Anki note, simply select the desired text and use the shortcut you created earlier\u003c/li\u003e\u003c/ol\u003e\nOutdated instructions can be found \u003ca href=\"https://luoliyan.github.io/incremental-reading\"\u003ehere\u003c/a\u003e. They were written for v2, but the basic behaviour of the add-on is still similar.\n\n\u003cb\u003e\u003ci\u003eSupport\u003c/i\u003e\u003c/b\u003e\n\nIf any issues are encountered, please post details to the \u003ca href=\"https://anki.tenderapp.com/discussions/add-ons\"\u003eAnki add-ons forum\u003c/a\u003e. It’s best if you post in the existing thread (\u003ca href=\"https://anki.tenderapp.com/discussions/add-ons/9054-incremental-reading-add-on-discussion-support\"\u003ehere\u003c/a\u003e) so I receive an email notification. Otherwise, \u003ca href=\"https://github.com/luoliyan/incremental-reading-for-anki/issues\"\u003enote an issue\u003c/a\u003e or make a pull request on GitHub.\n\nPlease include the following information in your post:\n\n\u003cul\u003e\u003cli\u003eThe version of Anki you are using (e.g., v2.1.0-beta5; can be found in Help → About...)\u003c/li\u003e\u003cli\u003eThe version of IR you are using (this can be found in Read → About...)\u003c/li\u003e\u003cli\u003eThe operating system you are using\u003c/li\u003e\u003cli\u003eDetails of the problem\u003c/li\u003e\u003cli\u003eSteps needed to reproduce the problem\u003c/li\u003e\u003c/ul\u003e\n\u003cb\u003e\u003ci\u003eLicense\u003c/i\u003e\u003c/b\u003e\n\nMultiple people have contributed to this add-on, and it’s somewhat unclear who to credit for which changes and which licenses to apply.\n\nTiago Barroso appears to have initiated the project, and he has \u003ca href=\"https://groups.google.com/d/msg/anki-addons/xibqDVFqQwQ/-qpxKvxurPMJ\"\u003estated\u003c/a\u003e 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 \u003ca href=\"https://ankiweb.net/account/terms\"\u003eAnkiWeb terms and conditions\u003c/a\u003e suggest they were automatically released under the AGPL v3. Aleksej’s changes to Frank’s version are \u003ca href=\"https://github.com/aleksejrs/anki-2.0-vsa-and-ire\"\u003emulti-licensed under the GPL and ISC licenses\u003c/a\u003e.\n\nFor 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.\n\nFrank 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 \u003ca href=\"http://frankraiser.de/drupal/AnkiIR\"\u003eAnki Incremental Reading\u003c/a\u003e.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjdlorimer%2Fincremental-reading","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjdlorimer%2Fincremental-reading","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjdlorimer%2Fincremental-reading/lists"}