dev case
1.0.0
DevCase dirancang untuk pengembang dan profesional TI. Ini adalah alat untuk membantu Anda mendapatkan blog dan portofolio Anda sendiri secara online dengan cepat dan mudah.
Demo/Contoh: rburkhardt.com
Rumah
Tentang
BlogPost dengan gambar (versi baru memiliki sistem komentar)
BlogPost tanpa gambar (versi baru memiliki sistem komentar)
Halaman kontak (versi baru memiliki captchas)
Dasbor Admin
Admin - Tentang Konfigurasi
Cara tercepat dan termudah untuk menguji dev-case secara lokal :
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
Penting :
Buat file .env baru dengan konten berikut (sebelum docker-compose up -d --build ):
DEBUG=True
DATABASE_URL=psql://postgres:postgres@db:5432/postgres
Buka http://127.0.0.1:8000/ dan periksa apakah semuanya berhasil.
Lingkungan Pengembangan dengan Python (VENV) dan Node (Opsional).
Diuji dengan 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
Buat file .env dengan setidaknya konten berikut:
DEBUG=True
# only if postgres is used, uncomend the next line (example):
# DATABASE_URL=psql://postgres:postgres@db:5432/postgres
Mulailah server pengembangan dengan python3 manage.py runserver
Pergi ke http://127.0.0.1:8000/
# Install dependecies with:
npm install
# Build "Fronted" manually (uses `rm -rf` for cleaning):
npm run build
Opsional: Mulai Backend-Server dan EsBuild dalam mode arloji pada saat yang sama dengan npm start .
# Unit/Integration Tests:
python3 manage.py test
# Code Quality with the help of pre-commit
pre-commit run -a -v
Pilihan pengaturan yang mungkin melalui variabel lingkungan:
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
Untuk penempatan/produksi ada dua cabang saat ini:
Untuk platform aplikasi DigitalOcean, Anda dapat menggunakan tombol "Digital to DigitalOcean" di bawah ini. Pastikan Anda memiliki ruang/ember S3 yang berfungsi dengan kredensial yang diperlukan. Panduan: Cara Membuat Ruang Digitalocean dan Kunci API
Setelah proses pembangunan selesai:
Akses konsol aplikasi Anda melalui tab konsol dan jalankan perintah berikut:
python3 manage.py migrate untuk migrasi basis data awalpython3 manage.py createsuperuser untuk membuat pengguna administratifSebagai langkah terakhir, buat penyesuaian berikut dalam pengaturan ruang Anda:
Ruang Anda -> Pengaturan -> Konfigurasi CORS (Tambah):
*ondigitalocean.app*example.comIni harus menyelesaikan masalah dengan font (header yang hilang, akses-kontrol-awal)
Pengaturan yang mungkin untuk produksi (melalui variabel lingkungan):
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
Pastikan USE_S3_STORAGE diatur ke True .
Kemungkinan Pengaturan untuk Penyimpanan Kompatibel S3 (melalui Variabel Lingkungan):
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)
Anda dapat mengubah lokasi untuk area admin menggunakan variabel lingkungan ADMIN_LOCATION . Default adalah admin/ .
Ubah nama domain dan nama tampilan melalui admin-panel (aplikasi situs) ke nama domain Anda yang sebenarnya. Default diatur ke "example.com".
Untuk menambahkan aturan yang tidak masuk akal , gunakan variabel lingkungan ROBOTS_DISALLOW . Untuk entri sitemap yang valid, ubah nama domain Anda seperti yang dijelaskan dalam sitemap.xml.
Contoh: ROBOTS_DISALLOW=/contact/,/private-file.html
Untuk menerima pemberitahuan, Anda dapat mengonfigurasi pengaturan berikut melalui variabel lingkungan:
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
Pastikan bahwa USE_EMAIL_SMTP dan EMAIL_NOTIFICATION diatur ke True .
Variabel DEFAULT_FROM_EMAIL perlu memiliki nilai yang valid (contoh: [email protected]).
Ini akan memberi tahu Anda ketika ada komentar baru atau ketika Anda menerima pesan melalui halaman kontak.
Jika Anda juga ingin diberi tahu jika terjadi kesalahan server, atur variabel lingkungan DJANGO_ADMINS dengan nama dan alamat email Anda. Contoh:
DJANGO_ADMINS=YourName:[email protected]
# or more
DJANGO_ADMINS=NameOne:[email protected],NameTwo:[email protected]
Pastikan variabel lingkungan USE_UMAMI_ANALYTICS diatur ke True .
Selain itu buat variabel lingkungan UMAMI_SCRIPT_URL dan UMAMI_DATA_WEBSITE_ID dengan nilai yang sesuai.
Contoh:
USE_UMAMI_ANALYTICS=True
UMAMI_SCRIPT_URL=https://your-umami-app.com/umami.js
UMAMI_DATA_WEBSITE_ID=2323-3232-2323-3232
Pastikan bahwa variabel lingkungan USE_PLAUSIBLE_ANALYTICS diatur ke True .
Selain itu buat variabel lingkungan PLAUSIBLE_SCRIPT_URL dan PLAUSIBLE_DATA_DOMAIN dengan nilai yang sesuai.
Contoh:
USE_PLAUSIBLE_ANALYTICS=True
PLAUSIBLE_SCRIPT_URL=https://plausible.io/js/script.js
PLAUSIBLE_DATA_DOMAIN=example.com
Kontribusi, umpan balik, dan permintaan fitur selalu diterima. Untuk mempelajari lebih lanjut, lihat Panduan Kontributor
Terima kasih banyak untuk proyek -proyek hebat berikut:
Proyek ini tersedia di bawah lisensi GNU GPLV3.
Jika Anda menyukai proyek ini, tolong berikan bintang
