WIP

Author: tabuna

README.md

@@ -8,17 +8,17 @@
 ## Документация (Работа с кодом)
 
 - [ ] Корректное отображение кода - Убедиться, что код в документации отображается правильно, с соблюдением форматирования, подсветкой синтаксиса
-- [ ] Корректное отображение таблиц - Убедиться, что таблицы в документации отображаются так, чтобы данные были читаемыми и оформлены правильно, с правильным выравниванием содержимого ячеек.
+- [x] Корректное отображение таблиц - Убедиться, что таблицы в документации отображаются так, чтобы данные были читаемыми и оформлены правильно, с правильным выравниванием содержимого ячеек.
 - [ ] Корректное отображение коллекций (столбцов) - Проверить, что коллекции (например, списки или словари) в документации правильно отображаются, особенно когда имеются вложенные структуры данных.
 - [ ] Корректное отображение цитат - Убедиться, что цитаты в документации выделяются и форматируются соответствующим образом для читаемости и понятности.
 - [ ] Корректное отображение предупреждений - Проверить, что предупреждения в документации явно выделяются, чтобы пользователи могли обратить на них внимание.
-- [ ] Типограф - Применить правила типографики к тексту документации с целью улучшения его читаемости, например, автоматическое исправление ошибок в расстановке кавычек, дефисов и других знаков препинания.
-- [ ] Команда для загрузки документов из git - Создать команду, которая будет позволять загружать документацию напрямую из системы контроля версий Git, чтобы всегда иметь актуальную версию документации доступной для пользователей.
+- [x] Типограф - Применить правила типографики к тексту документации с целью улучшения его читаемости, например, автоматическое исправление ошибок в расстановке кавычек, дефисов и других знаков препинания.
+- [x] Команда для загрузки документов из git - Создать команду, которая будет позволять загружать документацию напрямую из системы контроля версий Git, чтобы всегда иметь актуальную версию документации доступной для пользователей.
 - [ ] Поиск по документации - Реализовать функциональность поиска в документации, чтобы пользователи могли быстро находить нужную информацию по ключевым словам или фразам.
 - [ ] Проверка прошлых версий на работоспособность - Регулярно тестировать документацию на старых версиях продукта, чтобы убедиться, что все примеры и инструкции все еще актуальны и работоспособны.
-- [ ] Переключение версий - Предоставить возможность пользователям выбирать нужную версию документации
+- [x] Переключение версий - Предоставить возможность пользователям выбирать нужную версию документации
 - [ ] Обноавить инструкцию для системы переводов, что бы её было легко понять
-- [ ] Записывать последний доступный хэш коммита
+- [x] Записывать последний доступный хэш коммита
 - [ ] Дружелюбно показывать если документация отстаёт от оригинала и на сколько сильно 
 - [ ] Форматирование отступов, что бы последнего не было никогда.
 
@@ -39,17 +39,17 @@
 ## Публикации
 
 - [x] Возможность пользователю делать публикации
-- [ ] Markdown редактор (Пусть пользователь сразу привыкает к тому, что ему придётся иметь дело именно с markdown) 
+- [x] Markdown редактор (Пусть пользователь сразу привыкает к тому, что ему придётся иметь дело именно с markdown) 
 - [ ] Маркер, для того что бы пользователь определился сам, как будет выглядеть короткая версия поста, либо сделать это автоматически
 - [ ] Генерация изображений для социальных сетей и ссылок, где бы заголовок отображался на картинке красиво
 - [ ] Предпросмотр того как статья будет выглядеть ещё до публикации
 - [ ] Теги публикации, лучше всего из списка Enum и до 1/2/3
 - [ ] Рейтинг +1 / -1 где пользователь может высказывать понравилась ли ему публикация
-- [ ] Система коментариев с поддержкой (Не большой?) вложенности
+- [x] Система коментариев с поддержкой (Не большой?) вложенности
 - [ ] Рейтинг у комментария
 - [ ] Меншены в комментариях?
 - [ ] Возможность загрузки изображений через редактор и их эффективное удаление/ресайз
