readme and example updates
This commit is contained in:
parent
3f368f2f98
commit
bd53209ee5
27
README.md
27
README.md
|
@ -15,10 +15,10 @@ There are no ads, trackers, cookies (unless recipes thereof) or javascript.
|
||||||
|
|
||||||
## Rules for submission
|
## Rules for submission
|
||||||
|
|
||||||
- Model submission files after [example.md](example.md). Put them in `src/`.
|
- Model submission files after [example.md](example.md). Put them in `content/`.
|
||||||
- Recipes should start with a title, with a single `#`, *on the first line*. No
|
- Recipes should start with a title, with a single `#`, *on the first line*. No
|
||||||
empty line at the top, no trailing line at the end. The file needs to be `\n`
|
empty line at the top, no trailing line at the end. The file needs to be `\n`
|
||||||
terminated in linux-fashion (if you're on linux you don't need to care, it
|
terminated in unix-fashion (if you're on linux you don't need to care, it
|
||||||
should be automatic).
|
should be automatic).
|
||||||
- File names should be the name of the dish with words separated by hyphens
|
- File names should be the name of the dish with words separated by hyphens
|
||||||
(`-`). Not underscores, and definitely not spaces.
|
(`-`). Not underscores, and definitely not spaces.
|
||||||
|
@ -29,6 +29,11 @@ There are no ads, trackers, cookies (unless recipes thereof) or javascript.
|
||||||
|
|
||||||
**If you fail to do these things, I will close your submission and you will have to resubmit. I am tired of having to fix more than 50% of submissions.**
|
**If you fail to do these things, I will close your submission and you will have to resubmit. I am tired of having to fix more than 50% of submissions.**
|
||||||
|
|
||||||
|
You may include a json file with your personal links/donation addresses in
|
||||||
|
`data/authors/your-name.json`. See mine (`data/authors/luke-smith.json`) for a
|
||||||
|
model. You can include: `website`, `donate` (general donation link), `email` or
|
||||||
|
crypto addresses as `btc`, `xmr` and `eth`.
|
||||||
|
|
||||||
### Tags
|
### Tags
|
||||||
|
|
||||||
Remember to add tags to your recipe, but try to use tags already used by other recipes.
|
Remember to add tags to your recipe, but try to use tags already used by other recipes.
|
||||||
|
@ -40,19 +45,23 @@ If it includes dairy but no milk, incude the `cheesefare` tag.
|
||||||
|
|
||||||
Images are stored in `/pix`.
|
Images are stored in `/pix`.
|
||||||
|
|
||||||
Each recipe can have a title image at the top and perhaps
|
Each recipe can have a title image at the top and perhaps several instructional
|
||||||
several instructional images as absolutely necessary.
|
images as absolutely necessary.
|
||||||
|
|
||||||
Do not add stock images you found on the internet.
|
Do not add stock images you found on the internet. Take a good picture yourself
|
||||||
Take a good picture yourself of the actual dish created.
|
of the actual dish created. If you see a bad or substandard image, you may
|
||||||
If you see a bad or substandard image, you may submit a better one.
|
submit a better one.
|
||||||
|
|
||||||
Images should be in `.webp` format and with as small file size as possible.
|
Images should be in `.webp` format and with as small file size as possible. If
|
||||||
If you submit an image for say, `chicken-parmesan.md`, it should be added as `pix/chicken-parmesan.webp`.
|
you submit an image for say, `chicken-parmesan.md`, it should be added as
|
||||||
|
`pix/chicken-parmesan.webp`.
|
||||||
|
|
||||||
If you would like to add additional directional images,
|
If you would like to add additional directional images,
|
||||||
they should be numbered with two digits like: `pix/chicken-parmesan-01.webp`, etc.
|
they should be numbered with two digits like: `pix/chicken-parmesan-01.webp`, etc.
|
||||||
|
|
||||||
|
Note also that images should have links beginning with a slash in this use
|
||||||
|
case, i.e. `/pix/...`.
|
||||||
|
|
||||||
## License
|
## License
|
||||||
|
|
||||||
This website and all its content is in the public domain.
|
This website and all its content is in the public domain.
|
||||||
|
|
21
example.md
21
example.md
|
@ -2,6 +2,7 @@
|
||||||
title: Dish Title
|
title: Dish Title
|
||||||
tags: ['beef', 'soup', 'german']
|
tags: ['beef', 'soup', 'german']
|
||||||
date: 2022-02-20
|
date: 2022-02-20
|
||||||
|
author: "Your Name"
|
||||||
---
|
---
|
||||||
|
|
||||||
If necessary, provide a very brief description of the dish in one or two sentences.
|
If necessary, provide a very brief description of the dish in one or two sentences.
|
||||||
|
@ -31,18 +32,8 @@ You may also include prep/cook time and the number of servings as below:
|
||||||
5. an image can be included between some directions if needed to explain something particular.
|
5. an image can be included between some directions if needed to explain something particular.
|
||||||
6. But that should be kept to a minimum to reduce bandwidth and aid in simplicity.
|
6. But that should be kept to a minimum to reduce bandwidth and aid in simplicity.
|
||||||
|
|
||||||
## Contribution
|
Note that you can create a `your-name.json` file in `data/authors` to add
|
||||||
|
personal links and donation addresses if you want more specific credit. If you
|
||||||
Here, just put your name and links to yourself (maybe a website or donation link) if you want.
|
do this, for the `author:` line the in the metadata, include the bare file name
|
||||||
You may say "Anonymous" or a screenname if desired.
|
of the json file. For example, my file is `data/authors/luke-smith.json`, so I
|
||||||
If you add something substantial to an already existing recipe (including an image) you may add your name below with the contribution in parens.
|
would put `author: luke-smith`.
|
||||||
|
|
||||||
Note that your commit name will be used to sign the recipe, so for full
|
|
||||||
anonymity either commit with a name that can't be traced back to you, or ask
|
|
||||||
someone else to commit for you.
|
|
||||||
|
|
||||||
If you add a Bitcoin/Monero address, put it in "code" between \`'s, like below. This is for formatting, especially with long Monero addresses.
|
|
||||||
|
|
||||||
- Luke Smith - [website](https://lukesmith.xyz), [donate](https://lukesmith.xyz/donate)
|
|
||||||
- Billy Smith - btc: `bc1q763s4ud0hgfa66ce64gyh6tsss49vyk5cqcm6w`
|
|
||||||
- Sally Smith (photo credit) - [website](https://lukesmith.xyz), [donate](https://lukesmith.xyz/donate)
|
|
||||||
|
|
Loading…
Reference in New Issue