Skip to content

Commit 5c49e92

Browse files
committed
Rewrite README.md
1 parent 26411f0 commit 5c49e92

File tree

1 file changed

+23
-15
lines changed

1 file changed

+23
-15
lines changed

README.md

Lines changed: 23 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,42 +1,50 @@
11
# lsnotes
2-
(Part of the `better coreutils initiative`)
32

4-
Add a description to your directories! Simply add a `.lsnotes` file and that's it! This is the original repo of the `lsnotes` project.
3+
> Adding descriptions to your directories!
54
6-
It's an especially simple project, but the idea makes me feel fresh! It should be made a shell project but I don't feel like that. Anyway, it has endless possibilities!
5+
---
6+
7+
## What’s lsnotes?
8+
9+
**lsnotes** lets you attach and display notes for directories. Just drop a `.lsnotes` file in any folder and voilà—your directory has a description. Now remade with:
10+
11+
- **Python** — easier to use and extend
12+
- **Typer** — for snappy, intuitive CLI
13+
- **Markdown support** — so your notes can look sleek and formatted
714

815
## A story
916
It was originnaly just an April Fools joke that I told [@MrWillCom](https://github.com/MrWillCom), but it turned out to be a brilliant idea. So I made this project.
1017

1118
## Installation
1219

20+
Clone and build by yourself!
21+
```sh
22+
poetry install
23+
```
24+
25+
or get it from PyPI!
26+
1327
```sh
14-
git submodule init
15-
git submodule update
16-
mkdir build && cd build
17-
cmake ..
18-
make
19-
make install
28+
pip install lsnotes
2029
```
2130

2231
## Usage
2332

2433
```sh
25-
lsnotes # for viewing the description
26-
lsnotes --view or lsnotes -v # does the same as above
34+
lsnotes view # does the same as above
2735

2836
lsnotes --help # for assistance
2937

30-
lsnotes --edit or lsnotes -e # edits the .lsnotes file with your default editor
38+
lsnotes edit # edits the .lsnotes file with your default editor
3139

32-
lsnotes --config or lsnotes -c # for configuration
40+
lsnotes config # for configuration
3341
```
3442

3543
### Examples
3644

3745
```sh
38-
alias ls = "lsnotes && ls"
39-
alias pwd = "lsnotes && pwd"
46+
alias ls = "lsnotes view && ls"
47+
alias pwd = "lsnotes view && pwd"
4048
# etc.
4149
```
4250

0 commit comments

Comments
 (0)