-- [ ] Блок с самыми полулярными публикациями
+- [x] Блок с самыми полулярными публикациями
 - [ ] Push/Site уведомления о новых комментариях или упоминаний
 
 ## Как использовать этот репозиторий

app/Casts/PackageTypeEnum.php

@@ -28,35 +28,35 @@ enum PackageTypeEnum: string
     public function text(): string
     {
         return match ($this) {
-            self::FileManagement       => 'Управление файлами',
-            self::AuthAndPermission    => 'Аутентификация и разрешения',
-            self::DatabaseAndEloquent  => 'Базы данных и Eloquent',
+            self::FileManagement => 'Управление файлами',
+            self::AuthAndPermission => 'Аутентификация и разрешения',
+            self::DatabaseAndEloquent => 'Базы данных и Eloquent',
             self::DebuggingAndDevTools => 'Инструменты разработчика',
-            self::DevOps               => 'DevOps',
+            self::DevOps => 'DevOps',
             //self::Localization         => 'Локализация',
-            self::API                  => 'API',
+            self::API => 'API',
             //self::SEO                  => 'Оптимизация для поисковых систем (SEO)',
-            self::Testing              => 'Тестирование',
+            self::Testing => 'Тестирование',
             //self::Payment              => 'Платежи',
-            self::Security             => 'Безопасность',
+            self::Security => 'Безопасность',
             //self::Mail                 => 'Почта',
-            self::ECommerce            => 'Интернет-торговля',
-            self::CMSAndAdminPanels    => 'CMS и панели администратора',
-            self::CodeArchitecture     => 'Архитектура кода',
-            self::Notifications        => 'Уведомления',
+            self::ECommerce => 'Интернет-торговля',
+            self::CMSAndAdminPanels => 'CMS и панели администратора',
+            self::CodeArchitecture => 'Архитектура кода',
+            self::Notifications => 'Уведомления',
             self::UIAndBladeComponents => 'UI и компоненты Blade',
-            self::UtilitiesAndHelpers  => 'Утилиты',
+            self::UtilitiesAndHelpers => 'Утилиты',
 
         };
     }
 
     public function colorBg(): string
     {
-        return ColorText::Hex($this->text(),'21');//подобрать подходящее значение
+        return ColorText::Hex($this->text(), '21');//подобрать подходящее значение
     }
+
     public function colorText(): string
     {
         return ColorText::Hex($this->text());
     }
-
 }

app/Docs.php

@@ -74,7 +74,10 @@ public function __construct(string $version, string $file)
         $this->page = Storage::disk('docs')->get($this->path);
 
         // Abort the request if the page doesn't exist
-        abort_if($this->page === null, 404);
+        abort_if(
+            $this->page === null && Document::where('file', $this->file)->exists(),
+            redirect(status: 300)->route('docs', ['version' => $version, 'page' => 'installation'])
+        );
 
         $variables = Str::of($this->page)->after('---')->before('---');
 

app/Ecosystem.php

