"Planeten Entdecker” is an interactive website that was created in collaboration with students from the "PH Weingarten" and students from the "Hochschule der Medien". It aims to support teachers in preparing lessons and to offer pupils an exciting opportunity to explore the planetary system. The website provides customized learning materials and integrates playful elements, to promote understanding and interest in our solar system. With “Planeten Entdecker” the classroom becomes an interactive learning space where pupils can experience the planets up close.
For easy project setup, use Docker.
To run the "Planeten Entdecker" website locally using Docker Compose, follow these steps:
Ensure you have the following installed on your machine:
- Docker (version 20.x or higher)
- Docker Compose (if not included with Docker)
- Clone the Repository
First, clone the "Planeten Entdecker" repository to your local machine:
git clone https://github.com/schule4-0/planets.git
cd planets- Build Docker Image
If the Docker image needs to be built (usually only necessary if you haven't built the image before or if the Docker image needs updating), run:
docker-compose build- Start Docker Compose
Use Docker Compose to start the project. Make sure you are in the root directory of the project, and run the following command:
docker-compose up -d- Access the Website
Open your web browser and go to http://localhost:3000
A teacher's guide has been produced for the learning units, which can be found in the folder public/infos/Lehrerhandbuch.pdf
To adjust the texts in the JSON file, you can change the corresponding “text” fields within the “dialog” object. Here is a short guide:
The JSON files are located in the folder public/json/dialog
Within the “story” array you will find the “dialog” section. This contains a list of objects, each of which has a “speaker” and a “text”.
To change a text, search for the corresponding “text” field and adjust the value.
Example:
{
"speaker": "left",
"text": "Wer bist du denn?"
}To customize the responses in the JSON file, you can change the corresponding “answer” and “isCorrect” fields within the “dialog” object. Here is a short guide:
The JSON files are located in the folder public/json/dialog
Within the “story” array you will find the “question” section. This contains the possible answers, each of which has an “answer” and an “isCorrect”.
Change the “answer” and “isCorrect” fields accordingly.
Example:
{
"answer": "Wahr",
"isCorrect": false
},
{
"answer": "Falsch",
"isCorrect": true
}You can customize the “answer” texts and, if necessary, change the “isCorrect” values to false for an incorrect answer or true for a correct answer.
To adjust and customize the Planet profiles adapt the json properties. Here is a short guide:
The JSON file is located in the folder public/json
its “planet-profile.json”
Every Planet is its own Json object which looks like that :
Example:
"mercury": {
"header": "Merkur-Erkundung: Der kleine Planet",
"info": {
"Gas- oder Gesteinsplanet": "Gesteinsplanet",
"Alter": "Ca. 4.6 Milliarden Jahre (gleiches Alter wie das Sonnensystem)",
"Größe": "Durchmesser: Ca. 4.880 km",
"Temperatur": "",
"Tag": "bis zu 430 °C",
"Nacht": "bis zu -180 °C",
"Entfernung zur Sonne": "Ca. 57,9 Millionen km",
"Entfernung zur Erde": "Zwischen 77 und 222 Millionen km",
"Tagesdauer": "Ca. 58,6 Erdtage",
"Jahresdauer (Umlauf um die Sonne)": "Ca. 88 Erdtage",
"Besonderheit": "Merkur hat extreme Temperaturschwankungen zwischen Tag und Nacht und keine Atmosphäre, die diese Schwankungen ausgleichen könnte.",
"Monde": "Keine"
}
},Here we can adapt every Information about the planet. The Planet Name is the “header” is for the Planet Name.
To adjust and customize the Memory Game on Venus we can adjust 2 object “page” and “cards”. With the “page” object we can change “headline” and “content” of the whole page.
The “cards” object lets us edit every Memory card and add “keyword”, “src” for image path and “content”. Here is a short guide:
The JSON file is located in the folder public/json/minigame
its “memmory-venus.json”
The page has a headline and a content description. To customize these parts, just customize the text in the json
Example:
"page" : [
{
"headline": "Venus Entdeckungen: Ein Gedächtnisspiel",
"content" : "Decke abwechselnd zwei Karten auf und sammle Paare von passenden Bildern, um mehr über die Venus zu lernen."
}
]The cards have a "keyword" which acts as the ID for the cards and the alt text for the images.
Then "src" for the path to the image of the card.
And finally "content" as the descriptive text that is displayed when the right cardpair is found.
To customize these parts, just customize the card attributes in the json. Also add new or remove cards the same way.
Example:
"cards": [
{
"keyword": "atmosphere",
"src": "/images/memory/atmosphere.svg",
"content": "Die Atmosphäre der Venus besteht hauptsächlich aus Kohlendioxid und erzeugt einen starken Treibhauseffekt."
}
]The dictionary content is stored in a JSON file located here public/json/dictionary.json.
Each dictionary entry is an object with the following attributes:
- header: The title or term of the dictionary entry.
- info: The detailed description or explanation of the term.
- image: The path to an image that visually represents the term.
To Add a New Entry: Copy one of the existing entries and paste it within the "items" array. Change the "header", "info", and "image" fields to reflect the new term. To Edit an Existing Entry: Simply find the term you want to change and modify the "header", "info", or "image" fields as needed.
Example:
{
"header": "Erosion",
"info": "Erosion ist ein Prozess, bei dem Erde, Steine und andere Materialien von einem Ort zu einem anderen getragen werden. Das passiert oft durch Wasser, Wind oder Eis. Stell dir vor, wie der Wind Sand von einer Sandburg wegbläst oder wie Regen kleine Stückchen Erde von einem Hügel herunterspült.",
"image": "/images/erosion.jpg"
}Licensed under the GNU General Public License v3.0