mirror of
https://github.com/bitcoinbook/bitcoinbook
synced 2024-11-12 19:08:56 +00:00
small adjustments to getting started doc
This commit is contained in:
Adam Zaremba
parent
2810077254
commit
b96e7909b5
@ -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://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>
|
||||
<p>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.</p>
|
||||
</section>
|
||||
|
||||
<section data-type="sect1">
|
||||
@ -20,40 +20,40 @@
|
||||
|
||||
<p>If you want to start from scratch, you can define the title and description for your project and choose a project template to pre-populate your new repository with some skeleton files based on the kind of project you’re making.</p>
|
||||
|
||||
<p>You can also create a new Atlas project by importing an existing project from GitHub or by taking advantage of Atlas’ conversion services (if included in your pilot agreement).</p>
|
||||
<p>You can also create a new Atlas project by importing an existing project from GitHub.</p>
|
||||
|
||||
<p>Once you select a project or create a new one, <strong>you'll be taken to the project dashboard</strong>, where you'll see a list of all files in the project, and have access to the <a data-original-title="" data-type="xref" href="#building_in_atlas" title="">ebook-building tools</a>.</p>
|
||||
<p>Once you select a project or create a new one, <strong>you'll be taken to the project dashboard</strong>, where you'll see a list of all files in the project, and have access to the <a data-type="xref" href="#building_in_atlas" title="">ebook-building tools</a>.</p>
|
||||
</section>
|
||||
|
||||
<section data-type="sect1">
|
||||
<h1>The Project Dashboard</h1>
|
||||
|
||||
<p><strong>The project dashboard is your landing page for each project.</strong> It lists all the files and folders in your project and gives you quick access to the build tools (more on building <a data-type="xref" href="#building_in_atlas">below</a>).</p>
|
||||
<p><strong>The project dashboard is your landing page for each project.</strong> It lists all the files and folders in your project, specifies your active branch, and gives you quick access to the build tools (more on building <a data-type="xref" href="#building_in_atlas">below</a>). You can also navigate from here to the Project Settings and Activity pages.</p>
|
||||
|
||||
<p>From the project dashboard, your next steps will likely be either to start writing or to build your project. <strong>Click a file in your Files pane at left to open it in the editor.</strong> For more about building, <a data-type="xref" href="#building_in_atlas">see below</a>.</p>
|
||||
<p>From the project dashboard, <strong>click a file in the Files pane at left to open it in the editor.</strong></p>
|
||||
</section>
|
||||
|
||||
<section data-type="sect1">
|
||||
<h1>Writing and Editing</h1>
|
||||
|
||||
<p><strong>The Atlas editor has two writing modes</strong>: the Visual Editor and the Code Editor. The Visual Editor is an online authoring environment similar to a word processor, with a formatting toolbar 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 is an online authoring environment similar to a word processor, with a formatting toolbar for tagging and styling your content. Documents created in the Visual Editor are stored as <a href="http://oreillymedia.github.io/HTMLBook/">HTMLBook</a>, a specification of <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;"> <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>While <strong>HTML5 is the default markup language for Atlas content</strong>, Atlas also supports documents written in<strong> <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>. All three of these formats can be edited using the Code Editor.</p>
|
||||
|
||||
<p>In both writing modes, you can <strong>navigate among your files using 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) 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 your files using 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> (specify a custom commit message by clicking on the dropdown arrow next to the Save button), and even <strong>initiate builds</strong>.</p>
|
||||
</section>
|
||||
|
||||
<section data-type="sect1">
|
||||
<h1>Creating a New File</h1>
|
||||
|
||||
<p>To create a new file, click the New File button at bottom of the dashboard. Give your file a name, and hit Enter. You can also do this in the Files pane in the editor.</p>
|
||||
<p>To create a new file, click the New File button at bottom of the dashboard. Give your file a name, and press Enter. You can also do this in the Files pane in the editor.</p>
|
||||
|
||||
<p>You can also organize your files into folders. To add a folder, click the New Folder button (next to the New File button). You can then click the folder name in the Files menu to open the folder and create new files within it.</p>
|
||||
<p>You can also organize your files into folders. To add a folder, click the New Folder button (next to the New File button). You can then click the folder name in the Files menu to open the folder and create new files within it.</p>
|
||||
|
||||
<div data-type="warning">
|
||||
<h1>Warning</h1>
|
||||
|
||||
<p>You can't currently organize your files within Atlas. If you want to move existing files into a folder, you need to do that outside of Atlas using git.</p>
|
||||
<p>You can't currently organize your files within Atlas. If you want to move existing files into a folder, you need to do that outside of Atlas using Git.</p>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
@ -62,22 +62,28 @@
|
||||
|
||||
<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 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>Before you build for the first time, you'll need to choose which files from your project to include and the settings you want to apply to each format; <strong>click Configure</strong> on the project dashboard.</p>
|
||||
|
||||
<p>Every format has a few different options you can choose. Two options that are common to all formats are:</p>
|
||||
<p>In the Files section, simply <strong>choose files from the left-hand pane to add to the build</strong>, and drag the files into the correct order on the right. You can remove files from the build list by clicking on the minus button.</p>
|
||||
|
||||
<p>Each format has a few different configuration options. Four are common to all formats:</p>
|
||||
|
||||
<ul>
|
||||
<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 create an <strong>alphabetical index</strong> in your built project.</li>
|
||||
<li>Create a <strong>table of contents</strong> in your output, based on your section headings.</li>
|
||||
<li>Collect all index tags you've added and create an <strong>alphabetical index</strong> in your final format.</li>
|
||||
<li>Apply <strong>syntax highlighting</strong> to language-specific code sections in build output.</li>
|
||||
<li>Display or suppress <strong>Atlas comments</strong> in build output (HTMLBook only).</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>Finally, choose a theme for your project. You can pick from one of the available default themes, or specify your own custom theme.</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>
|
||||
<p>Click Save, and now you can build from the dashboard.</p>
|
||||
|
||||
<figure><img alt="Alt Text" class="icontentsimagesquickbuildspng" src="images/quickbuilds.png" />
|
||||
<figcaption>The Builds menu on the project dashboard allows you to quickly trigger a build using your previously chosen settings.</figcaption>
|
||||
</figure>
|
||||
|
||||
<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>
|
||||
</section>
|
||||
|
||||
<section data-type="sect1">
|
||||
@ -95,7 +101,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>, 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 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 <a href="http://docs.atlas.oreilly.com/ch11.html#atlas-api">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 but still want to see the final output.</p>
|
||||
</section>
|
||||
|
||||
<section data-type="sect1">
|
||||
|
||||
Loading…
Reference in New Issue
Block a user