@@ -4,7 +4,11 @@
 
 class Ecosystem
 {
-
+    /**
+     * Get the ecosystem items.
+     *
+     * @return array
+     */
     public static function items(): array
     {
         return [

app/Http/Controllers/DocsController.php

@@ -33,6 +33,7 @@ public function status(string $version = Docs::DEFAULT_VERSION)
     {
         $documents = Document::where('version', $version)
             ->orderByDesc('behind')
+            ->orderBy('file')
             ->get();
 
         return view('docs.status', [

app/Http/Controllers/PackagesController.php

@@ -15,9 +15,20 @@
 
 class PackagesController extends Controller
 {
-    public function index()
+    /**
+     * @param \Illuminate\Http\Request $request
+     *
+     * @return \Illuminate\Contracts\Foundation\Application|\Illuminate\Contracts\View\Factory|\Illuminate\Contracts\View\View|\Illuminate\Foundation\Application|null
+     */
+    public function index(Request $request)
     {
-        return view('packages.index');
+        $packages = Package::when($request->has('type'), function ($query) use ($request) {
+            return $query->where('type', $request->input('type'));
+        })->paginate();
+
+        return view('packages.index', [
+            'packages' => $packages
+        ]);
     }
 
     public function edit(Request $request, Package $package)

app/Http/Controllers/PostController.php

@@ -15,7 +15,7 @@ class PostController extends Controller
 {
 
     /**
-     * @return \Illuminate\Contracts\Foundation\Application|\Illuminate\Contracts\View\Factory|\Illuminate\Contracts\View\View|\Illuminate\Foundation\Application|null
+     * @return \Illuminate\Contracts\View\View|\Tonysm\TurboLaravel\Http\MultiplePendingTurboStreamResponse|\Tonysm\TurboLaravel\Http\PendingTurboStreamResponse|null
      */
     public function feed()
     {
@@ -26,11 +26,12 @@ public function feed()
             ->simplePaginate(5);//CursorPaginate не работает с сортировкой по полю из withCount
 
 
-        if(request()->isMethod('GET')){
+        if (request()->isMethod('GET')) {
             return view('post.list', [
                 'popular' => $popular,
             ]);
         }
+
         return turbo_stream([
             turbo_stream()->append('popular-list', view('post._popular_list', [
                 'popular' => $popular,
@@ -40,7 +41,6 @@ public function feed()
                 'popular' => $popular,
             ])),
         ]);
-
     }
 
 
@@ -60,33 +60,34 @@ public function show(Post $post)
         ]);
     }
 
-    public function edit(Request $request,Post $post)
+    public function edit(Request $request, Post $post)
     {
         $this->authorize('isOwner', $post);
 
         $request->validate([
-            'select_type'    => [
+            'select_type' => [
                 'sometimes',
-                Rule::enum(PostTypeEnum::class)
-            ]
+                Rule::enum(PostTypeEnum::class),
+            ],
         ]);
 
-         $isEditing = $post->exists;
-         if($request->has('select_type') && !$isEditing){
-             $post->type = PostTypeEnum::from($request->input('select_type'));
-             $view = 'post.edit.'. $request->input('select_type');
-         }elseif($isEditing){
-             $view = 'post.edit.'. $post->type->value;
+        $isEditing = $post->exists;
+        if ($request->has('select_type') && !$isEditing) {
+            $post->type = PostTypeEnum::from($request->input('select_type'));
+            $view = 'post.edit.' . $request->input('select_type');
+        } else if ($isEditing) {
+            $view = 'post.edit.' . $post->type->value;
 
-         }else{
-             $view = 'post.edit.'.PostTypeEnum::Article->value;
-         }
+        } else {
+            $view = 'post.edit.' . PostTypeEnum::Article->value;
+        }
 
         $title = $isEditing ? 'Редактирование' : 'Новая статья';
+
         return view($view, [
-            'title' => $title,
-            'post'  => $post,
-            'isEditing' => $isEditing
+            'title'     => $title,
+            'post'      => $post,
+            'isEditing' => $isEditing,
         ])->fragmentsIf(!$request->isMethodSafe());
     }
 
@@ -154,11 +155,11 @@ public function list(Request $request)
         return turbo_stream([
             turbo_stream()->removeAll('.post-placeholder'),
             turbo_stream()->append('posts-frame', view('particles.posts.list', [
-                'posts'       => $posts,
+                'posts' => $posts,
             ])),
 
             turbo_stream()->replace('post-more', view('post.pagination', [
-                'posts'       => $posts,
+                'posts' => $posts,
             ])),
         ]);
     }

app/Http/Controllers/ProfileController.php

@@ -27,28 +27,38 @@ public function index(Request $request)
     public function show(User $user, Request $request)
     {
         return view('profile.profile', [
-            'user'        => $user,
-            'posts'       => $this->getPosts($user, PostTypeEnum::Article, $request->user()),
+            'user'  => $user,
+            'posts' => $this->getPosts($user, PostTypeEnum::Article, $request->user()),
         ]);
     }
 
-    private function getPosts(User $owner, PostTypeEnum $type, User $user){
-        $posts =  $owner->posts()
+    /**
+     * @param \App\Models\User        $owner
+     * @param \App\Casts\PostTypeEnum $type
+     * @param \App\Models\User        $user
+     *
+     * @return \Illuminate\Pagination\AbstractCursorPaginator|\Illuminate\Pagination\AbstractPaginator
+     */
+    private function getPosts(User $owner, PostTypeEnum $type, User $user)
+    {
+        $posts = $owner->posts()
             ->type($type->value)
             ->withCount('comments')
             ->withCount('likers')
             ->orderBy('id', 'desc')
             ->cursorPaginate(2);
+
         return $user->attachLikeStatus($posts);
     }
 
     public function meets(User $user, Request $request)
     {
         $meets = $user->meets()->latest()
             ->cursorPaginate(2);
+
         return view('profile.events', [
-            'user'        => $user,
-            'meets'       => $meets,
+            'user'  => $user,
+            'meets' => $meets,
         ]);
     }
 
@@ -98,7 +108,7 @@ public function comments(Request $request, User $user)
     public function awards(User $user)
     {
         return view('profile.awards', [
-            'user'        => $user,
+            'user' => $user,
         ]);
     }
 
@@ -119,18 +129,18 @@ public function update(Request $request)
         $request->validate(
             [
                 'name'  => 'required|string',
-                'about' => 'sometimes|string'
+                'about' => 'sometimes|string',
             ],
             [],
             [
                 'name'  => 'Имя',
-                'about' => 'О себе'
+                'about' => 'О себе',
             ]
         );
 
         $request->user()->fill([
             'name'  => $request->input('name'),
-            'about' => $request->input('about')
+            'about' => $request->input('about'),
         ])->save();
 
         return redirect()->route('profile', $request->user());

resources/css/app.scss

@@ -6,18 +6,7 @@ $primary: #f9322c;
 $dark: #212529;
 
 $body-secondary-bg: #EBEEF4;
-$body-secondary-bg-dark: #1A1E28;//shade-color($body-secondary-bg, 85);
-
-/*
-$secondary:     $gray-600 !default;
-$success:       $green !default;
-$info:          $cyan !default;
-$warning:       $yellow !default;
-$danger:        $red !default;
-$light:         $gray-100 !default;
-$dark:          $gray-900 !default;
-// scss-docs-end theme-color-variables
-*/
+$body-secondary-bg-dark: #1A1E28;
 
 $container-max-widths: (
     sm: 540px,
@@ -92,6 +81,7 @@ $utilities: (
 }
 
 @import 'bootstrap/scss/bootstrap';
+@import "reset";
 @import 'prism';
 @import 'back-to-top';
 @import 'clipboard';
@@ -100,19 +90,10 @@ $utilities: (
 
 
 
-textarea {
-    resize: none;
-}
-
 .text-balance {
     text-wrap: balance;
 }
 
-.lead {
-    font-family: $headings-font-family;
-    @extend .text-balance;
-}
-
 
 .post {
     @extend .text-break;

resources/css/docs.scss

@@ -98,6 +98,7 @@ main div {
     }
 
     code {
+        @extend .text-nowrap;
         color: rgb(235, 68, 50);
     }
 }
@@ -184,6 +185,10 @@ main {
     pre {
         border-radius: 0.8rem;
         margin-bottom: 2em !important;
+
+        code {
+            white-space: inherit!important;
+        }
     }
 
     /*

resources/css/reset.scss

@@ -0,0 +1,10 @@
+
+textarea {
+    resize: none;
+}
+
+
+.lead {
+    font-family: $headings-font-family;
+    @extend .text-balance;
+}