<!DOCTYPE html><htmllang="en"><head><metacharSet="utf-8"/><metahttp-equiv="X-UA-Compatible"content="IE=edge"/><title>Adding a Blog · Docusaurus</title><metaname="viewport"content="width=device-width"/><metaname="generator"content="Docusaurus"/><metaname="description"content="<h2><aclass="anchor"aria-hidden="true"id="initial-setup"></a><ahref="#initial-setup"aria-hidden="true"class="hash-link"><svgclass="hash-link-icon"aria-hidden="true"height="16"version="1.1"viewBox="001616"width="16"><pathfill-rule="evenodd"d="M49h1v1H4c-1.50-3-1.69-3-3.5S2.55343h4c1.45031.6933.501.41-.912.72-23.25V8.59c.58-.451-1.271-2.09C105.228.98484H4c-.980-21.22-22.5S3949zm9-3h-1v1h1c1021.2222.5S13.98121312H9c-.980-2-1.22-2-2.50-.83.42-1.641-2.09V6.25c-1.09.53-21.84-23.25C611.317.5513913h4c1.4503-1.693-3.5S14.56136z"></path></svg></a>InitialSetup</h2>
"/><metaname="docsearch:version"content="1.7.2"/><metaname="docsearch:language"content="en"/><metaproperty="og:title"content="Adding a Blog · Docusaurus"/><metaproperty="og:type"content="website"/><metaproperty="og:url"content="https://docusaurus.io/index.html"/><metaproperty="og:description"content="<h2><aclass="anchor"aria-hidden="true"id="initial-setup"></a><ahref="#initial-setup"aria-hidden="true"class="hash-link"><svgclass="hash-link-icon"aria-hidden="true"height="16"version="1.1"viewBox="001616"width="16"><pathfill-rule="evenodd"d="M49h1v1H4c-1.50-3-1.69-3-3.5S2.55343h4c1.45031.6933.501.41-.912.72-23.25V8.59c.58-.451-1.271-2.09C105.228.98484H4c-.980-21.22-22.5S3949zm9-3h-1v1h1c1021.2222.5S13.98121312H9c-.980-2-1.22-2-2.50-.83.42-1.641-2.09V6.25c-1.09.53-21.84-23.25C611.317.5513913h4c1.4503-1.693-3.5S14.56136z"></path></svg></a>InitialSetup</h2>
"/><metaproperty="og:image"content="https://docusaurus.io/img/docusaurus.png"/><metaname="twitter:card"content="summary"/><metaname="twitter:image"content="https://docusaurus.io/img/docusaurus.png"/><linkrel="shortcut icon"href="/img/docusaurus.ico"/><linkrel="stylesheet"href="https://cdn.jsdelivr.net/docsearch.js/1/docsearch.min.css"/><linkrel="stylesheet"href="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/atom-one-dark.min.css"/><linkrel="alternate"type="application/atom+xml"href="https://docusaurus.io/blog/atom.xml"title="Docusaurus Blog ATOM Feed"/><linkrel="alternate"type="application/rss+xml"href="https://docusaurus.io/blog/feed.xml"title="Docusaurus Blog RSS Feed"/><script>
<p>To publish in the blog, create a file within the blog directory with a formatted name of <code>YYYY-MM-DD-My-Blog-Post-Title.md</code>. The post date is extracted from the file name.</p>
<p>For example, at <code>website/blog/2017-08-18-Introducing-Docusaurus.md</code>:</p>
<p>The only required field is <code>title</code>; however, we provide options to add author information to your blog post as well.</p>
<ul>
<li><code>author</code> - The text label of the author byline.</li>
<li><code>authorURL</code> - The URL associated with the author. This could be a Twitter, GitHub, Facebook account, etc.</li>
<li><code>authorFBID</code> - The Facebook profile ID that is used to fetch the profile picture.</li>
<li><code>authorImageURL</code> - The URL to the author's image. (Note: If you use both <code>authorFBID</code> and <code>authorImageURL</code>, <code>authorFBID</code> will take precedence. Don't include <code>authorFBID</code> if you want <code>authorImageURL</code> to appear.)</li>
<li><code>title</code> - The blog post title.</li>
<p>Use the <code><!--truncate--></code> marker in your blog post to represent what will be shown as the summary when viewing all published blog posts. Anything above <code><!--truncate--></code> will be part of the summary. For example:</p>
<p>You can configure a specific sidebar title by adding a <code>blogSidebarTitle</code> setting to your <code>siteConfig.js</code>.</p>
<p>The option is an object which can have the keys <code>default</code> and <code>all</code>. Specifying a value for <code>default</code> allows you to change the default sidebar title. Specifying a value for <code>all</code> allows you to change the sidebar title when the <code>blogSidebarCount</code> option is set to <code>'ALL'</code>.</p>
<p>Docusaurus provides a simple RSS feed for your blog posts. Both RSS and Atom feed formats are supported. This data is automatically to your website page's HTML <HEAD> tag.</p>
<p>A summary of the post's text is provided in the RSS feed up to the <code><!--truncate--></code>. If no <code><!--truncate--></code> tag is found, then all text up 250 characters are used.</p>
<p>If you want Facebook and/or Twitter social buttons at the bottom of your blog posts, set the <code>facebookAppId</code> and/or <code>twitter</code><ahref="/docs/en/site-config">site configuration</a> options in <code>siteConfig.js</code>.</p>
<p>You can run your Docusaurus site without a landing page and instead have your blog load first.</p>
<p>To do this:</p>
<ol>
<li>Create a file <code>index.html</code> in <code>website/static/</code>.</li>
<li>Place the contents of the template below into <code>website/static/index.html</code></li>
<li>Customize the <code><title></code> of <code>website/static/index.html</code></li>
<li>Delete the dynamic landing page <code>website/pages/en/index.js</code></li>
</ol>
<blockquote>
<p>Now, when Docusaurus generates or builds your site, it will copy the file from <code>static/index.html</code> and place it in the site's main directory. The static file is served when a visitor arrives on your page. When the page loads it will redirect the visitor to <code>/blog</code>.</p>
<spanclass="hljs-tag"><<spanclass="hljs-name">title</span>></span>Title of Your Blog<spanclass="hljs-tag"></<spanclass="hljs-name">title</span>></span>
If you are not redirected automatically, follow this <spanclass="hljs-tag"><<spanclass="hljs-name">a</span><spanclass="hljs-attr">href</span>=<spanclass="hljs-string">"blog/"</span>></span>link<spanclass="hljs-tag"></<spanclass="hljs-name">a</span>></span>.
</span></div></article></div><divclass="docLastUpdate"><em>Last updated on 2018-6-15 by Jonathan Ingram</em></div><divclass="docs-prevnext"><aclass="docs-prev button"href="/docs/en/docker"><spanclass="arrow-prev">← </span><span>Docker</span></a><aclass="docs-next button"href="/docs/en/custom-pages"><span>Custom Pages</span><spanclass="arrow-next"> →</span></a></div></div></div><navclass="onPageNav"><ulclass="toc-headings"><li><ahref="#initial-setup">Initial Setup</a></li><li><ahref="#adding-posts">Adding Posts</a></li><li><ahref="#header-options">Header Options</a></li><li><ahref="#summary-truncation">Summary Truncation</a></li><li><ahref="#changing-how-many-blog-posts-show-on-sidebar">Changing How Many Blog Posts Show on Sidebar</a></li><li><ahref="#changing-the-sidebar-title">Changing The Sidebar Title</a></li><li><ahref="#rss-feed">RSS Feed</a></li><li><ahref="#social-buttons">Social Buttons</a></li><li><ahref="#advanced-topics">Advanced Topics</a><ulclass="toc-headings"><li><ahref="#i-want-to-run-in-blog-only-mode">I want to run in "Blog Only" mode.</a></li></ul></li></ul></nav></div><footerclass="nav-footer"id="footer"><sectionclass="sitemap"><ahref="/"class="nav-home"><imgsrc="/img/docusaurus_monochrome.svg"alt="Docusaurus"width="66"height="58"/></a><divclass="footerSection"><h5>Docs</h5><ahref="
