Creating Text Paragraphs

Create a text paragraph with the <Paragraphtitle> icon.

Click the <Paragraphtitle> icon to create a text paragraph.
- If a paragraph is selected, the text paragraph is added below it. Otherwise, it is added at the bottom.
Drag the <Paragraphtitle> icon to where you want the text paragraph.

You can also create a text paragraph with keyboard shortcuts.

Ctrl + I, Ctrl + 1—If a paragraph is selected, the text paragraph is added below it. Otherwise, it is added at the bottom.
Ctrl + Alt + I, Ctrl + Alt + 1—If a paragraph is selected, the text paragraph is added above it. Otherwise, it is added at the top.

On Linux, use Alt + I instead of Ctrl + I. On Linux and macOS, use Alt + / instead of the Ctrl + Space shortcut used in this chapter.

Selecting a Text Paragraph Type

Before you write content in a text paragraph, select its type. For details about text paragraph types, see Writing Text Paragraphs.

Select the text paragraph type from the drop-down list at the lower right of the editing area, or press Ctrl + / and use the arrow keys.

Selecting a text paragraph type

While editing, you can also change the paragraph type directly with the following shortcuts: Ctrl + 0(Normal), Ctrl + 1 to Ctrl + 5(Heading 1 to Heading 5), Ctrl + 6(Code), Ctrl + 7(Ordered List), Ctrl + 8(Unordered List), Ctrl + 9(Note), and Ctrl + P(Proofreading).

In addition to the text paragraph types that ManualWorks provides, you can create text paragraph types with user styles. For details, see User Style Types.

Hiding Unneeded Text Paragraph Types

Use a Console to hide paragraph types that you do not use. For example, to stop using the “Epigraph” paragraph, run the following command.

disable-element-type -type epigraph

To use the Epigraph paragraph again, run the following command.

enable-element-type -type epigraph

You can use the following values for the type option.

Paragraph type values
Value	Paragraph Name
markdown	Markdown
normal	Normal
heading1	Heading 1
heading2	Heading 2
heading3	Heading 3
heading4	Heading 4
heading5	Heading 5
headline	Headline
code	Code
command	Command
pre	Preformatted
blockquote	Blockquote
epigraph	Epigraph
ordered_list	Ordered List
ordered_list_continuing_numbering	Ordered List(Continuing Numbering)
unordered_list	Unordered List
definition_list	Definition List
callout_list	Callout List
step1	Step
note	Note
tip	Tip
caution	Caution
proofreading	Proofreading

If a paragraph already uses a hidden paragraph type, you can still use that paragraph type for it, regardless of the setting above.

Character Styles

In ManualWorks, you cannot set the font, color, or weight of specific text directly. Instead, you give the text a meaning and then format it consistently through a theme. This is called a character style.

The main character styles are as follows.

Strong
Emphasis
Code
Keyboard
Inline Comment
Subscript
Superscript
Delete
Button
Callout

In addition to the character styles that ManualWorks provides, you can create character styles with user styles. For details, see User Style Types.

Set a character style as follows.

Select the text to apply the character style to.
- You can select text by dragging the mouse or by pressing Shift + Left and Shift + Right.
From the drop-down list at the upper left of the editing area, select the character style to apply to the text.
- You can also press Ctrl + Space and use the arrow keys to select it.

Selecting a character style

Remove a character style in one of the following ways.

Double-click the text whose character style you want to remove, and then click the <Delete> link in the “Are you sure you want to delete the character style?” window.
Place the cursor in the text whose character style you want to remove, press Ctrl + Space, and then select <Delete Character Style> from the context menu.

Line Breaks Within Character Styles

Line breaks are supported within a character style. You do not need to set the character style on each line.

Applying the “Code” Character Style with the `(grave accent) Character

You can apply the “Code” character style with the `(grave accent) character.

Type the ` character before and after the text, as shown below, to apply the “Code” character style to it.

Setting Links

Use the <1Link> menu in the paragraph editor to link to content repeated in the document or to documents for reference.

Document link
- Sets a reference target from all documents. You can link not only to chapters and paragraphs(Heading 1 to Heading 5, image, table paragraphs, and so on) but also to documents, libraries, web pages, and more.
Web link
- Enter a web address. To link to a paragraph in another document, use “Web”.
File link
- Upload a file and add a link to it in the document. For details, see Files.
Email link
- Enter an email address.

If you select “2Preserve link text”, the text of the link does not change.

Adding Marks(Setting Up the Index)

Use the <Mark> menu in the paragraph editor to create an index. For details, see Creating an Index.

Adding Footnotes

Use the <1Footnote> menu in the paragraph editor to add a footnote where you want it. To change or delete a footnote, double-click its icon (speaker_notes).

Note the following about footnotes.

You cannot insert a footnote in a footnote.
In the editor, footnotes appear directly below the paragraph. In the web viewer and EPUB, they appear as endnotes, and in PDF, as footnotes.

Setting Ruby Text

ManualWorks supports ruby, which shows small reading aids above body text, like Japanese furigana.

Select the text to annotate, and then click the <Ruby> menu in the paragraph editor. Enter the body text in “Body” and the reading in “Ruby”, and then click the button. To change or delete ruby text, double-click the annotated text. For example, if you enter 漢字 as the body and かんじ as the ruby, かんじ appears above 漢字.

漢字かんじ

Ruby is supported in all of the following output formats.

Web viewer
PDF
EPUB
HTML
MS Word

You can set the ruby character style in the theme. The default theme displays ruby text smaller than the body text.

Adding Inline Images

Use the <1Inline Image> menu in the paragraph editor to add small images, such as buttons or icons, to the document.

Get images and add them to a paragraph in the following ways.

Importing from My Computer: Upload an image file from your computer.
Importing from Library: Use buttons or icons uploaded to a library.
Importing from Other Document: Reference buttons or icons in another chapter. When you select a chapter, all the buttons and icons you can reference in that chapter appear. Click a button or icon to insert it into the paragraph right away.
Importing from Web: Enter the URL of an image on the web.

Resizing Inline Images

You can resize an image that you insert in a paragraph.

Use the 1icon to resize the image to insert in the paragraph. However, you cannot make it larger than the original.

If you insert a large image as an inline image, the layout breaks. Create large images as Image Paragraphs.

Adding Icons

You can add 1icons to the content of a document.

Note the following.

Icons are supported not only in the web viewer but also in PDF, EPUB, HTML, and MS Word.
However, if an EPUB viewer does not support font embedding, icons appear as text.

Adding Special Characters

Use the <Special Character> menu in the paragraph editor to add special characters to the document. You can also press Ctrl + Space and use the arrow keys to add special characters.

Clearing Formatting

Click Clear All Format (format_clear) in the paragraph editor to remove all settings, including character styles, links, index marks, and footnotes.

Undo and Redo

You can undo and redo editing tasks.

Click the Undo (undo) and Redo (redo) buttons in the paragraph editor.
Press Ctrl + Z and Ctrl + Y.

Removing Line Breaks When Editing Multiple Paragraphs Together

When you edit multiple text paragraphs together, the <1Remove Line Break> link appears at the lower left of the editing area. Click this link to remove the line breaks.