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…
	
	
			
			x
			
			
		
	
		Reference in New Issue
	
	Block a user
	 Volodymyr Patuta
						Volodymyr Patuta