hexo-shortcodes

Hexo shortcodes helper. Various shortcodes for hexo, adapted from jekyll. Various hexo shortcode tags.

GitHub | Demo and docs

Installation

• Firsly, remove old original tag renderer. Because this plugin already have all default tag (vimeo, youtube, gist, codeblock)

npm un hexo-tag-embed

• Install hexo-shortcodes

production

npm i hexo-shortcodes

latest changes, replace COMMIT_HASH with latest commit hash. see pre-release commit history

npm i hexo-shortcodes@https://github.com/dimaslanjaka/hexo-shortcodes/raw/COMMIT_HASH/pre-release/release/hexo-shortcodes.tgz
# or
yarn add hexo-shortcodes@https://github.com/dimaslanjaka/hexo-shortcodes/raw/COMMIT_HASH/pre-release/release/hexo-shortcodes.tgz

shortcodes list

shortcode	description
hexo codepen shortcode	embed codepen
hexo gist shortcode	embed gist
hexo jsfiddle shortcode	embed jsfiddle
hexo githubCard shortcode	embed github card
hexo rssreader shortcode	embed rss feed
hexo github shortcode	embed any source files from github.com
hexo npmrunkit shortcode	embed any javascript codes to website
hexo include_file shortcode	include any files relative to hexo.config.source_dir, hexo.config.code_dir, or reference file it self
videos	default hexo embedding videos

Config

define renderer returns by setting _config.yml

hexo-shortcodes:
  # true = return raw markdown format instead html
  raw: false

Language Test

• php

Changelog

read more at https://github.com/dimaslanjaka/hexo-shortcodes/commits/pre-release (chore,feat,fix sections)

1.2.4

• feat: update hexo-tag-embed from fork

1.2.3

• fix: hexo@6 context.extend.highlight undefined TypeError: Cannot read properties of undefined (reading 'query')

1.2.2

• include_file: fix typeof hexo undefined

1.2.1

• include_file: add include file shortcode tag
• gist: fix failed embed spesific lines

1.2.0

• gist: change parameters and usages
• gist: validate id is URL or not

1.1.3

• rssreader: hotfix get thumbnail from rss item
• rssreader: fix: validate item['media:group'] is Array

1.1.2

• gist: fix undefined username

1.1.1

• fix: invalid git-embed location

Documentations

• FULL DEMO, FEATURES, CHANGELOG, and USAGES

License

MIT