Update docs.

This commit is contained in:
Louis Cordier 2020-06-27 21:08:51 +02:00
parent a89f34348c
commit 6c101a3ecb

106
README.md
View file

@ -13,7 +13,7 @@ A recipe box can be a [treasure chest](https://www.ourstate.com/a-kitchens-riche
The idea is not to have the biggest collection of recipes, but to have the most valuable one. The one with the recipes you've The idea is not to have the biggest collection of recipes, but to have the most valuable one. The one with the recipes you've
personally tested and most of your family love. personally tested and most of your family love.
Since the recipes are stored in simple plaintext files it is easy to share with your friends and family, or pass down to the Since the recipes are stored in simple plain text files it is easy to share with your friends and family, or pass down to the
next generation years from now. next generation years from now.
> In our age when cloud services can shut down, get bought, or change privacy policy any day, the last thing you want is proprietary formats and data lock-in. > In our age when cloud services can shut down, get bought, or change privacy policy any day, the last thing you want is proprietary formats and data lock-in.
@ -21,3 +21,107 @@ next generation years from now.
> With Obsidian, your data sits in a local folder. Never leave your life's work held hostage in the cloud again. > With Obsidian, your data sits in a local folder. Never leave your life's work held hostage in the cloud again.
> >
> Plain text Markdown also gives you the unparalleled interoperability to use any kind of sync, encryption, or data processing that works with plain text files. > Plain text Markdown also gives you the unparalleled interoperability to use any kind of sync, encryption, or data processing that works with plain text files.
You could still backup your recipe collection to a private GitHub repository. You could also convert the Markdown files into a
PDF and print a physical book as a personalised gift. You'll need those #tags and [[backlinks]] to organise it thou.
## Installation
1. `pip install recipe-box`
2. Install [Obsidian](https://obsidian.md/) to view the pretty recipes ;)
## How To Use
First run `recipe_box` without parameters to create the config file, $HOME/.config/recipe_box/recipe_box.json
```
{
"recipe_box": "~/recipe_box/"
}
```
Here you can customize the name and location of your recipe box.
Then you are ready to download recipes. Search one of the supported sites for a recipe you like, copy the URL.
```
$ recipe_box https://www.bbc.co.uk/food/recipes/better_for_you_chocolate_83771
```
Open Obsidian, open vault and point it to your recipe_box.
## Supported Recipe Sites
These sites are scraped by the excellent [recipe-scrapers](https://github.com/hhursev/recipe-scrapers) library.
To add a new [recipe site](https://github.com/hhursev/recipe-scrapers#if-you-want-a-scraper-for-a-new-site-added).
* [101cookbooks.com](https://101cookbooks.com/)
* [allrecipes.com](https://allrecipes.com/)
* [archanaskitchen.com](https://archanaskitchen.com/)
* [bbc.co.uk](https://bbc.co.uk/)
* [bbc.com](https://bbc.com/)
* [bbcgoodfood.com](https://bbcgoodfood.com/)
* [bettycrocker.com](https://bettycrocker.com/)
* [bonappetit.com](https://bonappetit.com/)
* [budgetbytes.com](https://budgetbytes.com/)
* [closetcooking.com](https://closetcooking.com/)
* [cookieandkate.com](https://cookieandkate.com/)
* [cooking.nytimes.com](https://cooking.nytimes.com/)
* [cookpad.com](https://cookpad.com/)
* [cookstr.com](https://cookstr.com/)
* [copykat.com](https://copykat.com/)
* [countryliving.com](https://countryliving.com/)
* [cybercook.com.br](https://cybercook.com.br/)
* [delish.com](https://delish.com/)
* [en.wikibooks.org](https://en.wikibooks.org/)
* [epicurious.com](https://epicurious.com/)
* [finedininglovers.com](https://finedininglovers.com/)
* [fitmencook.com](https://fitmencook.com/)
* [food.com](https://food.com/)
* [foodnetwork.com](https://foodnetwork.com/)
* [foodrepublic.com](https://foodrepublic.com/)
* [geniuskitchen.com](https://geniuskitchen.com/)
* [gonnawantseconds.com](https://gonnawantseconds.com/)
* [gousto.co.uk](https://gousto.co.uk/)
* [greatbritishchefs.com](https://greatbritishchefs.com/)
* [healthyeating.nhlbi.nih.gov](https://healthyeating.nhlbi.nih.gov/)
* [heinzbrasil.com.br](https://heinzbrasil.com.br/)
* [hellofresh.co.uk](https://hellofresh.co.uk/)
* [hellofresh.com](https://hellofresh.com/)
* [inspiralized.com](https://inspiralized.com/)
* [jamieoliver.com](https://jamieoliver.com/)
* [justbento.com](https://justbento.com/)
* [marmiton.org](https://marmiton.org/)
* [matprat.no](https://matprat.no/)
* [mindmegette.hu](https://mindmegette.hu/)
* [misya.info](https://misya.info/)
* [momswithcrockpots.com](https://momswithcrockpots.com/)
* [motherthyme.com](https://motherthyme.com/)
* [mybakingaddiction.com](https://mybakingaddiction.com/)
* [myrecipes.com](https://myrecipes.com/)
* [ohsheglows.com](https://ohsheglows.com/)
* [panelinha.com.br](https://panelinha.com.br/)
* [paninihappy.com](https://paninihappy.com/)
* [przepisy.pl](https://przepisy.pl/)
* [realsimple.com](https://realsimple.com/)
* [receitas.ig.com.br](https://receitas.ig.com.br/)
* [ricette.giallozafferano.it](https://ricette.giallozafferano.it/)
* [seriouseats.com](https://seriouseats.com/)
* [simplyquinoa.com](https://simplyquinoa.com/)
* [simplyrecipes.com](https://simplyrecipes.com/)
* [southernliving.com](https://southernliving.com/)
* [steamykitchen.com](https://steamykitchen.com/)
* [tastesoflizzyt.com](https://tastesoflizzyt.com/)
* [tastykitchen.com](https://tastykitchen.com/)
* [thehappyfoodie.co.uk](https://thehappyfoodie.co.uk/)
* [thekitchn.com](https://thekitchn.com/)
* [thepioneerwoman.com](https://thepioneerwoman.com/)
* [thespruceeats.com](https://thespruceeats.com/)
* [thevintagemixer.com](https://thevintagemixer.com/)
* [tine.no](https://tine.no/)
* [tudogostoso.com.br](https://tudogostoso.com.br/)
* [twopeasandtheirpod.com](https://twopeasandtheirpod.com/)
* [vegolosi.it](https://vegolosi.it/)
* [whatsgabycooking.com](https://whatsgabycooking.com/)
* [yummly.com](https://yummly.com/)