mkdocs-link-embeds-plugin 0.1.7

Mkdocs plugin which shows embedded links in a more elegant manner.

Link Embeds Plugin: mkdocs

---

About

Requires mkdocs to function.

This plugin allows you to display embedded links in a more elegant and modern way with the use of markdown codeblocks. You may either specify a URL and let the plugin auto-fill in details such as the site description and title, or you can override the auto-generated values and add your own.

---

Documentation

If you wish to view the complete docuemtnation for this plugin, including installation and usage; visit https://aetherinox.github.io/mkdocs-link-embeds/

---

Install

Install the package for this plugin by running the command:

pip install mkdocs-link-embeds-plugin

Once you install the package above, open your mkdocs.yml and add a few new lines:

plugins:
  - link-embeds:
      enabled: true
      name_default: "Untitled Link"
      desc_default: "No description found"
      image_default: "https://github.com/Aetherinox/mkdocs-link-embeds/assets/118329232/c0298d98-0910-4235-a88f-0c3e2f704ba7"
      image_disabled: false
      favicon_default: "https://github.com/Aetherinox/mkdocs-link-embeds/assets/118329232/b37da9c6-6f17-4c3f-9c94-c346a6f31bfa"
      favicon_disabled: false
      favicon_size: 25
      target: "blank"

extra_css:
  - path/to/link-embeds.css

Ensure you download the contents of mkdocs_link_embeds_plugin/resources/link-embeds.css and place the file in your mkdocs directory. It must be placed in the path you specified under extra_css in the mkdocs.yml config above.

---

Usage

Once you have installed this plugin, you may now create a new page in your mkdocs project and insert a new codeblock with the following syntax:

```embed
url:            https://github.com/mkdocs/mkdocs/releases
image:          https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQjFUDe-vdiprKpCsiLoRmfCdUq0WS5tqUR9fyEzJjQ0g&s
name:           Github: Download Mkdocs
desc:           MkDocs is a fast, simple and downright gorgeous static site generator that's geared towards building project documentation. Documentation source files are written in Markdown, and configured with a single YAML configuration file. It is designed to be easy to use and can be extended with third-party themes, plugins, and Markdown extensions.
favicon:        https://github.com/Aetherinox/mkdocs-link-embeds/assets/118329232/b37da9c6-6f17-4c3f-9c94-c346a6f31bfa
favicon_size:   25
target:         new
```

This plugin accepts numerous values:

• url: The URL to the link.
• name: Name / Title to show at the top of each embed.
• desc: A description of what the site is for.
• image: Image to display on the left side of each embedded website.
• favicon: Favicon to display at the bottom, next to the link.
• favicon_size: Favicon size.
• target: Determines whether link opens in new window or same window.

The only required value is url.

If you provide only the url, and leave the others out; the plugin will attempt to check if your URL is valid, and then auto-fetch the metadata for that website. It will be used to populate the fields you did not provide.

If you do provide values such as desc, name, or image; those user inputs will take priority over the automatically fetched values.

---

Other

This plugin was originally based on mkdocs-link-preview-plugin. However, that plugin stopped being updated, and the style needed to be modernized. As well as giving more control for customization.