Adding your first chapter

In this section, we will add content to your lab. We will be starting out simple, as there are a couple of concepts to learn. If you're following the Getting Started guide, we should currently have a skeleton lab configured.

Concepts we will learn about in this section:

• Markdown

• Chapter

• Page

• Tab

Adding content to your lab

Now that we have a skeleton lab defined, let's add some content to it. First we will add some markdown, and then insert it into the first page. The markdown will later get displayed in the instructions column we added in the previous chapter.

Adding markdown content

1. create a markdown file with the content you want to add to the first page. Add the markdown inside the instructions directory. Let's call it page.md. (instructions/page.md)

(improve content to showcase what markdown is capable of, not too complex)

# My first page

This is an example

Adding a page to your lab

Create a page resource

In pages.hcl add a page resource, and set the file path to the page.md file we just created.

resource "page" "first" {
  file = "instructions/page.md"
}

(make text consistent) You can find the full list of options and how to configure pages in the docs.

Add a chapter to the lab with your new page

In main.hcl, find the lab you've defined. In this resource, let's add our content.

resource "lab" "main" {
  ...
  content {
    chapter "introduction" {
      title = "Introduction"

      page "first" {
        reference = resource.page.first
      }
    }
  }
}

For more information on configuring content, see the lab/content reference page.

Displaying and marking your instructions in the lab

To display your instructions we just created, we should specify where we want to display it. Inside main.hcl, locate the lab resource. Mark the panel to the column we specified in the layout. If you have multiple columns defined, you can select which one you want to mark as your main instructional content.

resource "lab" "main" {
  ...
  layout "single_layout" {
    instructions {
      panel = "main"
    }
  }
}

Preview your changes

(Guide, and screenshot of how our lab looks at this stage.)