Ko-fi button is a simple plugin that let's you add a Ko-fi button with markdown.
Project description
MkDocs Ko-fi Button Plugin
An MkDocs plugin that let's you easily add a Ko-fi buttons with markdown
The plugin looks for Jinja style tags like {{ko-fi}}
and replaces it with a Ko-fi button. It is possible to configure the text and color of the button.
Setup
Install the plugin using pip:
pip install mkdocs-ko-fi-button-plugin
Activate the plugin in mkdocs.yml
:
plugins:
- search
- ko-fi-button
Config
Mandatory
id
- Your Ko-fi ID. Can be found on your Ko-fi profile.
Optional
type
- The type of button. Valid values are "widget" or "image". Default: widgetcolor
- The color of the button.- If
type == 'widget'
: In hex format. Default: #29abe0 - If
type == 'image'
: Either "blue", "bluegray", "red", "green" or "black". Default: bluegray
- If
text
- The text on the Ko-fi button.- If
type == 'widget'
: Default: "Support Me on Ko-fi" - If
type == 'image'
: Whatever text they have in the image.
- If
For example:
plugins:
- search
- ko-fi-button:
id: "my_id"
text: "My cool text"
color: "#547884"
Note: Some MkDocs theme CSS conflicts with the widget styling. If that is the case and you cannot or will not update the CSS, the type
config is useful. Set that to "image" and it should render properly. There will be no wiggly coffe mug though.
Advanced config
In case the Ko-fi javascript is changed on the server side it is possible to configure the path and function calls. This will make it possible to still be able to get a working Ko-fi button widget until this plugin has been updated.
javascript_path
- The relative path to the javascript from https://ko-fi.com/. Default: "widgets/widget_2.js"javascript_f1
- The init function. Default: "kofiwidget2.init"javascript_f2
- The draw function. Default: "kofiwidget2.draw"
Note: These config options are only valid if type
is set to "widget". They are ignored otherwise.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for mkdocs-ko-fi-button-plugin-0.0.3.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | e0fe0fbda4b7d546cd2af1f6590bd17ad688c2feb8e00a300a3a9c6ae194baa9 |
|
MD5 | 6204e9f090ef44da51964ba7be6a6df1 |
|
BLAKE2b-256 | 656dc5109d943344309b23f7f6ba70b4c481c5cf49d163d0765ea67f78c677f4 |
Hashes for mkdocs_ko_fi_button_plugin-0.0.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2641fe61aa0b36abc56ef1cbee9dc05ef197a6d77cd009ea62bebcccacc42a31 |
|
MD5 | d8d3724d57b5b5ac85423c17cbb4967b |
|
BLAKE2b-256 | 86d2b3dc446bb28ceeba302028eb60bfe3c17aa903665a63c25217365440fd2f |