X-Git-Url: https://git.armaanb.net/?p=lightcards.git;a=blobdiff_plain;f=README.md;h=4c061d00390a704518f6f811ad9ca4d82474b895;hp=9284e1e212a47ea8cb765eee5f515302ca130808;hb=HEAD;hpb=dd109cb4a1b49f920e36e5732417c4a3d5582821 diff --git a/README.md b/README.md index 9284e1e..4c061d0 100644 --- a/README.md +++ b/README.md @@ -2,6 +2,10 @@ Terminal flashcards from Markdown. ## Installation +Lightcards is only tested and maintained on Linux. Support for other Unix-like operating systems such as MacOS and the various BSDs is likely, although untested. Windows support may be possible with [windows-curses](https://pypi.org/project/windows-curses/) or the like, however much of the program makes the assumption that there is a Unix-like file hierarchy, which may break on Windows. Nontrivial patches will not be accepted to improve Windows support, although may be for MacOS or BSD. + +Lightcards requires Python 3.9 + ### From PyPI ``` pip install lightcards @@ -22,10 +26,10 @@ pip install git+https://git.sr.ht/~armaan/lightcards@devel See `lightcards --help` or `man lightcards` for usage information. ## Input file -`contrib/example.md` is an example input file. 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. +`contrib/example.md` is an example input file. Lightcards takes all of the tables from a valid Markdown or HTML file. Each row is a card, and the two columns are the front and back. ## Configuration -An example config file is provided at `/usr/share/doc/lightcards/config.py`, or `~/.local/share/doc/lightcards/config.py` if installed without root privileges. Copy it to `~/.config/lightcards/config.py` or `/etc/lightcards/config.py` and modify the given values. +Copy the config file at `/etc/lightcards/config.py` to `~/.config/lightcards/config.py` or `~/${XDG_CONFIG_HOME}/lightcards/config.py` and edit. ## License Copyright Armaan Bhojwani 2021, MIT license