新增教程章节

Author: kyour-cn

docs/.vitepress/config.js

@@ -1,17 +1,17 @@
 const base = process.env.BASE || '/'
-const nav = require('./configs/nav')
-const sidebar = require('./configs/sidebar')
+const nav = require('./nav')
+const sidebar = require('./sidebar')
 
 module.exports = {
-    title: 'PHP-Sword Doc',
+    title: 'PHP-Sword',
     description: '基于EasySwoole的PHP协程快速开发框架，让你更专注于业务代码的开发！',
     head: [
-        ['link', { rel: 'icon', type: 'image/svg+xml', href: '/logo.svg' }]
+        ['link', { rel: 'icon', type: 'image/svg+xml', href: '/ps-logo.png' }]
     ],
     base: base,
     themeConfig: {
         repo: 'php-sword/sword',
-        logo: '/logo.svg',
+        logo: '/ps-logo.png',
         docsDir: 'docs',
         docsBranch: 'master',
 

docs/.vitepress/configs/nav.js renamed to docs/.vitepress/nav.js

@@ -2,7 +2,7 @@
 module.exports = [
   { text: '文档', link: '/doc/' },
   { text: '组件', link: '/components/'},
-  // { text: 'API 参考', link: '/api/' },
+  { text: '教程', link: '/course/' },
   // {
   //   text: '外链地址',
   //   link:

docs/.vitepress/configs/sidebar.js renamed to docs/.vitepress/sidebar.js

@@ -42,11 +42,40 @@ const sidebar = {
                 }
             ]
         }
+    ],
+    'course': [
+        {
+            text: '基础教程',
+            children: [
+                {
+                    text: '教程导读',
+                    link: '/course/index'
+                },
+                {
+                    text: '实践开始',
+                    children: [
+                        {
+                            text: '准备工作',
+                            link: '/course/practice/ready'
+                        },
+                        {
+                            text: '创建HTTP服务器',
+                            link: '/course/practice/create'
+                        }
+                    ]
+                },
+                {
+                    text: 'Swoole',
+                    link: '/course/swoole'
+                }
+            ]
+        }
     ]
 }
 
 module.exports = {
     ['/doc/']: sidebar['doc'],
     ['/components/']: sidebar['components'],
-    // [getPath('/api/')]: 'auto'
+    ['/course/']: sidebar['course'],
+    // ['/api/]: 'auto'
 }

docs/course/index.md

@@ -0,0 +1,27 @@
+## 教程导读
+
+> 想要用好swoole框架并不是没门槛的，你只是需要知道一下几点：
+
+- 什么是php-fpm？
+- 什么Swoole？
+- 它们有什么不同？
+
+> 通过什么方式学习？
+
+如果你在初次接触Swoole的话，从官网文档去学习会感到一头雾水。
+
+而我一直以来的学习方式都是`先动手`，而不是先去学习那些原理、理论知识。
+
+因为这会让你失去进行下去的信心，也会击垮你的自信，`实践`才是检验真理的唯一标准。
+
+### 实践开始
+
+> 为了降低Swoole框架使用门槛，我将以此项目为例展示如何去快速搭建起你的项目,
+>
+> 学习过程中会一步一步的为大家答疑解惑。
+
+- [准备工作](/course/practice/ready)
+- [创建一个新的项目](/course/swoole)
+- [启动Http服务器(网站)](/course/swoole)
+- [静态资源访问](/course/swoole)
+- [Session](/course/swoole)

docs/course/practice/create.md

@@ -0,0 +1 @@
+## 擦胡歌那就

docs/course/practice/env-php.md

@@ -0,0 +1,5 @@
+## PHP安装
+
+这里主要介绍如何在你的Linux系统安装PHP环境
+
+## 扩展安装

docs/course/practice/ready.md

@@ -0,0 +1,21 @@
+
+## 运行环境
+> 您需要具备一些基础条件才能运行
+
+#### Linux操作系统
+Swoole需要在Linux系统中运行，
+你可以准备一台Linux服务器，或者通过虚拟机(具体方法百度)、Docker容器模拟Linux环境。
+
+> 在 Windows 平台，也可使用 WSL(Windows Subsystem for Linux) 或 CygWin，这里不再单独说明
+
+#### 安装PHP 7.4 (不再推荐老版本安装)
+
+[参考PHP安装章节](/course/practice/env-php)
+
+#### 安装Swoole扩展
+
+[参考Swoole扩展安装章节](/course/practice/env-php)
+
+#### 安装Nginx服务器(可选)
+
+[参考Nginx安装章节](/course/practice/env-php)

docs/course/swoole.md

@@ -0,0 +1,3 @@
+## 什么是swoole
+
+swoole、、、

docs/index.md

@@ -1,6 +1,6 @@
 ---
 home: true
-heroImage: /logo.svg
+heroImage: /ps-logo.png
 actionText: 开始使用
 actionLink: /doc/