Summary: This article outlines how Jekyll Themes need to be prepared and the technical requirements expected for this item type.
Please note: There are three parts to preparing your item to sell on Envato. This process includes the item preparation and technical requirements for certain items (as shown below). Make sure to also review our overall Quality Requirements and Technical Requirements as well as Legal Requirements to cover all the bases and get through review!
What is Jekyll?
Jekyll is a simple, blog-aware, static site generator. It takes a template directory containing raw text files in various formats, runs it through Markdown (or Textile) and Liquid converters, and spits out a complete, ready-to-publish static website suitable for serving with your favorite web server. Jekyll also happens to be the engine behind GitHub Pages, which means you can use Jekyll to host your project’s page, blog, or website from GitHub’s servers for free.
Technical Requirements
- New submissions and theme updates must be compatible with the latest public minor release of Jekyll.
- Theme internal folder structure should follow this general format: http://jekyllrb.com/docs/structure/
- Follow the template coding guidelines found here: http://jekyllrb.com/docs/templates
- The main theme folder must be the name of your theme.
- Submissions may also optionally include Layered PSD files to allow users to customize the theme images.
- The item must include documentation.
- Item previews must include rendered screenshots of all template layouts.
- You must provide a URL to a live preview demonstrating your theme’s functionality on your own server.
- The item description must list and link to any non-standard or 3rd party fonts/scripts/assets used in your theme. If you include the 3rd party fonts/scripts/assets in your theme .ZIP package, ensure you have the legal rights to do so.
- Include a message to the reviewer in the upload comment box specifying if your Jekyll Theme is based off one of your existing ThemeForest items (e.g. a Wordpress Theme or Site Template), including a link to the existing item.
Documentation Requirements
Written documentation is required to help buyers with installation, setup, and customization.
- The full installation process of the theme must be documented.
- Sample content and any advanced styling/layout instructions must be included in the documentation.
- Any non-standard or 3rd party fonts/scripts/assets used in your theme must be listed, linked to, and appropriately credited in the documentation.
- Theme version notes must be documented, including:
- Version number
- Date of release
- List of all updates and fixes included in the release
- Past version history
- Refer to the ThemeForest General File Preparation Guidelines for instructions on how to format your documentation.
Additional Resources
- http://jekyllrb.com
- http://jekyllbootstrap.com (Framework)
- http://octopress.org/ (Framework)
- http://pages.github.com