As discussed in the [https://.../t/help_create|Creating Templates Overview], text rows are the rows that are neither a variable nor equation. Text rows are created by typing text, just like in a word processor. PowerOne will treat anything without an equals sign as a text row.
In general PowerOne figures out what you meant as you type. The type indicated in the details display will list a row as unknown with its assumed type in parentheses. When you are done typing it will fix its type. This type can always be changed manually if desired.
Note that, unlike equations and variables which remove returns in their sections when saving, text rows retain returns and allow multi-row/multi-paragraph sections.
Formatting
Text rows can include typed text, lists, links, images, videos or a combination. Text can be marked as bold or italic, for instance, and it can have sections dedicated to headlines and footnotes.
While the notation for each is straight-forward and easily typed, many of these formats are also available by selecting [icon--app-more | extras button] then **Insert Formatting**)
Headlines & Footnotes
powerOne offers three types of headlines (Headline, Sub-headline 1, Sub-headline 2) and a footnote style. To create one, add exclamation marks at the beginning of a paragraph of text:
Any of these paragraph types can be used with or without text. If used without text then a colored bar is displayed.
You can also add an indention by using the ⇥ character after the exclamation marks. Select [icon--app-more | extras button] then **Insert Formatting** and the appropriate option for all of these. (Or just type them!)
Note that adding a \ before the first exclamation mark will cause the block format to be ignored.
Separators
A separator is a special kind of headline that is smaller in height and often used with or without text. To create one of these special paragraph blocks, add three dashes at the beginning of a paragraph of text:
<---Separator>
A separator can be displayed with or without text. If used without text then a colored bar is displayed.
You can also add an indention by using the ⇥ character after the exclamation marks. Select [icon--app-more | extras button] then **Insert Formatting** and the appropriate option for all of these. (Or just type them!)
Note that adding a \ before the first exclamation mark will cause the block format to be ignored.
An alternative to --- is to use !!!!! (five exclamation marks) at the beginning of the row instead. Same rules and options apply.
Bold, Italic and Highlights
Bold, italic and highlight options interact with the selected text by placing two of each special marker before and after the desired text. These styles can be combined as well:
<*\*Bold**>
<_\_Italic__>
<+\+Highlight++>
Note that adding a \ between the two markers will cause the style to be ignored.
Lists
You can include both unordered and ordered lists. For unordered, start each row with a dash:
<- Item 1>
<- Item 2>
<- Item 3>
For ordered lists, start each row with a pound and decimal point:
<#. Item 1>
<#. Item 2>
<#. Item 3>
Nested lists are not offered. Note that adding a \ before the - or # will cause the list marker to be ignored.
Links
Links are web addresses (urls) surrounded by brackets [ ]. Links can either be in the format:
<[url]>
<[url | description]>
In the first example, the url will be displayed as the description. In the second, a bar | separates the url from description. Any of the following url types can be used:
The last two take an email address or telephone number, respectively, and will interact with your email or telephone app.
Note: when referencing a help document or template provided by this web site it is recommended to form the url with an ellipse in place of power.one. For instance, to link to this help document use the following url:
Images
You can insert images into your templates. Images can be in the following formats:
<[url]>
<[url | alternative description]>
<[url width]>
<[url width | alternative description]>
The url is that associated with the image. Image urls must end in .png, .gif, .jpg, .jpeg or .svg.
The alternative description is used when the image can not be displayed. In addition, the alternative description is read outloud by screen readers, including Apple's VoiceOver technology, for the visually impaired.
Finally, width allows you to dictate the width (in pixels) of the image as displayed. To use this add the url then a space then the width itself as a number.
Hosting Images
There are many hosts available if you do not currently have a place to access the url for an image. For instance, all PowerOne help images are uploaded to and shared from [https://aws.amazon.com/s3 | Amazon S3]. This is a more sophisticated option than most might prefer and is not free.
Another, free option is [https://dropbox.com | Dropbox]. Move the file to a Dropbox synced folder then right mouse click to access the Dropbox Link. Paste into PowerOne and finally change **?dl=0** to **?raw=1**.
Another free option is [https://www.flickr.com | Flickr]. The photo sharing site will allow you to embed an image in PowerOne. Upload your image then, in the sharing dialog, select BBCode. Copy the url between [img] and [/img] into PowerOne.
Other services may be available as well.
Videos
powerOne support both Vimeo and YouTube videos in the form:
<[url]>
where url starts with https://vimeo.com, https://www.youtube.com, or https://youtu.be.
Icons
You can embed certain icons within your document that are used throughout powerOne. These are in one of the two following forms:
<[icon]>
<[icon | alternative description]>
icon options include:
- [icon--app-unknown-inverse | unknown or unsure variable] : icon--app-unknown-inverse
- [icon--app-equals-known | known variable] : icon--app-equals-known
The alternative description is used when the image can not be displayed. In addition, the alternative description is read outloud by screen readers, including Apple's VoiceOver technology, for the visually impaired.
Source Code
You can display rows of source code by using angle brackets at the beginning and end of a row:
<>
In between can either be text typed to look like source code or an actual row of source code. When typed as source code, anything can be typed between the two angle brackets and it will take on the look of a source code row.
To connect actual source code to the row, embed the desired row's alias within the angle brackets. Any changes to the actual source code will also update the text display of that source. Selecting a source code row that uses an alias will display that row's details.
Using Equals Signs in Text Rows
Any character available for typing into a word processor is applicable for a text row in PowerOne. However, equals signs are used to determine whether an unknown row is a variable or equation. There are two ways to use an equals sign in a text row.
First, change the type. Select the list below the editor and change it to **text**.
Alternatively, you can escape the equals sign by placing an apostrophe ('=) or back slant (\=) before the equals sign. When it saves, the apostrophe or back slant will be removed, leaving you with just the equals sign but one in which the row is interpreted correctly as a text row.
Text Details
Each row has additional details that can be set. Most of these details are available in the details view, available by selecting the **details** button just below the editor to see them. Type, however, is available all of the time. Equation options include:
- ++**Type**++: The row's type. Equation rows are listed as "text?" if the row is unknown or "text" if already fixed (returning to an existing text row). This option can be changed by selecting the pop-up list below the editor. It is also displayed in details but cannot be modified there.
- ++**Collapsible**++: Make this text section collapsible.
- ++**Hidden**++: Hides the row so it does not appear in the template. Very useful for writing comments intended only for the author.
- ++**Include when sharing results**++: By default all text rows visible in the template are not included when sharing results. Check this box to include text in these cases instead.
- ++**Comment**++: Add any comments desired here. These are for your eyes only and will not appear to the template user.
