Merge branch 'readme' into 'main'
Update README.md See merge request paris8-rust/rnote!11
This commit is contained in:
commit
b65f03b9d9
154
README.md
154
README.md
@ -19,6 +19,160 @@ Example:
|
||||
└── to buy.md
|
||||
```
|
||||
|
||||
## Basic usage
|
||||
`rnote` gives certain subcommands for managing your notes.
|
||||
```
|
||||
USAGE:
|
||||
rnote [SUBCOMMAND]
|
||||
|
||||
FLAGS:
|
||||
-h, --help Prints help information
|
||||
-V, --version Prints version information
|
||||
|
||||
SUBCOMMANDS:
|
||||
edit Edit a note.
|
||||
help Prints this message or the help of the given subcommand(s)
|
||||
list List all notes or notes from a category.
|
||||
new Create new note
|
||||
panic Delete all notes.
|
||||
remove Remove a note.
|
||||
search Search a note.
|
||||
show Show note(s) in TextView.
|
||||
```
|
||||
You can get help page to each subcommand individually by typing `rnote <subcommand> -h` to see all possible options.
|
||||
|
||||
## Usage
|
||||
This section explains the thorough use of each procedure.
|
||||
|
||||
* [Create a note](#create-a-note)
|
||||
* [Edit a note](#edit-a-note)
|
||||
* [List notes](#list-notes)
|
||||
* [Remove notes](#remove-notes)
|
||||
* [Search notes](#search-notes)
|
||||
* [Show notes](#search-notes)
|
||||
|
||||
### Create a note
|
||||
`rnote new` can be simplified by `rnote n`.\
|
||||
In order to create a note, type:
|
||||
```
|
||||
$ rnote new
|
||||
```
|
||||
It will prompt you to enter a note name and a note will be saved in date-named category.\
|
||||
Or
|
||||
```
|
||||
$ rnote new <name>
|
||||
```
|
||||
Same as previous but without prompt.\
|
||||
Or
|
||||
```
|
||||
$ rnote new <name> <category>
|
||||
```
|
||||
It will create a note `<name>` in `<category>`.
|
||||
|
||||
### Edit a note
|
||||
`rnote edit` can be simplified by `rnote e`.\
|
||||
In order to edit a note, type:
|
||||
```
|
||||
$ rnote edit
|
||||
```
|
||||
It will prompt you to enter a note name.\
|
||||
Or
|
||||
```
|
||||
$ rnote edit <name>
|
||||
```
|
||||
It will search all notes named `<name>` and will prompt you to choose one if multiple notes found.
|
||||
|
||||
### List notes
|
||||
`rnote list` can be simplified by `rnote ls` or `rnote l`.\
|
||||
You can list all notes by typing:
|
||||
```
|
||||
$ rnote list
|
||||
```
|
||||
It will show you all notes and prompt to optionnaly choose one to open.\
|
||||
You can also list all notes from a `<category>` by typing:
|
||||
```
|
||||
$ rnote list -c
|
||||
```
|
||||
or
|
||||
```
|
||||
$ rnote list --category
|
||||
```
|
||||
It will prompt you to enter category name.
|
||||
|
||||
### Remove notes
|
||||
`rnote remove` can be simplified by `rnote r`.\
|
||||
To delete a note, you can simply type:
|
||||
```
|
||||
$ rnote remove
|
||||
```
|
||||
It will prompt you to enter a name of a note.
|
||||
Or
|
||||
```
|
||||
$ rnote remove <name>
|
||||
```
|
||||
Both commands will prompt if you do want to delete a note.\
|
||||
\
|
||||
You can also remove all notes created at a certain date with:
|
||||
```
|
||||
$ rnote remove -d
|
||||
```
|
||||
Or
|
||||
```
|
||||
$ rnote remove --date
|
||||
```
|
||||
Which will prompt to enter a date in the format `YYYY-mm-dd`.
|
||||
### Search notes
|
||||
`rnote search` can be simplified by `rnote s`.\
|
||||
To search a note simply type:
|
||||
```
|
||||
$ rnote search
|
||||
```
|
||||
Or
|
||||
```
|
||||
$ rnote search <name>
|
||||
```
|
||||
First one will prompt you to enter the name.\
|
||||
\
|
||||
You can also search by word/string containing in some note:
|
||||
```
|
||||
$ rnote search -w
|
||||
```
|
||||
or
|
||||
```
|
||||
$ rnote search --word
|
||||
```
|
||||
It will prompt to enter a string to search in all notes and will prompt you to choose one if multiple notes found.
|
||||
|
||||
### Show notes
|
||||
To show a note, type:
|
||||
```
|
||||
$ rnote show
|
||||
```
|
||||
Or
|
||||
```
|
||||
$ rnote show <name>
|
||||
```
|
||||
It will show a note in a scrollable TextView in a raw terminal.\
|
||||
To scroll use arrow keys or mouse. To quit click on any button.\
|
||||
\
|
||||
To show all notes, use flag `--all`:
|
||||
```
|
||||
$ rnote show --all
|
||||
```
|
||||
Or
|
||||
```
|
||||
$ rnote show -a
|
||||
```
|
||||
To show all notes from a `<category>`, use flag `--category`:
|
||||
```
|
||||
$ rnote show -c
|
||||
```
|
||||
Or
|
||||
```
|
||||
$ rnote show --category
|
||||
```
|
||||
It will prompt you to enter category name.
|
||||
|
||||
## TODO
|
||||
|
||||
- [x] Create a note
|
||||
|
Loading…
Reference in New Issue
Block a user