A Jekyll plugin to render a project's README as the site's index. Let's say you have a GitHub repository with a README.md file, that you'd like to use as the index (main page) for a GitHub Pages site. You could rename the file to index.md, but then it wouldn't render on GitHub.com. You could add YAML front matter with permalink: / to the README, but why force a human to do what Jekyll can automate? If you have a readme file, and your site doesn't otherwise have an index file, this plugin instructs Jekyll to use the readme as the site's index. That's it, no more, no less.

Features

  • Jekyll plugin to render a project's README as the site's index
  • By default the original README markdown files will be included as static pages in the output
  • Even if the plugin is enabled (e.g., via the :jekyll_plugins group in your Gemfile) you can disable it by setting the enabled key to false
  • Configuration options are optional are placed in _config.yml under the readme_index key
  • This plugin instructs Jekyll to use the readme as the site's index

Project Samples

Project Activity

See All Activity >

Categories

Web Design

License

MIT License

Follow Jekyll Readme Index

Jekyll Readme Index Web Site

Other Useful Business Software
Automate contact and company data extraction Icon
Automate contact and company data extraction

Build lead generation pipelines that pull emails, phone numbers, and company details from directories, maps, social platforms. Full API access.

Generate leads at scale without building or maintaining scrapers. Use 10,000+ ready-made tools that handle authentication, pagination, and anti-bot protection. Pull data from business directories, social profiles, and public sources, then export to your CRM or database via API. Schedule recurring extractions, enrich existing datasets, and integrate with your workflows.
Explore Apify Store
Rate This Project
Login To Rate This Project

User Reviews

Be the first to post a review of Jekyll Readme Index!

Additional Project Details

Programming Language

Ruby

Related Categories

Ruby Web Design Software

Registered

2023-09-11