Compare commits
No commits in common. 'main' and 'feature/create-config' have entirely different histories.
main
...
feature/cr
1 changed files with 13 additions and 93 deletions
@ -1,103 +1,23 @@ |
|||||||
# Ankimaker |
# Ankimaker |
||||||
|
|
||||||
A CLI app to generate anki decks. |
WIP |
||||||
|
|
||||||
Flashcards are a great tool for accelerating language learning. |
|
||||||
You can choose one from the many databases out there, developed |
|
||||||
by teachers and very conscientious people. It would be even better |
|
||||||
it is easy to create new flashcards to satisfy personalized needs. |
|
||||||
For instance, generating flashcards from your bookmarked words in |
|
||||||
google translator or dictionary add-on on your browser |
|
||||||
would be much more effective because you would focus in the words |
|
||||||
you actually are not familiar with including the ones that are more |
|
||||||
frequent in your professional or hobby contexts than in default |
|
||||||
common language use. |
|
||||||
|
|
||||||
# Usage |
|
||||||
|
|
||||||
## csv |
|
||||||
|
|
||||||
From csv file, with configurable parameters and |
|
||||||
(media to be supported in the future). |
|
||||||
|
|
||||||
```bash |
|
||||||
ankimaker csv -i file.csv -o deck.apkg --conf conf.yaml |
|
||||||
``` |
|
||||||
|
|
||||||
#### Configuration File |
A CLI app to generate anki decks. |
||||||
The configuration file required to convert csv can be |
|
||||||
generated manually or interactively with the following command: |
|
||||||
```bash |
|
||||||
ankimaker make-csv-config -i sample-input.csv -o custon-conf.yaml |
|
||||||
``` |
|
||||||
|
|
||||||
If you want to create the configuration manually, see instruction |
|
||||||
in `Manually create configuration file` section. |
|
||||||
|
|
||||||
## Manually create configuration file |
|
||||||
```yaml |
|
||||||
AnkimakerConfig: |
|
||||||
header: |
|
||||||
question_column: 'original' |
|
||||||
answer_column: 'translation' |
|
||||||
separators: \t |
|
||||||
filters: |
|
||||||
- - column: 'original language' |
|
||||||
values: Chinese |
|
||||||
- column: 'translation language' |
|
||||||
values: English |
|
||||||
- - column: 'original language' |
|
||||||
values: English |
|
||||||
- column: 'translation language' |
|
||||||
values: Chinese |
|
||||||
``` |
|
||||||
|
|
||||||
Explaining the fields: |
|
||||||
* **header**: Row index to be used as column. Use null |
|
||||||
if nonexistent or just don't insert this field. |
|
||||||
* **question_column**: Name or index of column to be used as question. |
|
||||||
* **answer_column**: Name or index of the columns containing the answers. . Use null |
|
||||||
if nonexistent or just don't insert this field. |
|
||||||
* **separators**: Select the character that separates cells in your csv. |
|
||||||
* **filters**: This is a list of groups that will be present in your |
|
||||||
final deck. Each group is defined by a list of rules that must be fulfilled |
|
||||||
so the row will be part of the group. For instance, the following filter |
|
||||||
would keep only the rows whose 'original language' column value |
|
||||||
is Chinese. |
|
||||||
|
|
||||||
```yaml |
|
||||||
filters: |
|
||||||
- - column: 'original language' |
|
||||||
values: Chinese |
|
||||||
``` |
|
||||||
|
|
||||||
This other filer would keep only the rows that 'original language' |
From csv file, with configurable parameters, filters and media. |
||||||
column is Chinese and 'translation language' column value is |
|
||||||
any of English or French. |
|
||||||
|
|
||||||
```yaml |
From epub, finding difficult* words in the book and getting their translations. |
||||||
filters: |
|
||||||
- - column: 'original language' |
|
||||||
values: Chinese |
|
||||||
- column: 'translation language' |
|
||||||
values: [English, French] |
|
||||||
``` |
|
||||||
|
|
||||||
The logic of the groups is that any row satisfying at least |
*I still don't know what 'difficult' will mean. Probably difficult words will be less frequent words that are more frequent in the text than in some corpus, cut above a grade threshold. The grades will map percentiles of frequency. |
||||||
one group's rule will be present in the final deck. In short, |
|
||||||
they're reduced with `or` logic. In the example bellow any row |
|
||||||
that has 'original language' column value Chinese and any roll |
|
||||||
that has 'translation language' column value English will be |
|
||||||
in the final deck. |
|
||||||
|
|
||||||
```yaml |
| Language Level | Number of Base Words Needed | |
||||||
filters: |
| ----- | ------ | |
||||||
- - column: 'original language' |
| A1 | 500| |
||||||
values: Chinese |
| A2 | 1000| |
||||||
- - column: 'translation language' |
| B1 | 2000| |
||||||
values: English |
| B2 | 4000| |
||||||
``` |
| C1 | 8000| |
||||||
|
| C2 | 16000| |
||||||
|
|
||||||
* * * |
|
||||||
|
|
||||||
This project is only possible because of the awesome work of genanki team. |
This project is only possible because of the awesome work of genanki team. |
Loading…
Reference in new issue