Skip to content

tolking/vuepress-plugin-reading-progress

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

vuepress-plugin-reading-progress

a reading progress bar plugin for vuepress

README | CHANGELOG

add reading progress bar for vuepress

vuepress-plugin-reading-progress


Installation

yarn add vuepress-plugin-reading-progress
# or
npm i vuepress-plugin-reading-progress

Usage

module.exports = {
  plugins: [
    'reading-progress'
  ]
}

Vuepress documentation

Options

readingDir

  • Type: null, string, array, object, RegExp
  • Required: false

Specify regularPath that display reading progress bar

example

{
  readingDir: 'posts'
  // or
  readingDir: ['posts1', 'posts2', 'posts3']
  // or { dir: fixed }
  readingDir: {
    posts1: 'top',
    posts2: 'bottom',
    posts3: 'left'
  }
  // or RegExp
  readingDir: /[^/]+$/ // exclude regularPath end with `/`
  // or
  readingDir: new RegExp('[^/]+$')
}

fixed

  • Type: string
  • Default: top
  • Required: false

support top, bottom, left, right

set position for reading progress bar

Front matter

Change the reading progress bar display of the current page by use readingShow

  • Type: string, boolean
  • Required: false
  • one of top, bottom, left, right, true, false
---
readingShow: false
---

Style

If you wish to apply simple color overrides to the styling

+- .vuepress
  +- styles
    +- palette.styl
$readingBgColor = transparent
$readingZIndex = 1000
$readingSize = 3px
$readingProgressColor = $accentColor
$readingProgressImage = none

example

$readingProgressImage = linear-gradient(-120deg, #E50743 0%, #F9870F 15%, #E8ED30 30%, #3FA62E 45%, #3BB4D7 60%, #2F4D9E 75%, #71378A 80%)

License

MIT