RetroSearch Browse

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://github.com/MadLittleMods/markdown-icons below:

MadLittleMods/markdown-icons: Easily display icon fonts in markdown.

markdown-icons (iconfonts.py)

Easily display icon fonts in python markdown. Just add the CSS necessary for your font and add this extension.

This is a 3rd party extension for Python Markdown. You can see a full list of 3rd party extensions here.

Although this works with any icon font, users can use a mod syntax to add more prefixed classes to support Font Awesome and its special classes such as 2x, 3x, muted, spin, etc

Furthermore, users can add their own user_mod syntax to add additional, non-prefixed, pre-defined classes for greater control over their icons while allowing you to control exactly what styles are allowed.

You can create your own Icon Fonts using the IcoMoon app: http://icomoon.io/app/
A great pre-made Icon Font is Font Awesome (GitHub Project)

See the python markdown documentation for more information.

Use it in any personal or commercial project you want.

Accepts a-z, A-Z, 0-9, _(underscore), and - (hypen)
Uses HTML Entity like syntax: &entity_name;

&icon-html5;
&icon-css3;
&icon-my-icon;

Mod syntax:

&icon-html5:2x;
&icon-quote:3x,muted;
&icon-spinner:large,spin;

User mod syntax:

&icon-html5::red;
&icon-quote:2x:bold;

I love &icon-html5; and &icon-css3;
&icon-spinner:large,spin; Sorry we have to load...

I love <i aria-hidden="true" class="icon-html5"></i> and <i aria-hidden="true" class="icon-css3"></i>
<i aria-hidden="true" class="icon-spinner icon-large icon-spin"></i> Sorry we have to load...

Just drop it in the extensions folder of the markdown package: markdown/extensions

Default Prefix is "icon-":

{{ textmd|markdown:"safe,iconfonts" }}

md = markdown.Markdown(extensions=['iconfonts'])
converted_text = md.convert(text)

{{ textmd|markdown:"safe,iconfonts(prefix=mypref-)" }}

md = markdown.Markdown(extensions=['iconfonts(prefix=mypref-)'])
converted_text = md.convert(text)

No prefix (just in case you couldn't figure it out :P):

This isn't suggested, as it will take over the already built in HTML Entities

md = markdown.Markdown(extensions=['iconfonts(prefix=)'])
converted_text = md.convert(text)

The base option allows for use of Bootstrap 3 and FontAwesome 4 icons

md = markdown.Markdown(extensions=['iconfonts(base=icon)'])
converted_text = md.convert(text)

Input: &icon-html5;

Output: 

Combine options with a comma:

md = markdown.Markdown(extensions=['iconfonts(prefix=fa-, base=fa)'])

The prefix_base_pairs option allows for multiple prefix-base pairs to be specified, to allow you to support both Bootstrap 3/Glyphicon and FontAwesome icons

md = markdown.Markdown(extensions=['iconfonts'],
                       extension_configs={
                           'iconfonts': {
                               'prefix_base_pairs': {
                                   'fa-': 'fa',
                                   'glyphicon-': 'glyphicon',
                               }
                           }
                       })
converted_text = md.convert(text)

Input: &glyphicon-remove; &fa-html5;

Output: 

How to run the unit tests

Install Markdown: pip install markdown
Install markdown icons. Copy the iconfonts.py file into site-packages/markdown/extensions/
Navigate to the test directory in CMD/terminal and run python unit-tests.py -v

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4