<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:media="http://search.yahoo.com/mrss/"><channel><title><![CDATA[Ghost & Gatsby]]></title><description><![CDATA[Thoughts, stories and JAMstack]]></description><link>https://jameskim.io/</link><image><url>https://jameskim.io/favicon.png</url><title>Ghost &amp; Gatsby</title><link>https://jameskim.io/</link></image><generator>Ghost 2.9</generator><lastBuildDate>Sat, 08 Feb 2020 04:58:40 GMT</lastBuildDate><atom:link href="https://jameskim.io/rss/" rel="self" type="application/rss+xml"/><ttl>60</ttl><item><title><![CDATA[About Ghost + Gatsby]]></title><description><![CDATA[Build an API driven static-site with Gatsby.js and use Ghost as a completely decoupled headless CMS.  Read more about how it works and how to use this starter theme here!]]></description><link>https://gatsby.ghost.io/about/</link><guid isPermaLink="false">Ghost__Post__5c360e513ad4e300bf4cbeb0</guid><dc:creator><![CDATA[Ghost]]></dc:creator><pubDate>Wed, 09 Jan 2019 15:08:14 GMT</pubDate><media:content url="https://gatsby.ghost.io/content/images/2019/01/ghost-headless-feature-image.png" medium="image"/><content:encoded><![CDATA[<img src="https://gatsby.ghost.io/content/images/2019/01/ghost-headless-feature-image.png" alt="About Ghost + Gatsby"/><p>Use Ghost as a completely decoupled headless CMS and bring your own front-end written in <a href="https://gatsbyjs.org">Gatsby.js</a></p><h2 id="build-an-api-driven-static-site">Build an API driven static-site</h2><p>There has been a lot of progress around static site generators, front end frameworks and API-centric infrastructure in recent years, which has generated some very cool products, like Gatsby. Since Ghost allows you to completely replace its default Handlebars theme layer in favour of a front-end framework, you can use Gatsby to build your site statically from the Ghost API.</p><figure class="kg-card kg-image-card"><img src="https://gatsby.ghost.io/content/images/2019/01/headless-ghost.png" class="kg-image" alt="About Ghost + Gatsby"/></figure><h2 id="the-headless-cms-revolution">The headless-cms revolution</h2><p>Using a static site generator usually involves storing Markdown files locally in the code repository. This would involve using a code editor to write content and a GIT workflow to publish - which works fine for small sites or developers. However, it's not ideal for professional publishers that need to scale. This is where a headless CMS comes in!</p><p>Instead, you can use Ghost for authoring, and then build out your front-end in Gatsby to pull content from the Ghost API. This provides several benefits for publishers: </p><ul><li>Developers can use their preferred stack</li><li>Writers have their preferred editor &amp; content management</li><li>Performance is the maximum possible </li><li>Security is the maximum possible </li><li>Your site will be extremely scalable </li></ul><p>Building sites in this way has become known as the <a href="https://jamstack.org">JAMstack</a> - (as in <strong>J</strong>avaScript, <strong>A</strong>PIs, <strong>M</strong>arkup). When you look at the bigger picture of <a href="https://www.gatsbyjs.org/blog/2018-10-04-journey-to-the-content-mesh/">the content mesh</a>, it really starts to feel like an inevitable future for building websites. </p><h2 id="official-gatsby-js-source-plugin-starter">Official Gatsby.js Source Plugin + Starter</h2><p>We rebuilt our entire <a href="https://docs.ghost.org">Ghost Docs</a> site with a front-end written in <a href="https://gatsbyjs.org">Gatsby.js</a> - which is a great example of what can be achieved with Ghost and Gatsby in the wild. We also shipped a few things to help others build their own sites using the same stack: </p><h3 id="-gatsby-source-ghost-plugin">⚡ <a href="https://github.com/tryghost/gatsby-source-ghost">gatsby-source-ghost</a> plugin</h3><p>A straightforward Gatsby source plugin which wraps the Ghost API and makes it compatible with Gatsby and GraphQL, so it's quick and easy to load all your Ghost data into any Gatsby project.</p><h3 id="-gatsby-starter-ghost">⚡ <a href="https://github.com/tryghost/gatsby-starter-ghost">gatsby-starter-ghost</a> </h3><p>An official <a href="https://github.com/tryghost/gatsby-starter-ghost">Gatsby starter repository</a> which is pre-configured to get content from Ghost and output it in a clean, blog-style design. The fastest way to get up and running with Gatsby and Ghost is to fork this repository, and check out our <a href="https://docs.ghost.org/api/gatsby/">Gatsby docs</a>.</p><h2 id="official-netlify-support">Official Netlify Support</h2><p>Deploying a static site with Gatsby and Ghost should be easy - so we've partnered with Netlify, which we also use for Ghost Docs: </p><h3 id="-netlify-integration-for-ghost">⚡<a href="https://docs.ghost.org/integrations/netlify/">Netlify integration for Ghost</a> </h3><p>The official integration guide for Netlify  explains how to set up outgoing webhooks in Ghost to trigger a site rebuild on Netlify. This means that any time you publish, update or remove any content in Ghost, the front end will update.</p><h2 id="future-proof-publishing">Future-proof publishing</h2><p>Converging disparate technologies under a single front-end centralises otherwise decentralised services in a way which caters predominantly to the needs of the site owner, rather than the platform and fosters flexibility and scalability. </p><figure class="kg-card kg-image-card"><img src="https://gatsby.ghost.io/content/images/2019/01/ghost-jamstack.png" class="kg-image" alt="About Ghost + Gatsby"/></figure><p/><p>No more platform-specific plugins and extensions. Just one front-end, and many APIs; all connected together and served as a single site or application with Gatsby!</p><p/><p/><p/>]]></content:encoded></item><item><title><![CDATA[Welcome to Ghost]]></title><description><![CDATA[Welcome, it's great to have you here.
We know that first impressions are important, so we've populated your new site with some initial getting started posts that will help you get familiar with everything in no time.]]></description><link>https://gatsby.ghost.io/welcome/</link><guid isPermaLink="false">Ghost__Post__5c13e1bd3bec6400c0973871</guid><category><![CDATA[Getting Started]]></category><dc:creator><![CDATA[Ghost]]></dc:creator><pubDate>Fri, 14 Dec 2018 17:00:50 GMT</pubDate><media:content url="https://static.ghost.org/v2.0.0/images/welcome-to-ghost.jpg" medium="image"/><content:encoded><![CDATA[<img src="https://static.ghost.org/v2.0.0/images/welcome-to-ghost.jpg" alt="Welcome to Ghost"/><p>👋 Welcome, it's great to have you here.</p><p>We know that first impressions are important, so we've populated your new site with some initial <strong>getting started</strong> posts that will help you get familiar with everything in no time. This is the first one!</p><p><strong>A few things you should know upfront</strong>:</p><ol><li>Ghost is designed for ambitious, professional publishers who want to actively build a business around their content. That's who it works best for. </li><li>The entire platform can be modified and customised to suit your needs. It's very powerful, but does require some knowledge of code. Ghost is not necessarily a good platform for beginners or people who just want a simple personal blog. </li><li>For the best experience we recommend downloading the <a href="https://ghost.org/downloads/">Ghost Desktop App</a> for your computer, which is the best way to access your Ghost site on a desktop device. </li></ol><p>Ghost is made by an independent non-profit organisation called the Ghost Foundation. We are 100% self funded by revenue from our <a href="https://ghost.org/pricing">Ghost(Pro)</a> service, and every penny we make is re-invested into funding further development of free, open source technology for modern publishing.</p><p>The version of Ghost you are looking at right now would not have been made possible without generous contributions from the open source <a href="https://github.com/TryGhost">community</a>.</p><h2 id="next-up-the-editor">Next up, the editor</h2><p>The main thing you'll want to read about next is probably: <a href="https://gatsby.ghost.io/the-editor/">the Ghost editor</a>. This is where the good stuff happens.</p><blockquote><em>By the way, once you're done reading, you can simply delete the default <strong>Ghost</strong> user from your team to remove all of these introductory posts! </em></blockquote>]]></content:encoded></item><item><title><![CDATA[Writing posts with Ghost ✍️]]></title><description><![CDATA[Getting started with the editor is simple, with familiar formatting options in a functional toolbar and the ability to add dynamic content seamlessly.]]></description><link>https://gatsby.ghost.io/the-editor/</link><guid isPermaLink="false">Ghost__Post__5c13e1bd3bec6400c097386f</guid><category><![CDATA[Getting Started]]></category><dc:creator><![CDATA[Ghost]]></dc:creator><pubDate>Fri, 14 Dec 2018 17:00:49 GMT</pubDate><media:content url="https://static.ghost.org/v2.0.0/images/writing-posts-with-ghost.jpg" medium="image"/><content:encoded><![CDATA[<img src="https://static.ghost.org/v2.0.0/images/writing-posts-with-ghost.jpg" alt="Writing posts with Ghost ✍️"/><p>Ghost has a powerful visual editor with familiar formatting options, as well as the ability to seamlessly add dynamic content. </p><p>Select the text to add formatting, headers or create links, or use Markdown shortcuts to do the work for you - if that's your thing. </p><!--kg-card-begin: markdown--><p><img src="https://static.ghost.org/v2.0.0/images/formatting-editor-demo.gif" alt="Writing posts with Ghost ✍️"/></p>
<!--kg-card-end: markdown--><h2 id="rich-editing-at-your-fingertips">Rich editing at your fingertips</h2><p>The editor can also handle rich media objects, called <strong>cards</strong>. </p><p>You can insert a card either by clicking the  <code>+</code>  button on a new line, or typing  <code>/</code>  on a new line to search for a particular card. This allows you to efficiently insert<strong> images</strong>, <strong>markdown</strong>, <strong>html</strong> and <strong>embeds</strong>.</p><p><strong>For Example</strong>:</p><ul><li>Insert a video from YouTube directly into your content by pasting the URL </li><li>Create unique content like a button or content opt-in using the HTML card</li><li>Need to share some code? Embed code blocks directly </li></ul><pre><code>&lt;header class="site-header outer"&gt;
    &lt;div class="inner"&gt;
        {{&gt; "site-nav"}}
    &lt;/div&gt;
