lirve.el/README.md

75 lines
1.4 KiB
Markdown
Raw Normal View History

2024-02-12 18:13:29 +01:00
# Lirve: Learn irregular English verbs in Emacs
Lirve helps you learn irregular verbs using the spaced repetition technique. In other words: Lirve remember your mistakes and repeat the challenge in the future.
2024-01-02 16:45:15 +01:00
![Demo](demo.png)
## Install
2024-02-12 18:13:29 +01:00
You need to have `straight` installed.
Then, add it to your `init.el`.
2024-01-02 16:45:15 +01:00
```elisp
2024-02-20 11:57:08 +01:00
(use-package lirve
2024-02-15 21:59:13 +01:00
:straight (:host github :repo "tanrax/learning-irregular-verbs-in-english.el" :files ("lirve-verbs.el" "lirve.el"))
2024-01-02 16:45:15 +01:00
:ensure t)
```
2024-01-08 19:14:11 +01:00
2024-02-16 09:53:31 +01:00
And add the following to your `init.el`:
```elisp
(require 'lirve)
```
2024-01-08 19:14:11 +01:00
## Configure (Optional)
Shows the translation of the verb when resolving or failing.
2024-01-08 23:10:26 +01:00
![Demo translation](demo-translation.png)
2024-02-12 18:13:29 +01:00
Only available in Spanish (at the moment).
2024-01-08 19:14:11 +01:00
```elisp
2024-02-20 12:02:45 +01:00
(setq lirve--set-translation 'es)
2024-01-08 19:14:11 +01:00
```
2024-02-16 10:52:51 +01:00
I also recommend creating a function to make it easier to remember the command.
```elisp
(defun learning-irregular-verbs-in-english ()
"Start Lirve."
(interactive)
(lirve))
```
2024-01-08 19:14:11 +01:00
## Usage
```
2024-02-16 10:52:51 +01:00
M-x lirve
2024-01-08 19:14:11 +01:00
```
## Controls
| Key | Description |
| --- | --- |
| `TAB` | Move to the next field |
| `S-TAB` | Move to the previous field |
| `RET` | Click on the button |
2024-02-12 18:13:29 +01:00
## Collaborate
If you want to add more languages, make a PR with the translations in `lirve-verbs.el`.
2024-02-12 18:15:58 +01:00
For example, the verb `beat` in Italian and Spanish:
```ellisp
(
(infinitive . "beat")
(simple-past . "beat")
(past-participle . "beaten")
(translations
(es . "golpear")
(it . "colpo")))
```