HTMLStarter

IOGKF_website_template — HTML Starter Template

By karate-dojo

A static website template for IOGKF Goju-ryu karate dojos, built with Hugo, with content managed through YAML files, supporting multiple languages and free hosting on GitHub Pages.

Explore the design

Compare the page layouts and mobile experience. Open any screenshot for a closer look.

2 previews
Desktop homepage1 / 2
Desktop captureTop of page

Actual screenshot captured by the server browser.

All pages & views 2

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-10-04View source

What stands out

A quick read of the recorded project description.

01

Static site generation based on Hugo, outputting pure static pages

02

Content configured through YAML files in the data directory, no HTML writing required

03

Built-in English and Portuguese, with documentation for adding other languages

04

Provides a quick start guide for non-technical dojo administrators

05

Includes documentation on configuration, images, deployment, SEO, analytics, and troubleshooting

06

Can be deployed to GitHub Pages, with deployment instructions provided in the repository

Template Details

This is a static website template designed for dojos affiliated with IOGKF (International Okinawan Goju-Ryu Karate-do Federation), and the repository is under the MIT license. The template is based on the Hugo static site generator, and page content is configured through YAML files in the data directory, allowing dojo information, instructor profiles, class schedules, and social media links to be maintained without writing HTML.

The template includes English and Portuguese, and provides language configuration documentation explaining how to add other languages. The project comes with a quick start guide for non-technical users, as well as documentation on installation, configuration, images, deployment, SEO, analytics, and troubleshooting. Deployment is via GitHub Pages, and GitHub Actions must be enabled as the publishing source in the repository settings.

Before use, note the following: the template requires the Hugo Extended version, with the README stating a minimum version of v0.100.0+, though actual use should follow the repository's current dependencies; the template is an independent open-source project and is not affiliated with or endorsed by IOGKF officially; third-party assets such as demo images, fonts, and icons require separate license verification, and the MIT license for the code does not cover these assets.

HTMLLauncher

Is it right for your project?

Use Cases

  • Building a public information website for IOGKF-affiliated Goju-ryu karate dojos
  • Martial arts groups needing to display instructors, class schedules, and contact information
  • Site maintainers who want to manage content via YAML without directly editing HTML
  • Projects planning to host a static website on GitHub Pages

Suitable For

  • Dojos or instructors within the IOGKF system
  • Users with basic text editing skills who can modify YAML
  • Developers or assistants who can install Hugo Extended and configure a GitHub repository
  • Dojo websites requiring an English or Portuguese interface

Getting started & customization

Use these recorded setup notes alongside the repository instructions for your chosen version.

  1. 1

    Requires Hugo Extended; the README states a minimum version of v0.100.0+, but please refer to the repository's current dependencies

  2. 2

    Content modifications are concentrated in files such as data/en/dojo.yaml, instructors.yaml, schedule.yaml, and data/social.yaml

  3. 3

    The dojo logo is placed at static/images/logo.png

  4. 4

    After deploying to GitHub Pages, set Source to GitHub Actions in the repository Settings → Pages

  5. 5

    Third-party assets such as demo images, fonts, and icons require separate license verification according to their respective licenses

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This entry covers the free version under the MIT license in the public repository; the free scope applies to the code of this version and does not imply that external services or third-party assets are free.

Must comply with when using

  • Free use, modification, commercial use, and distribution of this version's code are permitted.
  • When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
  • The code is provided as-is; warranties and limitations of liability are governed by the original license and applicable law.

Additional costs & items to verify

  • Demo images, fonts, icons, and other third-party assets require license verification according to their respective licenses and cannot be judged solely by the code's MIT license.
  • External services such as domains, hosting, databases, payments, or AI may incur additional charges.
  • Using this template requires installing the Hugo Extended version; the README states a minimum version of v0.100.0+, and the standard Hugo version cannot meet the requirements.
  • Deployment and hosting require a GitHub account; the template itself does not provide other hosting methods.
  • Before the first deployment, the Pages Source must be set to GitHub Actions in the repository settings, otherwise the site cannot be published.
  • This project is an independent open-source project and is not affiliated with or endorsed by IOGKF officially; it must not imply official approval.
  • Reiterating that there is no affiliation with IOGKF officially, this statement should be retained during use to avoid creating an impression of official endorsement.
View Original Text Basis

Permission is hereby granted, free of charge

Original License Text

