feat: support generate uuid

Author: MuYunyun

README.md

@@ -1,3 +1,6 @@
+<!--
+abbrlink: s31w9gd1
+-->
                                                      _.-"\
                                                 _.-"      \
                                               ,-"          \

docs/主题/默认主题.md

@@ -1,3 +1,7 @@
+<!--
+abbrlink: 85li8wdd
+-->
+
 ## 默认主题
 
 create-react-doc 的默认主题为 [crd-seed](https://github.com/MuYunyun/create-react-doc/tree/main/packages/crd-seed)。该主题有以下特性:

docs/书写组件.md

@@ -1,3 +1,7 @@
+<!--
+abbrlink: lx1euo1b
+-->
+
 import { Button } from '../components/index.jsx'
 
 ## 书写组件

docs/其它工具.md

@@ -1,3 +1,7 @@
+<!--
+abbrlink: 292h2c5k
+-->
+
 ## 其它工具
 
 ### crd-leetcode-cli

docs/更新日志.md

@@ -1,3 +1,7 @@
+<!--
+abbrlink: 179nqpxt
+-->
+
 # CHANGELOG
 
 `create-react-doc` 严格遵循 [Semantic Versioning 2.0.0](http://semver.org/lang/zh-CN/) 语义化版本规范。

docs/站点发布.md

@@ -1,3 +1,7 @@
+<!--
+abbrlink: ude9296y
+-->
+
 ## 站点发布
 
 在 [快速上手](http://muyunyun.cn/create-react-doc/%E5%BF%AB%E9%80%9F%E4%B8%8A%E6%89%8B) 一节中介绍了如何快速搭建站点, 本节将介绍如何将搭建好的站点打包、发布到 gh-pages。

docs/高阶用法.md

@@ -1,3 +1,7 @@
+<!--
+abbrlink: 9v9ug9h8
+-->
+
 ## 高阶用法
 
 与 git 文件结构类似, 如果在展示的文件夹中有私有文件不方便展示在文档站点, 可以在 `.gitignore` 文件中设置过滤文件, 这样它们就不会展示在文档站点中了。eg: [.gitignore](https://github.com/MuYunyun/blog/blob/main/.gitignore)

packages/crd-scripts/src/conf/node-directory-tree.js

@@ -3,7 +3,7 @@ const fs = require('fs')
 const PATH = require('path')
 const YAML = require('yamljs')
 const { execSync } = require('child_process')
-const { replaceFileContent, generateRandomId } = require('crd-utils')
+const { replaceForFrontMatter, generateRandomId } = require('crd-utils')
 const { getDigitFromDir, timeFormat } = require('../utils')
 
 const constants = {
@@ -79,13 +79,20 @@ function directoryTree({
       if (!contentStr) return
       const contentMatch = contentStr.match(/^<!--([^>]*)-->/)
       if (options.generate) {
+        const randomId = generateRandomId(8)
         if (!contentMatch) {
-
+          replaceForFrontMatter({
+            path,
+            target: `<!--\nabbrlink: ${randomId}\n-->\n`
+          })
         }
         if (contentMatch && contentMatch[1].indexOf('abbrlink') === -1) {
-          const randomId = generateRandomId(8)
-          replaceFileContent(path, contentMatch[1], `\nabbrlink: ${randomId}${contentMatch[1]}`)
-          console.log('✅ replaceFileContent success')
+          replaceForFrontMatter({
+            path,
+            source: contentMatch[1],
+            target: `\nabbrlink: ${randomId}${contentMatch[1]}`
+          })
+          console.log('✅ replaceForFrontMatter success')
         }
       }
 

packages/crd-utils/index.js

@@ -16,14 +16,26 @@ const getDocsConfig = () => {
   return yaml.safeLoad(fs.readFileSync(docsConfig))
 }
 
-const replaceFileContent = (path, source, target) => {
+/**
+ * replace file content for Front-matter
+ * path: file path
+ * source?: source content
+ * target: target content
+ */
+const replaceForFrontMatter = ({
+  path,
+  source,
+  target
+}) => {
   fs.readFile(path, (err, data) => {
     if (err) {
       console.log(`❎ readFileContent error in ${path}`)
       return
     }
     console.log(`✅ readFileContent success in ${path}`)
-    const replaceResult = data.toString().replace(source, target)
+    const replaceResult = source
+      ? data.toString().replace(source, target)
+      : `${target}\n${data.toString()}`
     fs.writeFile(path, replaceResult, (err) => {
       if (err) {
         console.log(`❎ writeFileContent error in ${path}`)
@@ -34,10 +46,6 @@ const replaceFileContent = (path, source, target) => {
   })
 }
 
-const insertFrontMatter = () => {
-  // todo...
-}
-
 // generate a random string, length of it is n.
 const generateRandomId = (n) => {
   const str = ['0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z']
@@ -53,7 +61,7 @@ module.exports = {
   resolveApp,
   resolveTool,
   getDocsConfig,
-  replaceFileContent,
+  replaceForFrontMatter,
   generateRandomId,
   // common paths
   docsGitIgnore: resolveApp('.gitignore'),