Skip to main content

Badges for Foliant.

Project description

Badges

Preprocessor for Foliant which helps to add badges to your documents. It uses Shields.io to generate badges.

Installation

$ pip install foliantcontrib.badges

Config

To enable the preprocessor, add badges to preprocessors section in the project config:

preprocessors:
    - badges

The preprocessor has a number of options:

preprocessors:
    - badges:
        server: 'https://img.shields.io'
        as_object: true
        add_link: true
        vars:
            jira_path: localhost:3000/jira
            package: foliant
        # badge look parameters
        style: flat-square
        logo: jira

server : Shields server URL, which hosts badges. default: https://img.shields.io

as_object : If true — preprocessor inserts svg badges with HTML <object> tag, instead of Markdown image tag. This is required for links and hints to work. default: true

add_link : If true preprocessor tries to determine the link which should be added to badge (for example, link to jira issue page for jira issue badge). Only works with as_object = true. default: true

Please note that right now only links for pypi and jira-issue badges are being added automatically. Please contribute or contact author for adding other services.

vars : Dictionary with variables which will be replaced in badge urls. See variables section.

Also you may add parameters specified on the shields.io website which alter the badge view like: label, logo, style etc.

Usage

Just add the badge tag and specify path to badge in the tag body:

<badge>jira/issue/https/issues.apache.org/jira/kafka-2896.svg</badge>

All options from config may be overriden in tag parameters:

<badge style="social" as_object="false">jira/issue/https/issues.apache.org/jira/kafka-2896.svg</badge>

Variables

You can use variables in your badges to replace parts which repeat often. For example, if we need to add many badges to our Jira tracker, we may put the protocol and host parameters into a variable like this:

preprocessors:
    - badges:
        vars:
            jira: https/issues.apache.org/jira

To reference a variable in a badge path use syntax ${variable}:

<badge>jira/issue/${jira}/kafka-2896.svg</badge>

Description of the issue goes here. But it's not the only one.

<badge>jira/issue/${jira}/KAFKA-7951.svg</badge>

Description of the second issue.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for foliantcontrib.badges, version 1.0.2
Filename, size File type Python version Upload date Hashes
Filename, size foliantcontrib.badges-1.0.2-py3-none-any.whl (5.2 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size foliantcontrib.badges-1.0.2.tar.gz (4.3 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page