next-blog

项目介绍

利用react服务端框架next.js写的博客，喜欢就给个Star支持一下。 https://github.com/Weibozzz/next-blog 线上地址： http://www.liuweibo.cn 本项目使用next.js经验分享：http://www.liuweibo.cn/p/206 另外还有一个仓库，建立自己的前端知识体系：https://github.com/Weibozzz/Weibozzz.github.io

软件架构

软件架构说明 react.js next.js antd mysql node koa2 fetch

网站使用技术

前端：React(16.x) Next.js antd-design fetch Less
后端：node框架koa和mysql （目前前后端分离，这里只负责写接口，和平常的ajax获取接口一样，这里就不开放源码了）
网站目的：业余学习，记录技术文章，学以致用
网站功能
- markdown发布文章
- 修改文章（增删改查）
- 用户评论
- 上传图片到七牛云存储
- 点击图片预览功能
- 支持手机自适应

安装教程

快速开始虽然是服务端渲染，但是也要调用接口，所以需要调用后端的接口

进入config文件夹下的env.js的isShow设置为true,这里只是调用了我自己线上的接口，当然你只能看不能修改接口哦。如果为false则调不到接口，需要自己去写接口。

运行

cnpm i
npm run dev

部署

cnpm i
npm run build
npm start

使用说明

关于演示不能上传图片，不能发表文章或者修改属于正常情况，因为只是为了展示。
关于路看不到发布文章路由和后台管理也属于正常情况，可以修改代码展示路由效果。

网站截图

详情页
列表页
编辑页面和发布文章，上传图片到七牛云

网站技术介绍

完全借助于 next.js 开发的个人网站，线上地址 http://www.liuweibo.cn 总结一下开发完成后的心得和使用体会。gtihub源码https://github.com/Weibozzz/next-blog。喜欢就给个Star支持一下。

为什么使用服务器端渲染(SSR)？

网站是要推广的，所以需要更好的 SEO，搜索引擎可以抓取完整页面
访问速度，更快的加载静态页面

网站使用技术

前端：React(16.x) Next.js antd-design fetch Less
后端：node框架koa和mysql （目前前后端分离，这里只负责写接口，和平常的ajax获取接口一样，这里就不开放源码了）
网站目的：业余学习，记录技术文章，学以致用
网站功能
- 发布文章
- 修改文章（增删改查）
- 用户评论

源码剖析

这里就只讲重点了

入口文件`server.js`

这里用的官方提供的express，同时开启gzip压缩

const express = require('express')
const next = require('next')

const compression = require('compression')
const dev = process.env.NODE_ENV !== 'production'
const app = next({ dev })
const handle = app.getRequestHandler()
let port= dev?4322:80

app.prepare()
  .then(() => {
    const server = express()

    if (!dev) {
      server.use(compression()) //gzip
    }
    //文章二级页面
    server.get('/p/:id', (req, res) => {
      const actualPage = '/detail'
      const queryParams = { id: req.params.id }
      app.render(req, res, actualPage, queryParams)
    })

    server.get('*', (req, res) => {
      return handle(req, res)
    })

    server.listen(port, (err) => {
      if (err) throw err
      console.log('> Ready on http://localhost ' port)
    })
  })
  .catch((ex) => {
    process.exit(1)
  })

page根组件_app.js

用于传递redux数据,store就和普通react用法一样了，还有header和footer可以放在这里,同理还有_err.js用于处理404页面

import App, {Container} from 'next/app'
import React from 'react'
import {withRouter} from 'next/router' // 接入next的router
import withReduxStore from '../lib/with-redux-store' // 接入next的redux
import {Provider} from 'react-redux'


class MyApp extends App {
  render() {

    const {Component, pageProps, reduxStore, router: {pathname}} = this.props;
    return (
      <Container>
        <Provider store={reduxStore}>
         <Component {...myPageProps}  />
        </Provider>

      </Container>
    )
  }
}

export default withReduxStore(withRouter(MyApp))

网站的服务端渲染页面Blog页面

