Atlas Quick Start Guide

How to start writing.

The visual editor vs. the code editor

Supported file types

Atlas supports four different markup languages: HTML, markdown, asciidoc, and docbook. To use the Visual Editor, write your project in HTML making sure to adhere to the HTMLBook spec, or just use the Visual Editor right from the beginning (it already follows the HTMLBook rules).

What is a section?

An integral part of the HTMLBook spec is the concept of sections. 

The Magic Line

Hover over this paragraph of text. See that blue line that appears? That line helps you insert a new block wherever it shows up. By default, the line will insert just a plain paragraph, but once you do that, you can use the Insert... menu to change that new paragraph into a whole new section, sidebar, note, or some other book element.

Try It!

Follow these steps to get started using the magic line:

  1. Hover over the above paragraph and click the arrow at the right of the magic blue line. 

  2. Now go to the insert menu, and choose "Section".

    Atlas inserts a new, nested section at the correct level. For example, if you are currently within a Section 1 block, Atlas will insert a Section 2.

The Insert... menu gives you different options depending on where you add the new paragraph. For example, if you've used the magic line to add a new paragraph inside a sidebar, you won't be allowed to insert a section (in the HTMLBook spec, sections are only allowed to be used as high-level container elements).

Warning

Sometimes the magic line won't appear after the last element in a chapter (section, paragraph, it doesn't matter what). To get around this, insert a new paragraph at the very end of the file. The magic line should then appear. 

Using the Insert... menu

The toolbar

Paste From...

TOC

Using the book skeleton