Feat 사이드바,버저닝,검색 기능 추가

Author: coldplay126

docs/architecture/container.md

@@ -0,0 +1,55 @@
+---
+sidebar_position: 2
+---
+
+# 서비스 컨테이너 (12.x 버전)
+
+## 소개
+
+Laravel 12.x의 서비스 컨테이너는 클래스 의존성을 관리하는 강력한 도구입니다. 의존성 주입은 본질적으로 클래스 의존성이 생성자나 setter 메소드를 통해 "주입"되는 것을 의미합니다.
+
+:::note 버전 정보
+이 문서는 Laravel 12.x 버전에 대한 내용입니다.
+:::
+
+## 바인딩
+
+Laravel 12.x에서 서비스 컨테이너에 바인딩하는 방법에는 여러 가지가 있습니다.
+
+```php
+// 기본 바인딩
+$this->app->bind('HelpSpot\API', function ($app) {
+    return new \HelpSpot\API($app->make('HttpClient'));
+});
+
+// 싱글톤 바인딩
+$this->app->singleton('HelpSpot\API', function ($app) {
+    return new \HelpSpot\API($app->make('HttpClient'));
+});
+
+// 12.x에서 추가된 새로운 바인딩 방법
+$this->app->scoped('HelpSpot\API', function ($app) {
+    return new \HelpSpot\API($app->make('HttpClient'));
+});
+```
+
+## 의존성 해결
+
+```php
+// 12.x에서는 생성자 프로퍼티 프로모션 기능 지원
+public function __construct(
+    private readonly UserRepository $users,
+    private readonly Logger $logger,
+) {}
+```
+
+## 12.x에서의 변경 사항
+
+Laravel 12.x에서는 서비스 컨테이너에 다음과 같은 새로운 기능이 추가되었습니다:
+
+- 더 효율적인 의존성 해결 알고리즘
+- 개선된 컨테이너 이벤트 시스템
+- 타입 힌팅을 활용한 더 정확한 의존성 주입
+- 새로운 스코프드 서비스 등록 방식
+
+추후 더 자세한 내용이 추가될 예정입니다.

docs/architecture/lifecycle.md

@@ -0,0 +1,33 @@
+---
+sidebar_position: 1
+---
+
+# 요청 라이프사이클 (12.x 버전)
+
+## 소개
+
+Laravel 12.x 애플리케이션에서 HTTP 요청이 처리되는 과정을 이해하는 것은 중요합니다. 이 문서에서는 Laravel 12.x의 요청 라이프사이클에 대해 설명합니다.
+
+:::note 버전 정보
+이 문서는 Laravel 12.x 버전에 대한 내용입니다.
+:::
+
+## 라이프사이클 개요
+
+1. 모든 요청은 `public/index.php` 파일로 들어옵니다.
+2. 오토로더가 로드됩니다.
+3. 프레임워크의 인스턴스가 생성됩니다.
+4. 요청이 처리됩니다.
+5. 응답이 반환됩니다.
+
+## 12.x에서의 변경 사항
+
+Laravel 12.x에서는 라이프사이클 처리 과정이 완전히 재작성되어 더 빠르고 효율적인 처리가 가능해졌습니다. 주요 변경 사항은 다음과 같습니다:
+
+- 새로운 애플리케이션 부트스트랩 프로세스
+- 더 효율적인 서비스 컨테이너 처리
+- 개선된 예외 처리 메커니즘
+
+## 자세한 설명
+
+추후 더 자세한 내용이 추가될 예정입니다.

docs/basics/routing.md

@@ -0,0 +1,68 @@
+---
+sidebar_position: 1
+---
+
+# 라우팅 (12.x 버전)
+
+## 기본 라우팅
+
+:::note 버전 정보
+이 문서는 Laravel 12.x 버전에 대한 내용입니다.
+:::
+
+가장 기본적인 Laravel 12.x 라우트는 URI와 클로저를 허용하여 매우 간단한 방법으로 경로를 정의할 수 있습니다:
+
+```php
+Route::get('/greeting', function () {
+    return 'Hello World';
+});
+```
+
+## 사용 가능한 라우터 메소드
+
+Laravel 12.x 라우터는 다음 HTTP 메소드에 대응하는 라우트를 등록할 수 있습니다:
+
+```php
+Route::get($uri, $callback);
+Route::post($uri, $callback);
+Route::put($uri, $callback);
+Route::patch($uri, $callback);
+Route::delete($uri, $callback);
+Route::options($uri, $callback);
+```
+
+## 라우트 파라미터
+
+```php
+Route::get('/user/{id}', function ($id) {
+    return 'User '.$id;
+});
+```
+
+## 12.x에서의 변경 사항
+
+Laravel 12.x에서는 라우팅 시스템에 다음과 같은 새로운 기능이 추가되었습니다:
+
+### Folio 페이지 기반 라우팅
+
+Laravel 12.x에서는 파일 기반 라우팅을 위한 Folio 패키지가 기본으로 포함되어 있습니다:
+
+```php
+// resources/views/pages/about-us.blade.php 파일이 자동으로 /about-us 경로로 라우팅됩니다
+```
+
+### 개선된 라우트 그룹핑
+
+```php
+Route::prefix('admin')->middleware(['auth', 'admin'])->group(function () {
+    Route::get('/dashboard', function () {
+        // /admin/dashboard에 대한 처리
+    });
+
+    Route::get('/users', function () {
+        // /admin/users에 대한 처리
+    });
+});
+```
+
+추후 더 자세한 내용이 추가될 예정입니다.