&lt;/header&gt;</code></pre><h1 id="working-with-images-in-posts">Working with images in posts</h1><p>You can add images to your posts in many ways:</p><ul><li>Upload from your computer</li><li>Click and drag an image into the browser</li><li>Paste directly into the editor from your clipboard</li><li>Insert using a URL</li></ul><p>Once inserted you can blend images beautifully into your content at different sizes and add captions wherever needed.</p><!--kg-card-begin: markdown--><p><img src="https://static.ghost.org/v2.0.0/images/using-images-demo.gif" alt="Writing posts with Ghost ✍️"/></p>
<!--kg-card-end: markdown--><p>The post settings menu and publishing options can be found in the top right hand corner. For more advanced tips on post settings check out the <a href="https://gatsby.ghost.io/publishing-options/">publishing options</a> post!</p>]]></content:encoded></item><item><title><![CDATA[Publishing options]]></title><description><![CDATA[The Ghost editor has everything you need to fully optimise your content. This is where you can add tags and authors, feature a post, or turn a post into a page.]]></description><link>https://gatsby.ghost.io/publishing-options/</link><guid isPermaLink="false">Ghost__Post__5c13e1bd3bec6400c097386d</guid><category><![CDATA[Getting Started]]></category><dc:creator><![CDATA[Ghost]]></dc:creator><pubDate>Fri, 14 Dec 2018 17:00:48 GMT</pubDate><media:content url="https://static.ghost.org/v2.0.0/images/publishing-options.jpg" medium="image"/><content:encoded><![CDATA[<img src="https://static.ghost.org/v2.0.0/images/publishing-options.jpg" alt="Publishing options"/><p>The Ghost editor has everything you need to fully optimise your content. This is where you can add tags and authors, feature a post, or turn a post into a page. </p><blockquote>Access the post settings menu in the top right hand corner of the editor. </blockquote><h2 id="post-feature-image">Post feature image</h2><p>Insert your post feature image from the very top of the post settings menu. Consider resizing or optimising your image first to ensure it's an appropriate size.</p><h2 id="structured-data-seo">Structured data &amp; SEO</h2><p>Customise your social media sharing cards for Facebook and Twitter, enabling you to add custom images, titles and descriptions for social media.</p><p>There’s no need to hard code your meta data. You can set your meta title and description using the post settings tool, which has a handy character guide and SERP preview. </p><p>Ghost will automatically implement structured data for your publication using JSON-LD to further optimise your content.</p><pre><code>{
    "@context": "https://schema.org",
    "@type": "Article",
    "publisher": {
        "@type": "Organization",
        "name": "Publishing options",
        "logo": "https://static.ghost.org/ghost-logo.svg"
    },
    "author": {
        "@type": "Person",
        "name": "Ghost",
        "url": "http://demo.ghost.io/author/ghost/",
        "sameAs": []
    },
    "headline": "Publishing options",
    "url": "http://demo.ghost.io/publishing-options",
    "datePublished": "2018-08-08T11:44:00.000Z",
    "dateModified": "2018-08-09T12:06:21.000Z",
    "keywords": "Getting Started",
    "description": "The Ghost editor has everything you need to fully optimise your content. This is where you can add tags and authors, feature a post, or turn a post into a page.",
    }
}
    </code></pre><p>You can test that the structured data <a href="https://schema.org/">schema</a> on your site is working as it should using <a href="https://search.google.com/structured-data/testing-tool" rel="noreferrer nofollow noopener">Google’s structured data tool</a>. </p><h2 id="code-injection">Code Injection</h2><p>This tool allows you to inject code on a per post or page basis, or across your entire site. This means you can modify CSS, add unique tracking codes, or add other scripts to the head or foot of your publication without making edits to your theme files. </p><p><strong>To add code site-wide</strong>, use the code injection tool <a href="https://gatsby.ghost.io/ghost/settings/code-injection/">in the main admin menu</a>. This is useful for adding a Facebook Pixel, a Google Analytics tracking code, or to start tracking with any other analytics tool.</p><p><strong>To add code to a post or page</strong>, use the code injection tool within the post settings menu. This is useful if you want to add art direction, scripts or styles that are only applicable to one post or page. </p><p>From here, you might be interested in managing some more specific <a href="https://gatsby.ghost.io/admin-settings/">admin settings</a>!</p>]]></content:encoded></item><item><title><![CDATA[Managing admin settings]]></title><description><![CDATA[There are a couple of things to do next while you're getting set up: making your site private and inviting your team.]]></description><link>https://gatsby.ghost.io/admin-settings/</link><guid isPermaLink="false">Ghost__Post__5c13e1bd3bec6400c097386b</guid><category><![CDATA[Getting Started]]></category><dc:creator><![CDATA[Ghost]]></dc:creator><pubDate>Fri, 14 Dec 2018 17:00:47 GMT</pubDate><media:content url="https://static.ghost.org/v2.0.0/images/admin-settings.jpg" medium="image"/><content:encoded><![CDATA[<img src="https://static.ghost.org/v2.0.0/images/admin-settings.jpg" alt="Managing admin settings"/><p>There are a couple of things to do next while you're getting set up:</p><h1 id="make-your-site-private">Make your site private</h1><p>If you've got a publication that you don't want the world to see yet because it's not ready to launch, you can hide your Ghost site behind a basic shared pass-phrase.</p><p>You can toggle this preference on at the bottom of Ghost's <a href="https://gatsby.ghost.io/ghost/settings/general/">General Settings</a>:</p><figure class="kg-card kg-image-card"><img src="https://static.ghost.org/v1.0.0/images/private.png" class="kg-image" alt="Managing admin settings"/></figure><p>Ghost will give you a short, randomly generated pass-phrase which you can share with anyone who needs access to the site while you're working on it. While this setting is enabled, all search engine optimisation features will be switched off to help keep your site under the radar.</p><p>Do remember though, this is <em>not</em> secure authentication. You shouldn't rely on this feature for protecting important private data. It's just a simple, shared pass-phrase for some very basic privacy.</p><hr><h1 id="invite-your-team">Invite your team </h1><p>Ghost has a number of different user roles for your team:</p><p><strong>Contributors</strong><br>This is the base user level in Ghost. Contributors can create and edit their own draft posts, but they are unable to edit drafts of others or publish posts. Contributors are <strong>untrusted</strong> users with the most basic access to your publication.</br></p><p><strong>Authors</strong><br>Authors are the 2nd user level in Ghost. Authors can write, edit  and publish their own posts. Authors are <strong>trusted</strong> users. If you don't trust users to be allowed to publish their own posts, they should be set as Contributors.</br></p><p><strong>Editors</strong><br>Editors are the 3rd user level in Ghost. Editors can do everything that an Author can do, but they can also edit and publish the posts of others - as well as their own. Editors can also invite new Contributors+Authors to the site.</br></p><p><strong>Administrators</strong><br>The top user level in Ghost is Administrator. Again, administrators can do everything that Authors and Editors can do, but they can also edit all site settings and data, not just content. Additionally, administrators have full access to invite, manage or remove any other user of the site.<br><br><strong>The Owner</strong><br>There is only ever one owner of a Ghost site. The owner is a special user which has all the same permissions as an Administrator, but with two exceptions: The Owner can never be deleted. And in some circumstances the owner will have access to additional special settings if applicable. For example: billing details, if using <a href="https://ghost.org/pricing/"><strong>Ghost(Pro)</strong></a>.</br></br></br></br></p><blockquote><em>It's a good idea to ask all of your users to fill out their user profiles, including bio and social links. These will populate rich structured data for posts and generally create more opportunities for themes to fully populate their design.</em></blockquote><p>Next up: <a href="https://gatsby.ghost.io/organising-content/">Organising your content</a> </p></hr>]]></content:encoded></item><item><title><![CDATA[Organising your content]]></title><description><![CDATA[Ghost has a flexible organisational taxonomy called tags which can be used to configure your site structure using dynamic routing.]]></description><link>https://gatsby.ghost.io/organising-content/</link><guid isPermaLink="false">Ghost__Post__5c13e1bd3bec6400c0973869</guid><category><![CDATA[Getting Started]]></category><dc:creator><![CDATA[Ghost]]></dc:creator><pubDate>Fri, 14 Dec 2018 17:00:46 GMT</pubDate><media:content url="https://static.ghost.org/v2.0.0/images/organising-your-content.jpg" medium="image"/><content:encoded><![CDATA[<img src="https://static.ghost.org/v2.0.0/images/organising-your-content.jpg" alt="Organising your content"/><p>Ghost has a flexible organisational taxonomy called<strong> tags</strong> which can be used to configure your site structure using <strong>dynamic routing</strong>. </p><h1 id="basic-tagging">Basic Tagging</h1><p>You can think of tags like Gmail labels. By tagging posts with one or more keyword, you can organise articles into buckets of related content.</p><p>When you create content for your publication you can assign tags to help differentiate between categories of content. </p><p>For example you may tag some content with  News and other content with Podcast, which would create two distinct categories of content listed on <code>/tag/news/</code> and <code>/tag/weather/</code>, respectively.</p><p>If you tag a post with both <code>News</code> <em>and</em> <code>Weather</code> - then it appears in both sections. Tag archives are like dedicated home-pages for each category of content that you have. They have their own pages, their own RSS feeds, and can support their own cover images and meta data.</p><h1 id="the-primary-tag">The primary tag</h1><p>Inside the Ghost editor, you can drag and drop tags into a specific order. The first tag in the list is always given the most importance, and some themes will only display the primary tag (the first tag in the list) by default. </p><blockquote><em><strong>News</strong>, Technology, Startup</em></blockquote><p>So you can add the most important tag which you want to show up in your theme, but also add related tags which are less important.</p><h1 id="private-tags">Private tags</h1><p>Sometimes you may want to assign a post a specific tag, but you don't necessarily want that tag appearing in the theme or creating an archive page. In Ghost, hashtags are private and can be used for special styling.</p><p>For example, if you sometimes publish posts with video content - you might want your theme to adapt and get rid of the sidebar for these posts, to give more space for an embedded video to fill the screen. In this case, you could use private tags to tell your theme what to do.</p><blockquote><em><strong>News</strong>, #video</em></blockquote><p>Here, the theme would assign the post publicly displayed tags of News - but it would also keep a private record of the post being tagged with #video. In your theme, you could then look for private tags conditionally and give them special formatting. </p><blockquote><em>You can find documentation for theme development techniques like this and many more over on Ghost's extensive <a href="https://themes.ghost.org/v2.0.0/docs">theme documentation</a>.</em></blockquote><h1 id="dynamic-routing">Dynamic Routing</h1><p>Dynamic routing gives you the ultimate freedom to build a custom publication to suit your needs. Routes are rules that map URL patterns to your content and templates. </p><p>For example, you may not want content tagged with <code>News</code> to exist on: <code>example.com/tag/news</code>. Instead, you want it to exist on <code>example.com/news</code> . </p><p>In this case you can use dynamic routes to create customised collections of content on your site. It's also possible to use multiple templates in your theme to render each content type differently.</p><p>There are lots of use cases for dynamic routing with Ghost, here are a few common examples: </p><ul><li>Setting a custom home page with its own template</li><li>Having separate content hubs for blog and podcast, that render differently, and have custom RSS feeds to support two types of content</li><li>Creating a founders column as a unique view, by filtering content created by specific authors</li><li>Including dates in permalinks for your posts</li><li>Setting posts to have a URL relative to their primary tag like <code>example.com/europe/story-title/</code><br/></li></ul><blockquote><em>Dynamic routing can be configured in Ghost using <a href="http://yaml.org/spec/1.2/spec.html" rel="noreferrer nofollow noopener">YAML</a> files. Read our dynamic routing <a href="https://docs.ghost.org/docs/dynamic-routing">documentation</a> for further details.</em></blockquote><p>You can further customise your site using <a href="https://gatsby.ghost.io/apps-integrations/">Apps &amp; Integrations</a>.</p>]]></content:encoded></item><item><title><![CDATA[Apps & integrations]]></title><description><![CDATA[There are three primary ways to work with third-party services in Ghost: using Zapier, editing your theme, or using the Ghost API.]]></description><link>https://gatsby.ghost.io/apps-integrations/</link><guid isPermaLink="false">Ghost__Post__5c13e1bd3bec6400c0973867</guid><category><![CDATA[Getting Started]]></category><dc:creator><![CDATA[Ghost]]></dc:creator><pubDate>Fri, 14 Dec 2018 17:00:45 GMT</pubDate><media:content url="https://static.ghost.org/v2.0.0/images/app-integrations.jpg" medium="image"/><content:encoded><![CDATA[<img src="https://static.ghost.org/v2.0.0/images/app-integrations.jpg" alt="Apps & integrations"/><p>There are three primary ways to work with third-party services in Ghost: using Zapier, editing your theme, or using the Ghost API.</p><h1 id="zapier">Zapier</h1><p>You can connect your Ghost site to over 1,000 external services using the official integration with <a href="https://zapier.com">Zapier</a>.</p><p>Zapier sets up automations with Triggers and Actions, which allows you to create and customise a wide range of connected applications.</p><blockquote><strong>Example</strong>: When someone new subscribes to a newsletter on a Ghost site (Trigger) then the contact information is automatically pushed into MailChimp (Action).</blockquote><p><strong>Here are the most popular Ghost&lt;&gt;Zapier automation templates:</strong> </p><!--kg-card-begin: markdown--><script src="https://zapier.com/apps/embed/widget.js?services=Ghost&container=true&limit=8"/>
<!--kg-card-end: markdown--><h1 id="editing-your-theme">Editing your theme</h1><p>One of the biggest advantages of using Ghost over centralised platforms is that you have total control over the front end of your site. Either customise your existing theme, or create a new theme from scratch with our <a href="https://themes.ghost.org">Theme SDK</a>. </p><p>You can integrate <em>any</em> front end code into a Ghost theme without restriction, and it will work just fine. No restrictions!</p><p><strong>Here are some common examples</strong>:</p><ul><li>Include comments on a Ghost blog with <a href="https://help.ghost.org/article/15-disqus">Disqus</a> or <a href="https://help.ghost.org/article/35-discourse">Discourse</a></li><li>Implement <a href="https://help.ghost.org/article/89-mathjax">MathJAX</a> with a little bit of JavaScript</li><li>Add syntax highlighting to your code snippets using <a href="https://prismjs.com/">Prism.js</a></li><li>Integrate any dynamic forms from <a href="https://www.google.com/forms/">Google</a> or <a href="https://www.typeform.com/">Typeform</a> to capture data</li><li>Just about anything which uses JavaScript, APIs and Markup.</li></ul><h1 id="using-the-public-api">Using the Public API</h1><p>Ghost itself is driven by a set of core APIs, and so you can access the Public Ghost JSON API from external webpages or applications in order to pull data and display it in other places.</p><blockquote>The Ghost API is <a href="https://api.ghost.org">thoroughly documented</a> and straightforward to work with for developers of almost any level. </blockquote><p>Alright, the last post in our welcome-series! If you're curious about creating your own Ghost theme from scratch, here are <a href="https://gatsby.ghost.io/themes/">some more details</a> on how that works.</p>]]></content:encoded></item><item><title><![CDATA[Creating a custom theme]]></title><description><![CDATA[Ghost comes with a beautiful default theme called Casper, which is designed to be a clean, readable publication layout and can be easily adapted for most purposes.]]></description><link>https://gatsby.ghost.io/themes/</link><guid isPermaLink="false">Ghost__Post__5c13e1bc3bec6400c0973865</guid><category><![CDATA[Getting Started]]></category><dc:creator><![CDATA[Ghost]]></dc:creator><pubDate>Fri, 14 Dec 2018 17:00:44 GMT</pubDate><media:content url="https://static.ghost.org/v2.0.0/images/creating-a-custom-theme.jpg" medium="image"/><content:encoded><![CDATA[<img src="https://static.ghost.org/v2.0.0/images/creating-a-custom-theme.jpg" alt="Creating a custom theme"/><p>Ghost comes with a beautiful default theme called Casper, which is designed to be a clean, readable publication layout and can be adapted for most purposes. However, Ghost can also be completely themed to suit your needs. Rather than just giving you a few basic settings which act as a poor proxy for code, we just let you write code.</p><p>There are a huge range of both free and premium pre-built themes which you can get from the <a href="http://marketplace.ghost.org">Ghost Theme Marketplace</a>, or you can create your own from scratch.</p><figure class="kg-card kg-image-card kg-card-hascaption"><img src="https://static.ghost.org/v1.0.0/images/marketplace.jpg" class="kg-image" alt="Creating a custom theme"><figcaption>Anyone can write a completely custom Ghost theme with some solid knowledge of HTML and CSS</figcaption></img></figure><p>Ghost themes are written with a templating language called handlebars, which has a set of dynamic helpers to insert your data into template files. For example: <code>{{author.name}}</code> outputs the name of the current author.</p><p>The best way to learn how to write your own Ghost theme is to have a look at <a href="https://github.com/TryGhost/Casper">the source code for Casper</a>, which is heavily commented and should give you a sense of how everything fits together.</p><ul><li><code>default.hbs</code> is the main template file, all contexts will load inside this file unless specifically told to use a different template.</li><li><code>post.hbs</code> is the file used in the context of viewing a post.</li><li><code>index.hbs</code> is the file used in the context of viewing the home page.</li><li>and so on</li></ul><p>We've got <a href="https://themes.ghost.org/v2.0.0/docs">full and extensive theme documentation</a> which outlines every template file, context and helper that you can use.</p><p>If you want to chat with other people making Ghost themes to get any advice or help, there's also a <strong>themes</strong> section on our <a href="https://forum.ghost.org/c/themes">public Ghost forum</a>.</p>]]></content:encoded></item></channel></rss>