An open API service indexing awesome lists of open source software.

https://github.com/cybersecsi/cybertrivia

Easily create a trivia board game from a generic YAML file.
https://github.com/cybersecsi/cybertrivia

cybersecurity game trivia

Last synced: 5 months ago
JSON representation

Easily create a trivia board game from a generic YAML file.

Awesome Lists containing this project

README

          




CyberTrivia



CyberTrivia

_CyberTrivia_ is a simple _React_ application to create a **trivia board game** from a generic _YAML_ file with the:

- questions
- answers
- points

## 📋 Table of Contents

- [📋 Table of Contents](#-table-of-contents)
- [⚡ YAML structure](#-yaml-structure)
- [â„šī¸ Usage](#â„šī¸-usage)
- [🔌 Creating a Trivia Game](#-creating-a-trivia-game)
- [🚧 Contributing](#-contributing)
- [📚 Credits](#-credits)
- [đŸĒĒ License](#-license)

## ⚡ YAML structure

The YAML file must have the following structure:

```yaml
:
- question:
-
-
-
- ...
answers:
-
-
- ...
points:

:
- question:
-
-
-
- ...
answers:
-
-
- ...
points:
```

Here is a description of these fields:

- **Category**: Represents the category of the trivia questions.
- **Question**: The trivia question itself.
- **Option**: Multiple options for the question (if applicable, leave blank otherwise).
- **Answer**: The correct answer(s) for the question.
- **Points**: The number of points awarded for answering the question correctly.

## â„šī¸ Usage

To use the "Cyber Trivia" application:

1. Clone the repository:

```bash
git clone https://github.com/cybersecsi/cybertrivia.git
```

2. Install the necessary dependencies:

```bash
yarn install
```

3. Start the application:

```bash
yarn dev
```

4. Access the application in your web browser at http://localhost:5173

### 🔌 Creating a Trivia Game

1. Prepare a YAML file following the structure mentioned above.
2. In the application, click on the "Nuova Partita" button.
3. Drag & Drop the YAML file.
4. Enjoy the game!

## 🚧 Contributing

Contributions are welcome! If you find any issues or have suggestions for improvements, please open an issue or submit a pull request.
When contributing to this repository, please follow the existing code style, conventions, and Git workflow.

## 📚 Credits

Developed by Angelo Delicato [@SecSI](https://secsi.io)

## đŸĒĒ License

This project is licensed under the [MIT License](https://github.com/cybersecsi/cybertrivia/blob/main/LICENSE).