codu

codú

พื้นที่สำหรับโค้ด

Codúเป็นชุมชนที่ดีที่สุดของนักพัฒนาเว็บที่จะเรียนรู้แบ่งปันและรับการสนับสนุนสำหรับโครงการของคุณไม่ว่าเล็กหรือใหญ่ เป็นสถานที่ที่สมบูรณ์แบบในการฝึกฝนทักษะของคุณและสร้างผลงานของคุณ ในCodúเราทุกคนมาที่นี่เพื่อช่วยเหลือซึ่งกันและกันในฐานะนักพัฒนาเว็บ นอกจากนี้Codúช่วยให้หาผู้ทำงานร่วมกันสำหรับโครงการใหญ่ต่อไปของคุณได้ง่ายขึ้น

---

เข้าร่วมการสนทนา

เรามีชุมชนที่ยอดเยี่ยมเติบโตขึ้นจากความไม่ลงรอยกัน คลิกที่นี่เพื่อเข้าร่วม!

---

การติดตั้ง

1. แยกโครงการ
2. โคลนกับ git clone https://github.com/YOUR_USERNAME/codu.git
3. นำทางไปยัง cd codu Directory Project
4. ติดตั้งการพึ่งพาด้วย:

npm install

• หากคุณมีปัญหาใด ๆ ในการติดตั้งการพึ่งพาให้ตรวจสอบเวอร์ชันโหนดของคุณกับที่กำหนดไว้ใน .nvmrc หากคุณใช้ nvm คุณสามารถเรียก nvm use ได้ก่อนที่จะติดตั้งการพึ่งพา

5. สร้างไฟล์ .env และเพิ่มตัวแปรต่อไปนี้ คุณสามารถคัดลอกเนื้อหาของ sample.env ด้วย cat sample.env > .env

 # This default value is if you run our local docker-compose.yml file to create the database.
DATABASE_URL=postgresql://postgres:[email protected]:5432/postgres
# Setup your GitHub ID & Secret on GitHub: https://developer.github.com/apps/building-oauth-apps/authorizing-oauth-apps
# For development, make sure you set up this with a Homepage URL of http://localhost:3000/ and an Authorization callback URL of http://localhost:3000/api/auth
GITHUB_ID=YOUR_GITHUB_APP_ID
GITHUB_SECRET=YOUR_GITHUB_APP_SECRET
NEXTAUTH_URL=http://localhost:3000/api/auth

สำหรับคู่มือรายละเอียดเพิ่มเติมเกี่ยวกับการตั้งค่าให้ไปที่ส่วนตัวแปรสภาพแวดล้อม

หมายเหตุ: ก่อนดำเนินการตรวจสอบให้แน่ใจว่าฐานข้อมูลของคุณกำลังทำงานอยู่

6. ตั้งค่าตารางในฐานข้อมูลด้วย Drizzle โดยการรัน:

npm run db:migrate

คำสั่งเต็มสามารถเห็นได้ในไฟล์ package.json ของเรา

7. เมล็ดฐานข้อมูลด้วยข้อมูลจำลองบางอย่างโดยการรัน:

npm run db:seed

คำสั่งเต็มสามารถเห็นได้ในไฟล์ package.json ของเรา

8. สุดท้ายเรียกใช้เซิร์ฟเวอร์การพัฒนา:

npm run dev

หลังจากเสร็จสิ้นคำสั่งข้างต้นนำทางไปที่ http: // localhost: 3000 ในเบราว์เซอร์ของคุณเพื่อดูผลลัพธ์

คุณสามารถเริ่มต้นการเดินทางของคุณได้โดยการปรับเปลี่ยน pages/index.tsx ด้วยคุณสมบัติการอัปเดตอัตโนมัติหน้าอัปเดตหน้าเมื่อคุณแก้ไขไฟล์