docs/intro.md

@@ -2,23 +2,27 @@
 sidebar_position: 1
 ---
 
-# Laravel 소개
+# Laravel 소개 (12.x 버전)
 
 Laravel은 웹 애플리케이션 개발을 위한 접근성, 강력함, 그리고 유연성을 제공하는 웹 애플리케이션 프레임워크입니다. 우아한 문법을 가진 Laravel은 우리가 창의성을 표현하고 즐겁게 작업할 수 있도록 도와줍니다. 이것이 바로 Laravel의 철학입니다.
 
+:::note 버전 정보
+이 문서는 Laravel 12.x 버전에 대한 내용입니다.
+:::
+
 ## 시작하기
 
-Laravel 설치 및 기본 사용법에 대해 알아보세요.
+Laravel 12.x 설치 및 기본 사용법에 대해 알아보세요.
 
 ```bash
-composer create-project laravel/laravel example-app
+composer create-project laravel/laravel example-app "12.*"
 cd example-app
 php artisan serve
 ```
 
 ## 주요 기능
 
-Laravel은 다음과 같은 강력한 기능을 제공합니다:
+Laravel 12.x는 다음과 같은 강력한 기능을 제공합니다:
 
 - 강력한 라우팅 시스템
 - 블레이드 템플릿 엔진
@@ -28,6 +32,16 @@ Laravel은 다음과 같은 강력한 기능을 제공합니다:
 - 이벤트 및 큐 시스템
 - 테스팅 지원
 
+## 12.x의 새로운 기능
+
+Laravel 12.x에서는 다음과 같은 새로운 기능이 추가되었습니다:
+
+- 완전히 새로워진 파일 구조
+- 향상된 성능과 최적화
+- 더 강력한 타입 힌팅 지원
+- 새로운 Folio 페이지 기반 라우팅
+- 개선된 Pest 테스팅 통합
+
 ## 더 알아보기
 
 Laravel의 공식 문서를 통해 더 많은 정보를 얻을 수 있습니다.

docusaurus.config.js

@@ -22,17 +22,29 @@ const config = {
   organizationName: 'letsescape', // Usually your GitHub org/user name.
   projectName: 'laravel-docs-web', // Usually your repo name.
 
-  onBrokenLinks: 'throw',
+  onBrokenLinks: 'warn',
   onBrokenMarkdownLinks: 'warn',
 
   // Even if you don't use internalization, you can use this field to set useful
   // metadata like html lang. For example, if your site is Chinese, you may want
   // to replace "en" with "zh-Hans".
   i18n: {
     defaultLocale: 'ko',
-    locales: ['ko'],
+    locales: ['ko', 'en'],
   },
 
+  themes: [
+    [
+      require.resolve("@easyops-cn/docusaurus-search-local"),
+      {
+        hashed: true,
+        language: ["en", "ko"],
+        highlightSearchTermsOnTargetPage: true,
+        explicitSearchResultPath: true,
+      },
+    ],
+  ],
+
   presets: [
     [
       'classic',
@@ -44,14 +56,22 @@ const config = {
           // Remove this to remove the "edit this page" links.
           editUrl:
             'https://github.com/letsescape/laravel-docs-web/tree/main/',
+          routeBasePath: 'docs',
+          includeCurrentVersion: true,
+          lastVersion: 'current',
+          versions: {
+            current: {
+              label: '12.x',
+              path: '',
+            },
+            '11.x': {
+              label: '11.x',
+              path: '11.x',
+            },
+          },
+          // remarkPlugins 설정 제거
         },
-        blog: {
-          showReadingTime: true,
-          // Please change this to your repo.
-          // Remove this to remove the "edit this page" links.
-          editUrl:
-            'https://github.com/letsescape/laravel-docs-web/tree/main/',
-        },
+        blog: false,
         theme: {
           customCss: require.resolve('./src/css/custom.css'),
         },
@@ -77,7 +97,17 @@ const config = {
             position: 'left',
             label: '문서',
           },
-          {to: '/blog', label: '블로그', position: 'left'},
+          // 블로그 기능 비활성화
+          {
+            type: 'docsVersionDropdown',
+            position: 'right',
+            dropdownItemsAfter: [],
+            dropdownActiveClassDisabled: true,
+          },
+          {
+            type: 'localeDropdown',
+            position: 'right',
+          },
           {
             href: 'https://github.com/letsescape/laravel-docs-web',
             label: 'GitHub',
@@ -109,10 +139,7 @@ const config = {
           {
             title: '더 보기',
             items: [
-              {
-                label: '블로그',
-                to: '/blog',
-              },
+              // 블로그 기능 비활성화
               {
                 label: 'GitHub',
                 href: 'https://github.com/letsescape/laravel-docs-web',

i18n/en/docusaurus-plugin-content-docs/current.json

@@ -0,0 +1,6 @@
+{
+  "version.label": {
+    "message": "12.x",
+    "description": "The label for version current"
+  }
+}