layout: page description: Jekyll
API - Extend Jekyll
using Plugins title: Jekyll
API - Plugins tagline: Extend Jekyll
using Plugins group: pages toc: true
:doctype: article :website: jekyllrb.com/ :revnumber: 3.2.1
// URLs :tao-of-programming: www.canonical.org/~kragen/tao-of-programming.html
- .boxShadow
-
¶ ↑
Jekyll
has a plugin system with hooks that allow you to create custom generated content specific to your site. You can run custom code for your site without having to modify theJekyll
source itself.¶ ↑
Jekyll
Plugins¶ ↑Plugins on GitHub Pages
<a href=“GitHub”>pages.github.com/“>GitHub Pages</a> is powered by
Jekyll
, however all Pages sites are generated using the--safe
option to disable custom plugins for security reasons. Unfortunately, this means your plugins won’t work if you’re deploying to GitHub Pages.
You can still use GitHub Pages to publish your site, but you’ll need to convert the site locally and push the generated static files to your GitHub repository instead of theJekyll
source files.
Installing a plugin ~~~~~~~~~~~~~~~~~~~
You have 2 options for installing plugins:
-
In your site source root, make a `_plugins` directory. Place your
plugins here. Any file ending in `*.rb` inside this directory will be loaded before
Jekyll
generates your site.-
In your `_config.yml` file, add a new array with the key `gems` and
the values of the gem names of the plugins you'd like to use. An example: +
gems: [jekyll-test-plugin, jekyll-jsonify, jekyll-assets] # This will require each of these gems automatically.
_plugins
andgems
can be used simultaneously
You may use both of the aforementioned plugin options simultaneously in the same site if you so choose. Use of one does not restrict the use of the other
In general, plugins you make will fall into one of three categories:
-
Generators
-
Converters
-
Tags
Generators ~~~~~~~~~~
You can create a generator when you need
Jekyll
to create additional content based on your own rules.A generator is a subclass of `Jekyll::Generator` that defines a `generate` method, which receives an instance of {{%20site.repository%20}}/blob/master/lib/jekyll/site.rb[`Jekyll::Site`].
Generation is triggered for its side-effects, the return value of `generate` is ignored.
Jekyll
does not assume any particular side-effect to happen, it just runs the method.Generators run after
Jekyll
has made an inventory of the existing content, and before the site is generated. Pages with YAML front-matters are stored as instances of {{%20site.repository%20}}/blob/master/lib/jekyll/page.rb[`Jekyll::Page`] and are available via `site.pages`. Static files become instances of {{%20site.repository%20}}/blob/master/lib/jekyll/static_file.rb[`Jekyll::StaticFile`] and are available via `site.static_files`.// See docs/variables/[theVariables documentation page] and {{%20site.repository%20}}/blob/master/lib/jekyll/site.rb[`Jekyll::Site`] for more details.
For instance, a generator can inject values computed at build time for template variables. In the following example the template `reading.html` has two variables `ongoing` and `done` that we fill in the generator:
{% highlight ruby %} module Reading class Generator < Jekyll::Generator def generate(site) ongoing, done = Book.all.partition(&:ongoing?)
reading = site.pages.detect {|page| page.name == 'reading.html'} reading.data['ongoing'] = ongoing reading.data['done'] = done
end
end end {% endhighlight %}
This is a more complex generator that generates new pages:
{% highlight ruby %} module
Jekyll
class CategoryPage < Page def initialize(site, base, dir, category) @site = site @base = base @dir = dir @name = 'index.html'
self.process(@name) self.read_yaml(File.join(base, '_layouts'), 'category_index.html') self.data['category'] = category category_title_prefix = site.config['category_title_prefix'] || 'Category: ' self.data['title'] = "#{category_title_prefix}#{category}"
end
end
class CategoryPageGenerator < Generator safe true
def generate(site)
if site.layouts.key? 'category_index' dir = site.config['category_dir'] || 'categories' site.categories.keys.each do |category| site.pages << CategoryPage.new(site, site.source, File.join(dir, category), category) end end
end
end
end {% endhighlight %}
In this example, our generator will create a series of files under the `categories` directory for each category, listing the posts in each category using the `category_index.html` layout.
Generators are only required to implement one method:
<tr>
<th>Method</th> <th>Description</th>
</tr>
<tr>
<td> <p><code>generate</code></p> </td> <td> <p>Generates content as a side-effect.</p> </td>
</tr>
- [converters]
-
Converters ~~~~~~~~~~
If you have a new markup language you’d like to use with your site, you can include it by implementing your own converter. Both the Markdown and Textile markup languages are implemented using this method.
Remember your YAML front-matter
Jekyll
will only convert files that have a YAML header at the top, even for converters you add using a plugin.
Below is a converter that will take all posts ending in `.upcase` and process them using the `UpcaseConverter`:
{% highlight ruby %} module
Jekyll
class UpcaseConverter < Converter safe true priority :low
def matches(ext)
ext =~ /^\.upcase$/i
end
def output_ext(ext)
".html"
end
def convert(content)
content.upcase
end
end end {% endhighlight %}
Converters should implement at a minimum 3 methods:
<tr>
<th>Method</th> <th>Description</th>
</tr>
<tr>
<td> <p><code>matches</code></p> </td> <td><p> Does the given extension match this converter’s list of acceptable extensions? Takes one argument: the file’s extension (including the dot). Must return <code>true</code> if it matches, <code>false</code> otherwise. </p></td>
</tr> <tr>
<td> <p><code>output_ext</code></p> </td> <td><p> The extension to be given to the output file (including the dot). Usually this will be <code>".html"</code>. </p></td>
</tr> <tr>
<td> <p><code>convert</code></p> </td> <td><p> Logic to do the content conversion. Takes one argument: the raw content of the file (without YAML front matter). Must return a String. </p></td>
</tr>
In our example, `UpcaseConverter#matches` checks if our filename extension is `.upcase`, and will render using the converter if it is. It will call `UpcaseConverter#convert` to process the content. In our simple converter we’re simply uppercasing the entire content string. Finally, when it saves the page, it will do so with a `.html` extension.
- [tags]
-
Tags ~~~~
If you’d like to include custom liquid tags in your site, you can do so by hooking into the tagging system. Built-in examples added by
Jekyll
include the `highlight` and `include` tags. Below is an example of a custom liquid tag that will output the time the page was rendered:{% highlight ruby %} module
Jekyll
class RenderTimeTag < Liquid::Tag
def initialize(tag_name, text, tokens)
super @text = text
end
def render(context)
"#{@text} #{Time.now}"
end
end end
Liquid::Template.register_tag('render_time', Jekyll::RenderTimeTag) {% endhighlight %}
At a minimum, liquid tags must implement:
<tr>
<th>Method</th> <th>Description</th>
</tr>
<tr>
<td> <p><code>render</code></p> </td> <td> <p>Outputs the content of the tag.</p> </td>
</tr>
You must also register the custom tag with the Liquid template engine as follows:
{% highlight ruby %} Liquid::Template.register_tag('render_time', Jekyll::RenderTimeTag) {% endhighlight %}
In the example above, we can place the following tag anywhere in one of our pages:
{% highlight ruby %} {% raw %} {% render_time page rendered at: %} {% endraw %} {% endhighlight %}
And we would get something like this on the page:
{% highlight html %} page rendered at: Tue June 22 23:38:47 –0500 2010 {% endhighlight %}
- [liquid-filters]
-
Liquid filters ^^^^^^^^^^^^^^
You can add your own filters to the Liquid template system much like you can add tags above. Filters are simply modules that export their methods to liquid. All methods will have to take at least one parameter which represents the input of the filter. The return value will be the output of the filter.
{% highlight ruby %} module
Jekyll
module AssetFilter def asset_url(input) “www.example.com/#{input}?#{Time.now.to_i}” end end endLiquid::Template.register_filter(Jekyll::AssetFilter) {% endhighlight %}
ProTip™: Access the site object using Liquid
Jekyll
lets you access thesite
object through thecontext.registers
feature of Liquid atcontext.registers[:site]
. For example, you can access the global configuration file_config.yml
usingcontext.registers[:site].config
.
- [flags]
-
Flags ^^^^^
There are two flags to be aware of when writing a plugin:
<tr>
<th>Flag</th> <th>Description</th>
</tr>
<tr>
<td> <p><code>safe</code></p> </td> <td> <p> A boolean flag that informs Jekyll whether this plugin may be safely executed in an environment where arbitrary code execution is not allowed. This is used by GitHub Pages to determine which core plugins may be used, and which are unsafe to run. If your plugin does not allow for arbitrary code, execution, set this to <code>true</code>. GitHub Pages still won’t load your plugin, but if you submit it for inclusion in core, it’s best for this to be correct! </p> </td>
</tr> <tr>
<td> <p><code>priority</code></p> </td> <td> <p> This flag determines what order the plugin is loaded in. Valid values are: <code>:lowest</code>, <code>:low</code>, <code>:normal</code>, <code>:high</code>, and <code>:highest</code>. Highest priority matches are applied first, lowest priority are applied last. </p> </td>
</tr>
To use one of the example plugins above as an illustration, here is how you’d specify these two flags:
{% highlight ruby %} module
Jekyll
class UpcaseConverter < Converter safe true priority :low … end end {% endhighlight %}///////////////////////////
- [available-plugins]
-
Available Plugins ~~~~~~~~~~~~~~~~~
You can find a few useful plugins at the following locations:
- [generators-1]
-
Generators ++++++++++
-
gist.github.com/707909[ArchiveGenerator by Ilkka Laukkanen]:
Uses gist.github.com/707020[this archive page] to generate archives.
-
gist.github.com/642739[LESS.js Generator by Andy Fowler]:
Renders LESS.js files during generation.
-
gist.github.com/449491[Version Reporter by Blake Smith]:
Creates a version.html file containing the
Jekyll
version.-
github.com/kinnetica/jekyll-plugins[Sitemap.xml Generator by
Michael Levin]: Generates a sitemap.xml file by traversing all of the available posts and pages.
-
github.com/PascalW/jekyll_indextank[Full-text search by Pascal
Widdershoven]: Adds full-text search to your
Jekyll
site with a plugin and a bit of JavaScript.Thomas Mango]: Generates redirect pages for posts when an alias is specified in the YAML Front Matter.
Redirect Generator by Nick Quinlan]: Generates redirects based on files in the
Jekyll
root, with support for htaccess style redirects.Frederic Hemberger]: Renders files in a directory as a single page instead of separate posts.
-
github.com/agelber/jekyll-rss[RssGenerator by Assaf Gelber]:
Automatically creates an RSS 2.0 feed from your posts.
archive generator by Shigeya Suzuki]: Generator and template which renders monthly archive like MovableType style, based on the work by Ilkka Laukkanen and others above.
archive generator by Shigeya Suzuki]: Generator and template which renders category archive like MovableType style, based on Monthly archive generator.
-
github.com/yihangho/emoji-for-jekyll[Emoji for Jekyll]:
Seamlessly enable emoji for all posts and pages.
-
github.com/mscharley/jekyll-compass[Compass integration for
Jekyll]: Easily integrate Compass and Sass with your
Jekyll
website.by Ben Baker-Smith]: Defines a `_pages` directory for page files which routes its output relative to the project root.
-
github.com/jeffkole/jekyll-page-collections[Page Collections
by Jeff Kolesky]: Generates collections of pages with functionality that resembles posts.
-
github.com/sheehamj13/jekyll-live-tiles[Windows 8.1 Live Tile
Generation by Matt Sheehan]: Generates Internet Explorer 11 config.xml file and Tile Templates for pinning your site to Windows 8.1.
- [converters-1]
-
Converters ++++++++++
-
github.com/snappylabs/jade-jekyll-plugin[Jade plugin by John
Papandriopoulos]: Jade converter for
Jekyll
.-
gist.github.com/517556[HAML plugin by Sam Z]: HAML converter
for
Jekyll
.-
gist.github.com/481456[HAML-Sass Converter by Adam Pearson]:
Simple HAML-Sass converter for
Jekyll
. gist.github.com/528642[Fork] by Sam X.-
gist.github.com/960150[Sass SCSS Converter by Mark Wolfe]:
Sass converter which uses the new CSS compatible syntax, based Sam X’s fork above.
-
gist.github.com/639920[LESS Converter by Jason Graham]:
Convert LESS files to CSS.
-
gist.github.com/760265[LESS Converter by Josh Brown]: Simple
LESS converter.
-
gist.github.com/449463[Upcase Converter by Blake Smith]: An
example
Jekyll
converter.-
gist.github.com/959938[CoffeeScript Converter by phaer]: A
coffeescript.org[CoffeeScript] to Javascript converter.
-
github.com/olov/jekyll-references[Markdown References by Olov
Lassus]: Keep all your markdown reference-style link definitions in one _references.md file.
-
gist.github.com/988201[Stylus Converter]: Convert .styl to
.css.
-
github.com/xdissent/jekyll-rst[ReStructuredText Converter]:
Converts ReST documents to HTML with Pygments syntax highlighting.
Use pandoc for rendering markdown. * github.com/fauno/jekyll-pandoc-multiple-formats[Jekyll-pandoc-multiple-formats] by github.com/edsl[edsl]: Use pandoc to generate your site in multiple formats. Supports pandoc’s markdown extensions.
-
gist.github.com/1472645[Transform Layouts]: Allows HAML
layouts (you need a HAML Converter plugin for this to work).
-
gist.github.com/abhiyerra/7377603[Org-mode Converter]:
Org-mode converter for
Jekyll
.- [filters]
-
Filters +++++++
codebeef.com[Matt Hall]: A
Jekyll
filter that truncates HTML while preserving markup structure.Name Filter by Lawrence Woodman]: Filters the input text so that just the domain name is left.
-
gist.github.com/731597[Summarize Filter by Mathieu Arnold]:
Remove markup after a `<div id=“extended”>` tag.
-
gist.github.com/919275[URL encoding by James An]: Percent
encoding for URIs.
-
gist.github.com/1850654[JSON Filter] by
github.com/joelverhagen[joelverhagen]: Filter that takes input text and outputs it as JSON. Great for rendering JavaScript. * github.com/gacha/gacha.id.lv/blob/master/_plugins/i18n_filter.rb[i18n_filter]: Liquid filter to use I18n localization.
github.com/SaswatPadhi[SaswatPadhi]: Convert text emoticons in your content to themeable smiley pics (saswatpadhi.github.com/[Demo]).
-
gist.github.com/zachleat/5792681[Read in X Minutes] by
github.com/zachleat[zachleat]: Estimates the reading time of a string (for blog post content).
time value to the time ago in words.
-
github.com/bdesham/pluralize[pluralize]: Easily combine a
number and a word into a gramatically-correct amount like “1 minute” or “2 minute*s*”.
-
github.com/bdesham/reading_time[reading_time]: Count words and
estimate reading time for a piece of text, ignoring HTML elements that are unlikely to contain running text.
-
github.com/dafi/jekyll-toc-generator[Table of Content
Generator]: Generate the HTML code containing a table of content (TOC), the TOC can be customized in many way, for example you can decide which pages can be without TOC.
is a port of the Django app humanize which adds a “human touch” to data. Each method represents a Fluid type filter that can be used in your
Jekyll
site templates. Given thatJekyll
produces static sites, some of the original methods do not make logical sense to port (e.g. naturaltime).liquid filter to output a date ordinal such as “st”, “nd”, “rd”, or “th”.
-
github.com/kzykbys/JekyllPlugins[Deprecated articles keeper]
by blog.kazuya.co/[Kazuya Kobayashi]: A simple
Jekyll
filter which monitor how old an article is.- [tags-1]
-
Tags ++++
by www.samrayner.com/[Sam Rayner]: Allows organisation of assets into subdirectories by outputting a path for a given file relative to the current post or page.
by Christian Hellsten]: Fetches and renders bookmarks from delicious.com.
-
gist.github.com/480380[Ultraviolet Plugin by Steve Alex]:
Jekyll
tag for the ultraviolet.rubyforge.org/[Ultraviolet] code highligher.-
gist.github.com/710577[Tag Cloud Plugin by Ilkka Laukkanen]:
Generate a tag cloud that links to tag pages.
-
gist.github.com/730347[GIT Tag by Alexandre Girard]: Add Git
activity inside a list.
-
gist.github.com/834610[MathJax Liquid Tags by Jessy
Cowan-Sharp]: Simple liquid tags for
Jekyll
that convert inline math and block equations to the appropriate MathJax script tags.-
gist.github.com/1027674[Non-JS Gist Tag by Brandon Tilley] A
Liquid tag that embeds Gists and shows code for non-JavaScript enabled browsers and readers.
-
gist.github.com/449509[Render Time Tag by Blake Smith]:
Displays the time a
Jekyll
page was generated.-
gist.github.com/912466[Status.net/OStatus Tag by phaer]:
Displays the notices in a given status.net/ostatus feed.
-
gist.github.com/1020852[Raw Tag by phaer]: Keeps liquid from
parsing text betweeen `raw` tags.
Robert Böhnke]: Autogenerate embeds from URLs using oEmbed.
-
gist.github.com/2290195[Logarithmic Tag Cloud]: Flexible.
Logarithmic distribution. Documentation inline.
-
gist.github.com/1455726[oEmbed Tag by Tammo van Lessen]:
Enables easy content embedding (e.g. from YouTube, Flickr, Slideshare) via oEmbed.
Thomas Mango]: Generates image galleries from Flickr sets.
-
github.com/scottwb/jekyll-tweet-tag[Tweet Tag by Scott W.
Bradley]: Liquid tag for dev.twitter.com/docs/embedded-tweets[Embedded Tweets] using Twitter’s shortcodes. * github.com/rustygeldmacher/jekyll-contentblocks[Jekyll-contentblocks]: Lets you use Rails-like content_for tags in your templates, for passing content from your posts up to your layouts.
-
gist.github.com/1805814[Generate YouTube Embed] by
github.com/joelverhagen[joelverhagen]:
Jekyll
plugin which allows you to embed a YouTube video in your page with the YouTube ID. Optionally specify width and height dimensions. Like “oEmbed Tag” but just for YouTube.FreeBSD utility tags for
Jekyll
sites.-
gist.github.com/1895282[Jsonball]: Reads json files and
produces maps for use in
Jekyll
files.BibTeX-formatted bibliographies/citations included in posts and pages using bibtex2html.
BibTeX-formatted bibliographies/citations included in posts and pages (pure Ruby).
Set Tag]: Builds Dribbble image galleries from any user.
-
gist.github.com/2218470[Debbugs]: Allows posting links to
Debian BTS easily.
-
github.com/aburdette/refheap_tag[Refheap_tag]: Liquid tag that
allows embedding pastes from refheap.com[refheap].
-
gist.github.com/2403522[Jekyll-devonly_tag]: A block tag for
including markup only during development.
github.com/redwallhp[redwallhp]: Generates thumbnails from a directory of images and displays them in a grid.
-
gist.github.com/Yexiaoxing/5891929[Youku and Tudou Embed]:
Liquid plugin for embedding Youku and Tudou videos.
plugin for embedding Adobe Flash files (.swf) using code.google.com/p/swfobject/[SWFObject].
Tag]: Easy responsive images for
Jekyll
. Based on the proposed github.com/scottjehl/picturefill[Picturefill].Better images for
Jekyll
. Save image presets, generate resized images, and add classes, alt text, and other attributes.github.com/matze[matze]: Renders ASCII diagram art into PNG images and inserts a figure tag.
-
github.com/penibelst/jekyll-good-include[Good Include] by
penibelst.de/[Anatol Broder]: Strips newlines and whitespaces from the end of include files before processing.
Suggested Tweet] by github.com/davidensinger/[David Ensinger]: A Liquid tag for
Jekyll
that allows for the embedding of suggested tweets via Twitter’s Web Intents API.-
github.com/GSI/jekyll_date_chart[Jekyll Date Chart] by
github.com/GSI[GSI]: Block that renders date line charts based on textile-formatted tables.
-
github.com/GSI/jekyll_image_encode[Jekyll Image Encode] by
github.com/GSI[GSI]: Tag that renders base64 codes of images fetched from the web.
-
github.com/GSI/jekyll_quick_man[Jekyll Quick Man] by
github.com/GSI[GSI]: Tag that renders pretty links to man page sources on the internet.
Quickly and easily add Font Awesome icons to your posts.
-
gist.github.com/tobru/9171700[Lychee Gallery Tag] by
github.com/tobru[tobru]: Include lychee.electerious.com/[Lychee] albums into a post. For an introduction, see tobrunet.ch/articles/jekyll-meets-lychee-a-liquid-tag-plugin/[Jekyll meets Lychee - A Liquid Tag plugin]
-
github.com/callmeed/jekyll-image-set[Image Set/Gallery Tag] by
github.com/callmeed[callmeed]: Renders HTML for an image gallery from a folder in your
Jekyll
site. Just pass it a folder name and class/tag options.figures and captions with links to the figure in a variety of formats
-
github.com/bwillis/jekyll-github-sample[Jekyll Github Sample
Tag]: A liquid tag to include a sample of a github repo file in your
Jekyll
site.Version Tag]: A Liquid tag plugin that renders a version identifier for your
Jekyll
site sourced from the git repository containing your code.www.alorenzi.eu/[Alessandro Lorenzi]:
Jekyll
plugin to generate thumbnails from a Piwigo gallery and display them with a Liquid tag- [collections]
-
Collections +++++++++++
Recursive Design]: Plugins to generate Project pages from GitHub readmes, a Category page, and a Sitemap generator.
-
github.com/flatterline/jekyll-plugins[Company website and blog
plugins] by Flatterline, a flatterline.com/[Ruby on Rails development company]: Portfolio/project page generator, team/individual page generator, an author bio liquid tag for use on posts, and a few other smaller plugins.
-
github.com/aucor/jekyll-plugins[Jekyll plugins by Aucor]:
Plugins for trimming unwanted newlines/whitespace and sorting pages by weight attribute.
- [other]
-
Other +++++
* github.com/rsim/blog.rayapps.com/blob/master/_plugins/pygments_cache_patch.rb[Pygments Cache Path by Raimonds Simanovskis]: Plugin to cache syntax-highlighted code from Pygments.
-
gist.github.com/49630[Draft/Publish Plugin by Michael Ivey]:
Save posts as drafts.
-
gist.github.com/490101[Growl Notification Generator by Tate
Johnson]: Send
Jekyll
notifications to Growl.-
gist.github.com/525267[Growl Notification Hook by Tate
Johnson]: Better alternative to the above, but requires his “hook” fork.
Posts by Lawrence Woodman]: Overrides `site.related_posts` to use categories to assess relationship.
-
gist.github.com/88cda643aa7e3b0ca1e5[Tiered Archives by Eli
Naeher]: Create tiered template variable that allows you to group archives by year and month. * github.com/blackwinter/jekyll-localization[Jekyll-localization]:
Jekyll
plugin that adds localization features to the rendering engine.Jekyll
plugin to provide alternative rendering engines.Jekyll
plugin to extend the pagination generator.plugin to automatically generate a tag cloud and tag pages.
extensions for the blogging scholar.
Bundles and minifies JavaScript and CSS.
github.com/ixti[ixti]: Rails-alike assets pipeline (write assets in CoffeeScript, Sass, LESS etc; specify dependencies for automatic bundling using simple declarative comments in assets; minify and compress; use JST templates; cache bust; and many-many more).
-
github.com/kitsched/japr[JAPR]:
Jekyll
Asset Pipeline Reborn -
Powerful asset pipeline for
Jekyll
that collects, converts and compresses JavaScript and CSS assets.-
gist.github.com/2758691[File compressor] by
github.com/mytharcher[mytharcher]: Compress HTML and JavaScript files on site build.
Asset bundling and cache busting using external minification tool of your choice. No gem dependencies.
github.com/JCB-K[JCB-K]: Turns
Jekyll
into a dynamic one-page website. * github.com/robwierzbowski/generator-jekyllrb[generator-jekyllrb]: A generator that wrapsJekyll
in yeoman.io/[Yeoman], a tool collection and workflow for builing modern web apps.straightforward gruntjs.com/[Grunt] plugin for
Jekyll
.`_postfiles` directory and {% raw %}`{{ postfile }}`{% endraw %} tag so the files a post refers to will always be right there inside your repo.
-
github.com/penibelst/jekyll-compress-html[A layout that
compresses HTML] by penibelst.de/[Anatol Broder]: Github Pages compatible, configurable way to compress HTML files on site build.
- [editors]
-
Editors +++++++
Sublime Text package for
Jekyll
static sites. This package should help creatingJekyll
sites and posts easier by providing access to key template tags and filters, as well as common completions and a current date/datetime command (for dating posts). You can install this package manually via GitHub, or via sublime.wbond.net/packages/Jekyll[Package Control].-
github.com/parkr/vim-jekyll[vim-jekyll]: A vim plugin to
generate new posts and run `jekyll build` all without leaving vim.
Jekyll
Plugins Wanted
If you have a
Jekyll
plugin that you would like to see added to this list, you should <a href=“../contributing/”>read the contributing page</a> to find out how to make that happen.
///////////////////////////
-
-
-
-
-
-
-
-