feat: Support custom theme

src/core/compiler.js

@@ -3,7 +3,6 @@ const webpack = require('webpack')
 const ProgressPlugin = require('webpack/lib/ProgressPlugin')
 const { babelOptions } = require('../utils/babel')
 
-const THEMES_DIR = syspath.resolve(__dirname, '../../themes')
 const NODE_MODS_DIR = syspath.resolve(__dirname, '../../node_modules')
 
 async function getCompiler (env, props) {
@@ -18,7 +17,7 @@ async function getCompiler (env, props) {
     entry: {
       main: [
         isDev && 'webpack-hot-middleware/client',
-        `${THEMES_DIR}/${props.config.theme}/index.js`,
+        `${props.config.theme}/index.js`,
       ].filter(Boolean),
     },
     output: {
@@ -38,7 +37,7 @@ async function getCompiler (env, props) {
       rules: [
         {
           test: /\.js$/,
-          include: THEMES_DIR,
+          include: syspath.dirname(props.config.theme),
           exclude: NODE_MODS_DIR,
           use: {
             loader: 'babel-loader',

src/utils/config.js

@@ -28,7 +28,7 @@ const DEFAULT_CONFIG = {
   port: 8000,
   languages: ['bash', 'json'],
   header_links: [],
-  theme: 'default',
+  theme: '~default',
   breadcrumbs: true,
   prefix_titles: false,
   table_of_contents: {
@@ -65,6 +65,28 @@ function getExternalConfig (dir, name) {
   return file ? readConfigFile(file) : {}
 }
 
+function resolveThemeDirectory (config) {
+  const theme = config.theme
+  if (theme.indexOf('/') === 0) {
+    return theme
+  } else if (theme.indexOf('.') === 0) {
+    // local path
+    return syspath.resolve(
+      config.root,
+      theme
+    )
+  } else if (theme.indexOf('~') === 0) {
+    // gitdocs built-in theme
+    return syspath.resolve(
+      __dirname,
+      '../../themes',
+      theme.substr(1)
+    )
+  }
+  // package theme
+  return require.resolve(theme)
+}
+
 async function getConfig (customFile) {
   // prioritize custom config file if passed,
   // but still fallback to default files
@@ -94,6 +116,8 @@ async function getConfig (customFile) {
     masterConfig.static,
   )
 
+  masterConfig.theme = resolveThemeDirectory(masterConfig)
+
   return masterConfig
 }
 

themes/server.js

@@ -2,8 +2,7 @@ import React from 'react'
 import { StaticRouter } from 'react-router-dom'
 
 export default function (props, route) {
-  const { theme } = props.config
-  const { default: App } = require(`./${theme}/application`)
+  const App = require(`${props.config.theme}/application`).default
 
   return (
     <StaticRouter