Writing lessons
An online course is made of modules, and each module holds lessons. Your members open them in their member space. This page is about writing one lesson. To use online courses, switch on the Online Courses plugin first (see Plugins).
The lesson’s settings
Section titled “The lesson’s settings”Open a course, choose a lesson on the left (or Add lesson under a module), and the lesson opens beside it. From the top:
-
Title: what members see in the course’s lesson list.
-
Members see: whether members can open the lesson.
- Shown: members can read it.
- Coming soon: members see the title and a short message of yours (for example “Available in November”), but not the content.
- Hidden: members don’t see the lesson at all.
Whatever you choose, the content is kept, so you can write a lesson in advance and show it later.
-
Featured media: one video or audio at the top of the lesson. A video is always a link (YouTube, Vimeo or a web address), never an uploaded file. An audio can be a link or a file you upload.
-
Badge: an optional small picture beside the lesson’s title, such as a belt. It shows in the lesson, in the course’s lesson list and in the PDF book. Dark mode file adds a second file for a drawing with dark lines.
-
Attachments: files members can download, such as a PDF handout or an image. In the PDF book, a picture attachment is printed at the end of the lesson, with its file name under it; other files, such as a PDF or an audio, are listed for members to download online.
-
Content: the lesson’s text, written in the editor described below.
When you change anything, a bar appears at the bottom of the page with Save and Discard. Nothing is saved until you press Save, and Discard puts the lesson back the way it was. Preview this lesson, next to Content, opens the saved lesson the way your members see it.
The text
Section titled “The text”The editor works like a word processor. Use the toolbar, or type / at the start of a line to pick from a menu:
- Headings: Heading 1, 2 and 3. A Heading 2 starts a numbered section. Members can jump between sections from Contents at the top of the lesson.
- Lists: bullet lists, numbered lists and to-do lists.
- Images: an image on its own line is shown as a figure, with its description as the caption. PNG, JPEG, WebP, GIF and SVG work; an SVG is cleaned when it is uploaded. Click a picture to get its bar:
- S, M, L: small, medium or full width.
- The three alignment buttons: left, centre or right.
- The two side buttons: beside the text, on the left or on the right. On a phone it goes above the text.
- The caption button: hides the caption. The description is still read out by screen readers.
- The frame button: makes the picture plain, with no frame or background, for a symbol.
- The moon: adds a second file for dark mode, or removes it.
- Alignment: the four alignment buttons in the toolbar set the paragraph or heading the cursor is in to left, centered, right or justified. Left is the default. Members see it in the lesson and in the PDF book.
- Links, quotes, tables and code. A link can go to a web page, or, with Lesson in the link window, to another lesson of the course and one of its sections. Members open it in place, and in the PDF book it jumps to that page. With Term, it goes to one of the course’s terms: members tap it to read the term’s explanation.
Blocks
Section titled “Blocks”These blocks give a lesson its shape. You find them first in the toolbar and in the / menu.
| Block | What it is |
|---|---|
| Card | A plain box around some content. Use one to set something apart, such as a list of techniques. A heading at the top of a card becomes its title. |
| Callout | A tinted box for something to notice. Choose its kind at the top of the box: Note, Tip or Warning. |
| Grid | Two or three columns side by side. Each column can hold anything: text, a card, a callout. Use 2 columns / 3 columns to change the layout, and Add column for another one. On a phone the columns are shown one under another. |
| Timeline | Steps in order down a vertical line, for anything done in a sequence. Each step can hold anything, a card included. Its marker is a dot, a short label you type above it (such as “1” or “Part A”), an icon you pick with the icon button beside the label, a picture of your own (an SVG or PNG, such as a belt) uploaded with the picture button next to it, or an icon or picture and a label together. A picture can have a second file for dark mode (the moon button). Use Add step for another one. |
| Show/hide answers | A button that hides or shows the answers of every question in the lesson at once, for testing yourself: hide them, try to recall each answer, then check. Answers start shown; in a lesson without questions it doesn’t appear, and the PDF book leaves it out. |
| Question | A question and its answer. Members can hide the answers to test themselves, and show them again. |
| Term explanation | One of the course’s terms, its explanation shown as text. Pick the term on the chip; the chip’s link button turns it into a link to the term. |
| Terms list | A list of the course’s terms with their explanations: all of them, one group, or the ones linked in this lesson, A to Z or in order of appearance, shown as a list or as a two-column table. See Terms. |
Card and Callout wrap the line you are on, so a paragraph you already wrote can become a card or a callout.
To put cards side by side, add a Grid and then a Card in each column.
What members see
Section titled “What members see”Members see a lesson exactly as you write it: a heading stays a heading, a list stays a list, and boxes appear only where you put a block.
At the top of the lesson, under its title, members see one line: the reading time, how many questions it has with a Hide answers / Show all answers switch, and Contents when the lesson has two or more sections.
Writing a course outside Linyup
Section titled “Writing a course outside Linyup”You can also write a whole course as a folder of text files, in the same format as the editor’s blocks, and have it brought into Linyup. See Course text format.