90 lines
3.7 KiB
Org Mode
90 lines
3.7 KiB
Org Mode
[[http://melpa.org/#/anki-editor][file:http://melpa.org/packages/anki-editor-badge.svg]]
|
|
|
|
anki-editor -- Make Anki Cards in Org-mode
|
|
|
|
* Installation
|
|
|
|
*Requirements*
|
|
- [[https://github.com/FooSoft/anki-connect#installation][anki-connect]],
|
|
an Anki add-on required by this package to interact with Anki.
|
|
- curl
|
|
|
|
If you have [[http://melpa.org/][MELPA]] in your =package-archives=,
|
|
just =M-x package-install RET anki-editor RET=, or install it
|
|
manually by downloading and visiting [[anki-editor.el]] in your
|
|
emacs buffer, and =M-x package-install-from-buffer RET=.
|
|
|
|
* Usage
|
|
|
|
** The Syntax
|
|
|
|
Now you can compose Anki notes in Org syntax, e.g. lists, code
|
|
blocks, tables, latex fragments / environments, when being
|
|
submitted to Anki, they will be converted to HTML by Org-mode's
|
|
HTML backend with specific markers (e.g. latex) translated to the
|
|
Anki style.
|
|
|
|
The structure of contents is as follow, which is inspired by
|
|
=org-drill=. See [[./examples.org][examples.org]] for reference.
|
|
|
|
#+BEGIN_EXAMPLE
|
|
* English :deck:
|
|
** Vocabulary
|
|
*** Item :note:
|
|
:PROPERTIES:
|
|
:ANKI_NOTE_TYPE: Basic (and reversed card)
|
|
:ANKI_TAGS: vocab idioms
|
|
:END:
|
|
**** Front
|
|
(it's) raining cats and dogs
|
|
**** Back
|
|
it's raining very hard
|
|
#+END_EXAMPLE
|
|
|
|
- Headings of deck are tagged with =deck=
|
|
- Headings of note are tagged with =note=
|
|
- Levels are not significant, but note headings must be descendents
|
|
of their deck headings
|
|
- Custom properties of a note heading can be used to specify note
|
|
type and tags
|
|
- Subheadings of a note heading are fields of its note type
|
|
|
|
** Command Cheatsheet
|
|
|
|
| Command | Brief Description |
|
|
|--------------------------------------+---------------------------------------------------------------------|
|
|
| =anki-editor-submit= | Send notes in current buffer to Anki. |
|
|
| =anki-editor-insert-deck= | Insert a deck heading. |
|
|
| =anki-editor-insert-note= | Insert the skeleton of a note. |
|
|
| =anki-editor-add-tags= | Add tags to property drawer of current heading with autocompletion. |
|
|
| =anki-editor-cloze-region= | Cloze region. |
|
|
| =anki-editor-export-subtree-to-html= | Export subtree of the element at point to HTML. |
|
|
| =anki-editor-convert-region-to-html= | Convert and replace region to HTML. |
|
|
|
|
*Since I'm not a native English speaker, let me know if there's any ambiguity or grammatical mistakes.*
|
|
|
|
* Demo
|
|
|
|
[[./demo.gif]]
|
|
|
|
* Change Log
|
|
|
|
*v0.2.2*
|
|
- Adds optional tag inheritance.
|
|
- Adds optional deck creation.
|
|
- Fixes issue #15 (url-encoded file path isn't recognized by shell commands).
|
|
|
|
*v0.2.1*
|
|
- Automatically store media files for links to file when submitting.
|
|
- =anki-editor-insert-tags= renamed to =anki-editor-add-tags=, with behavior slightly changed.
|
|
- =anki-editor-export-heading-contents-to-html= renamed to =anki-editor-export-subtree-to-html=.
|
|
|
|
*v0.2.0*
|
|
- Fix =org-element= not functioning correctly in temp buffer.
|
|
- Add a command to cloze region.
|
|
- Refactor the code to do the translation with Org's exporting framework.
|
|
- Add a customization variable to break consecutive braces in latex.
|
|
|
|
*v0.1.2*
|
|
- Make deck/note insertion commands smarter on choosing insertion point.
|
|
- Fix latex environments being joined with the elements following it.
|