config.js修改

README.md

@@ -84,7 +84,8 @@
 	![gitlink logo](/img/gitlink_logo.png)
 
 	```
-
+	初始化项目
+	node v20.x  npm install --force
 	## 	前端build成中文 （i18n中可编辑对应中文内容）
     ```
 	npm run build -- --locale zh-CN

docusaurus.config.js

@@ -1,6 +1,9 @@
 const lightCodeTheme = require('prism-react-renderer/themes/github');
 const darkCodeTheme = require('prism-react-renderer/themes/dracula');
-// import("@easyops-cn/docusaurus-search-local").PluginOptions;
+//Docusaurus v3写法
+// const { themes } = require('prism-react-renderer');
+// import { themes } from 'prism-react-renderer';
+import("@easyops-cn/docusaurus-search-local").PluginOptions;
 
 /** @type {import('@docusaurus/types').DocusaurusConfig} */
 module.exports = {
@@ -8,28 +11,27 @@ module.exports = {
   tagline:'gitlink帮助中心',
   url: 'https://help.gitlink.org.cn/',
   baseUrl: '/',
-  onBrokenLinks: 'ignore',
-  onBrokenMarkdownLinks: 'ignore',
+  onBrokenLinks: 'warn',
+  onBrokenMarkdownLinks: 'warn',
   favicon: 'img/icon.ico',
   organizationName: 'luffyZh', // Usually your GitHub org/user name.
   projectName: 'docusaurus-luffyzh-website', // Usually your repo name.
   scripts: [],
   // stylesheets: ['styles/dark-mode.css'],
   themeConfig: {
-    
     docs:{
       sidebar:{
         hideable:true,
       },
    },
     metadata:[
-      {name:"Keywords",content:"学位论文算法,帮助中心"},
+      {name:"Keywords",content:"Gitlink,forgeplus,GitLink,gitLink,GitLink,gitlink,帮助中心"},
       {name:"hostname",content:"gitlink.org.cn"},
-      {property:"og:site_name",content:"学位论文算法"},
-      {property:"og:image:alt",content:"学位论文算法"}
+      {property:"og:site_name",content:"GitLink"},
+      {property:"og:image:alt",content:"GitLink（确实开源）是中国计算机学会CCF官方指定的开源创新服务平台 - Gitlink/forgeplus：GitLink（确实开源）是中国计算机学会CCF官方指定的开源创新服务平台 for gitlink Gitlink/forgeplus for git"}
     ],
     prism: {
-      theme: lightCodeTheme,
+      theme:lightCodeTheme,
       darkTheme: darkCodeTheme,
     },
     zoom: {
@@ -53,9 +55,9 @@ module.exports = {
       logo: {
         // width: '32px',
         // height: '32px',
-        alt: '学位论文',
-        src: 'img/xuewei.png',
-        href:"/"
+        alt: 'gitlink',
+        src: 'img/gitlink.png',
+        href:"https://www.gitlink.org.cn/"
         // srcDark: 'img/logo-dark.png',
       },
       items: [
@@ -71,6 +73,26 @@ module.exports = {
           dropdownActiveClassDisabled: true
         },
         // {
+        //   type: 'localeDropdown',
+        //   position: 'right',
+        // },
+        // {
+          // position: 'right',
+          // component:'./src/components/LanguageSwitcher',
+          // label:"language",
+          // to:"#"
+          // items: [
+          //   {
+          //     label: 'English',
+          //     onClick: () => handleLocaleChange('en')
+          //   },
+          //   {
+          //     label: '简体中文',
+          //     onClick: () => handleLocaleChange('zh-Hans')
+          //   }
+          // ]
+        // }
+        // {
         //   href: 'https://github.com/boxyhq',
         //   position: 'right',
         //   className: 'header-github-link',
@@ -78,23 +100,72 @@ module.exports = {
       ],
     },
     footer: {
-      // style: 'dark',
-      // logo:{
-      //   src:"img/gitlink.png"
-      // },
-      // links: [
-      //   {
-      //     title: '关于我们',
-      //     items: [
-      //       {
-      //         label: '根据《“学位论文算法数据库”建设试点方案》及有关要求,计算机学院对第一阶段的数据类型、上传流程及数据描述等进行梳理，明确支持上传的数据类型主要包括代码、数据集、说明文档等，博士研究生应根据具体类型，完成相关数据整理和上传。',
-      //         to:""
-      //       }
-      //     ],
-      //   }
-      // ],
-      // copyright: `<p>©Copyright ${new Date().getFullYear()} CCF 开源发展委员会</p><p>Powered by Trustie& IntelliDE 京ICP备13000930号</p>`,
-      copyright: `<img src="/img/xuewei.png" /><div class="text"><p>关于我们</p><p>根据《“学位论文算法数据库”建设试点方案》及有关要求,计算机学院对第一阶段的数据类型、上传流程及数据描述等进行梳理，明确支持上传的数据类型主要包括代码、数据集、说明文档等，博士研究生应根据具体类型，完成相关数据整理和上传。</p><p style="margin-top:20px">工具下载</p><p><a>git32位安装下载</a><a>git64位安装下载</a></p></div>`,
+      style: 'dark',
+      logo:{
+        src:"img/gitlink.png"
+      },
+      links: [
+        {
+          title: '社区',
+          items: [
+            {
+              label: '网站首页',
+              to: 'https://www.gitlink.org.cn',
+            },
+            {
+              label: '关于我们',
+              to: 'https://www.gitlink.org.cn/aboutus',
+            },
+            {
+              label: '教学实践',
+              to: 'https://www.gitlink.org.cn/educoder',
+            },
+            {
+              label: '合作伙伴',
+              to: 'https://forum.trustie.net/forums/5030/detail',
+            },
+          ],
+        },
+        {
+          title: '支持与服务',
+          items: [
+            {
+              label: 'API文档',
+              to: 'https://forgeplus.trustie.net/docs/api',
+            },
+            {
+              label: 'Git常用命令',
+              to: 'https://git-scm.com',
+            },
+            {
+              label: '引擎使用手册',
+              to: 'https://forum.gitlink.org.cn/forums/7487/detail',
+            },
+            {
+              label: '服务协议',
+              to: 'https://forum.trustie.net/forums/5029/detail',
+            },
+          ],
+        },
+        {
+          title: '加入我们',
+          items: [
+            {
+              label: '官网邮箱：gitlink@ccf.org.cn',
+              to:"https://www.gitlink.org.cn"
+            },
+            {
+              label:'QQ群',
+              to:'https://www.gitlink.org.cn'
+            },
+            {
+              label:'公众号',
+              to:'https://www.gitlink.org.cn'
+            }
+          ],
+        },
+      ],
+      copyright: `<p>©Copyright ${new Date().getFullYear()} CCF 开源发展委员会</p><p>Powered by Trustie& IntelliDE 京ICP备13000930号</p>`,
     },
   },
   presets: [
@@ -114,25 +185,35 @@ module.exports = {
   ],
   themes: [
     // ... Your other themes.
-    // [
-    //   require.resolve("@easyops-cn/docusaurus-search-local"),
-    //   {
-    //     // ... Your options.
-    //     // `hashed` is recommended as long-term-cache of index file is possible.
-    //     hashed: true,
-    //     language: ["en", "zh"],
-    //     highlightSearchTermsOnTargetPage: true,
-    //     blogRouteBasePath: "/", 
-    //     explicitSearchResultPath: true,
-    //     // For Docs using Chinese, The `language` is recommended to set to:
-    //     // ```
-    //     // language: ["en", "zh"],
-    //     // ```
-    //   },
-    // ],
+    [
+      require.resolve("@easyops-cn/docusaurus-search-local"),
+      {
+        // ... Your options.
+        // `hashed` is recommended as long-term-cache of index file is possible.
+        hashed: true,
+        language: ["en", "zh"],
+        highlightSearchTermsOnTargetPage: true,
+        blogRouteBasePath: "/", 
+        explicitSearchResultPath: true,
+        // For Docs using Chinese, The `language` is recommended to set to:
+        // ```
+        // language: ["en", "zh"],
+        // ```
+      },
+    ],
   ],
   i18n: {
     defaultLocale: 'zh-cn',
-    locales: ['zh-cn'],
+    locales: ['zh-cn','en'],
+    localeConfigs: {
+      en: {
+        label: 'English',
+        htmlLang: 'en',
+      },
+      'zh-cn': {
+        label: '简体中文',
+        htmlLang: 'zh-CN',
+      },
+    },
   },
 };

oauth2.md

@@ -0,0 +1,47 @@
+为了构建更好的平台生态环境，我们推出了基于OAuth2的API版本。
+API 接口使用方式以及Url都参照GitHub，为了各位开发者更好的兼容已经存在的第三方应用。
+
+# API 使用条款
+
+未经用户允许，不准爬取或存储用户的资源。
+禁止滥用 API，请求频率过快将导致请求终止。
+OAuth2 认证基本流程
+![image](./oauth2.png)
+
+# OAuth2 获取 AccessToken 认证步骤
+
+### 1. 授权码模式
+* 应用通过 浏览器 或 Webview 将用户引导到平台三方认证页面上（ GET请求 ）
+
+    `https://gitlink.org.cn/oauth/authorize?client_id={client_id}&redirect_uri={redirect_uri}&response_type=code`
+
+* 用户对应用进行授权
+注意: 如果之前已经授权过的需要跳过授权页面，需要在上面第一步的 URL 加上 scope 参数，且 scope 的值需要和用户上次授权的勾选的一致。如用户在上次授权了user_info。则步骤A 中 GET 请求应为：
+
+    `https://gitlink.org.cn/oauth/authorize?client_id={client_id}&redirect_uri={redirect_uri}&response_type=code&scope=user_info`
+
+* 平台认证服务器通过回调地址`{redirect_uri}`将 用户授权码 传递给 应用服务器 或者直接在 Webview 中跳转到携带 用户授权码的回调地址上，Webview 直接获取code即可（`{redirect_uri}?code=abc&state=xyz`)
+* 应用服务器 或 Webview 使用 access_token API 向平台认证服务器发送post请求传入 用户授权码 以及 回调地址（ POST请求 ）
+注：请求过程建议将 client_secret 放在 Body 中传值，以保证数据安全。
+
+    `https://gitlink.org.cn/oauth/token?grant_type=authorization_code&code={code}&client_id={client_id}&redirect_uri={redirect_uri}&client_secret={client_secret}`
+
+* 平台认证服务器返回 access_token
+    
+    应用通过 access_token 访问 Open API 使用用户数据。
+    当 access_token 过期后（有效期为一天），你可以通过以下 refresh_token 方式重新获取 access_token（ POST请求 ）
+    
+    `https://gitlink.org.cn/oauth/token?grant_type=refresh_token&refresh_token={refresh_token}`
+
+> 注意：如果获取 access_token 返回 403，可能是没有设置User-Agent的原因。
+详见：获取Token时服务端响应状态403是什么情况
+
+### 2. 密码模式
+* 用户向客户端提供邮箱地址和密码。客户端将邮箱地址和密码发给平台认证服务器，并向平台认证服务器请求令牌。（ POST请求。Content-Type: application/x-www-form-urlencoded ）
+
+    `curl -X POST --data-urlencode "grant_type=password" --data-urlencode "username={email}" --data-urlencode "password={password}" --data-urlencode "client_id={client_id}" --data-urlencode "client_secret={client_secret}" --data-urlencode "scope=user_info" https://gitlink.org.cn/oauth/token`
+
+    scope表示权限范围，有以下选项，请求时使用空格隔开
+    `user_info` `projects` `pull_requests` `issues` `notes` `keys` `hook groups` `gists` `enterprises`
+* 认证服务器返回 access_token
+应用通过 access_token 访问 Open API 使用用户数据。

package.json

@@ -1,6 +1,6 @@
 {
   "name": "docusaurus",
-  "version": "0.0.0",
+  "version": "3.0.0",
   "private": true,
   "scripts": {
     "docusaurus": "docusaurus",
@@ -15,17 +15,20 @@
   },
   "dependencies": {
     "@cmfcmf/docusaurus-search-local": "1.1.0",
-    "@docusaurus/core": "2.4.1",
-    "@docusaurus/plugin-client-redirects": "2.4.1",
-    "@docusaurus/preset-classic": "2.4.1",
-    "@easyops-cn/docusaurus-search-local": "^0.49.2",
-    "@mdx-js/react": "1.6.22",
+    "@docusaurus/core": "3.9.2",
+    "@docusaurus/plugin-client-redirects": "3.9.2",
+    "@docusaurus/preset-classic": "3.9.2",
+    "@easyops-cn/docusaurus-search-local": "^0.35.0",
+    "@mdx-js/react": "^3.1.1",
     "@node-rs/jieba": "^1.7.0",
     "clsx": "1.2.1",
     "docusaurus-gtm-plugin": "0.0.2",
     "docusaurus-plugin-image-zoom": "1.0.1",
-    "react": "17.0.2",
-    "react-dom": "17.0.2",
+    "or": "^0.2.0",
+    "prism-react-renderer": "^1.3.5",
+    "prismjs": "^1.30.0",
+    "react": "18.2.0",
+    "react-dom": "18.2.0",
     "react-modal": "3.16.1"
   },
   "browserslist": {
@@ -41,6 +44,6 @@
     ]
   },
   "engines": {
-    "node": ">=14.18.1 <=18.x"
+    "node": ">=18.x"
   }
 }

src/components/LanguageSwitcher.js

@@ -0,0 +1,38 @@
+// src/components/LanguageSwitcher.js
+import React from 'react';
+import { useDocusaurusContext } from '@docusaurus/useDocusaurusContext';
+
+export default function LanguageSwitcher() {
+  const { i18n } = useDocusaurusContext();
+
+  const locales = [
+    { code: 'en', label: 'English' },
+    { code: 'zh-Hans', label: '简体中文' }
+  ];
+
+  return (
+    <div style={{ marginRight: '1rem' }}>
+      <select
+        value={i18n.currentLocale}
+        onChange={(e) => {
+          localStorage.setItem('preferredLocale', e.target.value);
+          window.location.href = `/${e.target.value}/`;
+        }}
+        style={{
+          padding: '0.5rem 1rem',
+          border: '1px solid #ddd',
+          borderRadius: '4px',
+          backgroundColor: 'white',
+          fontSize: '0.9rem',
+          cursor: 'pointer',
+        }}
+      >
+        {locales.map((locale) => (
+          <option key={locale.code} value={locale.code}>
+            {locale.label}
+          </option>
+        ))}
+      </select>
+    </div>
+  );
+}

src/css/custom.css

@@ -48,16 +48,15 @@ html[data-theme='dark'] .docusaurus-highlight-code-line {
   background-color: #33416b;
 }
 .footer{
-  /* height:450px;
+  height:450px;
   position: relative;
-  background: #1e1e1e; */
+  background: #1e1e1e;
   padding:0px;
 }
 .container{
   height: 100%;
   display: flex;
   flex-direction: column;
-  justify-content: space-around;
 }
 .footer__bottom .margin-bottom--sm{
   position: absolute;
@@ -135,33 +134,12 @@ html[data-theme='dark'] .docusaurus-highlight-code-line {
   font-weight: 400;
   color: #bdc2d1;
   line-height: 28px;
+  padding: 15px 0;
   text-align: center;
   background-color: #1b212c;
-  padding:50px 0px;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  font-size: 17px;
 }
-.container .footer__copyright .text{
-  text-align: left;
-}
-.container .footer__copyright img{
-  width: 300px;
-}
-.container .footer__copyright .text p:nth-child(2n+1){
-  font-size: 22px;
-  margin-left: 50px;
-  margin-bottom: 10px!important;
-}
-.container .footer__copyright .text p{
+.container .footer__copyright p{
   margin-bottom: 0px!important;
-  max-width: 950px;
-  margin-left: 50px;
-}
-.container .footer__copyright .text p a{
-  color: #bdc2d1;
-  margin-right: 25px;
 }
 .aa-Form{
   width: unset;

versioned_docs/version-1.1.0/intro.md

@@ -69,6 +69,26 @@ GitLink（确实开源）是CCF官方指定的开源创新服务平台，旨在
      <h2 class="text--truncate cardTitle" title="第三方服务">第三方服务</h2>
 		<p>第三方服务使用及设置[3个文档]</p>
 	</a></article>
+      <article class="col col--6 margin-bottom--lg">
+    <a class="card padding--lg cardContainer" href="/通知/通知简介">
+     <h2 class="text--truncate cardTitle" title="通知">通知</h2>
+		<p>通知使用及设置[2个文档]</p>
+	</a></article>
+      <article class="col col--6 margin-bottom--lg">
+    <a class="card padding--lg cardContainer" href="/个人主页建站/站点创建流程">
+     <h2 class="text--truncate cardTitle" title="个人主页建站">个人主页建站</h2>
+		<p>个人主页建站使用及设置[2个文档]</p>
+	</a></article>
+      <article class="col col--6 margin-bottom--lg">
+    <a class="card padding--lg cardContainer" href="/平台公告/">
+     <h2 class="text--truncate cardTitle" title="平台公告">平台公告</h2>
+		<p>平台公告使用及设置</p>
+	</a></article>
+      <article class="col col--6 margin-bottom--lg">
+    <a class="card padding--lg cardContainer" href="/服务协议/GitLink服务协议">
+     <h2 class="text--truncate cardTitle" title="服务协议">服务协议</h2>
+		<p>服务协议使用及设置[1个文档]</p>
+	</a></article>
 </section>
 </div>
 </div>