Update README
Browse files
README.md
CHANGED
@@ -29,3 +29,49 @@ Chessli2 is here to support your journey to becoming a chess master. Dive in and
|
|
29 |
## Quickstart
|
30 |
|
31 |
Try it directly out at [Huggingface Spaces](https://pwenker-chessli2.hf.space/).
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
29 |
## Quickstart
|
30 |
|
31 |
Try it directly out at [Huggingface Spaces](https://pwenker-chessli2.hf.space/).
|
32 |
+
|
33 |
+
|
34 |
+
## FAQ
|
35 |
+
|
36 |
+
### ποΈ How to Obtain Your Lichess API Token
|
37 |
+
|
38 |
+
:zap: Fast route: Simply click this pre-filled URL for a quick set-up with the correct token space: https://lichess.org/account/oauth/token/create?scopes[]=puzzle:read&description=My+token+for+chessli2
|
39 |
+
|
40 |
+
To acquire a personal API token for the Lichess platform, simply follow these steps:
|
41 |
+
|
42 |
+
1. **Create a Lichess Account** π: If you don't already have one, create a Lichess account by visiting [lichess.org](https://lichess.org) and signing up.
|
43 |
+
2. **Log In** π: After setting up your account, log in and navigate to your account settings.
|
44 |
+
3. **Access Token Settings** π§: Proceed to the 'API Access Tokens' section, typically found under a menu related to tools or personal settings. You can directly access it via [https://lichess.org/account/oauth/token](https://lichess.org/account/oauth/token).
|
45 |
+
4. **Create a New Token** π: Click on the button to create a new token. You'll need to specify the scopes or permissions that the token should have. These permissions determine what actions your token can perform on your behalf. For `chessli2` it is currently sufficient to permit "Read Puzzle Activity" and "Read Preferences".
|
46 |
+
5. **Name Your Token** π·οΈ: Assign a meaningful name to your token for easy identification, especially useful if managing multiple tokens.
|
47 |
+
6. **Generate the Token** π: After selecting the necessary scopes and naming your token, click to generate it. Lichess will display your new API token.
|
48 |
+
7. **Copy and Secure Your Token** π: Ensure you copy and securely store your token. Do not share it, as it grants access to your Lichess account based on the selected scopes. Remember, Lichess will not display the token again once you navigate away from the page.
|
49 |
+
8. **Use the Token** π: You can now use this token by pasting it into the "Lichess API token" field within the `chessli2` interface
|
50 |
+
|
51 |
+
π¨ **Important**: If your token is ever compromised or no longer needed, revoke it immediately to secure your account.
|
52 |
+
|
53 |
+
### π How to Get Anki Cards from My Mistakes?
|
54 |
+
|
55 |
+
#### π Create a CSV File
|
56 |
+
- After you've fetched your mistakes with `chessli2`, a "Download CSV" button will appear.
|
57 |
+
- Click this button and store the `CSV` file at a location of your choosing.
|
58 |
+
|
59 |
+
#### π Set-up Anki-Chess-2.0
|
60 |
+
- Next, you will need to set up [Anki-Chess-2.0](https://github.com/TowelSniffer/Anki-Chess-2.0). This is the Anki chess template that is needed to visualize your mistakes within Anki with a beautiful interactive chess board.
|
61 |
+
- While you are there, why not leave a star β to show the maintainer that you value the chess template, or send a nice message? π Since the beginnings of `chessli`, the chess template has always been a crucial part!
|
62 |
+
|
63 |
+
#### π₯ Import the CSV into Anki
|
64 |
+
|
65 |
+
Finally, you can import the CSV file into Anki.
|
66 |
+
|
67 |
+
1. Launch the Anki application on your computer.
|
68 |
+
2. Choose or create the deck into which you want to import the CSV file.
|
69 |
+
3. Click on the deck name to open it.
|
70 |
+
4. In the main Anki window, go to the menu bar and click on `File`.
|
71 |
+
5. Select `Import...` from the dropdown menu.
|
72 |
+
6. Browse to the location of your CSV file, select it, and click `Open`.
|
73 |
+
7. Anki will open a dialog box asking how you want to import the CSV file. Select the `Chess-2.0` note type.
|
74 |
+
8. Make sure it reads: "Field 1 of file is: mapped to PGN"
|
75 |
+
9. Click the `Import` button. Anki will process the file and add the new cards to the selected deck.
|
76 |
+
10. After importing, itβs a good idea to review a few cards to ensure they were imported correctly. You can do this by browsing the deck or starting a study session.
|
77 |
+
11. Pat yourself on the back! You did it! π
|