❤
npm
Sign UpSign In

hexo-filter-highlight

1.0.0 • Public • Published

hexo-filter-highlight

Build Status node npm downloads npm version GitHub release

Introduction

screenshot

Highlight plugin using highlight.js for Hexo. This plugin not highlight when generating, you must highlight your code in front-end.

Optionally, if you using Backtick Code Block style to insert code block, close the default highlight of hexo, your page will display unnormally, you can use this plugin to instead.

You can visit my blog to see the highlight result.

Feautre

  • Using highlight.js freely
  • Trim indent of code block
  • Code line numbering support
  • Code block copy support

Install

$ npm install hexo-filter-highlight --save

Then set enable: false to turn off the hexo highlight in _config.yml under blog.

Config

backend

config _config.yml under your blog

# hexo-filter-plugin (https://github.com/Jamling/hexo-filter-highlight) config  
## highlight in frontend, the plugin (backend) just do some prepare work. 
## you need to read the docs on https://github.com/Jamling/hexo-filter-highlight to getting start 
hljs:
  enable: true #true to enable the plugin 
  line_number: frontend # add line_number in frontend or backend (not recommend, have bugs in special hexo version) 
  trim_indent: backend # trim the indent of code block to prettify output. backend or front-end (recommend) 
  copy_code: true # show copy code in caption. 
  label:
    left: Code
    right: ':'
    copy: Copy Code

frontend

Import highlight js and style css in your <head></head>

<link rel="stylesheet" href="//cdn.bootcss.com/highlight.js/9.6.0/styles/github.min.css">
<script src="//cdn.bootcss.com/highlight.js/9.6.0/highlight.min.js"></script>

Then add highlight script after document loaded, such as under document.onready().

  • Simply
$(document).ready(function(){
    hljs.initHighlightingOnLoad();
});
  • Normally, insert following script after the document loaded
  var trim_indent = true;
  var line_number = true;
  // enable highlight
  $('pre code').each(function(i, block) {
    var texts = $(this).text().split('\n');
     // trim indent
     if (trim_indent){
      var tab = texts[0].match(/^\s{0,}/);
      if (tab) {
        var arr = [];
        texts.forEach(function(temp) {
          arr.push(temp.replace(tab, ''));
        });
        $(this).text(arr.join('\n'));
      }
    }
    // add line number
    if (line_number) {
      console.log("show line number in front-end");
      var lines = texts.length - 1;
      var $numbering = $('<ul/>').addClass('pre-numbering');
      $(this).addClass('has-numbering').parent().append($numbering);
      for (i = 1; i <= lines; i++) {
        $numbering.append($('<li/>').text(i));
      }
    }
    // hightlight
    hljs.highlightBlock(block);
  • Advancely

See hljs.js under Nova theme.

Last add your css to control the code block and line number. See nova.scss under Nova theme.

Refer

See My Blog for more information.

License

MIT

Versions

Current Tags

  • Version
    Downloads (Last 7 Days)
    • Tag
  • 1.0.0
    8
    • latest

Version History

  • Version
    Downloads (Last 7 Days)
    • Published
  • 1.0.0
    8
  • 0.0.3
    2
  • 0.0.2
    0
  • 0.0.1
    0

Package Sidebar

Install

npm i hexo-filter-highlight

Repository

github.com/Jamling/hexo-filter-highlight

Homepage

github.com/Jamling/hexo-filter-highlight#readme

Weekly Downloads

10

Version

1.0.0

License

MIT

Unpacked Size

48 kB

Total Files

7

Last publish

Collaborators

  • jamling
Try on RunKit
Report malware