bcb5b2df09
* Sentence length check * Replace external links with domain name. * Updated documentation. * Updated replacement values. * Updated Regex based on feedback. * Check description for undefined * Updated external url transform regex. * Updated formatting
1.3 KiB
1.3 KiB
title | tags | |
---|---|---|
Description |
|
This plugin generates descriptions that are used as metadata for the HTML head
, the RSS Feed and in folder and tag listings if there is no main body content, the description is used as the text between the title and the listing.
If the frontmatter contains a description
property, it is used (see authoring content#Syntax). Otherwise, the plugin will do its best to use the first few sentences of the content to reach the target description length.
Note
For information on how to add, remove or configure plugins, see the Configuration#Plugins page.
This plugin accepts the following configuration options:
descriptionLength
: the maximum length of the generated description. Default is 150 characters. The cut off happens after the first sentence that ends after the given length.replaceExternalLinks
: Iftrue
(default), replace external links with their domain and path in the description (e.g.https://domain.tld/some_page/another_page?query=hello&target=world
is replaced withdomain.tld/some_page/another_page
).
API
- Category: Transformer
- Function name:
Plugin.Description()
. - Source:
quartz/plugins/transformers/description.ts
.