2017-07-11 23:44:17 +02:00
# Gojekyll Plugin Status
2017-08-11 19:49:00 +02:00
Gojekyll doesn't include an extensible plugin system¹.
2017-07-11 23:44:17 +02:00
2017-07-11 23:54:25 +02:00
The functionality of some plugins is built into the core program:
2017-07-11 23:44:17 +02:00
2017-08-11 19:49:00 +02:00
| Plugin | Motivation | Implementation Status | Missing Features |
|--------------------------------------------------------------|---------------|-----------------------|--------------------------------------------------------------------------------------------------------------------------------------------|
| [jekyll-avatar][jekyll-avatar] | GitHub Pages² | ✓ | |
| [jekyll-coffeescript][jekyll-coffeescript] | GitHub Pages | | |
| [jekyll-default-layout][jekyll-default-layout] | GitHub Pages | ✓ | |
| [jekyll-feed][jekyll-feed] | GitHub Pages | ✓ | |
| [jekyll-gist][jekyll-gist] | core³ | ✓ | `noscript` option |
| [jekyll-github-metadata][jekyll-github-metadata] | GitHub Pages | partial | `build_revision` , `contributors` , `public_repositories` , `show_downloads` , `releases` , `versions` , `url` , `tar_url` , `zip_url` , `wiki_url` |
| [jekyll-live-reload][jekyll-live-reload] | core | ✓ | always enabled (by design); no way to disable |
| [jekyll-mentions][jekyll-mentions] | GitHub Pages | ✓ | |
| [jekyll-optional-front-matter][jekyll-optional-front-matter] | GitHub Pages | | |
| [jekyll-paginate][jekyll-paginate] | core | | |
| [jekyll-readme-index][jekyll-readme-index] | GitHub Pages | | |
| [jekyll-redirect_from][jekyll-redirect_from] | GitHub Pages | ✓ | user template |
| [jekyll-relative-links][jekyll-relative-links] | GitHub Pages | | |
| [jekyll-sass-converter][jekyll-sass-converter] | core | ✓ | always enabled (by design); no way to disable |
| [jekyll-seo_tag][jekyll-seo_tag] | GitHub Pages | partial | `dateModified` , `datePublished` , `publisher` , `mainEntityOfPage` , `@type` |
| [jekyll-sitemap][jekyll-sitemap] | GitHub Pages | ✓ | file modified dates⁴ |
| [jekyll-titles-from-headings][jekyll-titles-from-headings] | GitHub Pages | | |
| [jemoji][jemoji] | GitHub Pages | ✓ | image tag fallback |
¹ (1) The code and internal APIs are too immature for this; and (2) the [natural way ](https://golang.org/pkg/plugin/ ) of implementing this only works on Linux.
2017-07-11 23:44:17 +02:00
2017-07-11 23:54:25 +02:00
² < https: / / pages . github . com / versions / >
³ “Core” plugins are referenced in the main [Jekyll documentation ](https://jekyllrb.com/docs/home/ ).
2017-08-11 19:49:00 +02:00
The [Official Plugins ](https://jekyllrb.com/docs/plugins/#available-plugins ) section of the Jekyll documentation, and the #Official tag of [Awesome Jekyll Plugins ](https://github.com/planetjekyll/awesome-jekyll-plugins ), look dated; I didn't use those.
2017-07-12 15:52:40 +02:00
⁴ These don't seem that useful with source control and CI. (Post dates are included.)
2017-08-10 18:27:07 +02:00
[jekyll-avatar]: https://github.com/benbalter/jekyll-avatar
[jekyll-coffeescript]: https://github.com/jekyll/jekyll-coffeescript
[jekyll-default-layout]: https://github.com/benbalter/jekyll-default-layout
[jekyll-feed]: https://github.com/jekyll/jekyll-feed
[jekyll-gist]: https://github.com/jekyll/jekyll-gist
[jekyll-github-metadata]: https://github.com/parkr/github-metadata
[jekyll-live-reload]: https://github.com/RobertDeRose/jekyll-livereload
[jekyll-mentions]: https://github.com/jekyll/jekyll-mentions
[jekyll-optional-front-matter]: https://github.com/benbalter/jekyll-optional-front-matter
[jekyll-paginate]: https://github.com/jekyll/jekyll-paginate
[jekyll-readme-index]: https://github.com/benbalter/jekyll-readme-index
[jekyll-redirect_from]: https://github.com/jekyll/jekyll-redirect-from
[jekyll-relative-links]: https://github.com/benbalter/jekyll-relative-links
[jekyll-sass-converter]: https://github.com/jekyll/jekyll-sass-converter
[jekyll-seo_tag]: https://github.com/jekyll/jekyll-seo-tag
[jekyll-sitemap]: https://github.com/jekyll/jekyll-sitemap
2017-08-11 19:49:00 +02:00
[jekyll-titles-from-headings]: https://github.com/benbalter/jekyll-titles-from-headings
2017-08-10 18:27:07 +02:00
[jemoji]: https://github.com/jekyll/jemoji