jahir.dev

Jahir.dev

Куча

• Структура : Next.js
• Стиль : Tailwind CSS
• Контент : MDX и Velite
• База данных : Neon and Toprizzle Orm
• Аналитика : Умами
• Развертывание : Vercel

Структура проекта

 .
| ____config
| ____content
| ____public
| ____scripts
| ____src
| | ____actions
| | ____app
| | ____assets
| | ____components
| | | ____core
| | | ____molecules
| | | ____og
| | | ____views
| | | ____icons.ts
| | ____data
| | ____hooks
| | ____lib
| | ____providers
| | ____styles
| | ____types
| | ____utils

• config/* - включает в себя всю пользовательскую конфигурацию для MDX, Velite и Next.js
• content/* - сообщения в блоге MDX и контент для страниц donate
• public/* - Статические активы, включая изображения, шрифты, аудио, файлы и т. Д.
• scripts/* - Утилиты для настройки проекта
• src/app/* - Каждая страница и маршрут API на веб -сайте. Использует новый маршрутизатор приложения от Next.js 13.+
• src/assets/* - шрифты и статические изображения, используемые в разных компонентах
• src/components/core/* - самые простые компоненты. Большинство из них без гражданства
• src/components/molecules/* -Основные блоки для веб-сайта: toolbar , footer , main макет, кнопку back-to-top и social links
• src/components/og/* - код, который обеспечивает генерацию динамических изображений с открытым графом
• src/components/views/* - более сложные компоненты для создания различных страниц моего веб -сайта. (Они здесь, чтобы сохранить src/app/ максимально чистым)
• src/components/icons.ts - пути иконы SVG. Значки поступают из значков дизайна материала и Lucide
• src/data/* - файлы JSON, содержащие данные для проектов и страницы uses
• src/hooks/* - Пара крючков, используемых по всему приложению
• src/lib/* - Короче говоря, для «библиотеки», коллекции полезных утилит или кода для внешних услуг
• src/providers/* - React Contexts для хранения текущей темы и реакций в блоге.
• src/styles/* - глобальные стили с scss . В основном используйте занятия по ветру
• src/types/* - некоторые типы определений
• src/utils/* - больше функций утилит, но менее сложные, чем те, которые в lib

Бег на местном уровне

Это приложение требует node.js v18.18+.

1. Клонировать проект, установить зависимости и запустить начальную настройку

   git clone https://github.com/jahirfiquitiva/jahir.dev.git
   cd jahir.dev
   bun
   bun run setup # You can skip this if you're contributing to this repository. It removes all of my personal content and files

2. Создайте файл .env , похожий на .env.example .

3. (Необязательно) В этом проекте используется база данных Postgres для хранения подсчета представлений и реакций.

    CREATE TABLE counters (
     slug VARCHAR ( 255 ) PRIMARY KEY NOT NULL ,
     views INTEGER NOT NULL DEFAULT 0 ,
     likes INTEGER NOT NULL DEFAULT 0 ,
     loves INTEGER NOT NULL DEFAULT 0 ,
     awards INTEGER NOT NULL DEFAULT 0 ,
     bookmarks INTEGER NOT NULL DEFAULT 0
   );

4. Запустите проект локально:

   bun run dev

Примечание

Некоторые вещи могут быть сломаны или не найдены, потому что сценарий bun run setup будет удалять много файлов. Пожалуйста, дважды проверьте код и реализации.

Клонирование / развязка

Пожалуйста, просмотрите лицензию, не копируйте ее напрямую, удаляйте весь мой личный контент и файлы (резюме, сообщения в блоге, изображения и т. Д.), Запустив bun run setup и, пожалуйста, измените стиль и цвета, чтобы соответствовать вашему личному бренду. Вы можете использовать этот код в качестве вдохновения или ссылки на обучение, но на самом деле это не предназначено для того, чтобы быть шаблоном.

Дополнительные изменения

Обязательно установите переменную среды IS_TEMPLATE на false. В противном случае цвета на сайте могут быть перевернуты. (См src/styles/globals.scss )

Предыдущие версии

Все предыдущие версии этого сайта можно найти в Jahirfiquitiva/Prev-Websites