feat(docs): Restructure into Ruby Gem and Web App sections

Reorganize the documentation to create a clear distinction between the `html2rss` Ruby Gem and the standalone Web Application. This improves navigation and helps users find content relevant to their specific use case.

- Move all existing gem-related documentation (getting started, configuration, examples) into a new `/ruby-gem` directory.
- Add a new, comprehensive documentation section for the Web Application under `/web-application`.
- Update site-wide navigation, internal links, and page front matter to align with the new structure.
- Update gem dependencies in `Gemfile.lock`.

Author: gildesmarais

_config.yml

@@ -24,9 +24,6 @@ aux_links:
   "GitHub":
     - "https://github.com/html2rss"
 
-header_pages:
-  - configs/index.html
-  - contributing.md
 
 # Footer "Edit this page on GitHub" link text
 gh_edit_link: true # show or hide edit this page link

about.md

@@ -41,4 +41,4 @@ The `html2rss` project is more than just a single tool. It's a collection of too
 
 `html2rss` is maintained by a dedicated group of volunteers and contributors from around the world. We are passionate about open source and committed to continuously improving the project.
 
-Want to join us? Check out our [Contributing Guide]({{ '/contributing/' | relative_url }})!
+Want to join us? Check out our [Contributing Guide]({{ '/contributing' | relative_url }})!

configuration/index.md

@@ -4,66 +4,38 @@ title: Home
 nav_order: 1
 ---
 
-# Welcome to html2rss!
-
-**Transform any website into a custom RSS feed.**
+# Create RSS Feeds for Any Website
 
 Tired of missing updates from websites that don't offer RSS feeds? `html2rss` is a powerful and flexible tool that lets you create your own RSS feeds for almost any website.
 
-Whether you're a developer, a content curator, or just someone who wants to stay on top of the latest news, `html2rss` gives you the power to control your information flow.
+[**🚀 Get Started with the Web App!**]({{ '/web-application/getting-started' | relative_url }})
 
 ---
 
-## How it Works
+## The html2rss Ecosystem
 
-`html2rss` makes it easy to create custom RSS feeds in just a few steps:
+`html2rss` is a suite of tools designed to help you create and manage RSS feeds.
 
-1.  **Install `html2rss`:** Get up and running in minutes with a simple gem installation.
-2.  **Choose your scraper:**
-    - Use the **`auto_source` scraper** to automatically find and extract content from a website.
-    - Use the **`selectors` scraper** for more control, allowing you to specify exactly what content to extract using CSS selectors.
-3.  **Generate your feed:** Run a simple command to generate your custom RSS feed.
-4.  **Stay updated:** Use your favorite RSS reader to subscribe to your new feed and never miss an update.
+*   **[html2rss-web]({{ '/web-application' | relative_url }}):** A user-friendly web application that makes it easy to create, manage, and share RSS feeds. This is the recommended starting point for most users.
+*   **[html2rss (Ruby Gem)]({{ '/ruby-gem' | relative_url }}):** The core library that powers the web application. It provides a powerful and flexible command-line interface for creating custom RSS feeds.
+*   **[html2rss-configs](https://github.com/html2rss/html2rss-configs):** A community-driven repository of pre-built feed configurations for popular websites.
 
 ---
 
-### Key Features
+## Key Features
 
+- **User-Friendly Web Interface:** The `html2rss-web` application provides a simple and intuitive interface for managing your feeds.
 - **Automatic Feed Generation:** The `auto_source` scraper intelligently finds and extracts content from websites, so you can create feeds with minimal effort.
 - **Precise Content Extraction:** Use familiar CSS selectors to target the exact content you want to include in your feed.
-- **JSON Support:** Scrape and handle JSON responses from APIs and other web services.
 - **JavaScript Rendering:** Use a headless browser to render JavaScript-heavy websites and extract content that isn't available in the initial HTML.
-- **Customizable HTTP Headers:** Set custom HTTP headers for your requests, allowing you to access protected content or interact with APIs.
 - **Open Source:** `html2rss` is free to use, modify, and contribute to.
 
 ---
 
-### Get Started in Minutes
-
-Ready to create your first custom RSS feed? Our comprehensive documentation will guide you through the process, from installation to advanced configurations.
-
-[**🚀 Get Started Now!**]({{ '/getting-started/' | relative_url }})
-
----
-
-### Examples & Recipes
-
-Explore our collection of pre-built recipes and examples to see `html2rss` in action and get inspiration for your own feeds.
-
-[**📚 Browse Examples**]({{ '/examples/' | relative_url }})
-
----
-
 ### Join the Community
 
 Have a question, an idea, or a success story to share? Join the `html2rss` community on GitHub!
 
 - **[Discussions](https://github.com/orgs/html2rss/discussions):** Ask questions, share ideas, and connect with other users.
 - **[Issues](https://github.com/html2rss/html2rss/issues):** Report bugs and request new features.
 - **[Contribute](https://github.com/html2rss/html2rss/fork):** Fork the repository and submit your own improvements.
-
----
-
-### Need Help?
-
-Check out our [Troubleshooting Guide]({{ '/support/troubleshooting/' | relative_url }}) or [Contact Us]({{ '/support/contact/' | relative_url }}) for support.

examples/custom-http-requests.md

@@ -1,8 +1,10 @@
 ---
 layout: default
 title: Auto Source
-nav_order: 4
+nav_order: 1
 parent: Configuration
+grand_parent: Ruby Gem
+permalink: /ruby-gem/configuration/auto_source
 ---
 
 # `auto_source`

examples/handling-dynamic-content.md

@@ -1,8 +1,10 @@
 ---
 layout: default
 title: Channel
-nav_order: 1
+nav_order: 2
 parent: Configuration
+grand_parent: Ruby Gem
+permalink: /ruby-gem/configuration/channel
 ---
 
 # `channel`

getting-started/index.md

@@ -1,8 +1,10 @@
 ---
 layout: default
 title: Headers
-nav_order: 1
+nav_order: 3
 parent: Configuration
+grand_parent: Ruby Gem
+permalink: /ruby-gem/configuration/headers
 ---
 
 # `headers`
@@ -17,7 +19,7 @@ headers:
 
 You can also set headers for APIs that require authorization or custom headers.
 
-Dynamic parameters can be used in headers to pass values at runtime. See [Advanced Topics](/configuration/advanced-topics/) for more details.
+Dynamic parameters can be used in headers to pass values at runtime. See [Dynamic Parameters]({{ '/ruby-gem/examples/dynamic-parameters' | relative_url }}) for more details.
 
 ## Example Configuration