pelican-embed-microblog 1.1.0

A Pelican plugin that wrapps references to twitter et al. Forked from pelican-advance-embed-tweet

Embedding tweets into your Pelican blog posts. This repo is an advance version of the plugin from lqez which hasn’t the config for the style.

Author | Chris Rose
Homepage		https://offby1.website
Github		https://github.com/offbyone
Mastodon		https://wandering.shop/@offby1

How to enable it

1. Install the plugin with pip install pelican-embed-microblog

2. Put pelican_embed_microblog into plugin list of settings.

   • PLUGINS = ['pelican_embed_microblog']

3. Add your config into the pelicanconf.py

Config

The config implement the Twitter Api.

Config Label	Description
TWITTER_CARDS	When set to hidden, links in a Tweet are not expanded to photo, video, or link previews.
TWITTER_THEME	When set to none, only the cited Tweet will be displayed even if it is in reply to another Tweet.
TWITTER_CONVERS ATION	When set to dark, displays Tweet with light text over a dark background.
TWITTER_LINK_C OLOR	Adjust the color of Tweet links with a hexadecimal color value.
TWITTER_WIDTH	The maximum width of the rendered Tweet in whole pixels. This value should be between 250 and 550 pixels.
TWITTER_ALIGN	Float the Tweet left, right, or center relative to its container. Typically set to allow text or other content to wrap around the Tweet.
TWITTER_LANG	A supported Twitter language code. Loads text components in the specified language. Note: does not affect the text of the cited Tweet.
TWITTER_DNT	When set to true, the Tweet and its embedded page on your site are not used for purposes that include personalized suggestions and personalized ads.

Usage

When writing a post, you can use any of the following notations to link to microblogging content:

Usernames

Both Mastodon and Twitter usernames are supported. Any instance of “@[e-mail]” will be replaced with a link to the appropriate instances’ user account page, and any instance of “@username” will be replaced with a link to the twitter account page for the user.

Twitter statuses

To link a Twitter status, you write “@username/status/<numeric-tweet-id>”; essentially, you take the Twitter link itself and you replace “https://twitter.com/” with “@”

Acknowledgments

Thanks to lqez for the original, and to fundor333 who forked the original embed tweet plugin, on which this is based.