arno
/
bitcoinbook
mirror of https://github.com/bitcoinbook/bitcoinbook
1
0
Fork 0
Code Issues Releases Wiki Activity

Couple more text tweaks, and stripped out unresolved XREFs.

Browse Source
pull/192/head
Sanders Kleinfeld 10 years ago
parent 2eba1f7d0a
commit 4b6aa3bd25
1 changed files with 12 additions and 12 deletions
Show Stats Download Patch File Download Diff File

24
GETTING-STARTED.html
Unescape View File

@ -6,7 +6,7 @@
<section data-type="sect1">
<h1>Atlas (Beta Release) Is Built on Git</h1>
<p>The beta version of Atlas is built on <a data-original-title="" href="http://github.com" title="">Git</a>, the powerful version control system that tracks every change in your content, who made it, and when it happened. What this means is that your content is secure and can be rolled back to any previous version if necessary. Git also provides the functionality for seamless collaboration tools (coming soon!).</p>
<p>The beta version of Atlas is built on <a data-original-title="" href="http://git-scm.com" title="">Git</a>, the powerful version control system that tracks every change in your content, who made it, and when it happened. What this means is that your content is secure and can be rolled back to any previous version if necessary. Git also provides the functionality for seamless collaboration tools (coming soon!).</p>
</section>
<section data-type="sect1">
@ -36,11 +36,11 @@
<section data-type="sect1">
<h1>Writing and Editing</h1>
<p><strong>The Atlas editor has <a data-original-title="" data-type="xref" href="#editingenvironments" title="">two writing modes</a></strong>: the Visual Editor and the Code Editor. The Visual Editor&nbsp;is an&nbsp;online authoring environment similar to a word processor, with&nbsp;a formatting toolbar&nbsp;for tagging and styling your content. Documents created in the Visual Editor are stored as <a href="http://en.wikipedia.org/wiki/HTML5">HTML5</a>. The Code Editor allows you to view and edit the underlying HTML5 markup for your document. You can toggle back and forth between the Visual and Code Editors, and changes you make in either mode will immediately be reflected in the other.</p>
<p><strong>The Atlas editor has two writing modes</strong>: the Visual Editor and the Code Editor. The Visual Editor&nbsp;is an&nbsp;online authoring environment similar to a word processor, with&nbsp;a formatting toolbar&nbsp;for tagging and styling your content. Documents created in the Visual Editor are stored as <a href="http://en.wikipedia.org/wiki/HTML5">HTML5</a>. The Code Editor allows you to view and edit the underlying HTML5 markup for your document. You can toggle back and forth between the Visual and Code Editors, and changes you make in either mode will immediately be reflected in the other.</p>
<p>While <strong>HTML5 is the default markup language for Atlas content</strong>, Atlas also supports documents written in<strong style="line-height: 1.5em;">&nbsp;<a data-original-title="" data-type="xref" href="#markdownref" title="">Markdown</a>, <a href="http://www.methods.co.nz/asciidoc/">AsciiDoc</a>, and <a data-original-title="" href="http://www.docbook.org/" title="">DocBook XML</a></strong><span style="line-height: 1.5em;">. All three of these formats can be edited using the Code Editor.</span></p>
<p>While <strong>HTML5 is the default markup language for Atlas content</strong>, Atlas also supports documents written in<strong style="line-height: 1.5em;">&nbsp;<a data-original-title="" href="https://help.github.com/articles/github-flavored-markdown" title="">Markdown</a>, <a href="http://www.methods.co.nz/asciidoc/">AsciiDoc</a>, and <a data-original-title="" href="http://www.docbook.org/" title="">DocBook XML</a></strong><span style="line-height: 1.5em;">. All three of these formats can be edited using the Code Editor.</span></p>
<p>In both writing modes, you can <strong>navigate among&nbsp;your files using&nbsp;the Files menu</strong> to the left of the screen, <strong>create and delete files</strong> <strong>and folders</strong>,<strong> <a data-original-title="" data-type="xref" href="#addingimages" title="">upload images</a></strong>, <strong>save your project</strong> (top-right button in the editor, or use the keyboard shortcut ⌘-s/Ctrl+s)&nbsp;and even attach a <strong>custom commit message</strong> to each save (hover over the Save button to open the commit message dialog box).</p>
<p>In both writing modes, you can <strong>navigate among&nbsp;your files using&nbsp;the Files menu</strong> to the left of the screen, <strong>create and delete files and folders</strong>,<strong>upload images</strong>, <strong>save your project</strong> (top-right button in the editor, or use the keyboard shortcut ⌘-s/Ctrl+s)&nbsp;and even attach a <strong>custom commit message</strong> to each save (hover over the Save button to open the commit message dialog box).</p>
</section>
<section data-type="sect1">
@ -60,18 +60,18 @@
<section data-type="sect1" id="building_in_atlas">
<h1>Building</h1>
<p>When you're finished writing, it's time to build your project so you can share it with the world. <strong>Atlas lets you export your project in <a data-original-title="" data-type="xref" href="#outputformats" title="">four different formats</a></strong>: <a data-original-title="" data-type="xref" href="#formatspdf" title="">PDF</a>, <a data-original-title="" data-type="xref" href="#formatsepub" title="">EPUB</a>, <a data-original-title="" data-type="xref" href="#formatsmobi" title="">MOBI</a>, and <a data-original-title="" data-type="xref" href="#formatshtml" title="">HTML website</a>.</p>
<p>When you're finished writing, it's time to build your project so you can share it with the world. <strong>Atlas lets you export your project in four different formats</strong>: PDF, EPUB, MOBI, and HTML website.</p>
<p>The first time you&nbsp;build, you'll need to choose what formats to build, and what files and settings you want to apply to each format; <strong>click Configure</strong> on the project dashboard.</p>
<p>Every format has <a data-type="xref" href="#building">a few different options</a> you can choose. Two options that are common for all formats are:</p>
<p>Every format has a few different options you can choose. Two options that are common to all formats are:</p>
<ul>
<li>Create a<strong> table of contents</strong> in your built project, based on your section headings. <a data-type="xref" href="#toc">Learn more here</a>.</li>
<li>Collect all index tags you've added and&nbsp;create an <strong>alphabetical index</strong> in your built project. <a data-type="xref" href="#index" title="">Learn more here</a>.</li>
<li>Create a <strong>table of contents</strong> in your built project, based on your section headings.</li>
<li>Collect all index tags you've added and&nbsp;create an <strong>alphabetical index</strong> in your built project.</li>
</ul>
<p>Choose a theme for your project (more on that next). Then at the bottom of the Configure page, <strong>choose which files to add to the build</strong>, drag the files into the correct order, and then click save. Now you can build from the dashboard.</p>
<p>Choose a theme for your project (more on that next). Then at the bottom of the Configure page, <strong>choose which files to add to the build</strong>, drag the files into the correct order, and then click Save. Now you can build from the dashboard.</p>
<p>If the build is successful, you'll get a link to download the file. If it fails, you'll get information about what went wrong (the usual culprit is markup errors).</p>
@ -83,7 +83,7 @@
<section data-type="sect1">
<h1>Themes and Design</h1>
<p>All of the Atlas output formats (PDF, EPUB, MOBI, and HTML) are powered by <a href="http://en.wikipedia.org/wiki/Cascading_Style_Sheets">CSS</a>, the standard styling language for the Web. You can write <a data-original-title="" data-type="xref" href="#cssthemes" title="">an entirely new theme using CSS</a>, that can be used for multiple projects, by multiple people, or you can just add <a data-original-title="" data-type="xref" href="#csscustomizations" title="">CSS customizations</a> for your specific project.</p>
<p>All of the Atlas output formats (PDF, EPUB, MOBI, and HTML) are powered by <a href="http://en.wikipedia.org/wiki/Cascading_Style_Sheets">CSS</a>, the standard styling language for the Web. You can write an entirely new theme using CSS that can be used for multiple projects, by multiple people, or you can just add CSS customizations for your specific project.</p>
<p><strong>To apply a theme to your project</strong>, choose one of the default themes on the Configure page, or add a link to your own custom theme.</p>
@ -95,7 +95,7 @@
<section data-type="sect1">
<h1>Building Locally with the API</h1>
<p>Atlas gives you the option to <strong>build locally on the command line</strong>, <a data-original-title="" data-type="xref" href="#atlas-api" title="">using our API</a>. (Note that you'll still need an internet connection for this to work.) This is great if you prefer to work locally using your own text editor&nbsp;but still want to see the final output.</p>
<p>Atlas gives you the option to <strong>build locally on the command line</strong>, using our API. (Note that you'll still need an internet connection for this to work.) This is great if you prefer to work locally using your own text editor&nbsp;but still want to see the final output.</p>
</section>
<section data-type="sect1">
@ -103,4 +103,4 @@
<p>For more details on any of the above topics, or for more advanced information, <strong><a data-original-title="" href="http://atlasdocs.oreilly.com/" title="">check out the Atlas documentation</a></strong>.&nbsp;If you&rsquo;re stuck, have specific questions about the app, or just general ideas for improvement, you can contact the Atlas team&nbsp;at&nbsp;<a data-original-title="" href="mailto:atlas@oreilly.com?subject=Atlas%20Feedback" title="">atlas@oreilly.com</a>.</p>
</section>
</section>
</section>

Write Preview
Loading…
Cancel
Save