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 |     └── 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 | ## TODO | ||||||
| 
 | 
 | ||||||
| - [x] Create a note | - [x] Create a note | ||||||
|  | |||||||
		Loading…
	
	
			
			x
			
			
		
	
		Reference in New Issue
	
	Block a user
	 Volodymyr Patuta
						Volodymyr Patuta