
# 1.1: Minicourse Skills Page - Headings, TOC, Elements (Example, Exercise, Theorem, Definition, etc.) and Figures/Images


## Editing LibreTexts Pages

### Creating a Table of Contents for a Page

A LibreTexts page with headings can have a table of contents (TOC) of its own, showing a clickable list of its subheading hierarchy.  In order to have a meaningful TOC, you will need to have at least a couple headings on the page (like those just above this paragraph).

Exercise 1: If it is not already visible, we can turn it on.

1. First open the Page Settings by clicking on the + Page Settings bar (a gray bar) near the upper-left side of the page.
2. Change the option for Show Page TOC to yes.
3. Close the Page Settings by clicking on the top of the Page Settings window again.
4. Now reload the page to see the effect of this new setting.

Exercise 2: Explore the TOC by clicking on various subheadings.  The browser should take you to the appropriate part of this page.

Exercise 3: Note that we can add a new subheading to this TOC by creating a new heading anywhere in the document.

Let's create a new subheading here.  Click the Edit button on the black control bar near the top of the page. Type, "Creating a New Subheading" at the beginning of this paragraph, and then press "enter" (If you don't press enter then this entire paragraph will become the heading).  Now place your cursor anywhere on the phrase and use the Paragraph Format option in the light blue menu bar above (probably currently marked "Normal") to select Heading 3 (since we have already used Heading 1 for the top page heading and Heading 2 for the current page subsection).

Now click Save.  The TOC in the upper-right corner of the page should now show another subheading for this first section.

### Adding Elements to a Page Using the Provided Templates

In this section, we'll add Notes, Definitions, Examples, Exercises and Theorems.  See examples for some of these below.

Note

A Note has a built-in heading "Note" and is meant to set off an important or useful statement.

Definition: Key Word

A Key Word is a word with special significance in this topic.

Example $$\PageIndex{1}$$

In an example, an index is automatically added, but you have to update these numbers to match those already on the page.  Since the title of this LibreTexts page begins with "1.1:", LibreTexts knows to insert this section number before the index number when displaying this page in normal (not Edit) mode.

Note that the code for a page index is $$\PageIndex{1}$$.

Solution

Exercise 4: Now let's add an Exercise and a Theorem.  First we will need to click the Edit button at the very top of the page on the black control bar.

Next, select the Templates option from the Elements menu on the LibreText page editing menu bar (at the top of the page immediately above the light blue bar with the Format option in it we used in Exercise 3. When you are in edit mode, these two menu lines are always positioned at the top of the visible page).  There are a lot of options there. Left click on the down-ward pointing chevron to see them all.

To get a Note like that above, you would select: Template:BoxNote.

To get an Example like that above, you would select: Template:BoxExample.

To add an Exercise, just below this line, place your cursor there, navigate to the Elements menu, select Template:BoxExercise, and then click on the Insert Template button.

Place Exercise here:

Similarly, to add a Theorem, place your cursor below the "Place Theorem here:" line below, navigate to the Elements menu, select Template:BoxTheorem, and then click on the Insert Template button.

Place Theorem here:

Note that, by default, exercises and theorems also provide a page index for you to update.

### Adding an Image (not a Figure)

Here is an image element without a caption (not a Figure).  We might choose this option if the image is meant to accompany an exercise in an exercise section, for example.

Right click on this image and select Image Properties to see the options we can adjust. One important option you will want to be sure to fill in meaningfully is the alt text.  This will make the image accessible to readers with visual impairment. Another option you may wish to adjust is the alignment of the image.

Exercise 5: Now let's add a new image.

1. To add an image to a page (and not a captioned Figure), we don't use the Templates menu.  Instead we can just click the Image option on the Elements menu (or just click the image icon just to the right of the hyperlink icon in the editing menu for the page).

If the image is already attached to the page (using the Attach a file button at the bottom of the page), we can just select it from the Browse tab.  If it is an image on your computer, click the Attach files tab. Note that images already attached to this page are listed here as well and could be selected on this tab. Note also that some additional images have been provided in another page (named "Some Images for Practice") of this book and could be selected on the Browse menu for this exercise.

2. Either attach a new image from your computer or select one of the images already listed here.

Another option if you are creating your own images, say from Paint, you can save the image as a .png file on your computer. Then open the folder where this file has been saved, left click on the name of the image,  and drag-and-drop it to the location you want it to be in your LibreText file. If it doesn't land exactly where you want it you can move it around later.

Place Image here:

1. Now we will need to update the alt text, if it is not already meaningful, and the size of the image may need to be adjusted.  The Medium size may be helpful on some of these, or you may need to use the Custom option to size it appropriately on the page.

### Adding a Figure (with a Caption)

Below is an example of an ordinary Figure with a caption.  This should be the default way most images are placed in the exposition of a text.

Exercise 6: Now let's add a new Figure.

1. To add a new Figure, select the Template:AddFigureCenterCenter template from the Templates in the Elements menu.  Note that there are a few other Figure templates to choose from.  These either place the figure on the right side of the screen or allow for multiple figures to be placed side-by-side (with one or multiple captions), following the steps we used above.

2. The other thing you will need to do is update the caption so that it meaningfully describes the figure.

### Adding a Table (with a Caption)

Another element that can be put into a document is responsive table.  This can be done by choosing the Table option from the Elements menu and indicating the number or rows and columns you need (this can always be changed later). If you right click on the table and select table properties you can choose to add a caption or a header to the table. It is desirable that tables are responsive so that they can be appropriately viewed, regardless of the device being used. You can observe this responsiveness by reducing the width of this window.

Number of Courses Offered Per Academic year
Spring Semester Summer Session Fall Semester Total
2017-2018 359 107 275 741
2018-2019 244 101 255 600

Exercise 7: Add a new table in the space below.