next-mdx-blog
enables you to easily add a blog to any next.js
based project.
EXAMPLE: http://hipstersmoothie.com/blog/ CODE: https://github.com/hipstersmoothie/hipstersmoothie
Features:
- MDX Blog
- RSS Feed
- Simple Setup
- Customizable Rendering
yarn add next-mdx-blog
You can store your blog posts anywhere in the pages
directory. But to keep things tidy I like to keep all blog posts in pages/blog
.
A post has a meta
header. The rest of the blog post is MDX. Anything in the meta
header will be stored.
export const meta = {
author: 'Andrew Lisowski',
authorLink: 'https://github.intuit.com/alisowski',
avatar: 'https://avatars2.githubusercontent.com/u/1192452?s=400&v=4'
publishDate: '2018-05-10T12:00:00Z',
title: 'First Post',
}
# Section 1.10.32 of "de Finibus Bonorum et Malorum", written by Cicero in 45 BC
To get your blog index to build you must use the next-mdx-blog
plugin in your next.config.js
. You must also add @zeit/next-mdx
to parse your blog posts.
Make sure to include mdx
in your pageExtensions
.
const withPlugins = require('next-compose-plugins');
// Generates Blog Index
const withBlog = require('next-mdx-blog');
const withMDX = require('@zeit/next-mdx')();
module.exports = withPlugins([withMDX, withBlog], {
pageExtensions: ['js', 'mdx']
});
Now you next
website will generate a posts.js
with all the metadata about the posts in your project. You can use to build your blog. Anything stored in the meta
header can be found here.
You can add a global author by passing a configuration objecting into next-mdx-blog
.
const withBlog = require('next-mdx-blog');
const withMDX = require('@zeit/next-mdx')();
module.exports = withPlugins([withMDX, withBlog], {
author: 'Andrew Lisowski',
authorLink: 'https://github.intuit.com/alisowski',
avatar: 'https://avatars2.githubusercontent.com/u/1192452?s=400&v=4',
pageExtensions: ['js', 'mdx']
});
If you website is being served out of something other than the root domain you might need to add a prefix to your urls. Such as is the case with github pages.
const withBlog = require('next-mdx-blog');
const withMDX = require('@zeit/next-mdx')();
module.exports = withPlugins([withMDX, withBlog], {
assetPrefix: 'my-github-project',
pageExtensions: ['js', 'mdx']
});
next-mdx-blog
comes with default list
and post
components to build your blog with. You do not need to use these components, they are sensible defaults.
To get these to work you should also include bulma
in your head somehow
<link
rel="stylesheet"
href="https://jenil.github.io/bulmaswatch/default/bulmaswatch.min.css"
/>
To use the components with next.js you have to flush the styles. This is a bug in styled-jsx component package + next.js. To remedy this manually flush the styles:
import React from 'react';
import Document, { Head, Main, NextScript } from 'next/document';
import flush from 'styled-jsx/server';
import flushBlog from 'next-mdx-blog/dist/components/flush';
export default class MyDocument extends Document {
static getInitialProps({ renderPage }) {
const { html, head, errorHtml, chunks } = renderPage();
return { html, head, errorHtml, chunks, styles: [flush(), flushBlog()] };
}
render() {}
}
A list of blog posts. Each post displays a small preview of it's content. You must dynamically require the blog posts to get the previews working. This component should be used to display the blog index.
pages/blog.js
:
import React from 'react';
import Head from 'next/head';
import BlogIndex from 'next-mdx-blog/dist/components/list';
import postsData from '../posts';
// Dynamically import the blog posts
postsData.forEach(post => {
post.file = import('../pages' + post.filePath.replace('pages', ''));
});
const blogPage = ({ posts = postsData }) => (
<div className="blog-index">
<Head>
<title>Blog Posts</title>
</Head>
<BlogIndex posts={posts} stubClassName="content" />
</div>
);
// Before page loads await the dynamic components. prevents blog preview page flash.
blogPage.getInitialProps = async () => {
await Promise.all(
postsData.map(async post => {
post.BlogPost = (await post.file).default;
return post;
})
);
return { posts: [...postsData] };
};
export default blogPage;
The post index generated by the next plugin.
How many posts to display per page.
Classname for the root div.
Classname for the post stubs.
How much of the post should be displayed before the fold.
A full blog post. To get your blog content to render inside the blog posts component your must either
- Modify
_app.js
to render blog content inside appropriate wrapper
import React from 'react';
import App, { Container } from 'next/app';
import Layout from '../components/layout';
import BlogPost from 'next-mdx-blog/dist/components/post';
import posts from '../posts';
// Override the App class to put layout component around the page contents
// https://github.com/zeit/next.js#custom-app
export default class MyApp extends App {
render() {
const { Component, pageProps } = this.props;
const { pathname } = this.props.router;
return (
<Container>
<Layout pathname={pathname} active={active}>
{pathname.includes('blog/') ? (
<BlogPost
post={posts.find(post => post.urlPath === pathname)}
className="content"
>
<Component {...pageProps} />
</BlogPost>
) : (
<Component {...pageProps} />
)}
</Layout>
</Container>
);
}
}
- Wrap blog content inside each
mdx
file. This is more work but you can customize each blog post.
export const meta = {
publishDate: '2018-05-10T12:00:00Z',
title: 'First Post',
}
import Post from 'next-mdx-blog/dist/components/post'
<Post post={meta}>
# Section 1.10.32 of "de Finibus Bonorum et Malorum", written by Cicero in 45 BC
</Post>
Post body.
Classname to wrap the post in.
The post meta data to display.
If you are prefixing your URLS you will need to identify posts by prefixing the pathname.
const prefixUrl = (p) => path.join(assetPrefix, p)
<BlogPost post={posts.find(post => post.urlPath === prefixUrl(pathname))}>
<Component {...pageProps} />
</BlogPost>