Jekyll Pages Directory

screenshot of Jekyll Pages Directory

Defines a _pages directory for page files which routes its output relative to the project root.

Overview

Managing static pages in Jekyll can become unwieldy, especially when your project grows beyond a few simple files. The Jekyll Pages Directory Plugin addresses this issue by allowing users to define a dedicated _pages directory for all page files, which significantly tidies up the project structure. Instead of having pages scattered throughout the project root, this plugin enables a more organized setup that enhances efficiency.

With this plugin, it’s easy to configure and maintain your project's pages, ensuring a cleaner output routing while keeping important files neatly contained. Whether you're a seasoned Jekyll user or just starting, this plugin could greatly simplify your workflow.

Features

  • Dedicated _pages Directory: Establishes a specific _pages directory for storing all your page files, keeping your project root organized.
  • Customizable Directory: Allows you to define your own directory for page data through simple configuration, accommodating various project structures.
  • Intuitive Output Routing: Files in _pages are routed in relation to your project root, ensuring consistent and expected output structure.
  • Compatible with Other Plugins: Designed to work alongside other Jekyll plugins that do not directly access page data files, enhancing versatility.
  • Easy Installation: Just copy the provided Ruby script into your project's _plugins directory and you’re ready to go.
  • Open Source License: Distributed under the MIT License, allowing for free use, modification, and distribution within your projects.
  • Minimal Setup Requirements: Only requires having the main index.html file in the project root to function correctly, simplifying initial setup.
  • User Community Support: Encourages users to submit feedback or issues via Github, fostering an active user community for ongoing improvements.