Installation

This guide will walk you through installing the html2rss Ruby gem on your system. Choose the method that works best for your setup - we’ll walk you through each option step by step.

---

Prerequisites

• Ruby: html2rss is built with Ruby. Ensure you have a compatible version of Ruby installed. You can check your Ruby version by running ruby -v in your terminal. If you don’t have Ruby, visit ruby-lang.org for installation instructions.
• Bundler (Recommended): Bundler is a Ruby gem that manages your application’s dependencies. It’s highly recommended for a smooth installation. Install it with gem install bundler.

---

Method 1: Gem Installation (Recommended for CLI Usage)

The simplest way to get html2rss for command-line usage is to install it as a Ruby gem.

gem install html2rss

After installation, you should be able to run html2rss --version to confirm it’s working.

---

Method 2: Using a Gemfile (For Ruby Projects)

If you’re integrating html2rss into an existing Ruby project, add it to your Gemfile:

# Gemfile
gem 'html2rss'

Then, run bundle install in your project directory.

---

Method 3: GitHub Codespaces (For Cloud Development)

For a quick start without local setup, you can develop html2rss directly in your browser using GitHub Codespaces:

The Codespace comes pre-configured with Ruby, all dependencies, and VS Code extensions ready to go!

---

Verifying Installation

To ensure html2rss is installed correctly, open your terminal and run:

html2rss --version

You should see the installed version number. If you encounter any issues, please refer to the Troubleshooting Guide.

---

Next Steps

Now that html2rss is installed, let’s create your first RSS feed!