Skip to content

Commit 7c20525

Browse files
committed
docs: update installation and usage instructions to use uv and remove requirements.txt
1 parent 4199fde commit 7c20525

File tree

4 files changed

+27
-41
lines changed

4 files changed

+27
-41
lines changed

README.md

Lines changed: 14 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -64,39 +64,32 @@ Explore the demo to see how KoalaKeys works and to get ideas for creating custom
6464

6565
1. Clone the repository:
6666

67-
```
68-
git clone https://github.com/rtuszik/KoalaKeys
69-
cd KoalaKeys
70-
```
67+
```
68+
git clone https://github.com/rtuszik/KoalaKeys
69+
cd KoalaKeys
70+
```
7171
7272
2. Create and activate a virtual environment (optional):
7373
74-
```
75-
python -m venv .venv
76-
source .venv/bin/activate # On Windows, use `venv\Scripts\activate`
77-
```
74+
```
75+
uv sync --locked
76+
```
7877
79-
3. Install dependencies:
80-
81-
```
82-
pip install -r requirements.txt
83-
```
84-
85-
4. Set up the output directory:
78+
3. Set up the output directory:
8679
Create a `.env` file in the project root with:
87-
```
88-
CHEATSHEET_OUTPUT_DIR=path/to/your/output/directory
89-
```
80+
```
81+
CHEATSHEET_OUTPUT_DIR=path/to/your/output/directory
82+
```
9083
9184
## Usage
9285
9386
1. Create YAML files for your cheat sheets in the `cheatsheets` directory. For detailed instructions on how to format YAML files, please refer to the [YAML Cheat Sheet Specification Guide](yaml_cheatsheet_spec.md).
9487
9588
2. Generate cheat sheets:
9689
97-
```
98-
python src/generate_cheatsheet.py
99-
```
90+
```
91+
uv run src/generate_cheatsheet.py
92+
```
10093
10194
3. Find the HTML cheat sheets in the specified output directory.
10295

cheatsheets/example-cheatsheet.yaml

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -2,16 +2,16 @@ title: "KoalaKeys"
22
RenderKeys: true # defaults to true
33
AllowText: false # defaults to false - requires RenderKeys: false
44
layout:
5-
keyboard: US
6-
system: Darwin
5+
keyboard: US
6+
system: Darwin
77
shortcuts:
8-
General:
9-
"CMD+C":
10-
description: "Copy selected item"
11-
"CMD+X":
12-
description: "Cut selected item"
13-
File and App Management:
14-
"CMD+N":
15-
description: "Open new window or document"
16-
"CMD+O":
17-
description: "Open selected item or display dialog to choose file to open"
8+
General:
9+
"CMD+C":
10+
description: "Copy selected item"
11+
"CMD+X":
12+
description: "Cut selected item"
13+
File and App Management:
14+
"CMD+N":
15+
description: "Open new window or document"
16+
"CMD+O":
17+
description: "Open selected item or display dialog to choose file to open"

pyproject.toml

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,4 @@ version = "0.6.0"
44
description = "Build interactive, portable cheatsheets from YAML."
55
readme = "README.md"
66
requires-python = ">=3.9"
7-
dependencies = [
8-
"jinja2>=3.1.6",
9-
"python-dotenv>=1.1.1",
10-
"ruamel-yaml>=0.18.14",
11-
]
7+
dependencies = ["jinja2>=3.1.6", "python-dotenv>=1.1.1", "ruamel-yaml>=0.18.14"]

requirements.txt

Lines changed: 0 additions & 3 deletions
This file was deleted.

0 commit comments

Comments
 (0)