link用于跳转页面，利用as把原本的http://***.com?id=1变为漂亮的 /id/1
head可以嵌套meta标签进行seo
配置不需要seo的组件

import dynamic from 'next/dynamic';

//不需要seo
const DynasicTopTipsNoSsr = dynamic(import('../../components/TopTips'),{
  ssr:false
})

import React, {Component} from 'react'
import {connect} from 'react-redux'
import Router from 'next/router'
import 'whatwg-fetch' // 用于fetch请求数据
import Link from 'next/link'; // next的跳转link
import Head from 'next/head'  // next的跳转head可用于seo

class Blog extends Component {

  render() {
    return (
      <div className="Blog">
        <Head>
          <title>{BLOG_TXT}&raquo;{COMMON_TITLE}</title>
        </Head>
        <MyLayout>
          <Link   as={`/Blog/${current}`} href={`/Blog?id=${current}`}>
            <a onClick={this.onClickPageChange.bind(this)}>{current}</a>
          </Link>
        </MyLayout>
      </div>
    )
  }
}
//这里才是重点，getInitialProps方法来请求数据进行渲染，达到服务端渲染的目的
Blog.getInitialProps = async function (context) {
  const {id = 1} = context.query
  let queryStringObj = {
    type: ALL,
    num: id,
    pageNum
  }
  let queryTotalString = {type: ALL};
  const pageBlog = await fetch(getBlogUrl(queryStringObj))
  const pageBlogData = await pageBlog.json()


  return {pageBlogData}
}
// 这里根据需要传入redux
const mapStateToProps = state => {
  const {res, searchData, searchTotalData} = state
  return {res, searchData, searchTotalData};
}
export default connect(mapStateToProps)(Blog)

静态资源

根目录创建static文件夹，这里是强制要求，否则加载不到静态资源

配置antd和主题并且按需加载

主题配置

antd-custom.less

@primary-color: #722ED0;

@layout-header-height: 40px;
@border-radius-base: 0px;

styles.less

@import "~antd/dist/antd.less";
@import "./antd-custom.less";

最后统一配置在公共head

<Head>
    <meta charSet="utf-8"/>
    <meta httpEquiv="X-UA-Compatible" content="IE=edge, chrome=1"/>
    <meta name="viewport"
          content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"/>
    <meta name="renderer" content="webkit"/>
    <meta httpEquiv="description" content="刘伟波-伟波前端"/>
    <meta name="author" content="刘伟波,liuweibo"/>
    <link rel='stylesheet' href='/_next/static/style.css'/>
    <link rel='stylesheet' type='text/css' href='/static/nprogress.css' />
    <link rel='shortcut icon' type='image/x-icon' href='/static/favicon.ico' />
  </Head>

按需加载配置

.babelrc文件

{
  "presets": ["next/babel"],
  "plugins": [
    "transform-decorators-legacy",
    [
      "import",
      {
        "libraryName": "antd",
        "style": "less"
      }
    ]
  ]
}

next.config.js文件配置

const withLess = require('@zeit/next-less')

module.exports =   withLess(
  {
    lessLoaderOptions: {
      javascriptEnabled: true,
      cssModules: true,

    }
  }
)

页面css

感觉和vue的scope一样，style的jsx,加了global为全局，否则只在这里生效

