raspberrypilearning · ninaszymor · Jul 9, 2020 · Jul 9, 2020 · Jul 15, 2020 · Jul 15, 2020
diff --git a/af-ZA/images/banner.png b/af-ZA/images/banner.png
diff --git a/af-ZA/images/idle3.png b/af-ZA/images/idle3.png
diff --git a/af-ZA/images/story1.png b/af-ZA/images/story1.png
diff --git a/af-ZA/images/story2.png b/af-ZA/images/story2.png
diff --git a/af-ZA/images/story3.png b/af-ZA/images/story3.png
diff --git a/af-ZA/images/story4.png b/af-ZA/images/story4.png
diff --git a/af-ZA/images/story7.png b/af-ZA/images/story7.png
diff --git a/af-ZA/images/story8.png b/af-ZA/images/story8.png
diff --git a/af-ZA/images/story9.png b/af-ZA/images/story9.png
diff --git a/af-ZA/images/temp.md b/af-ZA/images/temp.md
diff --git a/af-ZA/meta.yml b/af-ZA/meta.yml
@@ -0,0 +1,38 @@
+---
+title: Story time
+hero_image: images/banner.png
+description: Create interactive fairy tales and other stories with basic Python
+original_url: https://raspberrypi.org/learning/storytime
+theme: yellow
+duration: 1
+listed: true
+ingredient: false
+copyedit: true
+curriculum: 2, design-0, programming-2, phys-comp-0, manufacture-0, community-0
+interests: ''
+technologies: raspberry-pi, electronic-components, python
+site_areas: projects
+hardware: raspberry-pi, electronic-components
+software: python
+version: 3
+last_tested: 2017-01-01
+steps:
+  - 
+    title: Introduction
+    completion: engaged
+  - 
+    title: Make your story interactive
+  - 
+    title: Big or small, old or young
+  - 
+    title: Lists of details
+  - 
+    title: Choose your story details
+    completion: internal
+  - 
+    title: Tell your story
+  - 
+    title: 'Challenge: add more details'
+    challenge: true
+  - 
+    title: What next?
diff --git a/af-ZA/resources/storytime.py b/af-ZA/resources/storytime.py
@@ -0,0 +1 @@
+from random import choice
diff --git a/af-ZA/solutions/storytime-complete.py b/af-ZA/solutions/storytime-complete.py
@@ -0,0 +1,31 @@
+from random import choice
+
+print("We are going to hear a story about a dragon!")
+name = input("What is the name of the dragon? ")
+print("Excellent, the dragon is called " + name)
+size = input("Is the dragon big or small? ")
+print("It was a " + size + " dragon")
+age = input("How old is the dragon? ")
+print("The dragon is " + age + " years old")
+
+print("")
+print("")
+
+if int(age) > 1000:
+    description = "old"
+else:
+    description = "young"
+
+things = ["slay", "cakes", "chocolate", "rocks", "kittens"]
+friends = ["Lila", "Naomi", "Noelle", "Idris", "Jonah", "Ari"]
+actions = ["slay", "kiss", "save", "marry", "rescue", "eat"]
+places = ["Middle Earth", "Narnia", "Hogwarts", "Alderaan"]
+
+friend = choice(friends)
+thing = choice(things)
+action = choice(actions)
+place = choice(places)
+
+story = "Once upon a time, there was a dragon called " + name + ". The dragon was a very " + description + " creature, and it was very " + size + ". It liked nothing better than to " +  action + " " + thing + ". Sadly, the dragon was so great at this that it ran out of " + thing + " to " + action + " in " + place + ". The dragon became very bored. Luckily the dragon had a friend called " + friend + ". " + friend + " knew where the dragon could find lots of " + thing + " and the two of them travelled far away from " + place + " and found a land filled with lots of lovely " + thing + " to " + action + ". " + name + " and " + friend + " lived happily ever, with all the " + thing + " they wanted."
+
+print(story)
diff --git a/af-ZA/step_1.md b/af-ZA/step_1.md
@@ -0,0 +1,63 @@
+## Introduction
+
+## What you will make
+
+You will use Python to create a program that generates a random story, based on what the user types in.
+
+\--- no-print \---
+
+Type in the name of your dragon to begin the story. <iframe src="https://trinket.io/embed/python/904db1ae15?outputOnly=true&runOption=console&start=result&showInstructions=true" width="100%" height="600" frameborder="0" marginwidth="0" marginheight="0" allowfullscreen mark="crwd-mark"></iframe> 
+
+\--- /no-print \---
+
+\--- print-only \---
+
+![complete project](images/storytime-final.png)
+
+\--- /print-only \---
+
+## \--- collapse \---
+
+## title: What you will need
+
+### Hardware
+
+- A computer that is connected to the internet
+
+OR
+
+- A computer that runs Python 3
+
+### Software
+
+- [Python 3](https://www.python.org/downloads/){:target="_blank"}, or [Trinket online](https://trinket.io/){:target="_blank"}
+
+### Downloads
+
+Find [the starter project here](https://trinket.io/python/a0aaa62eab){:target="_blank"}.
+
+\--- /collapse \---
+
+## \--- collapse \---
+
+## title: What you will learn
+
+- How to receive user input in Python
+- Why and when you need to convert strings to integers
+- How to use Python code to select random items from a list
+
+\--- /collapse \---
+
+## \--- collapse \---
+
+## title: Additional information for educators
+
+\--- no-print \---
+
+If you need to print this project, please use the [printer-friendly version](https://projects.raspberrypi.org/en/projects/storytime/print){:target="_blank"}.
+
+\--- /no-print \---
+
+You can [find the solution for this project here](https://rpf.io/p/en/storytime){:target="_blank"}.
+
+\--- /collapse \---
diff --git a/af-ZA/step_10.md b/af-ZA/step_10.md
@@ -0,0 +1,15 @@
+## The Final Print
+
+There is one last line of code you need to write in order for the final randomly generated story to appear on the screen. It was the first Python code you learned in step 1: the print function!
+
+- To print your final story, type:
+
+    ```python
+    print(story)    
+    ```
+
+    ![](images/story9.png)
+
+2. You may find that your program does not run first time, most likely due to a typing error. Don't worry; this happens a lot in computer programming. Working out where the error or bug is and fixing it is called **debugging**.
+
+    When your program does work, you may find that there are spaces missing between the words in the story, or that it is not quite displaying correctly. You can see this in the image above, where a space needs to be added between the words "wizard" and "to". You can simply locate the error, fix it, save the file and run it again.
diff --git a/af-ZA/step_11.md b/af-ZA/step_11.md
@@ -0,0 +1,5 @@
+## What next?
+
+- Can you create another story using the same techniques?
+- Can you connect an LCD screen to your Raspberry Pi GPIO pins to display the story?
+- Can you think of a way to add even more randomisation to your story?
diff --git a/af-ZA/step_2.md b/af-ZA/step_2.md
@@ -0,0 +1,59 @@
+## Make your story interactive
+
+\--- task \---
+
+Open the starter project.
+
+**Online**: open the Trinket starter project at [rpf.io/storytimeon](https://rpf.io/storytimeon){:target="_blank"}.
+
+**Offline**: download the [starter project](https://rpf.io/p/en/storytime-go){:target="_blank"} and open it in a text editor
+
+If you need to download and install Python, download it from [rpf.io/pythonoff](https://rpf.io/pythonoff){:target="_blank"}.
+
+In the starter project, you should see a single line of code:
+
+```python
+from random import choice
+```
+
+\--- /task \---
+
+The purpose of the story time program is to generate a story, and print the story to the screen so that you can read it. So first, learn how to use the Python `print` function.
+
+\--- task \---
+
+In your `storytime.py` file, type the following code on a new line:
+
+```python
+print("We are going to hear a story about a dragon!")
+``` <iframe src="https://trinket.io/embed/python/3b593eb9e4" width="100%" height="600" frameborder="0" marginwidth="0" marginheight="0" allowfullscreen mark="crwd-mark"></iframe> 
+
+\--- /task \---
+
+\--- task \---
+
+Run the program to see what happens. You should see the words “We are going to hear a story about a dragon!” appear in the output display.
+
+\--- /task \---
+
+Now that you can print to the screen, you're ready to ask the user for input, to learn more about the dragon.
+
+\--- task \---
+
+Create a new variable called `name`. Use the `input` function to ask the user for the dragon's name. Store the input name in the new `name` variable. <iframe src="https://trinket.io/embed/python/0de60dee6d" width="100%" height="600" frameborder="0" marginwidth="0" marginheight="0" allowfullscreen mark="crwd-mark"></iframe> 
+
+\--- /task \---
+
+\--- task \---
+
+Run your code again to test whether the program asks for input.
+
+\--- /task \---
+
+Now that you have the name of the dragon, use the `name` variable to print the name to the screen. In Python, you can use the `+` operator to join strings together.
+
+\--- task \---
+
+Add another line of code to print the name of the dragon to the screen. Then run your code. <iframe src="https://trinket.io/embed/python/e651eca8ca" width="100%" height="600" frameborder="0" marginwidth="0" marginheight="0" allowfullscreen mark="crwd-mark"></iframe> 
+
+\--- /task \---
diff --git a/af-ZA/step_3.md b/af-ZA/step_3.md
@@ -0,0 +1,47 @@
+## Big or small, old or young
+
+It's time to get some more information about the dragon.
+
+\--- task \---
+
+Add `input` and `print` functions to find out:
+
+1. Whether the dragon is **big** or **small**
+2. How old the dragon is
+
+\--- hints \--- \--- hint \---
+
+Use `input` to ask if the dragon is big or small. Then, use a `print` function to tell the user the size of the dragon.
+
+\--- /hint \--- \--- hint \---
+
+Here is some code that asks for the dragon's size and then print it.
+
+```python
+size = input("Is the dragon big or small? ")
+print("It was a " + size + " dragon")
+```
+
+Now do the same for the dragon's age.
+
+\--- /hint \--- \--- hint \---
+
+Here's the full code that you need to ask for the dragon's size and age. <iframe src="https://trinket.io/embed/python/3f9399e144" width="100%" height="600" frameborder="0" marginwidth="0" marginheight="0" allowfullscreen mark="crwd-mark"></iframe> 
+
+\--- /hint \--- \--- /hints \--- \--- /task \---
+
+Now that you know the age of the dragon, you can work out whether it is young or old. Dragons live for a long time, so they are only considered old if they are older than 1000.
+
+You can use **conditional selection** to work out whether the dragon is young or old. With the`if` and `else` statements, you can make decisions in your Python program. With the **greater than** operator (`>`), you can test whether a number is larger than another number.
+
+\--- task \---
+
+Add some code to work out whether the dragon is young or old. You need to **type cast** the `age` variable so that the computer knows it is a **number** and not a **character string**. This is important because for the Python language, there is a big difference between the **characters** `1` `0` `0` and the **number** `100`. <iframe src="https://trinket.io/embed/python/a3e3d4568c" width="100%" height="600" frameborder="0" marginwidth="0" marginheight="0" allowfullscreen mark="crwd-mark"></iframe> 
+
+\--- /task \---
+
+\--- task \---
+
+Add another `print` statement to tell the user whether the dragon is young or old. Then add two more `print` statements to create a break before the story begins. <iframe src="https://trinket.io/embed/python/c747445ac5" width="100%" height="600" frameborder="0" marginwidth="0" marginheight="0" allowfullscreen mark="crwd-mark"></iframe> 
+
+\--- /task \---
diff --git a/af-ZA/step_4.md b/af-ZA/step_4.md
@@ -0,0 +1,45 @@
+## Lists of details
+
+Your story time program will generate a lot of the story at random. That's part of the fun! You need to create some lists to store different and funny words that the final program can choose random items from for the story.
+
+Lists can be named in the same way as variables. For example, to create a list called `numbers` with four items in it, you could use the line `numbers = ["zero", "one", "two", "three"]`.
+
+\--- task \---
+
+Underneath the last line of code in your program, leave a line blank and then create a list of things that the dragon can interact with. Either use the same list that is shown here, or add different items to the list. <iframe src="https://trinket.io/embed/python/234f6ed347" width="100%" height="600" frameborder="0" marginwidth="0" marginheight="0" allowfullscreen mark="crwd-mark"></iframe> 
+
+\--- /task \---
+
+Now you need some more lists:
+
+- A list for the names of the dragon's `friends`
+- A list for `actions` such as "kiss", "throw", and "steal"
+- A list for `places` such as "Middle Earth" and "Narnia"
+
+\--- task \---
+
+Make three more lists that have the names `friends`, `actions`, and `places`.
+
+\--- hints \--- \--- hint \---
+
+To make the lists, you need to give each list a name.
+
+```python
+friends = []
+actions = []
+places  = []
+```
+
+\--- /hint \--- \--- hint \---
+
+Add strings as list items to all the lists, such as these strings for `friends`.
+
+```python
+friends = ["Lila", "Naomi", "Noelle", "Idris", "Jonah", "Ari"]
+```
+
+\--- /hint \--- \--- hint \---
+
+Here is what your completed code should look like: <iframe src="https://trinket.io/embed/python/5e264dd3e2" width="100%" height="600" frameborder="0" marginwidth="0" marginheight="0" allowfullscreen mark="crwd-mark"></iframe> 
+
+\--- /hint \--- \--- /hints \--- \--- /task \---
diff --git a/af-ZA/step_5.md b/af-ZA/step_5.md
@@ -0,0 +1,21 @@
+## Choose your story details
+
+Now that you have lists of actions, places, things, and friends, write some code that randomly picks one item from each list. This will help generate your story, and should make it quirky!
+
+\--- task \---
+
+Add in another line of code to create a variable called `friend`. Then assign the new variable a random item from the `friends` list. <iframe src="https://trinket.io/embed/python/b3668ceb66" width="100%" height="600" frameborder="0" marginwidth="0" marginheight="0" allowfullscreen mark="crwd-mark"></iframe> 
+
+\--- /task \---
+
+\--- task \---
+
+Now use the `friend` variable in a `print` function. Each time you run the code, the variable should be randomly assigned a new item from the `friends` list. <iframe src="https://trinket.io/embed/python/cf0dfd81da" width="100%" height="600" frameborder="0" marginwidth="0" marginheight="0" allowfullscreen mark="crwd-mark"></iframe> 
+
+\--- /task \---
+
+\--- task \---
+
+Create three more variables called `action`, `place`, and `thing`. Assign them random items from the `actions`, `places`, and `things` lists. <iframe src="https://trinket.io/embed/python/e6410121dd" width="100%" height="600" frameborder="0" marginwidth="0" marginheight="0" allowfullscreen mark="crwd-mark"></iframe> 
+
+\--- /task \---
diff --git a/af-ZA/step_6.md b/af-ZA/step_6.md
@@ -0,0 +1,19 @@
+## Tell your story
+
+Now you can have some fun with creating your story! Be as imaginative and creative as you like.
+
+Write this part of the program all on one line.
+
+\--- task \---
+
+First, type `story =` to create a variable to store your story in.
+
+\--- /task \---
+
+Now use all the variables you have to make an imaginative story of your own. There is an example provided below, but you can make any story you like.
+
+\--- task \---
+
+Write your story putting the variables together. Then on the last line of your program, print the story to the screen. <iframe src="https://trinket.io/embed/python/904db1ae15" width="100%" height="600" frameborder="0" marginwidth="0" marginheight="0" allowfullscreen mark="crwd-mark"></iframe> 
+
+\--- /task \---
diff --git a/af-ZA/step_7.md b/af-ZA/step_7.md
@@ -0,0 +1,7 @@
+## Challenge: add more details
+
+Make your story even more interesting by adding some more lists with items that your program can pick from.
+
+For example, you could create a list of `enemies` or `heroes`. Or give the dragon more detail: you could create a list called `colours` that decides what colour skin the dragon's scales are, or a list called `breath` that determines whether the dragon breathes fire, steam, or frost.
+
+Your story can be as long as you like, and the only limit is your imagination!
diff --git a/af-ZA/step_8.md b/af-ZA/step_8.md
@@ -0,0 +1,5 @@
+## What next?
+
+We have lots of Python projects for you to try. Go choose one of [these Python projects](https://projects.raspberrypi.org/en/projects?software%5B%5D=python&curriculum%5B%5D=%201){:target="_blank"} now!
+
+You could also recreate your story in Scratch, and add some graphics and animations to it.