Repeater Roundabout

This repo manages the website for the Repeater Roundabout. The main branch is automatically deployed to the production site; it is built using Jekyll to generate static HTML pages from the Markdown files in the root directory. These Markdown files are generated programmatically from the assets/templates directory, which contains the templates for the various pages on the site, and from information contained in assets/repeaters.json.

Template files

The files in assets/templates/ are used to generate the pages on the site.

• assets/templates/index.md is the homepage; template elements include {{ date_updated }} and {{ index_content }}, which is populated by either ongoing contest information or leaderboard data, depending on arguments passed to scripts/update.py (specifically, the --score argument, which triggers a leaderboard calculation).
• assets/templates/repeaters.md is the repeaters page; template elements include {{ table }} (a table of repeaters with frequencies and such) and {{ associations }} (a list naming and linking each group contributing their repeaters).
• assets/templates/map.md is the map page; template elements include {{ repeater_pins }} (a list of pins for each repeater on the map); this template is filled with Leaflet code to generate the map.
• assets/templates/rules.md contains the rules for the event; template elements include {{ n_repeaters }} and {{ n_groups }}.
• assets/templates/map.html is for local development only; it generates demo_map.html which is not styled and is not used in production, but can be opened in a browser to see the map locally and ensure it is correctly centered and zoomed.

Adding a repeater

To add a repeater, you should call python scripts/update.py. This script will prompt you for the repeater's information, and will add it to the assets/repeaters.json file containing all known repeaters, as well as regenerating the assets/rr_frequencies.csv file for CHIRP use.

This script can be called directly, in which case it will prompt you for repeater information, or you can call it by passing the following arguments to the command-line for the same effect.

• Group name (--name): The short name of the group that runs one or more repeaters (for example, PSRG or Shoreline ACS)
• Location (--loc): The general location of the repeater (for example, Seattle or Buck Mtn.)
• RepeaterBook State ID (--state_id): The State ID of the repeater on RepeaterBook (an integer you can find after state_id= in the URL). Defaults to Washington (53) if not specified.
• RepeaterBook ID (--id): The ID of the repeater on RepeaterBook (an integer you can find at the very end of the URL)
• Callsign (--call): The repeater's callsign (for example, WW7PSR)
• Frequency (--freq): The repeater's frequency (for example, 146.960)
• Offset (--offset): The repeater's offset, in MHz (for example, +0.6)
• Tone (--tone): The repeater's tone, in Hz (for example, 103.5); for DMR repeaters, use something like CC2/TS1 BEARS1 TG/312488 for color code, time slot, and talk group name and number
• Mode (--mode): The repeater's mode (for example, FM or DMR); defaults to FM if not provided
• Latitude (--lat): The repeater's latitude, in decimal degrees (for example, 47.6062)
• Longitude (--lon): The repeater's longitude, in decimal degrees (for example, -122.3321)
• Long name (--long_name): The full name of the group that runs the repeater (for example, Puget Sound Repeater Group or Shoreline Amateur Communication Society)
• Website (--url): The URL of the group's website (for example, https://psrg.org or https://shorelineacs.org); please include the http:// prefix

For example, you may call python scripts/update.py to be prompted to enter all of this information, or call

python scripts/update --name PSRG --loc Seattle --freq 146.960 --offset -0.6 --tone 103.5 --lat 47.623963 --lon -122.315173 --long_name "Puget Sound Repeater Group" --url https://psrg.org

If you provide a RepeaterBook ID, all but the Group Name, Location, Long Name, and Website are populated from RepeaterBook. The easiest way to add a repeater is to call python scripts/update.py, enter in both a group name and a general location, the RepeaterBook ID, and hit enter a bunch of times to accept the empty defaults, which will be overwritten by RepeaterBook data. Once you get to Long Name, you will need to provide that and the group's Website yourself.

Regenerating the site

If any changes are made to repeaters.json or to template files, you can regenerate the website's root .md files without adding a new repeater by calling python scripts/update.py --regen.

Populating the leaderboards

When the competition is over, call python scripts/update.py --score to have the index page populated with the leaderboards, rather than ongoing contest information.

Contributing

Contributions are welcome -- please open a pull request against a feature branch, or open an issue if you have any questions or suggestions. Note that any changes to .md files should be made to the respective template files in assets/templates/ and not to the root .md files, as the latter are generated programmatically.

Python Environment

The scripts in this repo use Python3. In order to install the dependencies, it is recommended to create a python virtual environment with the appropriate dependencies installed.

Note that Python version 3.9 or higher is required.

$ python -m venv .env        # Create a local Virtual Environment
                             # Possibly use "python3" if python defaults to
                             # version 2.

$ source .env/bin/activate   # Activate it (Mac or Linux)

OR

$ .\.env\Scripts\activate    # (Windows/Powershell)

$ pip install -r requirements.txt

Typescript Development Environment

To compile TypeScript to JavaScript the tool chain includes, node/npm. We install TypeScript locally in node_packages so we have a consistent version between contributors.

# Assumes you have nvm [installed](https://github.com/nvm-sh/nvm)
$ nvm use         # Looks in the .nvmrc file to select the current version of node

$ npm install     # Install the node packages we use (TypeScript)

$ npx tsc         # Compile the TypeScript files in src to assets/scripts.