idealyard

ايديال يارد

استخدم Vue2 و Flask لإنشاء مدونة شخصية RESTful ذات واجهة أمامية وخلفية منفصلة.

يمكن العثور على بعض التعليمات حول المشروع هنا. حول IdealYard إذا لم تجد ما تحتاجه، يرجى التواصل عبر البريد الإلكتروني أو المشكلات؛

يلاحظ

1. هذه المدونة مخصصة لمبادئ التعلم فقط. لا تنفذ الصفحة الأمامية تخطيطًا سريع الاستجابة، وليس لدي الطاقة لتنفيذه بعد، وليس لدي الوقت الكافي للاهتمام بمحتوى المدونة. يتم تحديث المدونات المتعلقة بالسجلات اليومية بشكل أساسي في سجلات Biyuan الرعوية.

2. إذا كنت مبتدئًا في Flask، فإنني أوصيك بكتاب باللغة الصينية: "Flask Web Development in Practice: البدء، التحليل المتقدم والمبادئ". أنا أيضًا قارئ ومستفيد من هذا الكتاب. في الوقت نفسه، يوصى بزيارة هذا الموقع أكثر: HelloFlask - مكان تجميع موارد القارورة

3. نظرًا لانتهاء صلاحية الخادم، لا تحتوي هذه المدونة على وظيفة توضيحية. إذا قام أي شخص بنشرها عبر الإنترنت ويمكنه تقديم رابط توضيحي، سأكون ممتنًا للغاية. في الوقت الحالي، يرجى النقر على الرابط أدناه لمشاهدة عرض توضيحي وظيفي بسيط. استخدم Vue وFlask لإنشاء عرض وظيفة مدونة شخصية RESTful يفصل بين الأطراف الأمامية والخلفية_bilibili(゜-゜)つロCheers~-bilibili

4. للأسباب المذكورة هنا، لم يعد Flask-RESTful خيارًا جيدًا ربما يكون flask-restx وApiflask <التطوير الصيني> (ملاحظة: نظرًا لأن إطار العمل هذا قيد التطوير النشط، يرجى تقييمه بعناية عند استخدامه) بديل أكثر موثوقية. بديل جيد . إذا كنت بحاجة إلى التعلم، فمن المستحسن أيضًا الانتقال إلى ملحق يتم صيانته بشكل أكثر نشاطًا.

انتبه إلى التمييز بين الامتدادات والأطر، يرجى الرجوع إلى: يرجى عدم مقارنة Flask وFastAPI معًا |

نظرًا لأنه "يجب مقارنة FastAPI بإطار عمل Web API المبني على Flask"، ما هي كائنات المقارنة المناسبة؟ على الرغم من أن Flask-RESTX، وFlask-Rebar، وflask-apispec، وflask-smorest، وFlask-RESTful، وAPIFairy تحاول أن تكون أطر عمل، إلا أنها لا تزال امتدادات Flask من حيث التنفيذ المحدد.

التواصل

1. بالنسبة للمشكلات الفنية، يرجى محاولة استخدام المشكلات · imoyao/idealyard لطرح الأسئلة وتقديم المساعدة للمجتمع، راجع: الإصدار رقم 15 · imoyao/idealyard
2. تم إنشاء مجموعة QQ بناءً على اقتراح مستخدمي الإنترنت، رقم المجموعة: 613922612. لكن يرجى ملاحظة: هذا المشروع مفتوح المصدر تمامًا ولا أحقق أي ربح منه (لدي طوب خاص بي لأنقله)، ولا يمكن أن أكرس نفسي للإجابة على أسئلة الجميع في المستقبل المنظور. ولذلك، فإن الغرض من هذه المجموعة هو إنشاء قناة للمبتدئين للتواصل مع بعضهم البعض. إذا كان ذلك ممكنًا، ناقش مشكلتك في مكان عام بدلاً من مجرد إلقاء لقطات الشاشة وانتظار الإجابة.

يلاحظ

إذا لم يكن ذلك ضروريا، يرجى النظر بعناية في ما إذا كنت تريد الانضمام! انضم بعض الطلاب إلى المجموعة ثم غادروا المجموعة دون أن يقولوا كلمة واحدة. إن عملية التقديم للانضمام إلى المجموعة ثم مغادرة المجموعة ستسبب لي إزعاجًا غير ضروري.

3. كن ودودًا، كن ودودًا، كن ودودًا. الإنترنت هو الخيط، نعتز بهذا المصير. يرجى أن تكون لطيفًا ومخلصًا مع الطلاب الآخرين.

الشروط المسبقة

بايثون

3.6+

ماي إس كيو إل

mysql  Ver 14.14 Distrib 5.7.26, for linux-glibc2.12 (x86_64) using  EditLine wrapper

أو

ماريا دي بي

[root@python] # mysql --version
mysql  Ver 15.1 Distrib 5.5.64-MariaDB, for Linux (x86_64) using readline 5.1

إنشاء قاعدة بيانات

قاعدة بيانات وضع التطوير: iyblog_dev ، يمكنك تعديل التكوين هنا

 CREATE USER ' USERNAME '@ ' localhost ' IDENTIFIED BY ' PASSWORD ' ;
