docs.atlas.oreilly.comAtlas Documentation

Atlas Docs Home Atlas Introduction What Is Atlas? Editing Environments Build All Formats from a Single Source Typesetting with Themes Content Stored with Git Project Options Configure Metadata Files to Build Theme Output Formats PDF EPUB MOBI HTML Options for All Formats Table of Contents Index atlas.json Files Optional Fields CSS Themes Themes Styling for PDF Output Customizing Your Project Styles How to Do It Styling for EPUB Output Page and Line Breaks for PDF Output Working Locally Atlas + Git SSH Keys Using Git Git Quick Reference Text Editors The Atlas API Authentication Builds Atlas CLI Packages Collaboration Tools Adding New Collaborators Working in Branches Creating and Selecting Your Own Branch Merging Changes Into Main Merge Conflicts Activity Log Best Practices Workflow Using the Git Collaboration Tools Writing in the Visual Editor The Toolbar Using and Adding Sections Adding Images Supported File Types Cross-References and Internal Links Inserting Code Blocks Setting the Language Writing in AsciiDoc AsciiDoc Markup Reference Text Chapters Headings Parts Prefaces Forewords Afterwords Dedications Glossaries Appendixes Chapter Contributors Inline Markup Sidebars Notes, Tips, Warnings, and Cautions Footnotes Quotes Figures and Other Images Lists Tables Code Cross-References Passthroughs Math Support via LaTeX Controlling Line Breaks Indexing Writing in DocBook DocBook XML Markup Reference Using Elements Correctly Chapters and Sections Parts Block Versus Inline Elements Inline Font Markup Cross-References Figures Tables Lists Notes, Tips, Warnings, and Cautions Sidebars Hyperlinks Footnotes Indexing Code Unicode for Special Characters Comments and Remarks Quotes and Epigraphs Writing in Jupyter Notebooks (Jupyter Book) Math Simple Math Math Markup Languages LaTeX MathML How Does Math Work in Atlas? Math in HTMLBook Projects Math in Asciidoc Projects Math in Docbook Projects Frequently Asked Questions General How is access control handled? Can I set up automated notifications to alert collaborators? What kind of reporting is available? Writing and Editing Why are some "Insert" options unavailable? Do images need to be sized before ingestion? How can I upload multiple images at once? Can I lock files or projects for use by a specific collaborator? How do I number elements like tables, figures, etc.? File Creation Are there any built-in validation mechanisms? Is pagination info included in epub files? How is epub navigation generated? Can I embed my preferred fonts in epub files? Atlas Introduction Welcome to the . On these pages, you’ll find relevant material ing Atlas to produce books for print and digital formats. What Is Atlas? Atlas is O’Reilly’s production application that creates the print and web versions of a book. With Atlas you can: Write in a Visual Editor or in one of three markup languages: AsciiDoc, HTMLBook, or DocBook XML Build EPUB, PDF, and HTML from a single set of source files Take advantage of Git infrastructure, enabling version control and collaboration Editing Environments Atlas supports two online editing modes: the Visual Editor and the Code Editor. In the Visual Editor, you write in an online environment that is similar to a traditional word processor. This editor gives you a toolbar with all your standard formatting tools and lets you write in a clean environment while still providing the underlying document structure that is necessary to build your project. Behind the scenes, you’re actually getting well-formed HTML5—specifically, HTMLBook , our open standard for writing books (or book-like projects) in HTML. If you prefer writing using a markup language, then you are able to use the Code Editor. In this text markup mode, you can use HTMLBook, DocBook XML, or AsciiDoc (a language similar to Markdown but more robust for presenting complex information). All of these languages can still be built to all four output formats. Note You can also use Atlas’ Git integration to work offline with your preferred text editing software. See Atlas + Git for more information. Build All Formats from a Single Source Like the web, Atlas separates content from presentation. Once you’ve written your material, you can build” it into the publishing and distribution formats used in production at O’Reilly: PDF or EPUB. On the the Configure page, simply drag and drop the files in the order you would like them to appear into the Build Contents list, hit Save, and Atlas handles the rest. Typesetting with Themes Projects in Atlas are typeset using "themes"—full stylesheets, written in CSS and XSL, specific to the O’Reilly series to which a title belongs. This ensures that every O’Reilly title is professionally and consistently styled without having to be individually typeset. O’Reilly editorial and production staff will provide the custom path for the O’Reilly book series themes. Content Stored with Git Atlas projects are based on Git repositories. Git is the powerful version control system that tracks every change in your content, who made it, and when. Tracking a project with Git means that your content is secure and can be rolled back to a previous version if necessary, and provides the functionality for seamless collaboration tools. © 2013, O’Reilly Media, Inc. All trademarks and registered trademarks appearing on oreilly.com are the property of their respective owners. Legal Terms of Service Privacy...