render() {

    return (
      <Container>
        <Provider store={reduxStore}>
          <Component {...myPageProps}  />
        </Provider>

        <style jsx global>{`

.fl{
    float: left;
}
.fr{
    float: right;
}
        `}</style>
      </Container>
    )

页面顶部加载进度条

import Router from 'next/router'
import NProgress from 'nprogress'

Router.onRouteChangeStart = (url) => {
  NProgress.start()
}
Router.onRouteChangeComplete = () => NProgress.done()
Router.onRouteChangeError = () => NProgress.done()

markdown发表文章和代码高亮

使用只需要marked('放入markdown字符串');

import marked from 'marked'
import hljs from 'highlight.js';

hljs.configure({
  tabReplace: '  ',
  classPrefix: 'hljs-',
  languages: ['CSS', 'HTML, XML', 'JavaScript', 'PHP', 'Python', 'Stylus', 'TypeScript', 'Markdown']
})
marked.setOptions({
  highlight: (code) => hljs.highlightAuto(code).value,
  gfm: true,
  tables: true,
  breaks: false,
  pedantic: false,
  sanitize: true,
  smartLists: true,
  smartypants: false
});

next.js 配置相关

next.config.js文件配置

module.exports = {
  webpack (config, ...args) {
    return config;
  }
}

增加 alias

config.resolve.alias = {
      ...config.resolve.alias,
      '@': path.resolve(__dirname, './'),
    }

增加插件

config.plugins.push(
      new webpack.DefinePlugin({
        'process.env.NODE_ENV': process.env.NODE_ENV
      })
    )

增加 rules

config.module.rules.push(
      {
        test: /\.svg(\?v=\d+\.\d+\.\d+)?$/,
        use: [
          {
            loader: 'babel-loader'
          },
          {
            loader: '@svgr/webpack',
            options: {
              babel: false,
              icon: true
            }
          }
        ]
      }
    )

支持css和less

config = withCSS()
      .webpack(config, ...args)
    config = withLess()
      .webpack(config, ...args)

less某些文件开启css module

const loaderUtils = require('loader-utils')
const fs = require('fs')
const path = require('path')
const cssModuleRegex = /\.module\.less$/

config = withLess(
      // 开启 css module 自定义
      {
        cssModules: true,
        cssLoaderOptions: {
          importLoaders: 1,
          minimize: !args[0].dev,
          getLocalIdent: (loaderContext, _, localName, options) => {
            const fileName = path.basename(loaderContext.resourcePath)
            if (cssModuleRegex.test(fileName)) {
              const content = fs.readFileSync(loaderContext.resourcePath)
                .toString()
              const name = fileName.replace(/\.[^/.]+$/, '')
              const hash = args[0].dev ? `${name}___[hash:base64:5]` : '[hash:base64:5]'
              const fileNameHash = loaderUtils.interpolateName(
                loaderContext,
                hash,
                { content }
              )
              return fileNameHash
            }
            return localName
          }
        }
      }
    )

支持 bundleAnalyzer

const withBundleAnalyzer = require('@next/bundle-analyzer')({
  enabled: process.env.ANALYZE === 'true'
})

    config = withBundleAnalyzer({})
      .webpack(config, ...args)

学累了，来个图放松下

)

参与贡献

Fork 本项目
新建 Feat_xxx 分支
提交代码
新建 Pull Request

遗留问题

访问量大的时候要做数据缓存
cdn node查看图片日期
配置图片描述和更改
上传图片高质量暂未支持上传,上传代码改进
上传为刚好1M bug
登陆后支持收藏文章和修改评论
发表文章如果上一篇文章被删除，自增id不是自加1，需要去查询数据库
填写markdown代码高亮，类似于掘金
versions当天的要合并

待学习修改

开发环境 warning.js:33 Warning: A component is contentEditable
eslint

关于作者 / About

github:https://github.com/Weibozzz
个人博客:http://www.liuweibo.cn
segmentfault:https://segmentfault.com/u/weibozzz
公众平台：伟波前端

版权声明

所有原创文章的著作权属于 Weibozzz。

作者：刘伟波

链接：http://www.liuweibo.cn/p/206

来源：刘伟波博客

本文原创版权属于刘伟波，转载请注明出处，谢谢合作

Weibozzz/next-blog

next-blog

项目介绍

软件架构

网站使用技术

安装教程

使用说明

网站截图

网站技术介绍

为什么使用服务器端渲染(SSR)？

网站使用技术

源码剖析

入口文件server.js

page根组件_app.js

网站的服务端渲染页面Blog页面

静态资源

配置antd和主题并且按需加载

主题配置

按需加载配置

页面css

页面顶部加载进度条

markdown发表文章和代码高亮

next.js 配置相关

学累了，来个图放松下

参与贡献

遗留问题

待学习修改

关于作者 / About

版权声明

入口文件`server.js`