template/book/exercises/007.md
2025-02-24 18:11:28 +01:00

1.4 KiB

Exercise 7: File Structure (Markdown)

In this exercise you will learn how to structure your chapters.


More useful Markdown syntax is explained in the [MyST cheat sheet](https://jupyterbook.org/en/stable/reference/cheatsheet.html).

  1. Navigate to the file you want to work in (for example book/some_content/overview.md) and make sure you're in the correct branch.

  2. Let's create the structure of your chapter. You can start by adding a title to the section. The title is always defined in the first line of the file after the hashtag #. Then you can also add sections and subsections as needed.

# Chapter Title 
## Section Title 
### Subsection Title 
#### Heading 
##### Smaller Heading
###### Smallest Heading
  1. Add some text to the (sub)sections to complete your chapter.

  2. When you are ready, commit your changes to the repository by clicking on the green Commit changes button.

  3. Add a commit message.

  4. To see you changes, go to {octicon}play;1em Actions - The most recent workflow run overview.md / the commit message of the commit you just made - Wait for it to finish - In the summary, click on the link of your book shown in the table Branches deployed and under Primary book at root (getting bored of waiting? There'll be exercising on doing this locally which prevents you from waiting (user type 4))

  5. Do you see your change? If you don't see it click CTRL+F5/Control+F5to refresh the page.