epubjs
Version:
Render ePub documents in the browser, across many devices
85 lines (75 loc) • 7.36 kB
HTML
<html xmlns:epub="http://www.idpf.org/2007/ops" xmlns="http://www.w3.org/1999/xhtml"><head><title>Writing in the Editor</title><link rel="stylesheet" type="text/css" href="epub.css"/></head><body data-type="book"><section data-type="chapter" epub:type="chapter" data-pdf-bookmark="Chapter 5. Writing in the Editor"><div class="chapter" id="idm669472">
<h1><span class="label">Chapter 5. </span>Writing in the Editor</h1>
<p>Atlas gives you a fully functional editor for writing and formatting your content. To access the editor, just click a file from the project dashboard, and that file will open in editing mode. Atlas has two editor modes—visual and code—and supports four markup languages: HTML, <a data-original-title="" data-type="xref" title="" href="ch10.html#markdownref">Chapter 10</a>, AsciiDoc, and DocBook (read more about the editor modes in <a data-original-title="" data-type="xref" title="" href="ch03.html#editingenvironments">“Editing Environments”</a>). The visual editor is only available to people using HTML, and includes a number of editing and formatting tools in the toolbar.</p>
<section data-type="sect1" data-pdf-bookmark="The Toolbar"><div class="sect1" id="idm664448">
<h1>The Toolbar</h1>
<p>Many of the standard formatting tools you’ve grown to know and love in other word processors are available in the visual editor’s toolbar. From left to right, you’ve got the following options:</p>
<dl>
<dt><img alt="Alt Text" class="icontentsimagesboldbuttonpng" src="assets/boldbutton.png"/> Bold</dt>
<dd>
<p>Bolds your selected text.</p>
</dd>
<dt><img alt="Alt Text" class="icontentsimagesitalbuttonpng" src="assets/italbutton.png"/> Italic</dt>
<dd>
<p>Italicizes your selected text.</p>
</dd>
<dt><img alt="Alt Text" class="icontentsimagesunderlinebuttonpng" src="assets/underlinebutton.png"/> Underline</dt>
<dd>
<p>Underlines your selected text.</p>
</dd>
<dt id="indextagging"><img alt="Alt Text" class="icontentsimagesindextermpng" src="assets/indexterm.png"/> Add an index entry</dt>
<dd>
<p>An index is a collection of key words, concepts, and phrases that are found throughout your project. To create an index, add index terms to your project text by placing your cursor where the term is discussed, and then clicking this button; you’ll get a dialog box where you can add an index term, and optionally a secondary and tertiary term as well. When you build, Atlas will collect all of these terms into an alphabetical list linked to the tag locations that you specified. </p>
</dd>
<dt><img alt="Alt Text" class="icontentsimageslinkbuttonpng" src="assets/linkbutton.png"/> Add a link</dt>
<dd>
<p>Converts your selected text to a link. To link to a location within your project, instead of typing the full path, simply type the id of the element, preceded by a # sign, like this: <code>#buildsettings</code>—no file name is necessary. When you build, Atlas will make sure to correctly convert all of those link destinations to include the correct file name.</p>
</dd>
<dt><img alt="Alt Text" class="icontentsimagesnumbuttonpng" src="assets/numbutton.png"/> Convert to or insert a numbered list</dt>
<dd>
<p>If you have some text selected, that text will be converted to a numbered list. If not, Atlas will insert an empty numbered list item to get your list started.</p>
</dd>
<dt><img alt="Alt Text" class="icontentsimagesbulletbuttonpng" src="assets/bulletbutton.png"/> Convert to or insert a bulleted list</dt>
<dd>
<p>If you have some text selected, that text will be converted to a bulleted list. If not, Atlas will insert an empty bulleted list item to get your list started.</p>
</dd>
<dt><img alt="Alt Text" class="icontentsimagesoutdentbuttonpng" src="assets/outdentbutton.png"/> Outdent a paragraph</dt>
<dd>
<p>Outdents the selected paragraph.</p>
</dd>
<dt><img alt="Alt Text" class="icontentsimagesindentbuttonpng" src="assets/indentbutton.png"/> Indent a paragraph</dt>
<dd>
<p>Indents the selected paragraph.</p>
</dd>
<dt><img alt="Alt Text" class="icontentsimagesblockquotebuttonpng" src="assets/blockquotebutton.png"/> Insert a blockquote</dt>
<dd>
<p>If you have some text selected, this will be converted to a blockquote. If not, Atlas will insert an empty blockquote paragraph for you to type in.</p>
</dd>
<dt><img alt="Alt Text" class="icontentsimagestablebuttonpng" src="assets/tablebutton.png"/> Insert a table</dt>
<dd>
<p>This button opens up a menu for you to set up a table that will be inserted at the current location of your cursor. You can set the number of columns and rows, and tell Atlas whether your table should include heading rows. </p>
</dd>
<dt><img alt="Alt Text" class="icontentsimagescodebuttonpng" src="assets/codebutton.png"/> Insert a code block or format inline code</dt>
<dd>
<p>If you have some text selected, Atlas will format it as inline code. If not, Atlas will insert a new placeholder code block for you to type in. If you hover over that code block, you’ll see a little </> icon at bottom center. Click this icon to tell Atlas what code language this block uses, so Atlas will know how to apply syntax highlighting when you build.</p>
<figure><div class="figure"><img alt="Alt Text" class="icontentsscreen-shot-2013-10-15-at-34912-pmpng" src="assets/Screen Shot 2013-10-15 at 3.49.12 PM.png"/> <h6><span class="label">Figure 5-1. </span>Click the icon to add the language for the code block.</h6></div></figure>
</dd>
<dt id="pastfromword"><img alt="Alt Text" class="icontentsimagespastefrombuttonpng" src="assets/pastefrombutton.png"/> Paste from Word or Paste Plain Text</dt>
<dd>
<p>This menu helps with copying over pieces from a Word document or from a plain text file. Paste the text you are copying inside the dialog box that appears, and Atlas will do its best to transfer over your formatting (or strip it out, if you’re pasting plain text). </p>
<div data-type="warning" epub:type="warning">
<h1>Warning</h1>
<p>This option is meant to be used only for short blocks of text, <em>not</em> for entire documents. If you’ve got an entire file that you want to put in Atlas, you should have that file converted to HTMLBook by a third-party vendor, and then add that converted HTML to Atlas instead.</p>
</div>
</dd>
<dt><img alt="Alt Text" class="icontentsimagesinsertbuttonpng" src="assets/insertbutton.png"/> The Insert... menu</dt>
<dd>
<p>The Insert... menu is your one-stop shop for adding predefined text blocks to your document. You can add smaller blocks like notes, warnings, and sidebars, or higher-level blocks like chapters and sections (see <a data-type="xref" href="#addingsections">“Using and Adding Sections”</a> for more on the latter). To add a block, place your cursor where you want the new block to appear, and then choose the kind of block you want from the drop-down menu. Atlas will insert the pre-formatted block along with some placeholder text that you can replace.</p>
<div data-type="warning" epub:type="warning">
<h1>Warning</h1>
<p>Not all elements are allowed everywhere—for example, you can’t insert a chapter inside a sidebar. If an element isn’t allowed, it’ll be grayed out in the menu.</p>
</div>
</dd>
</dl>
</div></section></body></html>