Documents Blog Only Mode and Netlify Hosting (#595)

* Documentation, newest: Add steps for hosting on Netlify

* Documents how to run a blog-only site

docs/getting-started-publishing.md

@@ -21,6 +21,11 @@ At this point, you can grab all of the files inside the `website/build` folder a
 
 > For example, both Apache and nginx serve content from `/var/www/html` by default. That said, choosing a web server or provider is outside the scope of Docusaurus.
 
+### Hosting on a Service:
+
+* [Github Pages](#using-github-pages)
+* [Netlify](#hosting-on-netlify)
+
 ### Using GitHub Pages
 
 While choosing a web server or host is outside Docusaurus' scope, Docusaurus was designed to work really well with one of the most popular hosting solutions for open source projects: [GitHub Pages](https://pages.github.com/).
@@ -155,3 +160,19 @@ jobs:
 ```
 
 Save this file as `config.yml` and place it in a `.circleci` folder inside your `website/assets` folder.
+
+### Hosting on Netlify
+
+Steps to configure your Docusaurus-powered site on Netlify.
+
+1. Select **New site from Git**
+2. Connect to your preferred Git provider.
+3. Select the branch to deploy. Default is `master`
+4. Configure your build steps:
+
+* For your build command enter: `cd website; npm install; npm run build;`
+* For publish directory: `build/<projectName>` (use the projectName from your siteConfig)
+
+5. Click **Deploy site**
+
+You can also configure Netlify to rebuild on every commit to your repo, or only `master` branch commits.

docs/guides-blog.md

@@ -17,7 +17,6 @@ headerLinks: [
 ]
 ```
 
-
 ## Adding Posts
 
 To publish in the blog, create a file within the blog folder with a formatted name of `YYYY-MM-DD-My-Blog-Post-Title.md`. The post date is extracted from the file name.
@@ -35,17 +34,15 @@ title: Introducing Docusaurus
 Lorem Ipsum...
 ```
 
-
 ## Header Options
 
 The only required field is `title`; however, we provide options to add author information to your blog post as well.
 
-- `author` - The text label of the author byline.
-- `authorURL` - The URL associated with the author. This could be a Twitter, GitHub, Facebook account, etc.
-- `authorFBID` - The Facebook profile ID that is used to fetch the profile picture.
-- `authorImageURL` - The URL to the author's image. (Note: If you use both `authorFBID` and `authorImageURL`, `authorFBID` will take precedence. Don't include `authorFBID` if you want `authorImageURL` to appear.)
-- `title` - The blog post title.
-
+* `author` - The text label of the author byline.
+* `authorURL` - The URL associated with the author. This could be a Twitter, GitHub, Facebook account, etc.
+* `authorFBID` - The Facebook profile ID that is used to fetch the profile picture.
+* `authorImageURL` - The URL to the author's image. (Note: If you use both `authorFBID` and `authorImageURL`, `authorFBID` will take precedence. Don't include `authorFBID` if you want `authorImageURL` to appear.)
+* `title` - The blog post title.
 
 ## Summary Truncation
 
@@ -78,6 +75,7 @@ You can configure a specific amount of blog posts to show by adding a `blogSideb
 The available options are an integer representing the number of posts you wish to show or a string with the value 'ALL'.
 
 Example:
+
 ```
 blogSidebarCount: 'ALL'
 ```
@@ -91,3 +89,39 @@ A summary of the post's text is provided in the RSS feed up to the `<!--truncate
 ## Social Buttons
 
 If you want Facebook and/or Twitter social buttons at the bottom of your blog posts, set the `facebookAppId` and/or `twitter` [site configuration](api-site-config.md) options in `siteConfig.js`.
+
+## Advanced Topics
+
+### I want to run in "Blog Only" mode.
+
+You can run your Docusaurus site without a landing page and instead have your blog load first.
+
+To do this:
+
+1. Create a file `index.html` in `website/static/`.
+
+1. Place the contents of the template below into `website/static/index.html`
+
+1. Customize the `<title>` of `website/static/index.html`
+
+1. Delete the dynamic landing page `website/pages/en/index.js`
+
+> Now, when Docusaurus generates or builds your site, it will copy the file from `static/index.html` and place it in the site's main folder. The static file is served when a visitor arrives on your page. When the page loads it will redirect the visitor to `/blog`.
+
+You can use this template:
+
+```<!DOCTYPE HTML>
+<html lang="en-US">
+    <head>
+        <meta charset="UTF-8">
+        <meta http-equiv="refresh" content="0; url=blog/">
+        <script type="text/javascript">
+            window.location.href = "blog/"
+        </script>
+        <title>Title of Your Blog</title>
+    </head>
+    <body>
+        If you are not redirected automatically, follow this <a href='blog/'>link</a>.
+    </body>
+</html>
+```