Inkless0

0

Описание

Минималистичная блог платформа на Django для программистов и писателей. Работает в условиях сломанных cdn (без внешних зависимостей).

Языки

  • Python61,8%
  • HTML18,4%
  • CSS15,5%
  • Shell3%
  • Dockerfile1,3%
README.md

Блог система Inkless0 beta

Персональный блог на Django 6.0 с редактором CKEditor 5 со всеми плюшками для блога и ничего лишнего...

Демонстрация блога

Данное описание написано моими руками, а не ИИ, поэтому, просьба почитать.

Сам код сгенерирован Qwen 3 Coder Next 80B q8, но я бы сказал что местами я приложил свои руки чтобы добиться того, что нужно, иногда приходилось описывать некоторые скиллы, искать документацию и подкладывать, чтобы добиться нужного результата.

Фишечки

  • Удобный редактор CKEditor 5 - позволяет загружать картинки из буфера обмена (например скриншоты), понимает markdown синтаксис, т.е. вы просто пишите

    ##
    а у вас заголовок первого уровня, пишите
    ```
    а у вас блок кода.

  • Ресайз и lightbox - при загрузке картинки создается ее уменьшенная копия в папке /data/media/thumbs/ больше никаких десятков фотографий в разрешении 4к в статье, только маленькие легкие картинки, а при клике грузится оригинальная полноразмерная картинка

  • Подсветка кода - куда нам программистам без подсветки кода в статьях, тут задействована библиотека Prism.js, которая подсвечивает номера строк, подсвечивает синтаксис и есть кнопочка для копирования листинга, сконфигурирована подсветка кода большинства языков.

  • Минималистичный дизайн - шаблон сделан настолько минималистичный, что нет никаких Bootstrap, нет Jquery, стили достаточно простые, но красивые, всё это слепила ИИ-шка, я немного подточил стили, поправил верстку.

  • Никаких внешних зависимостей - может работать без интернета или когда все cdn заблокируют.

  • SQLite/PostgreSQL - запускайте на любом слабом железе (SQLite) или используйте PostgreSQL для production-среды с более надежным хранением данных.

  • Конфигурация через переменные окружения - настройка проекта через

    .env
    файл или
    docker-compose.yml

Запуск

  1. Склонируйте репозиторий:

  2. Создайте виртуальное окружение Python:

  3. Активируйте виртуальное окружение:

    • Windows (PowerShell):

    • Linux/macOS:

  4. Установите зависимости:

  5. Примените миграции:

    Это чтобы инициализировалась БД, создались все необходимые папки для хранения картинок...

  6. Создайте суперпользователя (администратора):

  7. Запустите сервер :

  8. Откройте блог в браузере:

Использование переменных окружения

Проект поддерживает конфигурацию через переменные окружения. Создайте файл

.env
на основе
.env.example
и задайте необходимые значения:

Важно: Файл

.env
уже добавлен в
.gitignore
— не коммитьте его в репозиторий!

Установка переменных через .env файл

Создай файл

.env
в корне проекта и помести туда нужные переменные. Затем загрузи их:

Linux/macOS: Linux/macOS (bash/zsh):

или из .env

Windows (PowerShell):

Docker

  • Docker — подробная инструкция по запуску через Docker с поддержкой SQLite и PostgreSQL: documentation/docker.md

История изменений

CHANGELOG.md.