---json
{
    "canonical": ":page:article",
    "name": "Article (Blog, News)",
    "page_id": "8nnpqqrm4j82ccja2tg72"
}
---
====== ComboStrap Metadata - Article Page (News, Blog) ======


===== About =====
''article'' is a [[docs:type:type|type]] of page that defines a page where most of the content is textual and is meant to be read. 

This type of page understands also the subtype:
  * ''news''
  * ''blog''

Example: 
  * wiki article, 
  * news article,
  * blog,
  * piece of investigative report

<note>
If you don't defined a [[docs:page:published|published date]], the creation date is taken.
</note>



===== Usage =====

==== Google Rich Result ====

Setting a page to ''article'' enables:
  * the [[https://developers.google.com/search/docs/data-types/article|article card (advanced SEO)]].
  * and the [[https://developers.google.com/search/docs/data-types/speakable|Speakable feature]] for the [[docs:page:title|title]] and the [[docs:page:description|description]] if set


<box elevation="high" align="center" width="fit-content">
    {{docs:semantic:google_article_card.png?400|}}
</box>

\\

[[docs:social:google|Google]] understands the following ''article'' [[docs:type:type|type]] that we matches to the following [[docs:type:type|type values]]

^ Value ^ Google (Schema.org) ^
| ''article'' | [[https://schema.org/Article|Article]] |
| ''news'' | [[https://schema.org/NewsArticle|NewsArticle]] |
| ''blog'' | [[https://schema.org/BlogPosting|BlogPosting]] |

==== Facebook ====
[[docs:social:facebook|Facebook]] uses the ''article'' type to create cards and follows the [[https://ogp.me/#type_article|article ogp type]].

<box elevation="high" align="center" width="fit-content">
    {{docs:semantic:facebook_card.png?400|}}
</box>


===== Properties  =====
==== Automatically ====


When a page gets the ''article'' [[docs:type:type|type]], the below properties are automatically added.


^ [[docs:social:google|Google (ld-json)]] ^ [[docs:social:facebook|Facebook (ogp)]] ^ Description ^ 
| ''datePublished'' | ''published_time'' | When the article was first published - The [[docs:page:published|published date]] or the creation date if not available | 
| ''dateModified'' | ''modified_time'' | When the article was last changed. | 
| ''author'' | ''author'' | Writers of the article | 
| ''headline'' | ''title'' | The headline of the article (ie the first 110 characters of the [[docs:page:title|title]]) |
| Na | ''description'' | The [[docs:page:description|description]] of the article  |
| ''publisher.name'' | Na | The name of the publisher (the [[doku>config:title|dokuwiki wiki title configuration]]) |
| ''publisher.logo.url'' | Na | The URL of the [[docs:app:logo|logo]] |
| ''image'' | ''image'' | Image that belongs to the article (The [[#image|page image]]) |


==== Manually ====
With the [[docs:social:google#manual|manual json-ld property]], you can also add extra ''json-ld'' properties.

For instance, if you want to add a [[https://schema.org/Article|keywords property]]
<code json>
{
    "type":"article",
    "json-ld": {
        "keywords":"article, json-ld, semantic"
    }
}
</code>


===== Image =====
By default, ''ComboStap'' will set the [[release:deprecated:images-meta|page image]].

Google recommends to provide multiple images with 
  * a high-resolution (minimum of 300,000 pixels when multiplying width and height) 
  * the following aspect ratios: 16x9, 4x3, and 1x1.

You can create them and set them with the [[release:deprecated:images-meta|image]] property even if the [[https://schema.org/image|standard does not allow it]].

<code json>
{
    "type":"article",
    "image": [
            ":photos:1x1:photo.jpg",
            ":photos:4x3:photo.jpg",
            ":photos:16x9:photo.jpg"
    ]
}
</code>