-- 如果需要支持emoji，则设置utf8mb4编码。否则使用utf-8编码即可
CREATE DATABASE DATABASENAME CHARSET = utf8mb4;
grant all privileges on DATABASENAME. * to USERNAME@localhost identified by ' PASSWORD ' ;
flush privileges;

تكوين البيئة

1. بعد الدخول إلى الدليل الحالي، قم أولاً بتثبيت حزمة إدارة Pipenv من خلال النقطة

   pip install pipenv [--user]

2. تثبيت تبعيات بايثون

   pipenv install 

3. تكوين متغيرات البيئة

   vi .flaskenv

4. قم بتحرير ملف dot.env، وقم بتكوين متغيرات البيئة وأعد تسميته إلى .env

   vi dot.env
   mv dot.env .env        # 参考 master 分支

الواجهة الأمامية

يرجى البحث عن البرامج التعليمية على الإنترنت لتثبيت وتغيير مصادر العقدة وnpm/yarn بنفسك.

تم توضيح جزء نشر الواجهة الأمامية باستخدام npm كأداة لإدارة الحزم. إذا كنت تستخدم yarn لإدارة الحزم، فيرجى تعديله بنفسك (إذا كنت تستخدم الغزل، فلن تجد package.json بالتأكيد).

لتكوين أمر الواجهة الأمامية، يرجى الرجوع إلى فصل scripts في front/package.json .

تثبيت التبعيات

npm install

وضع التطوير

1. قم بتعديل العنوان والمنفذ الذي تطلبه الواجهة الخلفية في ملف الواجهة الأمامية front/config/dev.env.js إلى عنوان API الفعلي
2. ابدأ الواجهة الأمامية

npm run dev

وضع الإنتاج

1. تبديل الدليل

 cd front

2. قم بتعيين عنوان BASE_API لبيئة prod

 // /idealyard/front/config/prod.env.js
module . exports = {
  NODE_ENV : '"production"' ,
  BASE_API : '"http://192.168.116.21:5000/api"'  // TODO:修改为真实API地址
}

3. اضبط router على وضع history

 // path: front/src/router/index.js:16

const router = new VueRouter ( {
  // https://router.vuejs.org/zh/guide/essentials/history-mode.html#html5-history-%E6%A8%A1%E5%BC%8F
  // mode: 'history',
  routes : [ ]
} )

4. بناء الملف

npm run build

يرجى الاطلاع على ملف document/deploy.md لمعرفة المزيد.

دعم عامل الميناء

يمر

المهام

نظرًا لضيق الوقت، لا تزال هناك بعض المشكلات التي لم يتم حلها، يرجى الاطلاع هنا للحصول على التفاصيل. إذا كان أي من الطلاب بحاجة إلى PR ، فيمكنك أيضًا الرجوع إلى المشكلات المعروفة التي لم يتم حلها وأوراق bug هنا.

أكثر

وبدلاً من النظر إلى مكان آخر، فمن الأفضل أن نقف جنباً إلى جنب هنا. للحصول على تكوين وضع التطوير وتعليماته، راجع المزيد من المستندات

نظرة عامة على الكود

تشير هنا بنية الدليل وإحصائيات حجم التعليمات البرمجية

نظرة عامة على الواجهة الأمامية

شكر وتقدير

بفضل تشجيع السيدة جي @Sabiner، خطرت لي فكرة كتابة مدونة شخصية. بدأ كل شيء منذ فترة ما بعد الظهر عندما مر تشيو تشوجي بقرية نيوجيا...

أشكر أيضًاLeiWong على الوقت الذي قضاه للمساعدة في العثور على bug وحل المشكلات عندما واجه مشكلات أثناء التطوير.

---

يجب أن يكون الإنسان قادرًا على تغيير الحفاضات، والتخطيط لغزو، وذبح خنزير، وقيادة سفينة، وتصميم مبنى، وكتابة قصيدة، وموازنة الحسابات، وبناء جدار، وتثبيت عظمة، وتعزية المحتضرين، وتلقي الأوامر، وإعطاء الأوامر. يأمر، يتعاون، يتصرف بمفرده، يحل المعادلات، يحلل مشكلة جديدة، يرمي السماد، يبرمج جهاز كمبيوتر، يطبخ وجبة لذيذة، يقاتل بكفاءة، يموت بشجاعة، التخصص للحشرات.

يجب أن يكون الرجل قادرًا على تغيير الحفاضات، والتخطيط للحرب، وقتل خنزير، والإبحار في سفينة، وتصميم منزل، وكتابة قصيدة، وتسوية حساب، وبناء جدار، وربط العظام المخلوعة، ومواساة رجل يحتضر، وإطاعة الأوامر، يصدرون الأوامر، ويعملون معًا، ويتصرفون بشكل مستقل، ويحلون المعادلات الرياضية، ويحللون المشكلات الجديدة، ويجرفون السماد، ويبرمجون الكمبيوتر، ويعدون وجبات لذيذة، ويجيدون القتال، ويموتون بشجاعة. تقتصر الحشرات فقط على فئة واحدة.

-- روبرت أنسون هاينلاين، "الوقت الكافي للحب"