1
0
mirror of https://github.com/danog/gojekyll.git synced 2024-12-02 18:47:56 +01:00
gojekyll/docs/plugins.md

33 lines
3.4 KiB
Markdown
Raw Normal View History

2017-07-11 23:44:17 +02:00
# Gojekyll Plugin Status
2017-07-11 23:54:25 +02:00
Gojekyll doesn't include¹ an extensible plugin system, and won't for the foreseeable future.
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-07-12 01:36:47 +02:00
| Plugin | Motivation | Basic Functionality | Missing Features |
|------------------------------|---------------|---------------------|-------------------------------------------------------------------------|
| jekyll-avatar | GitHub Pages² | ✓ | randomized hostname |
| jekyll-coffeescript | GitHub Pages | | |
| jekyll-default-layout | GitHub Pages | | |
| jekyll-feed | GitHub Pages | ✓ | |
| jekyll-gist | core³ | ✓ | `noscript` |
| jekyll-github-metadata | GitHub Pages | | |
| jekyll-live-reload | core | ✓ (always enabled) | |
| jekyll-mentions | GitHub Pages | ✓ | |
| jekyll-optional-front-matter | GitHub Pages | | |
| jekyll-paginate | core | | |
| jekyll-readme-index | GitHub Pages | | |
| jekyll-redirect_from | GitHub Pages | ✓ | user template |
| jekyll-relative-links | GitHub Pages | | |
| jekyll-sass-converter | core | ✓ (always enabled) | |
| jekyll-seo_tag | GitHub Pages | ✓ | SEO and JSON LD are not fully populated; site? and other tag parameters |
| jekyll-sitemap | GitHub Pages | | |
| jemoji | GitHub Pages | ✓ | image tag fallback |
2017-07-11 23:44:17 +02:00
2017-07-11 23:54:25 +02:00
¹ (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-07-12 01:36:47 +02:00
The Jekyll documentation [Official Plugins](https://jekyllrb.com/docs/plugins/#available-plugins) / #Official tag of [Awesome Jekyll Plugins](https://github.com/planetjekyll/awesome-jekyll-plugins) look dated; I didn't use those.