.. _createatopic:

Creating a new topic
=====================

In this section, you will learn how to:

 * :ref:`Create a new topic <createtopic>`
 * :ref:`Create a new story <createstory>`
 * :ref:`Create a new chapter <createchapter>`
 * :ref:`Import an exploration in a chapter <importexploration>`

Watch this video to learn how to create a skill, or if you prefer reading the instructions instead, keep scrolling down.

.. raw:: html

   <iframe width="560" height="315" src="https://www.youtube.com/embed/-VBNUNTG8lQ" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

.. _createtopic:

Creating a new topic
----------------------

1. To create a new topic, click the |createtopic| button at the top of the **Topic and Skills Dashboard**.

.. |createtopic| image:: /images/create_topic_button.png
                 :scale: 35 %

2. Enter a name for the topic and click |createtop|. You will be taken to the **Topic Editor** screen, where you can give your topic a description.

.. |createtop| image:: /images/create_topic.png
               :scale: 40 %

.. figure:: /images/topic_editor.png
   :alt: Topic Editor Screen
   :scale: 30 %

   *Fig. 1*

3. To save a draft of the topic, click on |savechanges|. This will list the topic in the dashboard with a 'Not Published' status.

.. |savechanges| image:: /images/save_changes.png
                 :alt: Save Changes button
                 :scale: 40 %

4. To publish the topic, click the |publishtopic| button. This will list the topic in the dashboard with a 'Published' status.

.. |publishtopic| image:: /images/publish_topic.png
                  :alt: Publish Topic button
                  :scale: 40 %

5. To delete the topic, click the |trashcan| button to the right of the topic.

.. |trashcan| image:: /images/trashcan.png
              :alt: Delete skill button
              :scale: 40 %

.. figure:: /images/topic_creation.png
   :alt: New Topic created

   *Fig. 2*

.. _createstory:

Creating a new story
----------------------

1. To create a new story, click |createstory| from the **Topic Editor** screen.

.. |createstory| image:: /images/create_story_button.png
                 :scale: 35 %

2. Enter a title for the story and click |createstorybutton|. You will be taken to the editor screen, where you can give your story a description.

.. |createstorybutton| image:: /images/create_story.png
                       :scale: 40 %

.. figure:: /images/story_editor.png
   :alt: Story Editor screen
   :scale: 25 %

   *Fig. 3*


3. To save a draft of the story, click on |savechanges|. You can return back to the **Topic Editor** which will keep the story in a draft status.

4. To publish the story, click the |publishstory| button. This will list the story in the **Topic Editor** with a 'Published' status.

.. |publishstory| image:: /images/publish_story.png
                  :scale: 40 %

.. _createchapter:

Creating a new chapter
-----------------------

1. To create a new chapter for the story, click |createchapter| within the story editing screen.

.. |createchapter| image:: /images/create_chapter.png
                   :scale: 35 %

2. Enter a title for the chapter and click |createchapterbutton|.

.. |createchapterbutton| image:: /images/create_chapter_button.png
                         :scale: 40 %

.. _importexploration:

Importing an exploration
**************************

When you create a chapter, you will see the following fields:

 * **Chapter Outline**: Enter a description of what the lesson will entail. This will guide exploration creators when they create the lesson.
 * **Exploration ID**: Import a published exploration by :ref:`entering its ID <findid>`. You will not be able to publish the story or save changes to your chapter without completing this step.
 * **Prerequisite Skill IDs**: Select prerequisite skills for this lesson based on those identified in the :ref:`Skill Tree <skilltree>` by clicking |addprerequisite|.
 * **Acquired Skill IDs**:  Select acquired skills for this lesson based on those identified in the :ref:`Skill Tree <skilltree>` by clicking |addacquired|.
 * **New Chapter**: Click |addchapter| to create a new chapter for the story. As you create chapters, they are shown as a list on the left-hand side. Click on the new chapter here to import another exploration and select skills. Continue adding new chapters as needed for this story.

.. |addprerequisite| image:: /images/add_prerequisite_skill.png
                     :scale: 40 %

.. |addacquired| image:: /images/add_acquired_skill.png
                 :scale: 40 %

.. |addchapter| image:: /images/add_new_chapter.png
                :scale: 35 %

Finally, click |savechanges| and |publishstory| when done.

.. figure:: /images/creating_chapters.png
   :alt: Creating a new chapter
   :scale: 25 %

   *Fig. 4*