chore: update readme
This commit is contained in:
		
							parent
							
								
									6df4c5be07
								
							
						
					
					
						commit
						1efdd12510
					
				
					 1 changed files with 28 additions and 31 deletions
				
			
		
							
								
								
									
										59
									
								
								README.md
									
										
									
									
									
								
							
							
						
						
									
										59
									
								
								README.md
									
										
									
									
									
								
							|  | @ -1,15 +1,21 @@ | |||
| # eolas-db | ||||
| 
 | ||||
| This CLI application parses entries in my | ||||
| [zettelkasten](https://github.com/thomasabishop/eolas) and extracts key metadata | ||||
| about each entry. It creates and populates an SQLite database and offers different options for | ||||
| exporting representations of the relations. | ||||
| [zettelkasten](https://github.com/thomasabishop/eolas), extracts the content | ||||
| and metadata for each entry inserts into an SQLite database. | ||||
| 
 | ||||
| It takes two parameters: | ||||
| 
 | ||||
| - `--source` | ||||
|   - A file reference to the location of the markdown files comprising the Zettelkasten | ||||
| - `--target` | ||||
|   - A file reference designating where the SQLite file should be saved. | ||||
| 
 | ||||
| ## Local development | ||||
| 
 | ||||
| ```sh | ||||
| source venv/bin/activate | ||||
| python3 src/cli.py [opts] | ||||
| python3 src/app.py --source="/my-zettelkasten-entries" --target="/tmp/zettelkasten-output-dir" | ||||
| ``` | ||||
| 
 | ||||
| ## Production | ||||
|  | @ -18,42 +24,33 @@ python3 src/cli.py [opts] | |||
| 
 | ||||
| ```sh | ||||
| source venv/bin/activate | ||||
| pyinstaller --onefile ${HOME}/repos/eolas-db/src/cli.py --name eolas-db [opts] | ||||
| pyinstaller --onefile ${HOME}/eolas-db/src/app.py | ||||
| ``` | ||||
| 
 | ||||
| Will build to the `/dist` directory of this repo when run locally. | ||||
| 
 | ||||
| ### Run executable | ||||
| 
 | ||||
| ```sh | ||||
| ${HOME}/repos/eolas-db/dist/eolas-db | ||||
| ${HOME}/eolas-db/dist/app --source="/my-zettelkasten-entries" --target="/tmp/zettelkasten-output-dir" | ||||
| ``` | ||||
| 
 | ||||
| Or: | ||||
| 
 | ||||
| ```sh | ||||
| sudo mv ${HOME}/repos/eolas-db/dist/ /usr/local/bin | ||||
| eolas-db  [opts] | ||||
| 
 | ||||
| ``` | ||||
| 
 | ||||
| ## Options | ||||
| 
 | ||||
| ### `populate` | ||||
| 
 | ||||
| Parse entries and extract key metadata and body text, import into database | ||||
| tables. | ||||
| 
 | ||||
| ### `generate-graph` | ||||
| 
 | ||||
| Output a network graph of connections between entries and tags | ||||
| 
 | ||||
| ### `export-tags` | ||||
| 
 | ||||
| Export a one-to-many JSON object of tags to entries. | ||||
| 
 | ||||
| ## ERM | ||||
| 
 | ||||
|  | ||||
| 
 | ||||
| ## Resources | ||||
| ## Related projects | ||||
| 
 | ||||
| https://www.digitalocean.com/community/tutorials/how-to-use-the-sqlite3-module-in-python-3 | ||||
| ### [eolas](https://forgejo.systemsobscure.net/thomasabishop/eolas) | ||||
| 
 | ||||
| The repository for the Zettelkasten that this application reads from. | ||||
| 
 | ||||
| ### [eolas-api](https://forgejo.systemsobscure.net/thomasabishop/eolas-api) | ||||
| 
 | ||||
| A NodeJS Express API which sources its data from database created by | ||||
| this application. | ||||
| 
 | ||||
| ### [eolas-app](https://forgejo.systemsobscure.net/thomasabishop/eolas-app) | ||||
| 
 | ||||
| A web frontend for the application, deployed at | ||||
| [eolas-app.systemsobscure.net](https://eolas-app.systemsobscure.net). | ||||
|  |  | |||
		Loading…
	
	Add table
		
		Reference in a new issue