noerw / gitbook-plugin-localized-footer

add a footer to each page of a gitbook, allows l10n

gitbook-plugin-localized-footer

This gitbook plugin allows adding a custom footer to each page on the website output. Requires gitbook >=2.6.7 (should also run on 2.5.x, not tested).

The footer content is read from a markdown file in each (language) books' content directory (by default FOOTER.md), so translated content for multi-language is possible.

Custom styles may be applied on the css selector .localized-footer.

I wrote these ~40 lines, as other footer-plugins were removed or insufficient for my needs. Hoping footers will become functionality of the gitbook core.

usage

1. add the plugin to your book.json, and optionally configure it. default values as example:

   {
     "gitbook": "3.2.2",
     "plugins": ["localized-footer"],
     "localized-footer": {
       "hline": true,            // whether to include an horizontal line above the footer
       "filename": "./FOOTER.md" // may also be a relative path to the book root
     }
   }

2. run gitbook install

3. fill the footer file(s)

   *content published under [CC-BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/)*

license

LGPL-3.0