images tag formalize

pull/319/head
Dave Jones 2021-12-10 11:06:09 -06:00
rodzic 381c3eef76
commit 3379e02900
2 zmienionych plików z 30 dodań i 34 usunięć

Wyświetl plik

@ -256,39 +256,6 @@ Example:
----
### **\<podcast:images>** - <small>[Discuss](https://github.com/Podcastindex-org/podcast-namespace/issues/43)</small>
<br>
<b>
```xml
<podcast:images
srcset="[image urls with sizing attached(string array)]"
/>
```
</b>
Channel or Item
(optional | single)
This tag, when present, allows for specifying many different image sizes in a compact way at either the episode or channel level. The syntax is borrowed from
the HTML5 [srcset](https://html.spec.whatwg.org/multipage/images.html#srcset-attributes) syntax. It allows for describing multiple image sources with width and
pixel hints directly in the attribute.
Example of a single gateway:
```xml
<podcast:images
srcset="https://example.com/images/ep1/pci_avatar-massive.jpg 1500w,
https://example.com/images/ep1/pci_avatar-middle.jpg 600w,
https://example.com/images/ep1/pci_avatar-small.jpg 300w,
https://example.com/images/ep1/pci_avatar-tiny.jpg 150w"
/>
```
<br>
## Other Proposals

Wyświetl plik

@ -710,7 +710,6 @@ The node value is a string denoting one of the following possible values:
- `newsletter` - Describes a feed of curated written articles. Newsletter articles now sometimes have an spoken version audio enclosure attached.
- `blog` - Describes a feed of informally written articles. Similar to `newsletter` but more informal as in a traditional blog platform style.
### Examples
Example use for a "podcast":
```xml
@ -720,4 +719,34 @@ Example use for a "podcast":
Example use for "music":
```xml
<podcast:medium>music</podcast:medium>
```
<br><br><br><br><!-- Tag block -->
## Images
`<podcast:images>`<br><br>
This tag, when present, allows for specifying many different image sizes in a compact way at either the episode or channel level. The syntax is borrowed from
the HTML5 [srcset](https://html.spec.whatwg.org/multipage/images.html#srcset-attributes) syntax. It allows for describing multiple image sources with width and
pixel hints directly in the attribute.
### Parent
&nbsp; `<channel>` or `<item>`
### Count
&nbsp; Single
### Attributes
- **srcset** (required) A string that denotes each image url followed by a space and the pixel width, with each one separated by a comma. See the example
for a clear view of the syntax.
### Examples
Example of specifying four different image sizes:
```xml
<podcast:images
srcset="https://example.com/images/ep1/pci_avatar-massive.jpg 1500w,
https://example.com/images/ep1/pci_avatar-middle.jpg 600w,
https://example.com/images/ep1/pci_avatar-small.jpg 300w,
https://example.com/images/ep1/pci_avatar-tiny.jpg 150w"
/>
```