]> git.armaanb.net Git - lightcards.git/blob - man/lightcards.1.md
0c5441ca52222be8e84abc56eb275b481a194a76
[lightcards.git] / man / lightcards.1.md
1 ---
2 title: lightcards
3 section: 1
4 header: General Commands Manual
5 footer: VERSION_HERE
6 date: February 2021
7 ---
8
9 # NAME
10 lightcards - terminal flashcards from Markdown
11
12 # SYNOPSIS
13 lightcards \[options\] \[input file\]
14
15 # DESCRIPTION
16 **lightcards** is a Python program that reads data from a two column Markdown (and by extension, HTML) table in the **input file**, and displays flashcards from their contents.
17
18 # OPTIONS
19 ## Generic Program Information
20 **-h**, **\--help**
21 : Show a help message and exit
22
23 **-v**, **\--version**
24 : Print version and exit
25
26 ## Startup options
27 **-a**, **\--alphabetize**
28 : Alphabetize card order
29
30 **-p**, **\--purge**
31 : Purge cache for chosen set
32
33 **-r**, **\--reverse**
34 : Reverse card order
35
36 **-s**, **\--shuffle**
37 : Shuffle card order
38
39 **-V** \[1-3\], **\--view** \[1-3\]
40 : Specify startup view
41
42 **-c**, **\--config**
43 : Specify a custom config file
44
45 # KEYS
46 **l**, **right**
47 : Next card
48
49 **h**, **left**
50 : Previous card
51
52 **j**, **k**, **up**, **down**
53 : Flip card
54
55 **i**, **/**
56 : Star card
57
58 **0**, **^**, **home**
59 : Go to start of deck
60
61 **$**, **end**
62 : Go to end of deck
63
64 **H**, **?**
65 : Open help screen
66
67 **m**
68 : Open control menu
69
70 **1**, **2**, **3**
71 : Switch views between front first, back first, and both
72
73 **q**
74 : Quit
75
76 # INPUT FILE
77 Lightcards takes the first table from a valid Markdown or HTML file. Each row is a card, and the two columns are the front and back.
78
79 # EXIT STATUS
80 **0**
81 : Success
82
83 **1**
84 : Parse error
85
86 **2**
87 : Invalid option
88
89 **3**
90 : Curses error
91
92 **4**
93 : Config error
94
95 # SEE ALSO
96   **lightcards-config(5)**
97
98 # BUGS
99 https://lists.sr.ht/~armaan/public-inbox
100
101 # COPYRIGHT
102 Copyright 2021 Armaan Bhojwani <me@armaanb.net>, MIT License.