ไดเรกทอรี pages/api ถูกแมปกับ /api/* ไฟล์ในไดเรกทอรีนี้ถือเป็นเส้นทาง API แทนหน้าปฏิกิริยา

เรียนรู้เพิ่มเติมเกี่ยวกับเส้นทาง API ที่นี่

ตัวแปรสภาพแวดล้อม

database_url

DATABASE_URL เป็นสตริงการเชื่อมต่อไปยังฐานข้อมูล PostgreSQL (เวอร์ชัน 15.0)

โดยค่าเริ่มต้นเราชี้ไปที่ฐานข้อมูลที่ทำงานในเครื่องด้วย Docker จากไฟล์ docker-compose.yml ของเรา

ในการเรียกใช้ไฟล์นี้ตรวจสอบให้แน่ใจว่าคุณติดตั้ง Docker และ Docker นั้นกำลังทำงานอยู่

เรียกใช้คำสั่ง docker compose up

อีกทางเลือกหนึ่งหากคุณมี PostgreSQL ทำงานในเครื่องคุณสามารถใช้สตริงการเชื่อมต่อในพื้นที่ของคุณหรือคว้าหนึ่งจากบริการฟรีเช่น Supabase

github_id และ github_secret

ปัจจุบันเราอนุญาตให้ตรวจสอบสิทธิ์ผ่าน GitHub เท่านั้น ในการเปิดใช้งานสิ่งนี้คุณจะต้องมีค่า GITHUB_ID และ GITHUB_SECRET

ตั้งค่า GitHub ID & Secret บน GitHub:

• คลิกที่นี่เพื่อตั้งค่าแอพ OAuth ใหม่และกรอกรายละเอียดดังที่แสดงด้านล่าง

เพื่อการพัฒนาตรวจสอบให้แน่ใจว่าคุณตั้งค่าสิ่งนี้ด้วย URL หน้าแรก ของ

 http://localhost:3000/

และ URL การโทรกลับของการอนุญาต ของ

 http://localhost:3000/api/auth

หลังจากที่คุณคลิกปุ่ม "ลงทะเบียนแอปพลิเคชัน" คุณควรเห็น GITHUB_ID และสามารถสร้างความลับไคลเอนต์ใหม่ได้ หลังจากสร้างความลับตรวจสอบให้แน่ใจว่าคุณคัดลอกค่านี้ไปยังไฟล์ .env ของคุณเนื่องจากค่านี้ไม่สามารถมองเห็นได้อีกครั้งเมื่อคุณรีเฟรชหน้า

ข้อมูลเพิ่มเติมเกี่ยวกับการอนุญาต OAuth ในเอกสาร GitHub ที่นี่

การตั้งค่าการรับรองความถูกต้องของรหัสผ่านในเครื่อง

ในการใช้การเข้าสู่ระบบแบบไม่มีรหัสผ่านในเครื่องคุณจะต้องมีค่า ACCESS_KEY และ SECRET_KEY

ตรวจสอบไฟล์ตัวอย่าง .env ที่นี่เพื่อดูวิธีการเติมค่าเหล่านี้

หมายเหตุ: ปัจจุบันภูมิภาค AWS ของบริการ SNS ถูกเก็บไว้เป็น "EU-WEST-1"; อาจจำเป็นต้องเปลี่ยนสิ่งนี้หากบริการ SNS ของคุณอยู่ในภูมิภาคอื่น

nextauth_url

คุณไม่จำเป็นต้องเปลี่ยนค่าเริ่มต้นที่นี่ นี่คือตัวแปรที่ใช้โดย Auth Next เป็น URL การรับรองความถูกต้องไปยังเว็บไซต์ของคุณ

 NEXTAUTH_URL=http://localhost:3000/api/auth

ตัวอย่างไฟล์. ENV สามารถพบได้ที่นี่ คุณสามารถเปลี่ยนชื่อสิ่งนี้เป็น .env เพื่อเริ่มต้น

? ‍ แนวทางการบริจาค

• การมีส่วนร่วมได้ รับการชื่นชมอย่างมาก ผลงานทำให้ชุมชนโอเพนซอร์สเป็นสถานที่ที่น่าทึ่งในการเรียนรู้สร้างแรงบันดาลใจและสร้าง
• ตรวจสอบแนวทางการบริจาคของเราเพื่อสนับสนุนการซื้อคืนของเรา รวมถึง
  • วิธีการมีส่วนร่วม
  • วิธีสร้างคำขอดึง
  • เรียกใช้การทดสอบ
  • คู่มือสไตล์สำหรับข้อความ commit

- ทักษะที่จำเป็นต้องมีส่วนร่วม

• กระตวน

- การมีส่วนร่วมในเอกสาร

• การทำเครื่องหมาย

- การบริจาครหัส

• ตอบโต้
• next.js
• PostgreSQL
• ลมลม
• ละอองฝน

ทรัพยากรเพิ่มเติม

หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับ next.js ลองดูแหล่งข้อมูลต่อไปนี้:

• Next.js Documentation - เรียนรู้เกี่ยวกับคุณสมบัติ Next.js และ API
• เรียนรู้ next.js - การสอนแบบโต้ตอบ next.js

เอกสารบรรณาธิการ

หากต้องการเรียนรู้เกี่ยวกับทางลัดและสายลัดของตัวแก้ไขคุณสามารถตรวจสอบเอกสารนี้ได้:

• ปุ่มลัดและทางลัดของ Markdoc

- การทดสอบ E2E

สำหรับข้อมูลเกี่ยวกับการทดสอบ E2E โปรดดูเอกสารเฉพาะของเราที่นี่

- ปัญหา

คุณยินดีที่จะเปิดปัญหาเพื่อหารือเกี่ยวกับแนวคิดเกี่ยวกับการปรับปรุงCodú การปรับปรุงได้รับการสนับสนุนและชื่นชม