dev case
1.0.0
تم تصميم Devcase للمطورين ومحترفي تكنولوجيا المعلومات. إنها أداة لمساعدتك في الحصول على مدونتك الخاصة ومحفظة عبر الإنترنت بسرعة وسهولة.
Demo/مثال: rburkhardt.com
بيت
عن
Blogpost مع Image (إصدار جديد يحتوي على نظام تعليقات)
Blogpost بدون صورة (إصدار جديد يحتوي على نظام تعليقات)
صفحة الاتصال (إصدار جديد يحتوي على Captchas)
لوحة معلومات المشرف
المسؤول - حول التكوين
أسرع وأسهل طريقة لاختبار Dev-Case محليًا :
git clone [email protected]:rob32/dev-case.git
cd dev-case
docker-compose up -d --build
docker-compose exec web python manage.py migrate
docker-compose exec web python manage.py createsuperuser
مهم :
قم بإنشاء ملف .env جديد مع المحتوى التالي (قبل أن docker-compose up -d --build ):
DEBUG=True
DATABASE_URL=psql://postgres:postgres@db:5432/postgres
انتقل إلى http://127.0.0.1:8000/ وتحقق مما إذا كان كل شيء يعمل.
بيئة التنمية مع بيثون (VENV) والعقدة (اختياري).
تم اختباره مع GNU/Linux & Mac:
git clone [email protected]:rob32/dev-case.git
cd dev-case
python3 -m venv venv && source venv/bin/activate
pip install -r requirements-dev.txt
python3 manage.py migrate
pre-commit install
قم بإنشاء ملف .env مع المحتوى التالي على الأقل:
DEBUG=True
# only if postgres is used, uncomend the next line (example):
# DATABASE_URL=psql://postgres:postgres@db:5432/postgres
ابدأ خادم التطوير باستخدام python3 manage.py runserver
انتقل إلى http://127.0.0.1:8000/
# Install dependecies with:
npm install
# Build "Fronted" manually (uses `rm -rf` for cleaning):
npm run build
اختياري: ابدأ الخادم الخلفي و esbuild في وضع الساعة في نفس الوقت مع npm start .
# Unit/Integration Tests:
python3 manage.py test
# Code Quality with the help of pre-commit
pre-commit run -a -v
مجموعة مختارة من الإعدادات المحتملة عبر متغيرات البيئة:
SECRET_KEY=insecure-secretkey12345
DEBUG=FALSE
ALLOWED_HOSTS=my-domain-name.com
DATABASE_URL=psql://postgres:postgres@db:5432/postgres
ADMIN_LOCATION=dev-case/
ROBOTS_DISALLOW=/contact/,/private-file.html`
FEED_TITLE="My Feed Title"
FEED_DESCRIPTION="My feed description"
USE_UMAMI_ANALYTICS=True
UMAMI_SCRIPT_URL=https://your-umami-app.com/umami.js
UMAMI_DATA_WEBSITE_ID=2323-3232-2323-3232
WIP
للنشر/الإنتاج ، هناك فرعان في الوقت الحالي:
بالنسبة لمنصة تطبيق Digitalocean ، يمكنك استخدام زر "Deploy to DigitalOcean" أدناه. يرجى التأكد من أن لديك مساحة/دلو يعمل مع بيانات الاعتماد المطلوبة. الدليل: كيفية إنشاء مساحة رقمية ومفتاح API
بعد اكتمال عملية الإنشاء:
الوصول إلى وحدة التحكم في التطبيق الخاص بك من خلال علامة تبويب وحدة التحكم وقم بتشغيل الأوامر التالية:
python3 manage.py migrate لترحيل قاعدة البيانات الأوليةpython3 manage.py createsuperuser لإنشاء مستخدم إداريكخطوة أخيرة ، قم بالتعديل التالي في إعداد المساحة الخاص بك:
مساحتك -> الإعدادات -> تكوينات CORS (إضافة):
*ondigitalocean.app*example.comهذا يجب أن يحل المشكلة مع الخطوط (الرأس المفقود ، وصول الوصول إلى الأصل)
الإعدادات المحتملة للإنتاج (عبر متغيرات البيئة):
SECURE_SSL_REDIRECT=True
SECURE_HSTS_SECONDS=2592000
SECURE_HSTS_INCLUDE_SUBDOMAINS=True
SECURE_HSTS_PRELOAD=True
SESSION_COOKIE_SECURE=True
CSRF_COOKIE_SECURE=True
تأكد من ضبط USE_S3_STORAGE على True .
الإعدادات الممكنة للتخزين المتوافق مع S3 (عبر متغيرات البيئة):
USE_S3_STORAGE (default=False)
AWS_ACCESS_KEY_ID
AWS_SECRET_ACCESS_KEY
AWS_STORAGE_BUCKET_NAME
AWS_S3_REGION_NAME
AWS_S3_ENDPOINT_URL
AWS_S3_CUSTOM_DOMAIN
AWS_LOCATION
AWS_IS_GZIPPED (default=False)
AWS_S3_FILE_OVERWRITE (default=True)
AWS_DEFAULT_ACL (default=public-read)
يمكنك تغيير موقع منطقة المسؤول باستخدام متغير بيئة ADMIN_LOCATION . الافتراضي هو admin/ .
قم بتغيير اسم المجال واسم العرض عبر Panel Panel (تطبيق المواقع) إلى اسم المجال الفعلي. يتم تعيين الافتراضي على "example.com".
لإضافة قواعد عدم السماح ، استخدم متغير بيئة ROBOTS_DISALLOW . للحصول على إدخال Sitemap صالح ، قم بتغيير اسم المجال الخاص بك كما هو موضح في sitemap.xml.
مثال: ROBOTS_DISALLOW=/contact/,/private-file.html
لتلقي الإخطارات ، يمكنك تكوين الإعدادات التالية عبر متغيرات البيئة:
USE_EMAIL_SMTP (default=False)
EMAIL_NOTIFICATION (default=False)
EMAIL_RECIPIENT (receiver address)
EMAIL_HOST
EMAIL_HOST_USER
EMAIL_HOST_PASSWORD
EMAIL_USE_TLS (default=True)
EMAIL_USE_SSL (default=False)
EMAIL_PORT (default=587)
DEFAULT_FROM_EMAIL
تأكد من ضبط USE_EMAIL_SMTP و EMAIL_NOTIFICATION على True .
يحتاج متغير DEFAULT_FROM_EMAIL إلى قيمة صالحة (مثال: [email protected]).
سيؤدي ذلك إلى إخطارك عندما تكون هناك تعليقات جديدة أو عندما تتلقى رسالة عبر صفحة الاتصال.
إذا كنت تريد أيضًا أن يتم إخطارها في حالة أخطاء الخادم ، فقم بتعيين متغير البيئة DJANGO_ADMINS باسمك وعنوان بريدك الإلكتروني. مثال:
DJANGO_ADMINS=YourName:[email protected]
# or more
DJANGO_ADMINS=NameOne:[email protected],NameTwo:[email protected]
تأكد من ضبط متغير بيئة USE_UMAMI_ANALYTICS على True .
بالإضافة إلى ذلك ، قم بإنشاء متغير بيئة UMAMI_SCRIPT_URL و UMAMI_DATA_WEBSITE_ID مع القيم المقابلة.
مثال:
USE_UMAMI_ANALYTICS=True
UMAMI_SCRIPT_URL=https://your-umami-app.com/umami.js
UMAMI_DATA_WEBSITE_ID=2323-3232-2323-3232
تأكد من ضبط متغير بيئة USE_PLAUSIBLE_ANALYTICS على True .
بالإضافة إلى ذلك ، قم بإنشاء متغير بيئة PLAUSIBLE_SCRIPT_URL و PLAUSIBLE_DATA_DOMAIN مع القيم المقابلة.
مثال:
USE_PLAUSIBLE_ANALYTICS=True
PLAUSIBLE_SCRIPT_URL=https://plausible.io/js/script.js
PLAUSIBLE_DATA_DOMAIN=example.com
المساهمات والتعليقات وتراجعات الميزات هي دائما موضع ترحيب. لمعرفة المزيد ، راجع دليل المساهم
شكر كبير للمشاريع الرائعة التالية:
المشروع متاح بموجب ترخيص GNU GPLV3.
إذا كنت تحب المشروع ، فالرجاء إعطائه نجمة
