no message

README.md

@@ -0,0 +1,97 @@
+# Homebrew Fonts Tap
+
+This repository contains a collection of custom fonts for use with Homebrew.
+
+## Installation
+
+```bash
+brew tap trtmn-fonts/fonts
+brew install font-<font-name>
+```
+
+## Available Fonts
+
+This tap provides a variety of custom fonts. To see all available fonts, run:
+
+```bash
+brew search trtmn-fonts/fonts/font-
+```
+
+## Adding New Fonts
+
+To add a new font to this tap, follow these steps:
+
+1. **Create a Gitea API Token**:
+   - Go to your Gitea profile settings
+   - Navigate to "Applications" > "Generate New Token"
+   - Name the token (e.g., "Homebrew Fonts")
+   - Select the necessary permissions (at minimum: `repo`)
+   - Generate and copy the token
+
+2. **Set Up Environment Variables**:
+   - Create a `.env` file in the root of this repository with the following content:
+     ```
+     GITEA_URL=http://clancy.genet-godzilla.ts.net:3002
+     GITEA_USERNAME=trtmn-fonts
+     GITEA_API_TOKEN=your_api_token_here
+     ```
+   - Replace `your_api_token_here` with your actual Gitea API token
+   - **Important**: Do not commit the `.env` file to version control if it contains sensitive information
+
+3. **Install Required Python Packages**:
+   ```bash
+   pip install -r requirements.txt
+   ```
+
+4. **Run the Add Font Script**:
+   ```bash
+   python3 add-font-submodule.py
+   ```
+   - Follow the prompts to enter the font name and location of the font files
+   - The script will:
+     - Create a new repository on Gitea for the font
+     - Add the font as a submodule to this repository
+     - Create a Homebrew formula for the font
+     - Update the font index
+
+5. **Push Changes to Gitea**:
+   ```bash
+   git push
+   ```
+
+## Removing Fonts
+
+To remove a font from this tap, follow these steps:
+
+1. **Ensure Environment Variables are Set**:
+   - Make sure your `.env` file is properly configured (see "Adding New Fonts" section)
+
+2. **Run the Remove Font Script**:
+   ```bash
+   python3 remove-font.py <font-name>
+   ```
+   - Replace `<font-name>` with the name of the font to remove
+   - The script will:
+     - Ask for confirmation before proceeding
+     - Remove the font submodule
+     - Delete the font repository from Gitea
+     - Update the font index
+
+3. **Push Changes to Gitea**:
+   ```bash
+   git push
+   ```
+
+## Repository Structure
+
+- `Formula/`: Contains Homebrew formulas for each font
+- `fonts/`: Contains submodules for each font repository
+- `fonts/index.json`: Index of all available fonts
+- `add-font-submodule.py`: Script for adding new fonts
+- `remove-font.py`: Script for removing fonts
+- `.env`: Configuration file for Gitea credentials (not tracked by git)
+- `requirements.txt`: Python dependencies
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.