README

Overview

This application scrapes the "Kohler Report" section of ABC News and generates an RSS feed. It supports both CLI and CGI modes.

Installation

Prerequisites

• Go (if building from source)

Optional

• Apache or Nginx (for serving RSS files)

Build and Install

Install only (System level)

Grab the latest binary here: https://github.com/arran4/abc-kohler-report-rss/releases/

Install and build as user (User)

Install go 1.24+

Run `go install`:```bashgo install github.com/arran4/abc-kohler-report-rss/cmd/abckohlerreportrss@latest```This installs to `$HOME/go/bin` (typically; check with `go env`).

Usage

CLI Mode

Generate RSS Feed:```bashabckohlerreportrss -output /var/www/localhost/htdocs/rss/abckohlerreportrss.xml```

CGI Mode

1. Place `abckohlerreportrss-cgi` in your server's CGI directory (e.g., `/var/www/htdocs/cgi-bin/abckohlerreportrss-cgi`).2. Ensure it is executable: ```bash chmod +x /var/www/htdocs/cgi-bin/abckohlerreportrss-cgi ```3. Access it via URL (e.g., `http://example.com/cgi-bin/abckohlerreportrss-cgi`).

Deployment

rc.d (Cron Job system level)

Add a cron job to run the script periodically:1. Edit the root crontab: ```bash sudo crontab -e ```2. Add the following line: ```bash */15 /usr/local/bin/abckohlerreportrss -output /var/www/localhost/htdocs/rss/abckohlerreportrss.xml ```

rc.d (Cron Job user level)

Add a cron job to run the script periodically:1. Edit the user's crontab: ```bash crontab -e ```2. Add the following line: ```bash */15 ~/go/bin/abckohlerreportrss -output ~/public_html/rss/abckohlerreportrss.xml ```

systemd (as root)

1. Create a systemd service file at `/etc/systemd/system/abckohlerreportrss.service`:```ini[Unit]Description=ABC News Kohler Report RSS Feed Creator

[Service]Type=oneshotExecStart=/usr/bin/abckohlerreportrss -output /var/www/localhost/htdocs/rss/abckohlerreportrss.xmlUser=apacheGroup=apache```

2. Create a systemd timer file at `/etc/systemd/system/everyhour@.timer`:

```ini[Unit]Description=Monthly Timer for %i service

[Timer]OnCalendar=-- :00:00AccuracySec=1hRandomizedDelaySec=1hPersistent=trueUnit=%i.service

[Install]WantedBy=default.target```

3. Reload systemd and start the service: ```bash sudo systemctl daemon-reload sudo systemctl enable --now everyhour@abckohlerreportrss.timer ```

systemd (as user)

1. Create a systemd service file at `$HOME/.config/systemd/user/abckohlerreportrss.service`:```ini[Unit]Description=ABC News Kohler Report RSS Feed Creator

[Service]Type=oneshotExecStart=%h/go/bin/abckohlerreportrss -output %h/public_html/rss/abckohlerreportrss.xml```

2. Create a systemd timer file at `$HOME/.config/systemd/user/everyhour@.timer`:

```ini[Unit]Description=Monthly Timer for %i service

[Timer]OnCalendar=-- :00:00AccuracySec=1hRandomizedDelaySec=1hPersistent=trueUnit=%i.service

[Install]WantedBy=default.target```

3. Reload systemd and start the service: ```bash systemctl --user daemon-reload && systemctl --user enable --now everyhour@abckohlerreportrss.timer ```

Apache VirtualHost Configuration

User

Refer to documentation for setting up public_html directories

Enjoy

http://localhost/~$USERNAME/rss/abckohlerreportrss.xml

System

Add the following configuration to your Apache setup (e.g., `/etc/httpd/conf.d/rss.conf`):```apache ServerName example.com DocumentRoot /var/www/localhost/htdocs/rss Options Indexes FollowSymLinks AllowOverride None Require all granted ```

Nginx Configuration

User

Refer to documentation for setting up public_html directories

System

Add this to your Nginx server block:```nginxserver { listen 80; server_name example.com;

location /rss/ { root /var/www/localhost/htdocs; autoindex on; }}```