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 files\]
  14
  15 # DESCRIPTION
  16 **lightcards** is a Python program that reads data from two column Markdown (and by extension, HTML) tables from the **input files**, 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 file\], **\--config** \[config file\]
  43 : Specify a custom config file
  44
  45 **-l**, **\--lenient**
  46 : Don't raise exception if tables are malformed
  47
  48 # KEYS
  49 **l**, **right**
  50 : Next card
  51
  52 **h**, **left**
  53 : Previous card
  54
  55 **j**, **k**, **up**, **down**
  56 : Flip card
  57
  58 **i**, **/**
  59 : Star card
  60
  61 **0**, **^**, **home**
  62 : Go to start of deck
  63
  64 **$**, **end**
  65 : Go to end of deck
  66
  67 **H**, **?**
  68 : Open help screen
  69
  70 **m**
  71 : Open control menu
  72
  73 **1**, **2**, **3**
  74 : Switch views between front first, back first, and both
  75
  76 **q**
  77 : Quit
  78
  79 # INPUT FILE
  80 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.
  81
  82 # EXIT STATUS
  83 **0**
  84 : Success
  85
  86 **1**
  87 : Parse error
  88
  89 **2**
  90 : Invalid option
  91
  92 **3**
  93 : Curses error
  94
  95 **4**
  96 : Config error
  97
  98 # SEE ALSO
  99   **lightcards-config(5)**
 100
 101 # BUGS
 102 https://lists.sr.ht/~armaan/public-inbox
 103
 104 # COPYRIGHT
 105 Copyright 2021 Armaan Bhojwani <me@armaanb.net>, MIT License.