Skip to main content

A Python markdown extension for wrapping keyboard shortcuts in a special tag

Project description

TORO KBD Markdown Extension

The toro-mkdocs-kbd wraps your keyboard shortcut into a KBD tag. The tag will contain three attributes; linux, macos, and windows. The values in the attributes will be the keyboard shortcut based on the OS.

Installation

pip install toro-mkdocs-kbd

Usage

The markdown syntax will be the keyboard shortcut between two questions marks. A plus sign will be used to separate the keys. MOD will be used as a generic symbol for both the ctrl and command key.

??MOD+A??

The produced HTML of the markdown syntax will be:

<p><kbd linux="Ctrl + A" macos="⌘A" winodws="Ctrl + A"></kbd></p>

Conversion

Markdown Windows/Linux macOS
??mod?? Ctrl
??alt?? Alt
??enter?? Enter
??shift?? Shift
??ctrl?? Ctrl
??left?? Left
??right?? Right
??up?? Up
??down?? Down
??tab?? Tab
??esc?? Esc
??space?? Space Space

Project details


Download files

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

Source Distribution

toro-mkdocs-kbd-1.0.0.tar.gz (2.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

toro_mkdocs_kbd-1.0.0-py3-none-any.whl (2.9 kB view details)

Uploaded Python 3

File details

Details for the file toro-mkdocs-kbd-1.0.0.tar.gz.

File metadata

  • Download URL: toro-mkdocs-kbd-1.0.0.tar.gz
  • Upload date:
  • Size: 2.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/1.1.6 requests-toolbelt/0.8.0 tqdm/4.23.4 CPython/2.7.10

File hashes

Hashes for toro-mkdocs-kbd-1.0.0.tar.gz
Algorithm Hash digest
SHA256 00e023c18fe7de32b8084cebb466c4c758d87ac984cddaecaa731674a093c951
MD5 ccc0007a408cd92bec4ad95905becf1e
BLAKE2b-256 f8c94341c26962009b69e6e3d0dbb8b5076a4a2ce3aafb5bfe528d6ace76f03d

See more details on using hashes here.

File details

Details for the file toro_mkdocs_kbd-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: toro_mkdocs_kbd-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 2.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/1.1.6 requests-toolbelt/0.8.0 tqdm/4.23.4 CPython/2.7.10

File hashes

Hashes for toro_mkdocs_kbd-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 a2b712211885edf1e8b0173d431c3ffbfc28e21d91b150f7eb54e2e249606b93
MD5 decf47264f7b38d9ddb0092629c383fe
BLAKE2b-256 88d1e4eef2c11a96c23ed6114cfda5f396d54fa25475c11368ecb5906fc22332

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page