{"id":6097,"date":"2024-06-03T11:43:16","date_gmt":"2024-06-03T03:43:16","guid":{"rendered":"https:\/\/t.n-years.com\/?p=6097"},"modified":"2024-06-03T11:43:17","modified_gmt":"2024-06-03T03:43:17","slug":"docusaurus-%e6%a1%86%e6%9e%b6%e4%b8%ad%e7%9a%84%e5%87%a0%e4%b8%aa%e5%85%b3%e9%94%ae%e6%a6%82%e5%bf%b5","status":"publish","type":"post","link":"https:\/\/t.n-years.com\/?p=6097","title":{"rendered":"docusaurus \u6846\u67b6\u4e2d\u7684\u51e0\u4e2a\u5173\u952e\u6982\u5ff5"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Docusaurus \u662f\u4e00\u4e2a\u7528\u4e8e\u6784\u5efa\u3001\u90e8\u7f72\u548c\u7ef4\u62a4\u5f00\u6e90\u9879\u76ee\u6587\u6863\u7684\u7f51\u7ad9\u6846\u67b6\uff0c\u57fa\u4e8e React \u548c Markdown\u3002\u5b83\u65e8\u5728\u5e2e\u52a9\u5f00\u53d1\u8005\u5feb\u901f\u521b\u5efa\u6f02\u4eae\u7684\u6587\u6863\u7f51\u7ad9\u3002\u4ee5\u4e0b\u662f Docusaurus \u6846\u67b6\u4e2d\u7684\u51e0\u4e2a\u5173\u952e\u6982\u5ff5\uff1a<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">1. <strong>Docs\uff08\u6587\u6863\uff09<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>\u6982\u8ff0<\/strong>\uff1a\u6587\u6863\u662f Docusaurus \u7f51\u7ad9\u7684\u6838\u5fc3\u90e8\u5206\uff0c\u4e3b\u8981\u7528\u4e8e\u5c55\u793a\u9879\u76ee\u7684\u6587\u6863\u5185\u5bb9\u3002<\/li>\n\n\n\n<li><strong>\u7ed3\u6784<\/strong>\uff1a\u6587\u6863\u901a\u5e38\u4ee5 Markdown \u6587\u4ef6\u7684\u5f62\u5f0f\u7ec4\u7ec7\uff0c\u5e76\u653e\u7f6e\u5728 <code>docs<\/code> \u76ee\u5f55\u4e2d\u3002\u53ef\u4ee5\u901a\u8fc7\u76ee\u5f55\u548c\u6587\u4ef6\u7684\u5c42\u6b21\u7ed3\u6784\u6765\u7ec4\u7ec7\u5185\u5bb9\u3002<\/li>\n\n\n\n<li><strong>\u5bfc\u822a<\/strong>\uff1aDocusaurus \u81ea\u52a8\u751f\u6210\u4fa7\u8fb9\u680f\u5bfc\u822a\uff0c\u5e2e\u52a9\u7528\u6237\u6d4f\u89c8\u6587\u6863\u3002\u4fa7\u8fb9\u680f\u914d\u7f6e\u5728 <code>sidebars.js<\/code> \u6587\u4ef6\u4e2d\u3002<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">2. <strong>Blog\uff08\u535a\u5ba2\uff09<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>\u6982\u8ff0<\/strong>\uff1aDocusaurus \u63d0\u4f9b\u4e86\u535a\u5ba2\u529f\u80fd\uff0c\u5141\u8bb8\u9879\u76ee\u7ef4\u62a4\u8005\u53d1\u5e03\u66f4\u65b0\u3001\u516c\u544a\u548c\u6280\u672f\u6587\u7ae0\u3002<\/li>\n\n\n\n<li><strong>\u7ed3\u6784<\/strong>\uff1a\u535a\u5ba2\u6587\u7ae0\u901a\u5e38\u5b58\u50a8\u5728 <code>blog<\/code> \u76ee\u5f55\u4e2d\uff0c\u4ee5 Markdown \u6587\u4ef6\u7684\u5f62\u5f0f\u5b58\u5728\u3002\u6587\u4ef6\u540d\u53ef\u4ee5\u5305\u542b\u65e5\u671f\uff0c\u4ee5\u4fbf\u4e8e\u6392\u5e8f\u548c\u7ec4\u7ec7\u3002<\/li>\n\n\n\n<li><strong>\u529f\u80fd<\/strong>\uff1aDocusaurus \u7684\u535a\u5ba2\u652f\u6301\u6807\u7b7e\u3001\u5206\u9875\u3001\u5f52\u6863\u7b49\u529f\u80fd\uff0c\u5e2e\u52a9\u7528\u6237\u66f4\u597d\u5730\u7ba1\u7406\u548c\u6d4f\u89c8\u535a\u5ba2\u5185\u5bb9\u3002<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">3. <strong>Pages\uff08\u9875\u9762\uff09<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>\u6982\u8ff0<\/strong>\uff1a\u9875\u9762\u662f\u6307\u7f51\u7ad9\u7684\u72ec\u7acb\u9875\u9762\uff0c\u901a\u5e38\u7528\u4e8e\u6587\u6863\u548c\u535a\u5ba2\u4e4b\u5916\u7684\u5185\u5bb9\uff0c\u6bd4\u5982\u81ea\u5b9a\u4e49\u7684 About\u3001Contact \u9875\u9762\u3002<\/li>\n\n\n\n<li><strong>\u7ed3\u6784<\/strong>\uff1a\u9875\u9762\u6587\u4ef6\u653e\u7f6e\u5728 <code>src\/pages<\/code> \u76ee\u5f55\u4e2d\uff0c\u652f\u6301\u4f7f\u7528 Markdown \u6216 React \u7ec4\u4ef6\u521b\u5efa\u9875\u9762\u3002<\/li>\n\n\n\n<li><strong>\u8def\u7531<\/strong>\uff1a\u9875\u9762\u7684 URL \u8def\u5f84\u7531\u6587\u4ef6\u540d\u51b3\u5b9a\uff0c\u4f8b\u5982 <code>src\/pages\/about.js<\/code> \u5bf9\u5e94 <code>\/about<\/code> \u8def\u7531\u3002<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">4. <strong>Theme\uff08\u4e3b\u9898\uff09<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>\u6982\u8ff0<\/strong>\uff1a\u4e3b\u9898\u51b3\u5b9a\u4e86 Docusaurus \u7f51\u7ad9\u7684\u5916\u89c2\u548c\u98ce\u683c\u3002\u9ed8\u8ba4\u4e3b\u9898\u63d0\u4f9b\u4e86\u5e38\u89c1\u7684\u5e03\u5c40\u548c\u6837\u5f0f\uff0c\u4f46\u4e5f\u53ef\u4ee5\u81ea\u5b9a\u4e49\u6216\u521b\u5efa\u81ea\u5df1\u7684\u4e3b\u9898\u3002<\/li>\n\n\n\n<li><strong>\u81ea\u5b9a\u4e49<\/strong>\uff1a\u53ef\u4ee5\u901a\u8fc7\u4fee\u6539\u4e3b\u9898\u7ec4\u4ef6\u3001CSS \u6587\u4ef6\u548c\u914d\u7f6e\u6587\u4ef6\u6765\u81ea\u5b9a\u4e49\u4e3b\u9898\u3002Docusaurus \u4f7f\u7528 CSS-in-JS \u89e3\u51b3\u65b9\u6848\uff08\u5982 Infima \u548c Tailwind CSS\uff09\uff0c\u5e76\u652f\u6301\u4e3b\u9898\u7684\u6269\u5c55\u548c\u8986\u76d6\u3002<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">5. <strong>Plugin\uff08\u63d2\u4ef6\uff09<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>\u6982\u8ff0<\/strong>\uff1a\u63d2\u4ef6\u7528\u4e8e\u6269\u5c55 Docusaurus \u7684\u529f\u80fd\uff0c\u6bd4\u5982\u589e\u52a0\u65b0\u7684\u5185\u5bb9\u7c7b\u578b\u3001\u6570\u636e\u6e90\u6216\u96c6\u6210\u5916\u90e8\u670d\u52a1\u3002<\/li>\n\n\n\n<li><strong>\u5185\u7f6e\u63d2\u4ef6<\/strong>\uff1aDocusaurus \u63d0\u4f9b\u4e86\u591a\u79cd\u5185\u7f6e\u63d2\u4ef6\uff0c\u5982\u6587\u6863\u63d2\u4ef6\u3001\u535a\u5ba2\u63d2\u4ef6\u3001Google Analytics \u63d2\u4ef6\u7b49\u3002<\/li>\n\n\n\n<li><strong>\u81ea\u5b9a\u4e49\u63d2\u4ef6<\/strong>\uff1a\u5f00\u53d1\u8005\u53ef\u4ee5\u521b\u5efa\u81ea\u5df1\u7684\u63d2\u4ef6\uff0c\u901a\u8fc7 JavaScript \u7f16\u5199\u81ea\u5b9a\u4e49\u903b\u8f91\uff0c\u589e\u5f3a\u7f51\u7ad9\u529f\u80fd\u3002<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">6. <strong>Config\uff08\u914d\u7f6e\uff09<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>\u6982\u8ff0<\/strong>\uff1aDocusaurus \u7684\u914d\u7f6e\u6587\u4ef6\u662f <code>docusaurus.config.js<\/code>\uff0c\u7528\u4e8e\u5b9a\u4e49\u7f51\u7ad9\u7684\u57fa\u672c\u8bbe\u7f6e\u548c\u884c\u4e3a\u3002<\/li>\n\n\n\n<li><strong>\u5185\u5bb9<\/strong>\uff1a\u914d\u7f6e\u6587\u4ef6\u5305\u62ec\u7f51\u7ad9\u6807\u9898\u3001URL\u3001\u4e3b\u9898\u3001\u63d2\u4ef6\u3001\u5bfc\u822a\u680f\u3001\u9875\u811a\u7b49\u8bbe\u7f6e\u3002\u901a\u8fc7\u4fee\u6539\u914d\u7f6e\u6587\u4ef6\uff0c\u53ef\u4ee5\u8f7b\u677e\u8c03\u6574\u7f51\u7ad9\u7684\u5404\u9879\u53c2\u6570\u3002<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">7. <strong>Sidebar\uff08\u4fa7\u8fb9\u680f\uff09<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>\u6982\u8ff0<\/strong>\uff1a\u4fa7\u8fb9\u680f\u662f\u6587\u6863\u90e8\u5206\u7684\u5bfc\u822a\u83dc\u5355\uff0c\u5e2e\u52a9\u7528\u6237\u5feb\u901f\u627e\u5230\u6240\u9700\u5185\u5bb9\u3002<\/li>\n\n\n\n<li><strong>\u914d\u7f6e<\/strong>\uff1a\u4fa7\u8fb9\u680f\u7684\u914d\u7f6e\u5728 <code>sidebars.js<\/code> \u6587\u4ef6\u4e2d\uff0c\u53ef\u4ee5\u5b9a\u4e49\u6587\u6863\u7684\u5c42\u6b21\u7ed3\u6784\u3001\u5206\u7ec4\u548c\u663e\u793a\u987a\u5e8f\u3002<\/li>\n\n\n\n<li><strong>\u529f\u80fd<\/strong>\uff1a\u4fa7\u8fb9\u680f\u652f\u6301\u591a\u7ea7\u76ee\u5f55\u3001\u5206\u7ec4\u6807\u9898\u548c\u6298\u53e0\u529f\u80fd\uff0c\u63d0\u5347\u7528\u6237\u6d4f\u89c8\u6587\u6863\u7684\u4f53\u9a8c\u3002<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">8. <strong>Localization\uff08\u672c\u5730\u5316\uff09<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>\u6982\u8ff0<\/strong>\uff1aDocusaurus \u652f\u6301\u591a\u8bed\u8a00\u7ad9\u70b9\uff0c\u5141\u8bb8\u7528\u6237\u4e3a\u4e0d\u540c\u7684\u8bed\u8a00\u521b\u5efa\u72ec\u7acb\u7684\u6587\u6863\u7248\u672c\u3002<\/li>\n\n\n\n<li><strong>\u5b9e\u73b0<\/strong>\uff1a\u672c\u5730\u5316\u901a\u8fc7 <code>i18n<\/code> \u76ee\u5f55\u548c\u7ffb\u8bd1 JSON \u6587\u4ef6\u5b9e\u73b0\u3002\u53ef\u4ee5\u4e3a\u6bcf\u79cd\u8bed\u8a00\u521b\u5efa\u72ec\u7acb\u7684\u6587\u6863\u3001\u9875\u9762\u548c\u7ffb\u8bd1\u6587\u4ef6\u3002<\/li>\n\n\n\n<li><strong>\u914d\u7f6e<\/strong>\uff1a\u5728 <code>docusaurus.config.js<\/code> \u4e2d\u914d\u7f6e\u8bed\u8a00\u9009\u9879\uff0c\u5e76\u4e3a\u4e0d\u540c\u8bed\u8a00\u5b9a\u4e49\u8def\u5f84\u548c\u7ffb\u8bd1\u6587\u4ef6\u3002<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">9. <strong>Versioning\uff08\u7248\u672c\u7ba1\u7406\uff09<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>\u6982\u8ff0<\/strong>\uff1aDocusaurus \u652f\u6301\u6587\u6863\u7248\u672c\u7ba1\u7406\uff0c\u5141\u8bb8\u9879\u76ee\u7ef4\u62a4\u8005\u4e3a\u4e0d\u540c\u7248\u672c\u7684\u9879\u76ee\u63d0\u4f9b\u5bf9\u5e94\u7684\u6587\u6863\u3002<\/li>\n\n\n\n<li><strong>\u5b9e\u73b0<\/strong>\uff1a\u901a\u8fc7\u547d\u4ee4 <code>docusaurus docs:version<\/code> \u521b\u5efa\u6587\u6863\u7248\u672c\u3002\u7248\u672c\u5316\u7684\u6587\u6863\u5b58\u50a8\u5728 <code>versioned_docs<\/code> \u76ee\u5f55\u4e2d\u3002<\/li>\n\n\n\n<li><strong>\u914d\u7f6e<\/strong>\uff1a\u7248\u672c\u4fe1\u606f\u5b58\u50a8\u5728 <code>versions.json<\/code> \u6587\u4ef6\u4e2d\uff0c\u53ef\u4ee5\u5728 <code>docusaurus.config.js<\/code> \u4e2d\u914d\u7f6e\u7248\u672c\u83dc\u5355\u548c\u9ed8\u8ba4\u7248\u672c\u3002<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\u8fd9\u4e9b\u5173\u952e\u6982\u5ff5\u6784\u6210\u4e86 Docusaurus \u7684\u6838\u5fc3\u529f\u80fd\uff0c\u4f7f\u5176\u6210\u4e3a\u4e00\u4e2a\u529f\u80fd\u5f3a\u5927\u4e14\u6613\u4e8e\u4f7f\u7528\u7684\u6587\u6863\u7f51\u7ad9\u751f\u6210\u5668\u3002\u901a\u8fc7\u7406\u89e3\u548c\u8fd0\u7528\u8fd9\u4e9b\u6982\u5ff5\uff0c\u5f00\u53d1\u8005\u53ef\u4ee5\u5feb\u901f\u642d\u5efa\u548c\u7ef4\u62a4\u9ad8\u8d28\u91cf\u7684\u6587\u6863\u7f51\u7ad9\u3002<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Docusaurus \u662f\u4e00\u4e2a\u7528\u4e8e\u6784\u5efa\u3001\u90e8\u7f72\u548c\u7ef4\u62a4\u5f00\u6e90\u9879\u76ee\u6587\u6863\u7684\u7f51\u7ad9\u6846\u67b6\uff0c\u57fa\u4e8e React \u548c Markdown&#8230; <\/p>\n<div class=\"read-more navbutton\"><a href=\"https:\/\/t.n-years.com\/?p=6097\">\u9605\u8bfb\u66f4\u591a<i class=\"fa fa-angle-double-right\"><\/i><\/a><\/div>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[5],"tags":[],"class_list":["post-6097","post","type-post","status-publish","format-standard","hentry","category-5"],"_links":{"self":[{"href":"https:\/\/t.n-years.com\/index.php?rest_route=\/wp\/v2\/posts\/6097","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/t.n-years.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/t.n-years.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/t.n-years.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/t.n-years.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=6097"}],"version-history":[{"count":1,"href":"https:\/\/t.n-years.com\/index.php?rest_route=\/wp\/v2\/posts\/6097\/revisions"}],"predecessor-version":[{"id":6098,"href":"https:\/\/t.n-years.com\/index.php?rest_route=\/wp\/v2\/posts\/6097\/revisions\/6098"}],"wp:attachment":[{"href":"https:\/\/t.n-years.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=6097"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/t.n-years.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=6097"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/t.n-years.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=6097"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}