Skip to content

Latest commit

 

History

History
60 lines (46 loc) · 1.66 KB

README.md

File metadata and controls

60 lines (46 loc) · 1.66 KB

gitbook-plugin-versions

Display a <select> with other versions of your gitbook.

Usage with gitbook.com

When your book is hosted on GitBook.com, the plugin can access a listing of versions using the GitBook API.

Put this in your book.json:

{
    "plugins": [ "versions" ],
    "pluginsConfig": {
        "versions": {
            "type": "branches"
        }
    }
}

Type can have different values:

  • Branches (branches)
  • Tags (tags)
  • Languages (languages)

Usage with a manual configuration

Put this in your book.json:

{
    "plugins": [ "versions" ],
    "pluginsConfig": {
        "versions": {
            "gitbookConfigURL": "https://raw.githubusercontent.com/rackt/history/gh-pages/book.json",
            "options": [
                {
                    "value": "https://rackt.github.io/history/v1.3.0/",
                    "text": "Version 1.3.0"
                },
                {
                    "value": "https://rackt.github.io/history/v1.4.0/",
                    "text": "Version 1.4.0",
                    "selected": true
                }
            ]
        }
    }
}

A <select> element will be created with the given options and placed at the top of the book summary. When the user selects one of the options, they are taken to that URL.

The gitbookConfigURL variable is a publicly accessible URL to your book.json. If this is present, the plugin will fetch the latest config when the page loads, so even older versions of your book will have updated options.

Credits

Original work by @mjackson.