**Hugo Extended v0.100.0+** ([Installation Guide](https://gohugo.io/installation/))

Original README

- **GitHub Account** for hosting (free)

Original README

> **📝 Note**: After creating your repository, remember to enable GitHub Pages in Settings → Pages → Source: "GitHub Actions" before your first deployment.

Original README

> **Note**: This is an independent open-source project and is not officially affiliated with or endorsed by IOGKF.

Original README

_This template is an independent open-source project created to help IOGKF dojos worldwide maintain professional websites while preserving the traditional values of Goju-Ryu Karate. Not officially affiliated with IOGKF._

Original README
https://github.com/karate-dojo/IOGKF_website_template/blob/main/LICENSEhttps://github.com/karate-dojo/IOGKF_website_template/blob/main/README.md

Compiled by DeepSeek based on repository license and README ·2026-10-04. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.

Project checks & description sources

Template Information

Source platforms
GitHub
Documentation and maintenance reference score
More documented · 80 / 100
Technologies
HTML
Website type
Starter
How this score is calculated

Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.

What to verify for this project

Repository update recorded
2026-10-04
Screenshot last checked
2026-10-04

A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.

The catalog identifies HTML as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.

Use a selection guide →

How this description was prepared

AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.

Review declaration: [email protected] · 2026-10-05

Inspect the recorded source material

SHA-256: b0b379e21e92fc1f180f33aa1458c01394eea3ac667e0e1e8bac7784b98e5699

2026-10-04T23:08:20.497Z

Source file / repository
# IOGKF Dojo Website Template

A modern, static website template for Goju-Ryu Karate dojos affiliated with the International Okinawan Goju-Ryu Karate-do Federation (IOGKF). Create a professional, mobile-responsive website for your dojo with minimal technical knowledge required.

> **Note**: This is an independent open-source project and is not officially affiliated with or endorsed by IOGKF.

## 🥋 Overview

This template provides a unified, professional web presence for IOGKF dojos worldwide while allowing complete customization of your dojo's specific information. Built with Hugo static site generator and featuring clean, traditional styling appropriate for martial arts organizations.

### Key Features

- ✅ **Easy Configuration** - Manage content through simple YAML files
- ✅ **Multi-language Support** - English and Portuguese included, extensible
- ✅ **Mobile Responsive** - Looks great on all devices
- ✅ **Fast & Secure** - Static site generation for optimal performance
- ✅ **Free Hosting** - Deploy to GitHub Pages at no cost
- ✅ **Professional Design** - Clean, traditional aesthetic for martial arts
- ✅ **IOGKF Branding** - Unified association identity with custom dojo details

## 🚀 Quick Start

### For Dojo Owners (Simplest Setup)

**Want your dojo website live in 15 minutes?** Perfect for dojo owners who just want to get online quickly with basic information.

👉 **[🥋 Dojo Owner's Quick Start Guide](docs/QUICK_START.md)** - Step-by-step for non-technical users

### For Developers

[![Deploy to GitHub Pages](https://img.shields.io/badge/Deploy%20to-GitHub%20Pages-blue?style=for-the-badge&logo=github)](https://github.com/karate-dojo/IOGKF_website_template/generate)

> **📝 Note**: After creating your repository, remember to enable GitHub Pages in Settings → Pages → Source: "GitHub Actions" before your first deployment.

**[📖 Complete Setup Guide](docs/SETUP.md)** - Local development and advanced configuration

## 📋 Prerequisites

- **Hugo Extended v0.100.0+** ([Installation Guide](https://gohugo.io/installation/))
- **GitHub Account** for hosting (free)
- Basic text editing skills for YAML configuration

_Verify Hugo installation: `hugo version` (must show "extended")_

## ⚙️ Configuration

All website content is managed through YAML configuration files. No HTML or technical knowledge required!

### Essential Files

| File                       | Purpose                                 |
| -------------------------- | --------------------------------------- |
| `data/en/dojo.yaml`        | Basic dojo information, contact details |
| `data/en/instructors.yaml` | Instructor names, ranks, photos         |
| `data/en/schedule.yaml`    | Class schedule and timetables           |
| `data/social.yaml`         | Social media links and handles          |
| `static/images/logo.png`   | Your dojo logo                          |

**📖 Complete reference:** [Configuration Guide](docs/CONFIGURATION.md)

## 🌍 Multi-language Support

The template includes English and Portuguese translations. To add more languages or customize translations, see [� Language Configuration](docs/LANGUAGE_CONFIGURATION.md)

## 📚 Documentation

### Getting Started

- [🥋 **Dojo Owner's Quick Start**](docs/QUICK_START.md) - **15-minute setup for dojo owners**
- [📖 Complete Setup Guide](docs/SETUP.md) - Advanced setup and local development
- [⚙️ Configuration Reference](docs/CONFIGURATION.md) - All YAML files explained
- [📊 Analytics Setup](docs/ANALYTICS.md) - Optional GA4 setup, consent behavior, and privacy responsibilities
- [SEO Configuration](docs/SEO.md) - Language-specific page titles and descriptions

### Customization & Advanced Topics

- [🎨 Customization Guide](docs/CUSTOMIZATION.md) - Layout, styling, and advanced features
- [📷 Images Guide](docs/IMAGES.md) - Photo requirements and upload
- [🚀 Deployment Guide](docs/DEPLOYMENT.md) - GitHub Pages setup and custom domains
- [📱 Social Media Setup](docs/SOCIAL_MEDIA.md) - Connect your social accounts

### Support & Troubleshooting

- [🔧 Troubleshooting](docs/TROUBLESHOOTING.md) - Common issues and solutions
- [⚠️ Error Handling](docs/ERROR_HANDLING.md) - Template error recovery
- [🌐 Language Configuration](docs/LANGUAGE_CONFIGURATION.md) - Adding new languages

## 🤝 Contributing

This is an open-source project created to help IOGKF dojos worldwide. Contributions are welcome!

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

## 📄 License

MIT License - see [LICENSE](LICENSE) file for details.

## 🥋 About IOGKF

The International Okinawan Goju-Ryu Karate-do Federation (IOGKF) is the official worldwide organization for traditional Okinawan Goju-Ryu Karate, founded by Morio Higaonna Sensei.

- **Website**: [IOGKF.com](https://iogkf.com)

## 🆘 Support

- **Template Issues**: [GitHub Issues](https://github.com/gabrielpedepera/IOGKF_dojo_website_template/issues)

---

_This template is an independent open-source project created to help IOGKF dojos worldwide maintain professional websites while preserving the traditional values of Goju-Ryu Karate. Not officially affiliated with IOGKF._

## 🏆 Example Sites

_Add your dojo site here by submitting a pull request!_

---

**Made with ❤️ by Gabriel Pereira for the Goju-Ryu community**
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.