| Index: pages/metadata.md |
| =================================================================== |
| new file mode 100644 |
| --- /dev/null |
| +++ b/pages/metadata.md |
| @@ -0,0 +1,63 @@ |
| +title=Metadata |
|
ire
2018/01/26 11:33:59
I added this page because 1) I think it's easier t
juliandoucette
2018/01/30 04:04:41
Acknowledged.
|
| +description=Default metadata for eyeo websites |
| + |
| +<head> |
| + <style> |
| + code { font-family: monospace; } |
|
ire
2018/01/26 11:33:59
This could/should be in website-defaults. If you a
juliandoucette
2018/01/30 04:04:41
NIT: Please add it separately and remove the head
ire
2018/01/30 08:19:10
https://codereview.adblockplus.org/29684561
|
| + </style> |
| +</head> |
| + |
| +# Metadata |
| + |
| +Default metadata for eyeo websites |
| + |
| +1. [Social metadata](#social) |
| + |
| +## Social metadata { #social } |
| + |
| +### Local variables |
| + |
| +The following variables can be set on a per page basis: |
|
juliandoucette
2018/01/30 04:04:41
NIT: Perhaps we should mention where/how they can
ire
2018/01/30 08:19:09
I think this is more global "how to use the cms" i
|
| + |
| +- `og_url` |
| +- `og_type` |
| +- `og_site_name` |
|
juliandoucette
2018/01/30 04:04:41
NIT: Should not be page specific.
ire
2018/01/30 08:19:08
I think it's very unlikely, but perhaps it could b
|
| +- `og_title` |
| +- `og_description` |
| +- `og_image` |
| +- `og_image_alt` |
| +- `og_locale` |
|
juliandoucette
2018/01/30 04:04:41
NIT: Should not be set by the user/developer.
ire
2018/01/30 08:19:10
Same comment as above. I can't really imagine a ca
|
| +- `facebook_id` |
|
juliandoucette
2018/01/30 04:04:41
NIT: Should not be page specific?
ire
2018/01/30 08:19:09
I can imagine that there could be different pages
|
| +- `twitter_site` |
| +- `twitter_card` |
| +- `twitter_image` |
| +- `twitter_image_alt` |
| +- `pinterest_id` |
|
juliandoucette
2018/01/30 04:04:41
NIT: Should not be page specific?
ire
2018/01/30 08:19:09
See comment above.
|
| + |
| +### Global variables |
| + |
| +Additionally, the following global variables can be set for the entire site. |
|
juliandoucette
2018/01/30 04:04:41
This is a locale string not a global variable. The
ire
2018/01/30 08:19:10
I didn't mean it as a literal global variable. I m
|
| + |
| +#### Site Name |
| + |
| +In a `locales/[locale]/site.json` file: |
|
juliandoucette
2018/01/30 04:04:41
I think that it must be defined in the defaultloca
ire
2018/01/30 08:19:09
I don't think so. There's no file in website-defau
|
| + |
| +``` |
| +{ |
| + "name": { |
| + "message": "eyeo", |
| + "description": "Website title" |
| + } |
| +} |
| +``` |
| + |
| +#### Social accounts |
| + |
| +In the `settings.ini` file: |
|
juliandoucette
2018/01/30 04:04:41
NIT: I think "In `/settings.ini`" gets the point a
ire
2018/01/30 08:19:09
Done.
|
| + |
| +``` |
| +[social] |
| +facebook_id = 1234 |
|
juliandoucette
2018/01/30 04:04:41
NIT: Are these IDs actually short integers?
ire
2018/01/30 08:19:10
I don't think so, I think they may be alphanumeric
|
| +pinterest_id = 1234 |
| +twitter = @username |
|
juliandoucette
2018/01/30 04:04:41
(Why do they make you include the @ sign!? :'( )
ire
2018/01/30 08:19:09
Done.
|
| +``` |