CINXE.COM

<!DOCTYPE html>    <html class="no-js" lang="en"><head> <meta content='IE=edge' http-equiv='X-UA-Compatible'> <meta charset='utf-8'> <meta content='width=device-width, initial-scale=1.0, maximum-scale=1, user-scalable=no' name='viewport'> <meta content='en' name='Content-Language'> <link rel="apple-touch-icon-precomposed" type="image/png" href="https://leanpub.com/assets/favicons/apple-touch-icon-57x57-3dc48b9be1873ac9bf6d580e7836e3e5.png" sizes="57x57" /> <link rel="apple-touch-icon-precomposed" type="image/png" href="https://leanpub.com/assets/favicons/apple-touch-icon-60x60-06b95deca3f378372b051ca8ea42cfbd.png" sizes="60x60" /> <link rel="apple-touch-icon-precomposed" type="image/png" href="https://leanpub.com/assets/favicons/apple-touch-icon-72x72-935ba702f9d3da9b4404aa2b797920e5.png" sizes="72x72" /> <link rel="apple-touch-icon-precomposed" type="image/png" href="https://leanpub.com/assets/favicons/apple-touch-icon-76x76-937dbc8b688db389b5b872c5ffdffe2d.png" sizes="76x76" /> <link rel="apple-touch-icon-precomposed" type="image/png" href="https://leanpub.com/assets/favicons/apple-touch-icon-114x114-9db66ed49dfe9c3ed799923955da36e2.png" sizes="114x114" /> <link rel="apple-touch-icon-precomposed" type="image/png" href="https://leanpub.com/assets/favicons/apple-touch-icon-120x120-3fd2359930103db35eb499036b81ba90.png" sizes="120x120" /> <link rel="apple-touch-icon-precomposed" type="image/png" href="https://leanpub.com/assets/favicons/apple-touch-icon-144x144-5bee791d2b53cc426eb14e7f6e40a024.png" sizes="144x144" /> <link rel="apple-touch-icon-precomposed" type="image/png" href="https://leanpub.com/assets/favicons/apple-touch-icon-152x152-af69d0ec0fe11cf82324b06ff9a56e3b.png" sizes="152x152" /> <link rel="icon" type="image/png" href="https://leanpub.com/assets/favicons/favicon-16x16-19545df363d1089bccdc59d17ee5b781.png" sizes="16x16" /> <link rel="icon" type="image/png" href="https://leanpub.com/assets/favicons/favicon-32x32-9a0898109481d6450269c966cdf6a2d7.png" sizes="32x32" /> <link rel="icon" type="image/png" href="https://leanpub.com/assets/favicons/favicon-96x96-98f4372a68f5617fc907b7bde8d94e05.png" sizes="96x96" /> <link rel="icon" type="image/png" href="https://leanpub.com/assets/favicons/favicon-128x128-bf73acc329429fbf555afe3b067aa2d6.png" sizes="128x128" /> <link rel="icon" type="image/png" href="https://leanpub.com/assets/favicons/favicon-196x196-24a71f1b4fb02600f635b59a116daf05.png" sizes="196x196" /> <meta content='Leanpub' name='application-name'> <meta content='#ffffff' name='msapplication-TileColor'> <meta content='favicons/mstile-144x144.png' name='msapplication-TileImage'> <meta content='favicons/mstile-150x150.png' name='msapplication-square150x150logo'> <meta content='favicons/mstile-310x150.png' name='msapplication-wide310x150logo'> <meta content='favicons/mstile-310x310.png' name='msapplication-square310x310logo'> <meta content='favicons/mstile-70x70.png' name='msapplication-square70x70logo'> <title>Read The Leanpub Manual | Leanpub</title> <link href='//fonts.googleapis.com/' rel='dns-prefetch'> <script src='https://ajax.googleapis.com/ajax/libs/webfont/1.6.16/webfont.js'></script> <script> if (typeof WebFont !== 'undefined') { WebFont.load({ google: { families: [ 'Noto+Sans:ital,wght@0,400;0,700;1,400;1,700', 'Noto+Serif:ital,wght@0,400;0,700;1,400;1,700', 'Inter:wght@400;700', ] } }); } </script> <link rel="stylesheet" media="screen" href="https://leanpub.com/assets/font_awesome-bbab983f4954a5c7dd952efdd403ebe8.css" /> <link rel="stylesheet" media="all" href="https://leanpub.com/assets/application-7d935fd14b1fd37f7b91eaf5e29b9c52.css" /> <script> var _rollbarConfig = { accessToken: "3d279f41d3804636adbbba833c2c0d2d", captureUncaught: true, captureUnhandledRejections: true, code_version: "f4b064a9", payload: { environment: "production" } }; // Rollbar Snippet !function(r){function o(n){if(e[n])return e[n].exports;var t=e[n]={exports:{},id:n,loaded:!1};return r[n].call(t.exports,t,t.exports,o),t.loaded=!0,t.exports}var e={};return o.m=r,o.c=e,o.p="",o(0)}([function(r,o,e){"use strict";var n=e(1),t=e(4);_rollbarConfig=_rollbarConfig||{},_rollbarConfig.rollbarJsUrl=_rollbarConfig.rollbarJsUrl||"https://cdnjs.cloudflare.com/ajax/libs/rollbar.js/2.5.2/rollbar.min.js",_rollbarConfig.async=void 0===_rollbarConfig.async||_rollbarConfig.async;var a=n.setupShim(window,_rollbarConfig),l=t(_rollbarConfig);window.rollbar=n.Rollbar,a.loadFull(window,document,!_rollbarConfig.async,_rollbarConfig,l)},function(r,o,e){"use strict";function n(r){return function(){try{return r.apply(this,arguments)}catch(r){try{console.error("[Rollbar]: Internal error",r)}catch(r){}}}}function t(r,o){this.options=r,this._rollbarOldOnError=null;var e=s++;this.shimId=function(){return e},"undefined"!=typeof window&&window._rollbarShims&&(window._rollbarShims[e]={handler:o,messages:[]})}function a(r,o){if(r){var e=o.globalAlias||"Rollbar";if("object"==typeof r[e])return r[e];r._rollbarShims={},r._rollbarWrappedError=null;var t=new p(o);return n(function(){o.captureUncaught&&(t._rollbarOldOnError=r.onerror,i.captureUncaughtExceptions(r,t,!0),i.wrapGlobals(r,t,!0)),o.captureUnhandledRejections&&i.captureUnhandledRejections(r,t,!0);var n=o.autoInstrument;return o.enabled!==!1&&(void 0===n||n===!0||"object"==typeof n&&n.network)&&r.addEventListener&&(r.addEventListener("load",t.captureLoad.bind(t)),r.addEventListener("DOMContentLoaded",t.captureDomContentLoaded.bind(t))),r[e]=t,t})()}}function l(r){return n(function(){var o=this,e=Array.prototype.slice.call(arguments,0),n={shim:o,method:r,args:e,ts:new Date};window._rollbarShims[this.shimId()].messages.push(n)})}var i=e(2),s=0,d=e(3),c=function(r,o){return new t(r,o)},p=function(r){return new d(c,r)};t.prototype.loadFull=function(r,o,e,t,a){var l=function(){var o;if(void 0===r._rollbarDidLoad){o=new Error("rollbar.js did not load");for(var e,n,t,l,i=0;e=r._rollbarShims[i++];)for(e=e.messages||[];n=e.shift();)for(t=n.args||[],i=0;i<t.length;++i)if(l=t[i],"function"==typeof l){l(o);break}}"function"==typeof a&&a(o)},i=!1,s=o.createElement("script"),d=o.getElementsByTagName("script")[0],c=d.parentNode;s.crossOrigin="",s.src=t.rollbarJsUrl,e||(s.async=!0),s.onload=s.onreadystatechange=n(function(){if(!(i||this.readyState&&"loaded"!==this.readyState&&"complete"!==this.readyState)){s.onload=s.onreadystatechange=null;try{c.removeChild(s)}catch(r){}i=!0,l()}}),c.insertBefore(s,d)},t.prototype.wrap=function(r,o,e){try{var n;if(n="function"==typeof o?o:function(){return o||{}},"function"!=typeof r)return r;if(r._isWrap)return r;if(!r._rollbar_wrapped&&(r._rollbar_wrapped=function(){e&&"function"==typeof e&&e.apply(this,arguments);try{return r.apply(this,arguments)}catch(e){var o=e;throw o&&("string"==typeof o&&(o=new String(o)),o._rollbarContext=n()||{},o._rollbarContext._wrappedSource=r.toString(),window._rollbarWrappedError=o),o}},r._rollbar_wrapped._isWrap=!0,r.hasOwnProperty))for(var t in r)r.hasOwnProperty(t)&&(r._rollbar_wrapped[t]=r[t]);return r._rollbar_wrapped}catch(o){return r}};for(var u="log,debug,info,warn,warning,error,critical,global,configure,handleUncaughtException,handleUnhandledRejection,captureEvent,captureDomContentLoaded,captureLoad".split(","),f=0;f<u.length;++f)t.prototype[u[f]]=l(u[f]);r.exports={setupShim:a,Rollbar:p}},function(r,o){"use strict";function e(r,o,e){if(r){var t;if("function"==typeof o._rollbarOldOnError)t=o._rollbarOldOnError;else if(r.onerror){for(t=r.onerror;t._rollbarOldOnError;)t=t._rollbarOldOnError;o._rollbarOldOnError=t}var a=function(){var e=Array.prototype.slice.call(arguments,0);n(r,o,t,e)};e&&(a._rollbarOldOnError=t),r.onerror=a}}function n(r,o,e,n){r._rollbarWrappedError&&(n[4]||(n[4]=r._rollbarWrappedError),n[5]||(n[5]=r._rollbarWrappedError._rollbarContext),r._rollbarWrappedError=null),o.handleUncaughtException.apply(o,n),e&&e.apply(r,n)}function t(r,o,e){if(r){"function"==typeof r._rollbarURH&&r._rollbarURH.belongsToShim&&r.removeEventListener("unhandledrejection",r._rollbarURH);var n=function(r){var e,n,t;try{e=r.reason}catch(r){e=void 0}try{n=r.promise}catch(r){n="[unhandledrejection] error getting `promise` from event"}try{t=r.detail,!e&&t&&(e=t.reason,n=t.promise)}catch(r){}e||(e="[unhandledrejection] error getting `reason` from event"),o&&o.handleUnhandledRejection&&o.handleUnhandledRejection(e,n)};n.belongsToShim=e,r._rollbarURH=n,r.addEventListener("unhandledrejection",n)}}function a(r,o,e){if(r){var n,t,a="EventTarget,Window,Node,ApplicationCache,AudioTrackList,ChannelMergerNode,CryptoOperation,EventSource,FileReader,HTMLUnknownElement,IDBDatabase,IDBRequest,IDBTransaction,KeyOperation,MediaController,MessagePort,ModalWindow,Notification,SVGElementInstance,Screen,TextTrack,TextTrackCue,TextTrackList,WebSocket,WebSocketWorker,Worker,XMLHttpRequest,XMLHttpRequestEventTarget,XMLHttpRequestUpload".split(",");for(n=0;n<a.length;++n)t=a[n],r[t]&&r[t].prototype&&l(o,r[t].prototype,e)}}function l(r,o,e){if(o.hasOwnProperty&&o.hasOwnProperty("addEventListener")){for(var n=o.addEventListener;n._rollbarOldAdd&&n.belongsToShim;)n=n._rollbarOldAdd;var t=function(o,e,t){n.call(this,o,r.wrap(e),t)};t._rollbarOldAdd=n,t.belongsToShim=e,o.addEventListener=t;for(var a=o.removeEventListener;a._rollbarOldRemove&&a.belongsToShim;)a=a._rollbarOldRemove;var l=function(r,o,e){a.call(this,r,o&&o._rollbar_wrapped||o,e)};l._rollbarOldRemove=a,l.belongsToShim=e,o.removeEventListener=l}}r.exports={captureUncaughtExceptions:e,captureUnhandledRejections:t,wrapGlobals:a}},function(r,o){"use strict";function e(r,o){this.impl=r(o,this),this.options=o,n(e.prototype)}function n(r){for(var o=function(r){return function(){var o=Array.prototype.slice.call(arguments,0);if(this.impl[r])return this.impl[r].apply(this.impl,o)}},e="log,debug,info,warn,warning,error,critical,global,configure,handleUncaughtException,handleUnhandledRejection,_createItem,wrap,loadFull,shimId,captureEvent,captureDomContentLoaded,captureLoad".split(","),n=0;n<e.length;n++)r[e[n]]=o(e[n])}e.prototype._swapAndProcessMessages=function(r,o){this.impl=r(this.options);for(var e,n,t;e=o.shift();)n=e.method,t=e.args,this[n]&&"function"==typeof this[n]&&("captureDomContentLoaded"===n||"captureLoad"===n?this[n].apply(this,[t[0],e.ts]):this[n].apply(this,t));return this},r.exports=e},function(r,o){"use strict";r.exports=function(r){return function(o){if(!o&&!window._rollbarInitialized){r=r||{};for(var e,n,t=r.globalAlias||"Rollbar",a=window.rollbar,l=function(r){return new a(r)},i=0;e=window._rollbarShims[i++];)n||(n=e.handler),e.handler._swapAndProcessMessages(l,e.messages);window[t]=n,window._rollbarInitialized=!0}}}}]); // End Rollbar Snippet </script> <script src="https://www.google.com/recaptcha/api.js?render=6LdDCakUAAAAAEFI0Kyx_gg9t-G4r1mOWrIwFLd0"></script> <script src="https://leanpub.com/assets/modernizr-a38b94cc0625ba4488942166ee4d23a4.js"></script> <script src="//www.google.com/jsapi"></script> <script src="https://leanpub.com/assets/chartkick-ecf78465738cad825935037ff8bba32a.js"></script> <link rel="stylesheet" media="screen" href="https://leanpub.com/assets/stylesheets/header-bundle-408d358a86027a178756.css" /> <script src="/mathjax/MathJax.js?config=TeX-AMS_HTML-full.js" type="text/javascript"></script> <script> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); ga('create', 'G-XQK3X47PGQ', 'auto'); // Replace with your property ID. ga('require', 'ec'); // Visitor type parameters (only settable from non cached) ga('send', 'pageview'); </script> </head> <body id='reads-show'> <div class='flash' id='js-flash-prototype'> <div class='flash__progress-bar'></div> <div class='container--large'> <div class='flash__message'></div> <div class='flash__close-icon'> <!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"> <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" height="25px" id="Layer_1" style="enable-background:new 0 0 512 512;" version="1.1" viewBox="0 0 512 512" width="25px" xml:space="preserve"><path d="M437.5,386.6L306.9,256l130.6-130.6c14.1-14.1,14.1-36.8,0-50.9c-14.1-14.1-36.8-14.1-50.9,0L256,205.1L125.4,74.5 c-14.1-14.1-36.8-14.1-50.9,0c-14.1,14.1-14.1,36.8,0,50.9L205.1,256L74.5,386.6c-14.1,14.1-14.1,36.8,0,50.9 c14.1,14.1,36.8,14.1,50.9,0L256,306.9l130.6,130.6c14.1,14.1,36.8,14.1,50.9,0C451.5,423.4,451.5,400.6,437.5,386.6z"></path></svg> </div> </div> </div> <script type='text/javascript'> window.__menu_data__ = null window.__menuPath__ = null window.__hidesStoreContent__ = true </script> <div id='react-header-root'></div> <script> window.__BASE_URL__ = "https://leanpub.com/" </script> <script src="https://leanpub.com/assets/polyfill-bundle-5f104fb50a95af5ea5b4.js"></script> <script src="https://leanpub.com/assets/header-bundle-408d358a86027a178756.js"></script> <div class='scroll-wrapper' id='scroll-wrapper'> <div class='main ruby-main'> <button class='toggle-sidebar btn btn--plain'> <div class='fa fa-list-ol'></div> </button> <div class='container--large' id='read-online' lang='en'> <header class='read-online-slidable'> <div class='read-upsell'> <a href="/manual"><img alt="The Leanpub Manual" src="https://d2sofvawe08yqg.cloudfront.net/manual/s_shelf?1621300401" /></a> <div class='upsell-text'> <div class='book-title'>The Leanpub Manual</div> <div class='book-author'>Peter Armstrong and Len Epp</div> </div> </div> <a class="btn--solid" href="/manual">Buy on Leanpub</a> <hr> </header> <section class='read'> <div id="leanpub-toc"> <h2>Table of Contents</h2> <ol class="toc"> <ul class="toc no-parts"> <li> <a href="#leanpub-auto-support">Support</a> <ul> <li> <a href="#leanpub-auto-where-to-get-help">Where to Get Help</a> </li> </ul> </li> <li> <a href="#leanpub-auto-about-the-leanpub-manual">About The Leanpub Manual</a> </li> <li> <a href="#leanpub-auto-the-5-writing-modes-of-leanpub">The 5 Writing Modes of Leanpub</a> <ul> <li> <a href="#leanpub-auto-reasons-to-use-github-or-bitbucket">Reasons to Use GitHub or Bitbucket</a> </li> </ul> </li> <li> <a href="#leanpub-auto-markua-vs-leanpub-flavoured-markdown">Markua vs. Leanpub Flavoured Markdown</a> <ul> <li> <a href="#leanpub-auto-switching-writing-modes">Switching Writing Modes</a> </li> </ul> </li> <li> <a href="#getting-started-with-browser-writing-mode">Getting Started with In-Browser Plain Text Editor Writing Mode</a> <ul> <li> <a href="#creating-a-preview-in-browser-writing-mode">Creating a Book in In-Browser Plain Text Editor Writing Mode</a> </li> <li> <a href="#getting-started">Getting Started</a> </li> <li> <a href="#where-you-write-your-book">Where You Write Your Book</a> </li> <li> <a href="#creating-a-preview-in-browser-mode">Creating a Preview</a> </li> <li> <a href="#writing-your-book-in-browser-mode">Writing In Your Book</a> </li> <li> <a href="#next-steps-in-browser-mode">Next Steps</a> </li> </ul> </li> <li> <a href="#getting-started-with-dropbox-writing-mode">Getting Started with Dropbox Writing Mode</a> <ul> <li> <a href="#creating-a-book-in-dropbox-writing-mode">Creating a Book in Dropbox Writing Mode</a> </li> <li> <a href="#setting-up-your-book-in-dropbox">Setting Up Your Book In Dropbox</a> </li> <li> <a href="#creating-a-preview-in-dropbox-writing-mode">Creating a Preview</a> </li> <li> <a href="#writing-your-book-in-dropbox-mode">Writing in Your Book</a> </li> <li> <a href="#make-a-new-preview-of-your-book-in-dropbox-mode">Make a New Preview of Your Book</a> </li> <li> <a href="#how-the-list-of-files-in-book-txt-works-in-dropbox-mode">How the List of Files in Book.txt Works</a> </li> <li> <a href="#next-steps-in-dropbox-mode">Next Steps</a> </li> </ul> </li> <li> <a href="#getting-started-with-github-writing-mode">Getting Started with Git and GitHub Writing Mode</a> <ul> <li> <a href="#creating-your-books-github-repository">Creating Your Book’s GitHub Repository</a> </li> <li> <a href="#creating-a-book-in-github-writing-mode">Creating a Book in GitHub Writing Mode</a> </li> <li> <a href="#leanpub-auto-adding-leanpub-as-a-collaborator-on-your-books-github-repository">Adding Leanpub As A Collaborator on Your Book’s GitHub Repository</a> </li> <li> <a href="#adding-default-content-to-your-github-repository">Adding Default Content to Your GitHub Repository</a> </li> <li> <a href="#creating-a-preview-in-github-writing-mode">Creating a Preview</a> </li> <li> <a href="#writing-your-book-in-github-mode">Writing in Your Book</a> </li> <li> <a href="#make-a-new-preview-of-your-book-in-github-mode">Make a New Preview of Your Book</a> </li> <li> <a href="#how-the-list-of-files-in-book-txt-works-in-github-mode">How the List of Files in Book.txt Works</a> </li> <li> <a href="#next-steps-in-github-mode">Next Steps</a> </li> </ul> </li> <li> <a href="#getting-started-with-bitbucket-writing-mode">Getting Started with Git and Bitbucket Writing Mode</a> <ul> <li> <a href="#creating-your-books-bitbucket-repository">Creating Your Book’s Bitbucket Repository</a> </li> <li> <a href="#creating-a-book-in-bitbucket-writing-mode">Creating a Book in Bitbucket Writing Mode</a> </li> <li> <a href="#adding-leanpub-as-a-collaborator-on-bitbucket">Adding Leanpub As A Collaborator on Your Book’s Bitbucket Repository</a> </li> <li> <a href="#adding-default-content-to-your-bitbucket-repository">Adding Default Content to Your Bitbucket Repository</a> </li> <li> <a href="#creating-a-preview-in-bitbucket-writing-mode">Creating a Preview</a> </li> <li> <a href="#writing-your-book-in-bitbucket-mode">Writing in Your Book</a> </li> <li> <a href="#make-a-new-preview-of-your-book-in-bitbucket-mode">Make a New Preview of Your Book</a> </li> <li> <a href="#how-the-list-of-files-in-book-txt-works-in-bitbucket-mode">How the List of Files in Book.txt Works</a> </li> <li> <a href="#next-steps-in-bitbucket-mode">Next Steps</a> </li> </ul> </li> <li> <a href="#getting-started-with-byob-mode">Getting Started with Bring Your Own Book Writing Mode</a> <ul> <li> <a href="#creating-a-book-in-byob-mode">Creating a Book in Bring Your Own Book Writing Mode</a> </li> <li> <a href="#uploading-your-book-in-byob-mode">Uploading Your Book In Bring Your Own Book</a> </li> <li> <a href="#adding-your-profile-and-your-book-information">Adding Your Profile and Your Book Information</a> </li> <li> <a href="#publishing-your-book-in-byob-mode">Publishing Your Book</a> </li> <li> <a href="#next-steps-in-byob-mode">Next Steps</a> </li> </ul> </li> </ul> </ol> </div> <div id="leanpub-main" class="markua"> <h1 id="leanpub-auto-support" class="chapter"> <a class="anchor-link" href="#leanpub-auto-support"><i class="fa fa-link"></i></a>Support</h1> <h2 id="leanpub-auto-where-to-get-help" class="section"> <a class="anchor-link" href="#leanpub-auto-where-to-get-help"><i class="fa fa-link"></i></a>Where to Get Help</h2> <h3 id="leanpub-auto-readers" class="subsection"> <a class="anchor-link" href="#leanpub-auto-readers"><i class="fa fa-link"></i></a>Readers</h3> <dl> <dt>Help Center</dt> <dd>We have <b>lots</b> of great documentation and FAQs for readers and authors in our Help Center at <a href="http://help.leanpub.com">http://help.leanpub.com</a>. Basically, whenever we’re asked a good, general question, we post a generalized version of the answer there as well. There are specific sections for <a href="http://help.leanpub.com/en/collections/32701-reader-help">readers</a> and <a href="http://help.leanpub.com/en/collections/32925-purchasing-help">purchasing</a>, or you can just <a href="http://help.leanpub.com/en/">search the entire help center</a>.</dd> <dt>Email <a href="mailto:hello@leanpub.com">hello@leanpub.com</a> </dt> <dd>If you have a specific problem that you can’t find the answer to in our Help Center and don’t want to post on the forum, email us at <a href="mailto:hello@leanpub.com">hello@leanpub.com</a> and we’ll be happy to help you.</dd> </dl> <h3 id="leanpub-auto-leanpub-authors" class="subsection"> <a class="anchor-link" href="#leanpub-auto-leanpub-authors"><i class="fa fa-link"></i></a>Leanpub Authors</h3> <dl> <dt>Help Center</dt> <dd>Our help center isn’t just for readers. We have <b>lots</b> of great documentation and FAQs in our Help Center for Leanpub authors as well. In fact, there are about three times as many <a href="http://help.leanpub.com/en/collections/32694-author-help">articles for authors</a> on our Help Center as there are for readers. The Help Center is at <a href="http://help.leanpub.com">http://help.leanpub.com</a>.</dd> <dt>The Leanpub Author Forum</dt> <dd>Just as every Leanpub book can have a forum, we have a forum for Leanpub authors as well. Join the <a href="https://community.leanpub.com/c/authors">Leanpub Author Forum</a> and post your question there. Our authors enjoys helping each other out, and we pay attention too. Please ask all general questions there.</dd> <dt>Email <a href="mailto:hello@leanpub.com">hello@leanpub.com</a> </dt> <dd>If you have a specific problem that you can’t find the answer to in our Help Center and don’t want to post on the forum, email us at <a href="mailto:hello@leanpub.com">hello@leanpub.com</a> and we’ll be happy to help you.</dd> <dt>Getting Started</dt> <dd>To learn how to get started with the various writing modes, read this manual.</dd> <dt>Markua</dt> <dd>To learn how to write in Markua on Leanpub, see <a href="https://leanpub.com/markua/read">The Markua Manual</a>.</dd> <dt>Leanpub Flavoured Markdown</dt> <dd>To learn how to write in Leanpub Flavoured Markdown, see <a href="https://leanpub.com/lfm/read">The Leanpub Flavoured Markdown Manual</a>.</dd> <dt>The Leanpub Frontmatter Podcast</dt> <dd>Leanpub has a podcast called <a href="https://leanpub.com/podcasts/frontmatter">Frontmatter</a>, where we interview authors about their lives & careers, their areas of expertise and the issues of the moment, and their experiences as authors. Every episode is deeply researched and covers subjects that are equally of human interest, general interest, and of professional interest, particularly for writers. We highly recommend it as a resource during your writing journey.</dd> </dl> <h1 id="leanpub-auto-about-the-leanpub-manual" class="chapter"> <a class="anchor-link" href="#leanpub-auto-about-the-leanpub-manual"><i class="fa fa-link"></i></a>About The Leanpub Manual</h1> <p>Welcome to <a href="http://leanpub.com/manual">The Leanpub Manual</a>!</p> <p>This is a short manual. It contains three things:</p> <ol> <li>A description of the various writing modes.</li> <li>A discussion of Leanpub Flavoured Markdown vs. Markua</li> <li>Getting Started instructions for each writing mode.</li> </ol> <p>The Getting Started instructions in this many vary based on the writing mode of your book. So, you should only read the Getting Started chapter for the specific writing mode you have chosen.</p> <p>If you already know which writing mode you want to choose, and if the Leanpub Flavoured Markdown vs. Markua decision doesn’t apply (or you want to save it for later), you can skip to the Getting Started chapter for that writing mode now.</p> <p>If you want to first learn a bit about the different writing modes, and a bit about the Leanpub Flavoured Markdown vs. Markua decision, read on.</p> <h1 id="leanpub-auto-the-5-writing-modes-of-leanpub" class="chapter"> <a class="anchor-link" href="#leanpub-auto-the-5-writing-modes-of-leanpub"><i class="fa fa-link"></i></a>The 5 Writing Modes of Leanpub</h1> <p>There are 5 different writing modes on Leanpub:</p> <ol> <li>Leanpub In-Browser Text Editor</li> <li>Dropbox</li> <li>GitHub</li> <li>Bitbucket</li> <li>Bring Your Own Book</li> </ol> <p>In the first four writing modes, you write in plain text. This plain text can be formatted in either Leanpub Flavoured Markdown (LFM) or Markua. Both of these are dialects of Markdown, which was created as a way for bloggers to easily write blog posts. (Markdown is easier to write than HTML.)</p> <p>In the last writing mode, Bring Your Own Book, you don’t write in plain text, so you don’t write in either Leanpub Flavoured Markdown or Markua. Instead, you write your book any way you like (such as using Word, Pages, or LaTeX), and then you just upload PDF, EPUB, and MOBI files that you produce using your tools. (You can also choose to upload any one or two of these formats - you don’t need all three.)</p> <p>So, if you’re using our In-Browser Text Editor, Dropbox, GitHub, or Bitbucket, you’ll be able to use Leanpub Flavoured Markdown or Markua. You can change back and forth between them as often as you want. It’s as easy as clicking a checkbox.</p> <h2 id="leanpub-auto-reasons-to-use-github-or-bitbucket" class="section"> <a class="anchor-link" href="#leanpub-auto-reasons-to-use-github-or-bitbucket"><i class="fa fa-link"></i></a>Reasons to Use GitHub or Bitbucket</h2> <p>If you’re a programmer and comfortable with Git, we recommend you choose GitHub or Bitbucket over Dropbox. Here are 5 reasons why:</p> <ol> <li>You can run your own version control, which is great for collaborating with co-authors and keeping track of versions for yourself.</li> <li>You can also choose a Dropbox folder for the generated preview and published versions of your book to be automatically copied into.</li> <li>You can set up webhooks so that whenever you commit and push, we automatically preview (or, if you live on the edge, automatically publish) your book.</li> <li>You can use different branches for preview and publish, so that you can have a bugfix branch (say master) and a development branch for the next version of your book.</li> <li>You can use a different branch for a course, based on the same repository as the book. (Again, courses require that you use Markua, so if you’re writing a book which you think might be a good course, that’s another reason to use it.)</li> </ol> <p>If you’re not a programmer, we recommend using Dropbox mode. Every time you preview or publish, we store a version of your manuscript as a backup, so we recommend you preview and publish often.</p> <h1 id="leanpub-auto-markua-vs-leanpub-flavoured-markdown" class="chapter"> <a class="anchor-link" href="#leanpub-auto-markua-vs-leanpub-flavoured-markdown"><i class="fa fa-link"></i></a>Markua vs. Leanpub Flavoured Markdown</h1> <p>On Leanpub, there are two ways to write in plain text:</p> <ol> <li>Markua</li> <li>Leanpub Flavoured Markdown (LFM)</li> </ol> <p>Leanpub Flavoured Markdown came first; Markua is its replacement. Both LFM and Markua are dialects of Markdown. Markua is newer and better than LFM.</p> <p>To write in Markua or LFM, you need to be in Dropbox, GitHub or Bitbucket writing mode, or you need to be writing in the Leanpub In-Browser Text Editor.</p> <p>There are six good reasons to write a book in Markua:</p> <ol> <li>Markua is better than LFM. A lot better. Markua fixes the many mistakes we made with LFM.</li> <li>Markua is the future of Leanpub.</li> <li>Markua has more features than LFM.</li> <li>If you want to create a course on Leanpub, you need to use Markua.</li> <li>The Leanpub In-Browser Text Editor is better with Markua now, and it’s going to be way better soon. (We’re working on an upgrade to the Leanpub In-Browser Text Editor which will only be available for Markua books.)</li> <li>The Markua Manual is newer and better than the Leanpub Flavoured Markdown Manual.</li> </ol> <p>There are two good reasons to write a book in LFM:</p> <ol> <li>You already started your book in LFM and you don’t want to convert it yet.</li> <li>You are writing a translation of a book which is written in LFM.</li> </ol> <h2 id="leanpub-auto-switching-writing-modes" class="section"> <a class="anchor-link" href="#leanpub-auto-switching-writing-modes"><i class="fa fa-link"></i></a>Switching Writing Modes</h2> <p>If you have an existing Leanpub book and you want to switch writing modes, you go here:</p> <p><b>Author > Books > (your book) > Settings > Writing Mode</b></p> <p>Once you’ve chosen an appropriate writing mode, you then can switch between the Markua and LFM dialects of Markdown here:</p> <p><b>Author > Books > (your book) > Settings > Markdown Dialect</b></p> <h1 id="getting-started-with-browser-writing-mode" class="chapter"> <a class="anchor-link" href="#getting-started-with-browser-writing-mode"><i class="fa fa-link"></i></a>Getting Started with In-Browser Plain Text Editor Writing Mode</h1> <p>You can write a Leanpub book using the In-Browser Plain Text Editor writing mode. In this section we’ll show you how to create a book, how to write in the In-Browser Editor, and how generate your first preview.</p> <blockquote> <p>We also have a video, if you prefer to learn that way! You can watch the video here: <a href="https://youtu.be/QC8Utbrc9MM">https://youtu.be/QC8Utbrc9MM</a>. </p> </blockquote> <p>Once you have successfully generated your first preview, you’ll know everything you know to get started writing in the In-Browser Plain Text Editor writing mode.</p> <p>You’ll find more information and detailed instructions on the “Getting Started” page for your book, which you’ll go to automatically when you create your book.</p> <h2 id="creating-a-preview-in-browser-writing-mode" class="section"> <a class="anchor-link" href="#creating-a-preview-in-browser-writing-mode"><i class="fa fa-link"></i></a>Creating a Book in In-Browser Plain Text Editor Writing Mode</h2> <p>Go to <a href="https://leanpub.com/create/book">https://leanpub.com/create/book</a> to create a book in our In-Browser Plain Text Editor writing mode.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----1-book-create-shared.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Next, type a title for your book into the “TITLE” box. You can change your title later.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----IB1.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Click in the “BOOK URL” box. Leanpub will automatically suggest a URL for your book’s web page on Leanpub. You can change this URL at any time.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----IB2.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Scroll down and you will see “MAIN LANGUAGE USED IN YOUR BOOK.” You can select a language from the drop-down. Like the other settings, you can change this at any time.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----2-book-language.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Scroll down and you will see the “BOOK THEME” options. “Business” will be selected by default. The Book Theme is just a set of standard formatting options conventional for books on these subjects. You are not required to choose any particular option. You can change your Book Theme at any time.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----3-book-theme.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>In the section below, you will be presented with various Writing Mode options. By default, the “In your web browser” option will be selected, which is what we want:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----4-in-your-browser.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>When you scroll down, you will see the subscription plan options. By default, “Standard” will be selected, if you are setting up your first book in Leanpub.</p> <p>Select a plan.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----6-accounts.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Scroll down and, if you are not signed in to a Leanpub account, you will see an option to enter information to create a new account. You will also see an option to sign in, if you already have a Leanpub account.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----7-account-create.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>To create a new account, fill in the relevant information.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----8-account-info.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>If you selected a paid account, you’ll see a form for entering your payment information:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----9-payment-form.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Finally, click the blue button to finish creating your new In-Browser Plain Text Editor book.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----10-sign-up-for-standard-plan.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <h2 id="getting-started" class="section"> <a class="anchor-link" href="#getting-started"><i class="fa fa-link"></i></a>Getting Started</h2> <p>You will now be taken to the Getting Started page for the In-Browser Plain Text Editor writing mode:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----IB-w-0.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>On this page, you will see lots of helpful information that we recommend you read at some point. However, for this tutorial, let’s just dive in to the In-Browser Plain Text editor, where you will spend your time writing your book!</p> <p>To go to the editor, click the link at the top of the page that says <b>”If you already know what you’re doing and you just want to start writing, click here!”</b></p> <h2 id="where-you-write-your-book" class="section"> <a class="anchor-link" href="#where-you-write-your-book"><i class="fa fa-link"></i></a>Where You Write Your Book</h2> <p>You will now be taken directly to the page where you will be writing your book:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----IB-w-1.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>If you use bookmarks in your web browser, we recommend you bookmark this page in your web browser in a bookmark folder for your book, but this is not required.</p> <p>When you are on the Write page, you will see a menu of files at the top left.</p> <p>You will see that we have provided three default chapter files:</p> <figure class="code " dir="ltr"> <figcaption></figcaption> <div class="highlight"><pre><code></code>chapter1txt chapter2txt chapter3txt </pre></div> </figure> <p>First, click on the <code>chapter1txt</code> file at the top right.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----IB-w-2.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>This will take you to the first chapter of the default content Leanpub provides to help you get started with each new book:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----IB-w-3.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <h2 id="creating-a-preview-in-browser-mode" class="section"> <a class="anchor-link" href="#creating-a-preview-in-browser-mode"><i class="fa fa-link"></i></a>Creating a Preview</h2> <p>Next, let’s create a Preview of your book from the default chapter content. (A “Preview” is a private version of your book you can create at any time, to see what your book looks like.) </p> <p>To do this click on the <code>Preview</code> link you’ll see at the top of the page:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----IB-w-4.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>This will take you to the Preview page for your book:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----IB-w-5.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Now, click the blue “Create Preview” button.</p> <p>You will now see a progress bar at the top of the page. This shows the steps carried out by Leanpub’s book generators, every time you create a new Preview.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----IB-w-7.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>When the process is complete, the progress bar will turn green, and you’ll see the download links for your book:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----IB-w-8.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Next, click the top link to download the PDF version of your Preview:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----IB-w-9.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Here’s what the PDF looks like when it is opened on a Mac (your PDF might look different, depending on your settings, and what app is used to open the PDF on your device):</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 50%"> <img alt="" src="/site_images/manual/images----IB-w-10.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Go to the fourth page in the document, and you’ll see the same content you saw on the Write page earlier, when you selected the first chapter:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 50%"> <img alt="" src="/site_images/manual/images----IB-w-11.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>(Also, your device might not open the PDF automatically. If it does not open automatically when the download completes, to open the PDF, you’ll need to go to the folder on your computer where you keep files downloaded from the internet.)</p> <h2 id="writing-your-book-in-browser-mode" class="section"> <a class="anchor-link" href="#writing-your-book-in-browser-mode"><i class="fa fa-link"></i></a>Writing In Your Book</h2> <p>OK, now let’s do some writing!</p> <p>Let’s go back to the Write page for your book. To do that, select <code>Write</code> from the Leanpub menu:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----IB-w-12.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>This will take you back to the Write page:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----IB-w-14.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>In this step of the tutorial we will show you how to write in your book, and how to add and delete chapters.</p> <p>First, let’s type something in the first chapter. Click into the page, and you’ll see the editor changes to a “focus” mode, with less clutter, so you can focus when are writing:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----IB-w-15.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Next, hit the Enter or Return key a couple of times and then type <code>Hello World!</code></p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----IB-w-16.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Any changes you type in the editor will be saved automatically.</p> <p>Next, let’s delete a chapter. Click on the left side of the screen to bring back the chapter menu:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----IB-w-17.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Hover your mouse over <code>chapter3txt</code> and click on the gear wheel icon you will see:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----IB-w-18.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Now, you’ll see a box appear called <code>File Settings</code>:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----IB-w-19.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>You can do a few things in the <code>File Settings</code> box, including rename the file.</p> <p>We want to delete this chapter, so next, click the red “Delete File” button:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----IB-w-20.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>The chapter will now disappear from the menu at the left:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----IB-w-21.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Next, let’s create a new chapter.</p> <p>In the menu on the left, click on the + sign in the circle:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----IB-w-22.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>You will now see a box appear, where you can type a name for your new chapter:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----IB-w-23.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Let’s name this chapter <code>Conclusion</code>. First, type <code>Conclusion</code> in the box:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----IB-w-24.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Then, click the blue <code>OK</code> button:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----IB-w-25.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>You will now see a chapter file on the left called “Conclusion.”</p> <p>Now, you will see a blinking cursor in the Write tab. Type the following:</p> <figure class="code " dir="ltr"> <figcaption></figcaption> <div class="highlight"><pre><code></code># Conclusion This book is **done** and ready for *the world to see*, hooray! </pre></div> </figure> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----IB-w-26.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>OK, let’s make a new Preview, to see what the book looks like now. Click <code>Preview</code> at the top of the page:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----IB-w-27.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>This will take you back to the Preview page for your book:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----Ib-w-28.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Scroll down to see the blue <code>Create Preview</code> button, and click on it, to generate a new Preview of your book:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----IB-w-29.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>When the process completes, you will see the links, with an updated time stamp (the time is set to Coordinated Universal Time):</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----IB-w-30.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Click on the PDF download link at the top, like you did earlier in this walkthrough.</p> <p>You will now see that there is a chapter called <code>Conclusion</code> in the table of contents:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 50%"> <img alt="" src="/site_images/manual/images----IB-w-31.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Next, go to Chapter One, and you’ll see <code>Hello World!</code> there now:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 50%"> <img alt="" src="/site_images/manual/images----IB-w-32.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Finally, go to the end of the PDF, to see the <code>Conclusion</code>:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 50%"> <img alt="" src="/site_images/manual/images----IB-w-33.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p><b>Congratulations!</b> You’ve completed the Getting Started walkthrough for writing a book in Leanpub using our In-Browser Plain Text Editor.</p> <h2 id="next-steps-in-browser-mode" class="section"> <a class="anchor-link" href="#next-steps-in-browser-mode"><i class="fa fa-link"></i></a>Next Steps</h2> <p>Next, we recommend you explore the Overview page for your book:</p> <p><code>Author > Books > [Your Book Title] > Book Info > Overview</code></p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----IB-w-34.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>On the Overview page, you can see all the pages you need to get your book set up on Leanpub, like “Upload Book Cover” and the “Book Details” page, where you can explain what your book is about to potential readers.</p> <p>You might also want to check out the Markua manual <a href="https://leanpub.com/markua/read">here</a>:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----IB-w-35.jpeg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Markua is the name of the manuscript markup system you use to write books in plain text on Leanpub. It’s easy to learn the basics you need to write most books. In fact you know some Markyua already: in this tutorial, when you created the <code>Conclusion</code> chapter, you learned to type # at the beginning of a line to make a chapter heading!</p> <p>If you have any questions or can’t find anything, please search our Help Center for authors here: <a href="http://help.leanpub.com/author-help">http://help.leanpub.com/author-help</a>.</p> <p>You can also reach out to our friendly and knowledgable community of successful Leanpub authors here: <a href="https://community.leanpub.com/c/authors">https://community.leanpub.com/c/authors</a>.</p> <p>Happy writing!</p> <h1 id="getting-started-with-dropbox-writing-mode" class="chapter"> <a class="anchor-link" href="#getting-started-with-dropbox-writing-mode"><i class="fa fa-link"></i></a>Getting Started with Dropbox Writing Mode</h1> <p>You can write a Leanpub book using Dropbox. In this chapter we’ll show you how to create a book and generate your first preview.</p> <p>Once you have successfully generated your first preview, you’ll know everything you know to get started writing in the Dropbox writing mode.</p> <p>You’ll find more information and detailed instructions on the “Getting Started” page for your book, which you’ll go to automatically when you create your book.</p> <h2 id="creating-a-book-in-dropbox-writing-mode" class="section"> <a class="anchor-link" href="#creating-a-book-in-dropbox-writing-mode"><i class="fa fa-link"></i></a>Creating a Book in Dropbox Writing Mode</h2> <p>Go to <a href="https://leanpub.com/create/book">https://leanpub.com/create/book</a> to create a new book in Dropbox.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----book-create.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Next, type a title for your book into the “TITLE” box. You can change your title later.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----DB2.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Click in the “BOOK URL” box. Leanpub will automatically suggest a URL for your book’s web page on Leanpub. You can change this URL at any time.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----DB3.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Scroll down and you will see “MAIN LANGUAGE USED IN YOUR BOOK.” You can select a language from the drop-down. Like the other settings, you can change this at any time.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----book-language.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Scroll down and you will see the “BOOK THEME” options. “Business” will be selected by default. The Book Theme is just a set of standard formatting options conventional for books on these subjects. You are not required to choose any particular option. You can change your Book Theme at any time.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----book-theme.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>For this tutorial, we selected the “Fiction” Book Theme.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----book-fiction.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>In the section below, you will be presented with various Writing Mode options. For this tutorial, you don’t need to do anything, because writing on your computer in Dropbox is selected by default.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----DB7.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>When you scroll down, you will see the subscription plan options. By default, “Free” will be selected. If you have a paid Leanpub account already, you will see that plan selected automatically.</p> <p>Select a plan.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----accounts.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Scroll down and, if you are not signed in to a Leanpub account, you will see an option to enter information to create a new account. You will also see an option to sign in, if you already have a Leanpub account.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----account-create.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>To create a new account, fill in the relevant information.</p> <p><b>In Dropbox mode, you should use the same email address for Leanpub as you do for your Dropbox account.</b> If you don’t have Dropbox account, you can get one for free here:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----account-info.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Finally, click the blue button to finish creating your new Dropbox book.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----sign-up-for-free-plan.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>You will now see that you are on the Getting Started page for your book. You will see a progress bar at the top of the page, while our book generators are creating your new book.</p> <p>If you use bookmarks in your web browser, we recommend you bookmark this page in your web browser in a bookmark folder for your book, but this is not required.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----DB8.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Look at the Author “breadcrumb” menu at the top of the screen. This is how you will navigate to the web pages you will be using in Leanpub to work on your book and see all the features we provide, like uploading a book cover, or setting a price for your book.</p> <p>When you are finished this tutorial, we recommend you explore the various Author options.</p> <h2 id="setting-up-your-book-in-dropbox" class="section"> <a class="anchor-link" href="#setting-up-your-book-in-dropbox"><i class="fa fa-link"></i></a>Setting Up Your Book In Dropbox</h2> <p>When you clicked the button to create your book, Leanpub’s Bookbot created a folder for your book in Dropbox, and sent a Dropbox shared folder invitation to the email address you used when you signed up.</p> <p>It may take one or two minutes for you to receive the Dropbox shared folder invitation.</p> <p>To accept the invitation, you can click on the Dropbox icon in the menu bar for your computer (these images are on a Mac; if you are using a PC, it will look different.)</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 358px"> <img alt="" src="/site_images/manual/images----DB9.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Click “Add to Dropbox.”</p> <p>Alternatively, you can accept the invitation by logging in to Dropbox. You should see the book invitation near the top of the “Home” screen:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----DB10.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>If you click on the invitation, you will be able to click “Add to Dropbox:”</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 385px"> <img alt="" src="/site_images/manual/images----DB11.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Another way to accept the Dropbox invitation is in your email. Here is what it looks like in Gmail:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----DB12.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>If you open the email, you should see a button that takes you to your Dropbox account in your browser, and then lets you accept the invitation:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----DB13.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Within a minute or two, in your Dropbox folder on your computer, you should see the folder for your new book:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----DB14.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <h2 id="creating-a-preview-in-dropbox-writing-mode" class="section"> <a class="anchor-link" href="#creating-a-preview-in-dropbox-writing-mode"><i class="fa fa-link"></i></a>Creating a Preview</h2> <p>To create your first preview, using the default content we included in your new book, go back the Getting Started page for your book:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----DB8.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Click on “Getting Started” at the top, and you will see the Author menu. It will look something like this:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----DB15.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Click on “Preview or Publish” under the “Book Info” column, and you will see something like this:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----DB16.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Select “Preview’ in the column to the right, and you will go to the “Preview” page for your book:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----DB17.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Click the “Create Preview” button. You will go to a page like this, where you will see a progress bar at the top:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----DB18.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>When the preview process is complete, you will see download links for the preview, in a variety of formats:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----DB19.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Click on the links to see what your book looks like in the various formats.</p> <h2 id="writing-your-book-in-dropbox-mode" class="section"> <a class="anchor-link" href="#writing-your-book-in-dropbox-mode"><i class="fa fa-link"></i></a>Writing in Your Book</h2> <p>Open your book folder in Dropbox. You’ll see a folder named <code>manuscript</code> inside it. This is where you write your book.</p> <p>If you have just created a new book, the <code>manuscript</code> folder will contain four files with the file name extension <code>.txt</code>. There will also be a folder called <code>resources</code>:</p> <figure class="code " dir="ltr"> <figcaption></figcaption> <div class="highlight"><pre><code></code>Book.txt chapter1.txt chapter2.txt chapter3.txt resources </pre></div> </figure> <p>Open the file called <code>chapter1.txt</code> by double-clicking on it. You can also open the file in any specific text editing software you prefer.</p> <p>Next, delete the contents of the file and type:</p> <figure class="code " dir="ltr"> <figcaption></figcaption> <div class="highlight"><pre><code></code># Chapter 1 Hello, world! </pre></div> </figure> <p>In your text editor, save this change.</p> <h2 id="make-a-new-preview-of-your-book-in-dropbox-mode" class="section"> <a class="anchor-link" href="#make-a-new-preview-of-your-book-in-dropbox-mode"><i class="fa fa-link"></i></a>Make a New Preview of Your Book</h2> <p>The next time you create a preview of your book, you will see that Chapter One has changed, and it now says “Hello, world!”</p> <p>To create a new preview, repeat what you did when you made your first preview, by using the Author menu in Leanpub to go to:</p> <p><code>Author > Books > [Your Book Title] > Preview or Publish > Preview</code></p> <h2 id="how-the-list-of-files-in-book-txt-works-in-dropbox-mode" class="section"> <a class="anchor-link" href="#how-the-list-of-files-in-book-txt-works-in-dropbox-mode"><i class="fa fa-link"></i></a>How the List of Files in Book.txt Works</h2> <p>When you create a preview, you may not want our book generators to use all of the files in your <code>manuscript</code> folder. Also, you may want the contents of your book to reflect a different order than the order they are presented in, in your <code>manuscript</code> folder.</p> <p>So, whenever you create a preview, our friendly bookbots generate your book using only the files that you have listed in the <code>Book.txt</code> file that is in your book’s <code>manuscript</code> folder, and they use those files in the order that you have listed them.</p> <p>Let’s see how this works.</p> <p>First, delete a file. In your book’s <code>manuscript</code> folder, select the file named <code>chapter3.txt</code> and delete it.</p> <p>Now, let’s rename a file. The files listed in <code>Book.txt</code> can have any name you want to give them. (To be clear, the files do not have to include the word “chatper” in the file name.)</p> <p>In your book’s <code>manuscript</code> folder, select the file <code>chapter2.txt</code>.</p> <p>Now, change the file name to <code>conclusion.txt</code> by right-clicking on the file and selecting “Rename.” **(Your computer might show a different word than “Rename,” but there should be an option to change any file’s name if you right-click on the file.)</p> <p>Now that we have changed the files in the <code>manuscript</code> folder, we need to update the list of files in the <code>Book.txt</code> file.</p> <p>Using your text editor, open the <code>Book.txt</code> file.</p> <p>In the <code>Book.txt</code> file, you will see this list of files, like this:</p> <figure class="code " dir="ltr"> <figcaption></figcaption> <div class="highlight"><pre><code></code>chapter1.txt chapter2.txt chapter3.txt </pre></div> </figure> <p>First, delete <code>chapter2.txt</code>. Then, delete <code>chapter3.txt</code>.</p> <p>Next, on the second line, type <code>conclusion.txt</code>.</p> <p>Now, your list of files in Book.txt will look like this:</p> <figure class="code " dir="ltr"> <figcaption></figcaption> <div class="highlight"><pre><code></code>chapter1.txt conclusion.txt </pre></div> </figure> <p>Next, open the file <code>conclusion.txt</code>.</p> <p>Now, delete everthing in the file, and type this:</p> <figure class="code " dir="ltr"> <figcaption></figcaption> <div class="highlight"><pre><code></code># Conclusion This book is **done** and ready for *the world to see*, hooray! </pre></div> </figure> <p>Finally, save this change your text editor.</p> <p>Go back to the preview page for your book at:</p> <p><code>Author > Books > [Your Book Title] > Preview or Publish > Preview</code></p> <p>The next time you create a preview, it will reflect the changes you have made.</p> <p><b>Congratulations!</b> You’ve completed the Getting Started tutorial for writing a book in Leanpub using Dropbox.</p> <h2 id="next-steps-in-dropbox-mode" class="section"> <a class="anchor-link" href="#next-steps-in-dropbox-mode"><i class="fa fa-link"></i></a>Next Steps</h2> <p>Next, we recommend you explore the Overview page for your book:</p> <p><code>Author > Books > [Your Book Title] > Book Info > Overview</code></p> <p>On the Overview page, you can see all the pages you need to get your book set up on Leanpub, like “Upload Book Cover” and the “Book Details” page, where you can explain what your book is about to potential readers.</p> <p>If you have any questions or can’t find anything, please search our Help Center for authors here: <a href="http://help.leanpub.com/author-help">http://help.leanpub.com/author-help</a>.</p> <p>Happy writing!</p> <h1 id="getting-started-with-github-writing-mode" class="chapter"> <a class="anchor-link" href="#getting-started-with-github-writing-mode"><i class="fa fa-link"></i></a>Getting Started with Git and GitHub Writing Mode</h1> <p>You can write a Leanpub book using Git and GitHub. In this chapter we’ll show you how to create a book and generate your first preview.</p> <p>Once you have successfully generated your first preview, you’ll know everything you know to get started writing in the GitHub writing mode.</p> <p>You’ll find more information and detailed instructions on the “Getting Started” page for your book, which you’ll go to automatically when you create your book.</p> <h2 id="creating-your-books-github-repository" class="section"> <a class="anchor-link" href="#creating-your-books-github-repository"><i class="fa fa-link"></i></a>Creating Your Book’s GitHub Repository</h2> <p>The first thing you need to is create a repository for your book on GitHub.</p> <p>To do this, go to <a href="https://github.com">https://github.com</a> and sign in.</p> <p>Click the green “New” button to the right of the list of Repositories.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----GH1.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>This will take you to a page where you can set up a new repository for your Leanpub book.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----GH2.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>By default, “Public” will be selected. This means anyone can see your repository. Select “Private” if you don’t want anyone to be able to see your repository.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----GH3.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Next, type a name for your repository.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----GH4.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Click the green “Create repository” button. If you want, you can click the checkbox to initialize the repository with a README. It doesn’t matter, but this will get rid of the warning message later.</p> <p>This will take you to a “Quick setup” page:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----GH5.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Select the repository information and copy it, or click the little copy-to-clipboard icon button.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----GH6.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Go to the command line on your computer. In this tutorial we’re using a Mac, so we use Terminal.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----GH7.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Go to the folder on your computer where you want to clone your GitHub repository. In this tutorial, that is a folder called <code>repos</code>.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----GH8.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Type <code>git clone</code> and paste in the repository information you copied on GitHub, and hit Enter.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----GH9.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>After a moment, you will see a message saying that the repository has been cloned.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----GH10.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <h2 id="creating-a-book-in-github-writing-mode" class="section"> <a class="anchor-link" href="#creating-a-book-in-github-writing-mode"><i class="fa fa-link"></i></a>Creating a Book in GitHub Writing Mode</h2> <p>Go to <a href="https://leanpub.com/create/book">https://leanpub.com/create/book</a> to create a book in GitHub writing mode.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----github-book-create.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>First, type a title for your book into the “TITLE” box. You can change your title later.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----GH11.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Click in the “BOOK URL” box. Leanpub will automatically suggest a URL for your book’s web page on Leanpub. You can change this URL at any time.</p> <p>In this case, the URL that was automatically generated was already taken. This will be rare for you, but is a lot more common for us when making tutorials!</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----GH12.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>If a URL you want is already taken, you can add hyphens or numbers to create a URL that is close to it, but it’s better to use other words so people don’t get confused between your book and someone else’s!</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----GH13.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Scroll down and you will see “MAIN LANGUAGE USED IN YOUR BOOK.” You can select a language from the drop-down. Like the other settings, you can change this at any time.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----book-language.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Scroll down and you will see the “BOOK THEME” options. “Business” will be selected by default. The Book Theme is just a set of standard formatting options conventional for books on these subjects. You are not required to choose any particular option. You can change your Book Theme at any time.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----book-theme.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>For this tutorial, we selected the “Fiction” Book Theme.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----book-fiction.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>In the section below, you will be presented with various Writing Mode options. For this tutorial, select “Using Git and GitHub.”</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----GH14.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Scroll down and you will see a box to enter your GitHub username, followed by a forward slash / and your GitHub repo name.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----GH15.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Enter your GitHub username, followed by a forward slash / and your GitHub repo name.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----GH16.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>When you scroll down further, you will see the subscription plan options. By default, “Free” will be selected. If you have a paid Leanpub account already, you will see that plan selected automatically.</p> <p>Select a plan.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----accounts.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Scroll down and, if you are not signed in to a Leanpub account, you will see an option to enter information to create a new account. You will also see an option to sign in, if you already have a Leanpub account.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----account-create.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>To create a new account, fill in the relevant information.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----account-info.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Finally, click the blue button to finish creating your new GitHub book.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----sign-up-for-free-plan.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>You will now see that you are on the Getting Started page for your book:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----getting-started-github.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>[Please note this screenshot has been updated, so it doesn’t exactly match the rest of the screenshots in this tutorial.]</p> <p>If you use bookmarks in your web browser, we recommend you bookmark this page in your web browser in a bookmark folder for your book, but this is not required.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----GH17.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Look at the Book Tools “breadcrumb” menu at the top of the screen. This is how you will navigate to the web pages you will be using in Leanpub to work on your book and see all the features we provide, like uploading a book cover, or setting a price for your book.</p> <p>When you are finished this tutorial, we recommend you explore the various Book Tools options.</p> <h2 id="leanpub-auto-adding-leanpub-as-a-collaborator-on-your-books-github-repository" class="section"> <a class="anchor-link" href="#leanpub-auto-adding-leanpub-as-a-collaborator-on-your-books-github-repository"><i class="fa fa-link"></i></a>Adding Leanpub As A Collaborator on Your Book’s GitHub Repository</h2> <p>Go back to the GitHub page for your book’s GitHub repository.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----GH18.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Click on “Settings” near the top right, to go to the “Settings” page for the repository.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----GH19.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Click on “Collaborators” in the menu on the left, to go to the “Collaborators” page for the repository.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----GH20.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Type “leanpub” in the search box to find the leanpub GitHub user.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----GH21.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Select the “leanpub” user and click the “Add collaborator” button.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----GH22.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Until Leanpub has automatically accepted the invite, previewing or publishing your book will not work. If this has not happened in 15 minutes, please email hello@leanpub.com and let us know!</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----GH22b.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>You will see that Leanpub has been added as a collaborator on the repository.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----GH23.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <h2 id="adding-default-content-to-your-github-repository" class="section"> <a class="anchor-link" href="#adding-default-content-to-your-github-repository"><i class="fa fa-link"></i></a>Adding Default Content to Your GitHub Repository</h2> <p>Next, you need to add some content to your GitHub repository. (Leanpub <b>NEVER</b> commits to your GitHub repository, since we do not want to cause merge conflicts.)</p> <p>To download our default book content, <a href="https://github.com/leanpub/default-new-book-content/archive/master.zip">click this link to download the zip file</a>. This will download the default content to your computer.</p> <p>You will now find the file wherever you store downloads on your computer.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----GH26.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Double-click the folder to unzip it.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----GH27.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Copy the “manuscript” folder. Then, go to the cloned GitHub repository on your computer, and paste the “manuscript” folder into the repository.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----GH28.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Go back to the command line on your computer and change to the GitHub repository for your book.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----GH29.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Type <code>git add .</code> to the content using Git.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----GH30.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Type <code>git commit -m "adding default manuscript folder"</code>. You will see messages indicating that the content has been committed.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----GH31.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Type <code>git push</code> to push the commit to the repository on GitHub.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----Gh32.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <h2 id="creating-a-preview-in-github-writing-mode" class="section"> <a class="anchor-link" href="#creating-a-preview-in-github-writing-mode"><i class="fa fa-link"></i></a>Creating a Preview</h2> <p>To create your first preview, using the default content we included in your new book, go back to the Getting Started page for your book:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----getting-started-github.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Click on “Getting Started” at the top, and you will see your the Book Tools menu. It will look something like this:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----GH33.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Click on “Preview or Publish” under the “Book Info” column, and you will see something like this:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----GH34.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Select “Preview’ in the column to the right, and you will go to the “Preview” page for your book:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----GH35.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Click the “Create Preview” button. You will go to a page like this, where you will see a progress bar at the top:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----GH36.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>When the preview process is complete, you will see download links for the preview, in a variety of formats:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----GH37.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Click on the links to see what your book looks like in the various formats.</p> <h2 id="writing-your-book-in-github-mode" class="section"> <a class="anchor-link" href="#writing-your-book-in-github-mode"><i class="fa fa-link"></i></a>Writing in Your Book</h2> <p>Open your book folder in Github. You’ll see a folder named <code>manuscript</code> inside it. This is where you write your book.</p> <p>If you have just created a new book, the <code>manuscript</code> folder will contain four files with the file name extension <code>.txt</code>. There will also be a folder called <code>resources</code>:</p> <figure class="code " dir="ltr"> <figcaption></figcaption> <div class="highlight"><pre><code></code>Book.txt chapter1.txt chapter2.txt chapter3.txt resources </pre></div> </figure> <p>Open the file called <code>chapter1.txt</code> by double-clicking on it. You can also open the file in any specific text editing software you prefer.</p> <p>Next, delete the contents of the file and type:</p> <figure class="code " dir="ltr"> <figcaption></figcaption> <div class="highlight"><pre><code></code># Chapter 1 Hello, world! </pre></div> </figure> <p>In your text editor, save this change.</p> <h2 id="make-a-new-preview-of-your-book-in-github-mode" class="section"> <a class="anchor-link" href="#make-a-new-preview-of-your-book-in-github-mode"><i class="fa fa-link"></i></a>Make a New Preview of Your Book</h2> <p>Next, you need to commit your changes and push them to GitHub.</p> <p>On the command line, type <code>git commit -m "first tutorial steps"</code> and hit the return key.</p> <p>Next, type ‘git push’ and hit the return key.</p> <p>The next time you create a preview of your book, you will see that Chapter One has changed, and it now says “Hello, world!”</p> <p>To create a new preview, repeat what you did when you made your first preview, by using the Author menu in Leanpub to go to:</p> <p><code>Author > Books > [Your Book Title] > Preview or Publish > Preview</code></p> <h2 id="how-the-list-of-files-in-book-txt-works-in-github-mode" class="section"> <a class="anchor-link" href="#how-the-list-of-files-in-book-txt-works-in-github-mode"><i class="fa fa-link"></i></a>How the List of Files in Book.txt Works</h2> <p>When you create a preview, you may not want our book generators to use all of the files in your <code>manuscript</code> folder. Also, you may want the contents of your book to reflect a different order than the order they are presented in, in your <code>manuscript</code> folder.</p> <p>So, whenever you create a preview, our friendly bookbots generate your book using only the files that you have listed in the <code>Book.txt</code> file that is in your book’s <code>manuscript</code> folder, and they use those files in the order that you have listed them.</p> <p>Let’s see how this works.</p> <p>First, delete a file. In your book’s <code>manuscript</code> folder, select the file named <code>chapter3.txt</code> and delete it.</p> <p>Now, let’s rename a file. The files listed in <code>Book.txt</code> can have any name you want to give them. (To be clear, the files do not have to include the word “chatper” in the file name.)</p> <p>In your book’s <code>manuscript</code> folder, select the file <code>chapter2.txt</code>.</p> <p>Now, change the file name to <code>conclusion.txt</code> by right-clicking on the file and selecting “Rename.” **(Your computer might show a different word than “Rename,” but there should be an option to change any file’s name if you right-click on the file.)</p> <p>Now that we have changed the files in the <code>manuscript</code> folder, we need to update the list of files in the <code>Book.txt</code> file.</p> <p>Using your text editor, open the <code>Book.txt</code> file.</p> <p>In the <code>Book.txt</code> file, you will see this list of files, like this:</p> <figure class="code " dir="ltr"> <figcaption></figcaption> <div class="highlight"><pre><code></code>chapter1.txt chapter2.txt chapter3.txt </pre></div> </figure> <p>First, delete <code>chapter2.txt</code>. Then, delete <code>chapter3.txt</code>.</p> <p>Next, on the second line, type <code>conclusion.txt</code>.</p> <p>Now, your list of files in Book.txt will look like this:</p> <figure class="code " dir="ltr"> <figcaption></figcaption> <div class="highlight"><pre><code></code>chapter1.txt conclusion.txt </pre></div> </figure> <p>Next, open the file <code>conclusion.txt</code>.</p> <p>Now, delete everthing in the file, and type this:</p> <figure class="code " dir="ltr"> <figcaption></figcaption> <div class="highlight"><pre><code></code># Conclusion This book is **done** and ready for *the world to see*, hooray! </pre></div> </figure> <p>Finally, save this change your text editor.</p> <p>Next, you need to commit your changes and push them to GitHub.</p> <p>On the command line, type <code>git commit -m "finishing tutorial"</code> and hit the return key.</p> <p>Next, type ‘git push’ and hit the return key.</p> <p>Now, go back to the preview page for your book at:</p> <p><code>Author > Books > [Your Book Title] > Preview or Publish > Preview</code></p> <p>The next time you create a preview, it will reflect the changes you have made.</p> <p><b>Congratulations!</b> You’ve completed the Getting Started tutorial for writing a book in Leanpub using GitHub.</p> <h2 id="next-steps-in-github-mode" class="section"> <a class="anchor-link" href="#next-steps-in-github-mode"><i class="fa fa-link"></i></a>Next Steps</h2> <p>Next, we recommend you explore the Overview page for your book:</p> <p><code>Author > Books > [Your Book Title] > Book Info > Overview</code></p> <p>On the Overview page, you can see all the pages you need to get your book set up on Leanpub, like “Upload Book Cover” and the “Book Details” page, where you can explain what your book is about to potential readers.</p> <p>If you have any questions or can’t find anything, please search our Help Center for authors here: <a href="http://help.leanpub.com/author-help">http://help.leanpub.com/author-help</a>.</p> <p>Happy writing!</p> <h1 id="getting-started-with-bitbucket-writing-mode" class="chapter"> <a class="anchor-link" href="#getting-started-with-bitbucket-writing-mode"><i class="fa fa-link"></i></a>Getting Started with Git and Bitbucket Writing Mode</h1> <p>You can write a Leanpub book using Git and Bitbucket. In this chapter we’ll show you how to create a book and generate your first preview.</p> <p>Once you have successfully generated your first preview, you’ll know everything you know to get started writing in the Bitbucket writing mode.</p> <p>You’ll find more information and detailed instructions on the “Getting Started” page for your book, which you’ll go to automatically when you create your book.</p> <h2 id="creating-your-books-bitbucket-repository" class="section"> <a class="anchor-link" href="#creating-your-books-bitbucket-repository"><i class="fa fa-link"></i></a>Creating Your Book’s Bitbucket Repository</h2> <p>The first thing you need to is create a repository for your book on Bitbucket.</p> <p>To do this, go to <a href="https://bitbucket.org">https://bitbucket.org</a> and sign in.</p> <p>Click the + plus sign to the left in the menu at the top of the page.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 375px"> <img alt="" src="/site_images/manual/images----BB1.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Under “CREATE”, select “Repository.”</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 357px"> <img alt="" src="/site_images/manual/images----1-create-repo-menu.jpg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>This will take you to a page where you can set up a new repository for your Leanpub book.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 397px"> <img alt="" src="/site_images/manual/images----2-empty-repo-name.jpg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>By default, “Private repository” will be selected. Leave this set to “Private repository” if you don’t want anyone to be able to see your repository.</p> <p>Next, you’ll have to associate the repository with a Project:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 397px"> <img alt="" src="/site_images/manual/images----3-create-project.jpg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Select an existing project, or click on “Create new project”:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 397px"> <img alt="" src="/site_images/manual/images----4-select-create-new-project.jpg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>You will now have an option to create a name for your new project:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 397px"> <img alt="" src="/site_images/manual/images----5-empty-project-name.jpg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>For this tutorial, we’re going to name the project “My Leanpub Book”:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 397px"> <img alt="" src="/site_images/manual/images----6-enter-project-name.jpg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Next, type a name for your repository.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 397px"> <img alt="" src="/site_images/manual/images----7-enter-repo-name.jpg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Click the blue “Create repository” button.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 397px"> <img alt="" src="/site_images/manual/images----8-click-create-repository.jpg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>This will take you to a “Get started quickly” page:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 397px"> <img alt="" src="/site_images/manual/images----9-get-started-quickly.jpg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Select the repository information and copy it.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 397px"> <img alt="" src="/site_images/manual/images----10-select-text.jpg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Go to the command line on your computer. In this tutorial we’re using a Mac, so we use Terminal.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----BB7.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Go to the folder on your computer where you want to clone your Bitbucket repository. In this tutorial, that is a folder called <code>repos</code>.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----BB8.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Paste in the repository information you copied on Bitbucket, and hit Enter.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----BB9.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>You may see a message asking if you are sure you want to connect. If you are sure, type “yes” and hit return.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----BB10.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>After a moment, you will see a message saying that the repository has been cloned.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----BB11.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <h2 id="creating-a-book-in-bitbucket-writing-mode" class="section"> <a class="anchor-link" href="#creating-a-book-in-bitbucket-writing-mode"><i class="fa fa-link"></i></a>Creating a Book in Bitbucket Writing Mode</h2> <p>Go to <a href="https://leanpub.com/create/book">https://leanpub.com/create/book</a> to create a book in Bitbucket writing mode.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----book-create-bitbucket.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>First, type a title for your book into the “TITLE” box. You can change your title later.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----BB12.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Click in the “BOOK URL” box. Leanpub will automatically suggest a URL for your book’s web page on Leanpub. You can change this URL at any time.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----BB13.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Scroll down and you will see “MAIN LANGUAGE USED IN YOUR BOOK.” You can select a language from the drop-down. Like the other settings, you can change this at any time.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----book-language-bitbucket.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Scroll down and you will see the “BOOK THEME” options. “Business” will be selected by default. The Book Theme is just a set of standard formatting options conventional for books on these subjects. You are not required to choose any particular option. You can change your Book Theme at any time.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----book-theme-bitbucket.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>For this tutorial, we selected the “Fiction” Book Theme.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----book-fiction-bitbucket.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>In the section below, you will be presented with various Writing Mode options. For this tutorial, select “Using Git and Bitbucket.”</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----BB14.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Scroll down and you will see a box to enter your Bitbucket username, followed by a forward slash / and your Bitbucket repo name.</p> <p>Enter your Bitbucket username, followed by a forward slash / and your Bitbucket repo name.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----BB15.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>When you scroll down further, you will see the subscription plan options. By default, “Free” will be selected. If you have a paid Leanpub account already, you will see that plan selected automatically.</p> <p>Select a plan.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----accounts.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Scroll down and, if you are not signed in to a Leanpub account, you will see an option to enter information to create a new account. You will also see an option to sign in, if you already have a Leanpub account.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----account-create.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>To create a new account, fill in the relevant information.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----account-info.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Finally, click the blue button to finish creating your new Bitbucket book.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----sign-up-for-free-plan.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>You will now see that you are on the Getting Started page for your book.</p> <p>If you use bookmarks in your web browser, we recommend you bookmark this page in your web browser in a bookmark folder for your book, but this is not required.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----BB17.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Look at the Author “breadcrumb” menu at the top of the screen. This is how you will navigate to the web pages you will be using in Leanpub to work on your book and see all the features we provide, like uploading a book cover, or setting a price for your book.</p> <p>When you are finished this tutorial, we recommend you explore the various Author options.</p> <h2 id="adding-leanpub-as-a-collaborator-on-bitbucket" class="section"> <a class="anchor-link" href="#adding-leanpub-as-a-collaborator-on-bitbucket"><i class="fa fa-link"></i></a>Adding Leanpub As A Collaborator on Your Book’s Bitbucket Repository</h2> <p>Go back to the Bitbucket page for your book’s Bitbucket repository.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 397px"> <img alt="" src="/site_images/manual/images----11-go-back-to-bitbucket.jpg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Click on “Repository Settings” in the menu to the left:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 397px"> <img alt="" src="/site_images/manual/images----12-click-on-repository-settings.jpg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>This will take you to the “Repository settings” page:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 397px"> <img alt="" src="/site_images/manual/images----13-repository-settings-page.jpg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Click on “User and group access” in the menu, under “Repository details”:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 397px"> <img alt="" src="/site_images/manual/images----15-click-on-user-and-group-access.jpg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>This will take you to the “User and group access” page:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 397px"> <img alt="" src="/site_images/manual/images----16-user-and-group-access-page.jpg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Type “leanpub” in the search box.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 397px"> <img alt="" src="/site_images/manual/images----17-type-in-leanpub.jpg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Click the “Add” button to the right:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 397px"> <img alt="" src="/site_images/manual/images----18-click-Add.jpg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>You will see that Leanpub has been added as a collaborator on the repository.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 397px"> <img alt="" src="/site_images/manual/images----19-leanpub-added.jpg" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <h2 id="adding-default-content-to-your-bitbucket-repository" class="section"> <a class="anchor-link" href="#adding-default-content-to-your-bitbucket-repository"><i class="fa fa-link"></i></a>Adding Default Content to Your Bitbucket Repository</h2> <p>Next, you need to add some content to your Bitbucket repository. (Leanpub <b>NEVER</b> commits to your Bitbucket repository, since we do not want to cause merge conflicts.)</p> <p>Go back to the Getting Started page for your book.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----BB17.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Scroll down to Step 2 and click the <a href="https://github.com/leanpub/default-new-book-content/archive/master.zip">this zip file</a> link, or click the link in this sentence in the tutorial. This will download the default content to your computer.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----BB23.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>You will now find the file wherever you store downloads on your computer.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----GH26.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Double-click the folder to unzip it.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----GH27.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Copy the “manuscript” folder. Then, go to the cloned Bitbucket repository on your computer, and paste the “manuscript” folder into the repository.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----BB24.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Go back to the command line on your computer and change to the Bitbucket repository for your book.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----BB25.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Type <code>git add .</code> to the content using Git.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----BB26.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Type <code>git commit -m "adding default manuscript folder"</code>. You will see messages indicating that the content has been committed.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----BB27.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Type <code>git push origin master</code> to push the commit to the repository on Bitbucket.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----BB28.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <h2 id="creating-a-preview-in-bitbucket-writing-mode" class="section"> <a class="anchor-link" href="#creating-a-preview-in-bitbucket-writing-mode"><i class="fa fa-link"></i></a>Creating a Preview</h2> <p>To create your first preview, using the default content we included in your new book, go back the Getting Started page for your book:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----BB17.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Click on “Getting Started” at the top, and you will see your the Author menu. It will look something like this:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----BB29.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Click on “Preview or Publish” under the “Book Info” column, and you will see something like this:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----BB30.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Select “Preview’ in the column to the right, and you will go to the “Preview” page for your book:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----BB31.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Click the “Create Preview” button. You will go to a page like this, where you will see a progress bar at the top:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----BB32.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>When the preview process is complete, you will see download links for the preview, in a variety of formats:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----BB33.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Click on the links to see what your book looks like in the various formats.</p> <h2 id="writing-your-book-in-bitbucket-mode" class="section"> <a class="anchor-link" href="#writing-your-book-in-bitbucket-mode"><i class="fa fa-link"></i></a>Writing in Your Book</h2> <p>Open your book folder in Bitbucket. You’ll see a folder named <code>manuscript</code> inside it. This is where you write your book.</p> <p>If you have just created a new book, the <code>manuscript</code> folder will contain four files with the file name extension <code>.txt</code>. There will also be a folder called <code>resources</code>:</p> <figure class="code " dir="ltr"> <figcaption></figcaption> <div class="highlight"><pre><code></code>Book.txt chapter1.txt chapter2.txt chapter3.txt resources </pre></div> </figure> <p>Open the file called <code>chapter1.txt</code> by double-clicking on it. You can also open the file in any specific text editing software you prefer.</p> <p>Next, delete the contents of the file and type:</p> <figure class="code " dir="ltr"> <figcaption></figcaption> <div class="highlight"><pre><code></code># Chapter 1 Hello, world! </pre></div> </figure> <p>In your text editor, save this change.</p> <h2 id="make-a-new-preview-of-your-book-in-bitbucket-mode" class="section"> <a class="anchor-link" href="#make-a-new-preview-of-your-book-in-bitbucket-mode"><i class="fa fa-link"></i></a>Make a New Preview of Your Book</h2> <p>Next, you need to commit your changes and push them to Bitbucket.</p> <p>On the command line, type <code>git commit -m "first tutorial steps"</code> and hit the return key.</p> <p>Next, type ‘git push’ and hit the return key.</p> <p>The next time you create a preview of your book, you will see that Chapter One has changed, and it now says “Hello, world!”</p> <p>To create a new preview, repeat what you did when you made your first preview, by using the Author menu in Leanpub to go to:</p> <p><code>Author > Books > [Your Book Title] > Preview or Publish > Preview</code></p> <h2 id="how-the-list-of-files-in-book-txt-works-in-bitbucket-mode" class="section"> <a class="anchor-link" href="#how-the-list-of-files-in-book-txt-works-in-bitbucket-mode"><i class="fa fa-link"></i></a>How the List of Files in Book.txt Works</h2> <p>When you create a preview, you may not want our book generators to use all of the files in your <code>manuscript</code> folder. Also, you may want the contents of your book to reflect a different order than the order they are presented in, in your <code>manuscript</code> folder.</p> <p>So, whenever you create a preview, our friendly bookbots generate your book using only the files that you have listed in the <code>Book.txt</code> file that is in your book’s <code>manuscript</code> folder, and they use those files in the order that you have listed them.</p> <p>Let’s see how this works.</p> <p>First, delete a file. In your book’s <code>manuscript</code> folder, select the file named <code>chapter3.txt</code> and delete it.</p> <p>Now, let’s rename a file. The files listed in <code>Book.txt</code> can have any name you want to give them. (To be clear, the files do not have to include the word “chatper” in the file name.)</p> <p>In your book’s <code>manuscript</code> folder, select the file <code>chapter2.txt</code>.</p> <p>Now, change the file name to <code>conclusion.txt</code> by right-clicking on the file and selecting “Rename.” **(Your computer might show a different word than “Rename,” but there should be an option to change any file’s name if you right-click on the file.)</p> <p>Now that we have changed the files in the <code>manuscript</code> folder, we need to update the list of files in the <code>Book.txt</code> file.</p> <p>Using your text editor, open the <code>Book.txt</code> file.</p> <p>In the <code>Book.txt</code> file, you will see this list of files, like this:</p> <figure class="code " dir="ltr"> <figcaption></figcaption> <div class="highlight"><pre><code></code>chapter1.txt chapter2.txt chapter3.txt </pre></div> </figure> <p>First, delete <code>chapter2.txt</code>. Then, delete <code>chapter3.txt</code>.</p> <p>Next, on the second line, type <code>conclusion.txt</code>.</p> <p>Now, your list of files in Book.txt will look like this:</p> <figure class="code " dir="ltr"> <figcaption></figcaption> <div class="highlight"><pre><code></code>chapter1.txt conclusion.txt </pre></div> </figure> <p>Next, open the file <code>conclusion.txt</code>.</p> <p>Now, delete everthing in the file, and type this:</p> <figure class="code " dir="ltr"> <figcaption></figcaption> <div class="highlight"><pre><code></code># Conclusion This book is **done** and ready for *the world to see*, hooray! </pre></div> </figure> <p>Finally, save this change your text editor.</p> <p>Next, you need to commit your changes and push them to Bitbucket.</p> <p>On the command line, type <code>git commit -m "finishing tutorial"</code> and hit the return key.</p> <p>Next, type ‘git push’ and hit the return key.</p> <p>Now, go back to the preview page for your book at:</p> <p><code>Author > Books > [Your Book Title] > Preview or Publish > Preview</code></p> <p>The next time you create a preview, it will reflect the changes you have made.</p> <p><b>Congratulations!</b> You’ve completed the Getting Started tutorial for writing a book in Leanpub using Bitbucket.</p> <h2 id="next-steps-in-bitbucket-mode" class="section"> <a class="anchor-link" href="#next-steps-in-bitbucket-mode"><i class="fa fa-link"></i></a>Next Steps</h2> <p>Next, we recommend you explore the Overview page for your book:</p> <p><code>Author > Books > [Your Book Title] > Book Info > Overview</code></p> <p>On the Overview page, you can see all the pages you need to get your book set up on Leanpub, like “Upload Book Cover” and the “Book Details” page, where you can explain what your book is about to potential readers.</p> <p>If you have any questions or can’t find anything, please search our Help Center for authors here: <a href="http://help.leanpub.com/author-help">http://help.leanpub.com/author-help</a>.</p> <p>Happy writing!</p> <h1 id="getting-started-with-byob-mode" class="chapter"> <a class="anchor-link" href="#getting-started-with-byob-mode"><i class="fa fa-link"></i></a>Getting Started with Bring Your Own Book Writing Mode</h1> <p>You can write a Leanpub book using the Bring Your Own Book writing mode. In this chapter we’ll show you how to create a book and generate your first preview.</p> <blockquote> <p>We also have a video, if you prefer to learn that way! You can watch the video here: <a href="https://youtu.be/8sSi0PLwIDo">https://youtu.be/QC8Utbrc9MM</a>. </p> </blockquote> <p>Once you have successfully generated your first preview, you’ll know everything you know to get started writing in the Bring Your Own Book writing mode.</p> <p>You’ll find more information and detailed instructions on the “Getting Started” page for your book, which you’ll go to automatically when you create your book.</p> <h2 id="creating-a-book-in-byob-mode" class="section"> <a class="anchor-link" href="#creating-a-book-in-byob-mode"><i class="fa fa-link"></i></a>Creating a Book in Bring Your Own Book Writing Mode</h2> <p>Go to <a href="https://leanpub.com/create/book">https://leanpub.com/create/book</a> to create a book in Bring Your Own Book.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----book-create.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Next, type a title for your book into the “TITLE” box. You can change your title later.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----BY1.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Click in the “BOOK URL” box. Leanpub will automatically suggest a URL for your book’s web page on Leanpub. You can change this URL at any time.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----BY2.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Scroll down and you will see “MAIN LANGUAGE USED IN YOUR BOOK.” You can select a language from the drop-down. Like the other settings, you can change this at any time.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----book-language.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Scroll down and you will see the “BOOK THEME” options. “Business” will be selected by default. The Book Theme is just a set of standard formatting options conventional for books on these subjects. You are not required to choose any particular option. You can change your Book Theme at any time.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----book-theme.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>For this tutorial, we selected the “Fiction” Book Theme.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----book-fiction.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>In the section below, you will be presented with various Writing Mode options. For this tutorial, select “Bring your own book.”</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----BY3.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>When you scroll down, you will see the subscription plan options. By default, “Free” will be selected. If you have a paid Leanpub account already, you will see that plan selected automatically.</p> <p>Select a plan.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----accounts.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Scroll down and, if you are not signed in to a Leanpub account, you will see an option to enter information to create a new account. You will also see an option to sign in, if you already have a Leanpub account.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----account-create.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>To create a new account, fill in the relevant information.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----account-info.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Finally, click the blue button to finish creating your new Bring Your Own Book book.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 395px"> <img alt="" src="/site_images/manual/images----sign-up-for-free-plan.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>You will now see that you are on the Getting Started page for your book.</p> <p>If you use bookmarks in your web browser, we recommend you bookmark this page in your web browser in a bookmark folder for your book, but this is not required.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----BY4.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Look at the Book Tools “breadcrumb” menu at the top of the screen. This is how you will navigate to the web pages you will be using in Leanpub to work on your book and see all the features we provide, like uploading a book cover, or setting a price for your book.</p> <p>When you are finished this tutorial, we recommend you explore the various Book Tools options.</p> <h2 id="uploading-your-book-in-byob-mode" class="section"> <a class="anchor-link" href="#uploading-your-book-in-byob-mode"><i class="fa fa-link"></i></a>Uploading Your Book In Bring Your Own Book</h2> <p>Click on “Getting Started” at the top, and you will see your the Book Tools menu. It will look something like this:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----BY5.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Click on “Preview or Publish” in the menu, and you will see something like this:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----BY6.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Select “Upload” in the column to the right:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----BY7.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>On your computer, find the book file or files you would like to upload. (The file does not have to named “book.pdf”; you can use any file name you prefer.)</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----BY8.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Drag the file onto the top box that under “Upload Your Book Files.” You will see a progress bar as the file uploads:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----BY9.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>When the file is uploaded, you will see a check mark:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----BY10.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>That’s it, you’re done uploading your file! After you have added information about your book to Leanpub, then all you have to do is click the Publish button.</p> <h2 id="adding-your-profile-and-your-book-information" class="section"> <a class="anchor-link" href="#adding-your-profile-and-your-book-information"><i class="fa fa-link"></i></a>Adding Your Profile and Your Book Information</h2> <p>Here is an article on what to do next:</p> <p><a href="http://help.leanpub.com/en/articles/2627439-things-to-do-before-publishing-your-leanpub-book">http://help.leanpub.com/en/articles/2627439-things-to-do-before-publishing-your-leanpub-book</a></p> <p>If you have all your materials ready, like your profile picture and your book cover, this should only take a few minutes, and you’ll be ready to publish your book!</p> <h2 id="publishing-your-book-in-byob-mode" class="section"> <a class="anchor-link" href="#publishing-your-book-in-byob-mode"><i class="fa fa-link"></i></a>Publishing Your Book</h2> <p>To do this, click on “Upload” in the menu at the top:</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----BY11.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Select “Publish Your Book” at the top right, to go to the Publish page for your book.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----BY12.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <p>Scroll down and you will see the blue “Publish Book” button.</p> <div class="figure-wrapper center"> <figure class="image block" style="width: 396px"> <img alt="" src="/site_images/manual/images----BY14.png" style="width: 100%;"> <figcaption></figcaption> </figure> </div> <h2 id="next-steps-in-byob-mode" class="section"> <a class="anchor-link" href="#next-steps-in-byob-mode"><i class="fa fa-link"></i></a>Next Steps</h2> <p>Next, we recommend you explore the Overview page for your book:</p> <p><code>Author > Books > [Your Book Title] > Book Info > Overview</code></p> <p>On the Overview page, you can see all the pages you need to get your book set up on Leanpub, like “Upload Book Cover” and the “Book Details” page, where you can explain what your book is about to potential readers.</p> <p>Leanpub has some features that are pretty unique in the world of self-publishing platforms. We recommend you read the following article if you’re interested in learning more:</p> <p><a href="http://help.leanpub.com/en/articles/1587118-tips-for-self-publishing-and-selling-books-using-leanpub">http://help.leanpub.com/en/articles/1587118-tips-for-self-publishing-and-selling-books-using-leanpub</a></p> <p>If you have any questions or can’t find anything, please search our Help Center for authors here: <a href="http://help.leanpub.com/author-help">http://help.leanpub.com/author-help</a>.</p> <p>Good luck!</p> </div> </section> </div> </div> <footer class='footer'> <div class='container--small'> <h1 class='footer-logo'> <a href="https://leanpub.com/"><img src="https://leanpub.com/assets/logos/logo-white-96-67-2x-cbf54f68046da93161c6375a4d74259d.png" alt="Logo white 96 67 2x" /> </a></h1> <h3 class='footer-slogan'>Publish Early, Publish Often</h3> <ul class='footer-list-break'> <li> <h5 class='footer-headings'>Path</h5> </li> <li class='footer-descriptions-top'>There are many paths, but the one you're on right now on Leanpub is:</li> <li class='path'> Manual › Read </li> </ul> <div class='footer-links'> <ul class='footer-list'> <ul class='footer-columns'> <li> <h5 class='footer-headings'>READERS</h5> </li> </ul> <ul class='footer-list-break'> <li> <h5 class='footer-list-title'>Newsletters</h5> </li> <li><a href="/newsletters">Weekly Sale</a></li> <li><a href="/newsletters">Monthly Sale</a></li> </ul> <ul class='footer-list-break'> <li> <h5 class='footer-list-title'>Store</h5> </li> <li><a href="/">Home</a></li> <li><a href="/redeem">Redeem a Token</a></li> <li><a href="/bookstore/book?search">Search</a></li> </ul> <ul class='footer-list-break'> <li> <h5 class='footer-list-title'>Support</h5> </li> <li><a href="https://help.leanpub.com/en/articles/3788293-the-leanpub-faq">Leanpub FAQ</a></li> <li><a href="https://help.leanpub.com/en/articles/4405350-leanpub-author-faq">Leanpub Author FAQ</a></li> <li><a href="https://help.leanpub.com/en/">Search our Help Center</a></li> <li><a href="https://help.leanpub.com/en/articles/110768-if-i-can-t-find-an-answer-to-my-question-in-this-help-center-what-should-i-do">How to Contact Us</a></li> </ul> <ul class='footer-list-break'> <li> <h5 class='footer-headings'>FRONTMATTER PODCAST</h5> </li> <li><a href="/podcasts/featured">Featured Episode</a></li> <li><a href="/podcasts/frontmatter">Episode List</a></li> </ul> <ul class='footer-list-break'> <li> <h5 class='footer-headings'>MEMBERSHIPS</h5> </li> <li><a href="/reader_memberships">Reader Memberships</a></li> <li><a href="/departmentmemberships">Department Reader Memberships</a></li> <li><a href="/author_memberships">Author Memberships</a></li> <li><a href="/membership">Your Membership</a></li> </ul> <ul class='footer-list-break'> <li> <h5 class='footer-headings'>COMPANY</h5> </li> <li> <h5 class='footer-list-title'>About</h5> </li> <li><a href="/about">About Leanpub</a></li> <li><a href="/blog">Blog</a></li> <li><a href="/contact">Contact</a></li> <li><a href="/press">Press</a></li> </ul> <ul class='footer-list-break'> <li> <h5 class='footer-list-title'>Essays</h5> </li> <li><a href="/ai_services">AI Services</a></li> <li><a href="/imagine_a_world">Imagine a world...</a></li> <li><a href="/manifesto">Manifesto</a></li> </ul> <ul class='footer-list-break'> <li> <h5 class='footer-list-title'>More</h5> </li> <li><a href="/partner_program">Partner Program</a></li> <li><a href="/causes">Causes</a></li> <li><a href="/accessibility">Accessibility</a></li> </ul> </ul> <ul class='footer-list'> <ul class='footer-columns'> <li> <h5 class='footer-headings'>AUTHORS</h5> </li> </ul> <ul class='footer-list-break'> <li> <h5 class='footer-list-title'>Write and Publish on Leanpub</h5> </li> <li><a href="/create/book">Create a Book</a></li> <li><a href="/author_dashboard/new_bundle">Create a Bundle</a></li> <li><a href="/create/course">Create a Course</a></li> <li><a href="/course_set_admin/leanpub/course_sets/new">Create a Track</a></li> <li><a href="/testimonials">Testimonials</a></li> <li><a href="/authors">Why Leanpub</a></li> </ul> <ul class='footer-list-break'> <li> <h5 class='footer-list-title'>Services</h5> </li> <li><a href="/translate_ai/buy">TranslateAI</a></li> <li><a href="/translate_word/buy">TranslateWord</a></li> <li><a href="/translate_epub/buy">TranslateEPUB</a></li> <li><a href="/publish_word/create">PublishWord</a></li> <li><a href="/publish_on_amazon/buy">Publish on Amazon</a></li> <li><a href="/course_ai/buy">CourseAI</a></li> <li><a href="/global_author/buy">GlobalAuthor</a></li> <li><a href="/shelf/buy">Marketing Packages</a></li> <li><a href="/index_ai/buy">IndexAI</a></li> </ul> <ul class='footer-list-break'> <li> <h5 class='footer-list-title'>Author Newsletter</h5> </li> <li><a href="/newsletters">The Leanpub Author Update</a></li> </ul> <ul class='footer-list-break'> <li> <h5 class='footer-list-title'>Author Support</h5> </li> <li><a href="https://help.leanpub.com/author-help">Author Help Center</a></li> <li><a href="https://community.leanpub.com/c/authors">Leanpub Authors Forum</a></li> <li><a href="https://leanpub.com/manual/read">The Leanpub Manual</a></li> <li><a href="/help/supported_languages">Supported Languages</a></li> <li><a href="https://leanpub.com/lfm/read">The LFM Manual</a></li> <li><a href="https://leanpub.com/markua/read">Markua Manual</a></li> <li><a href="/help/api">API Docs</a></li> </ul> <ul class='footer-list-break'> <li> <h5 class='footer-list-title'>Organizations</h5> </li> <li><a href="/organizations">Learn More</a></li> <li><a href="/p/register">Sign Up</a></li> </ul> <ul class='footer-list-break'> <li> <h5 class='footer-headings'>LEGAL</h5> </li> <li><a href="/terms">Terms of Service</a></li> <li><a href="/takedown">Copyright Policy</a></li> <li><a href="/privacy">Privacy Policy</a></li> <li><a href="/refunds">Refund Policy</a></li> </ul> </ul> </div> <p class='footer-copyright'> *   *   * </p> <p class='footer-copyright'> Leanpub is copyright © 2010-2025 <a href="http://ruboss.com">Ruboss Technology Corp.</a><br/> All rights reserved. </p> <p class='footer-copyright'> This site is protected by reCAPTCHA<br/> and the Google  <a rel='noopener noreferrer' target='_blank' href="https://policies.google.com/privacy">Privacy Policy</a> and  <a rel='noopener noreferrer' target='_blank' href="https://policies.google.com/terms">Terms of Service</a> apply. </p> </div> </footer> <div id='react-modal'></div> </div> <div class='cookies-banner alert alert--info' style='display: none'> Leanpub requires cookies in order to provide you the best experience. <a class='dismiss link'>Dismiss</a> </div> <script type='text/javascript'> window.addEventListener('load', function() { var shouldShowCookies = document.cookie.indexOf('should_show_cookies') !== -1 if (shouldShowCookies) { var banner = document.querySelector('.cookies-banner') // IE < 9 check if (banner.style.removeProperty) { banner.style.removeProperty('display'); } else { banner.style.removeAttribute('display'); } document.querySelector('.cookies-banner').classList.add('shown') // Note that we have to use vanilla JS here because ujs (remote links) code doesn't live in the react app, and i don't // want to have to write this shit twice. document.querySelector('.cookies-banner .dismiss').addEventListener('click', function() { document.querySelector('.cookies-banner').remove() var xhr = new XMLHttpRequest() xhr.open("POST", "/api/v1/accepted_terms/dismiss_cookies", true); xhr.send() }) } }) </script> <script src="https://leanpub.com/assets/application-88e446d6bb15c5682db3fb765baa70b6.js"></script>  <script> !function(e,t,n,s,u,a){e.twq||(s=e.twq=function(){s.exe?s.exe.apply(s,arguments):s.queue.push(arguments); },s.version='1.1',s.queue=[],u=t.createElement(n),u.async=!0,u.src='//static.ads-twitter.com/uwt.js', a=t.getElementsByTagName(n)[0],a.parentNode.insertBefore(u,a))}(window,document,'script'); // Insert Twitter Pixel ID and Standard Event data below twq('init','nw0pa'); twq('track','PageView'); </script>  <script> $('.toc a').on('click', function(e) { if (window.innerWidth <= 768) { $('#read-online').addClass('sidebar-hidden') $('.toggle-sidebar').addClass('sidebar-hidden') } }) $('.scroll-wrapper').on('scroll', function(e) { if (e.target.scrollTop > 10) { $('.read-online-slidable').addClass('scrolled') $('#scroll-wrapper').addClass('read-online-scrolled') } else { $('.read-online-slidable').removeClass('scrolled') $('#scroll-wrapper').removeClass('read-online-scrolled') } }) $('.toggle-sidebar').on('click', function(e) { $(this).toggleClass('sidebar-hidden') $('#read-online').toggleClass('sidebar-hidden') }) if (window.innerWidth <= 768) { $('#read-online').addClass('sidebar-hidden') $('.toggle-sidebar').addClass('sidebar-hidden') } </script> </body></html>