Pico
2.1.4
Pico عبارة عن ملف CMS بسيط وسريع للغاية ومسطح.
تفضل بزيارتنا على http://picocms.org/ وراجع http://picocms.org/about/ لمزيد من المعلومات.
رؤية Unparenthesized a ? b : c ? d : e is not supported. خطأ؟
تواجه Pico حاليًا مشكلات مع إصدارات PHP الأحدث من 8.0. ويرجع ذلك إلى تبعيات بيكو، وليس بيكو نفسه. يوجد حاليًا إصدار "ألفا" من Pico يمكنك تنزيله كإصدار مُجمَّع مسبقًا يعمل على حل هذه المشكلة.
هذا "alpha" آمن تمامًا للاستخدام في الإنتاج، حيث أن التغييرات الوحيدة هي التبعيات المحدثة وسلاسل أرقام الإصدار . إذا كنت فضوليًا، يمكنك تأكيد ذلك عن طريق مقارنة التغييرات بين الفروع.
كان من المقرر القيام بالمزيد من العمل في هذا الفرع، ومن هنا جاءت التسمية "3.0"، لكن ذلك لم يحدث بعد. هناك نقاش مستمر حول دمج هذه التبعيات المحدثة كتحديث رسمي (إما Pico 2.2 أو 3.0) في أقرب وقت ممكن.
آسف على الإزعاج، وشكرا لجميع مستخدمي بيكو على صبركم بشأن هذه المسألة.
يعد تثبيت Pico أمرًا بسيطًا للغاية - ويتم تنفيذه في ثوانٍ! إذا كان لديك حق الوصول إلى Shell على الخادم الخاص بك (أي الوصول إلى SSH)، فنوصي باستخدام Composer. إذا لم يكن الأمر كذلك، فاستخدم إصدارًا مُجمَّعًا مسبقًا. إذا كنت لا تعرف ما هو "الوصول إلى SSH"، فانتقل إلى الإصدار المُجمّع مسبقًا.
يتطلب Pico PHP 5.3.6+ وتفعيل ملحقات PHP dom و mbstring .
بدءًا من Pico 2.0، نوصي بتثبيت Pico باستخدام Composer كلما أمكن ذلك. ثق بنا، فلن تندم عندما يتعلق الأمر بترقية Pico! على أي حال، إذا كنت لا ترغب في استخدام Composer، أو إذا كنت ببساطة لا تستطيع استخدام Composer لأنه لا يمكنك الوصول إلى Shell على الخادم الخاص بك، فلا تيأس، فلا يزال تثبيت Pico باستخدام إصدار مُجمَّع مسبقًا أمرًا ضروريًا. أسهل من كل ما تعرفه!
افتح Shell وانتقل إلى دليل httpdocs (على سبيل المثال /var/www/html ) الخاص بخادمك. قم بتنزيل Composer وتشغيله باستخدام خيار create-project لتثبيته على الدليل المطلوب (على سبيل المثال /var/www/html/pico ):
$ الضفيرة -sSL https://getcomposer.org/installer | PHP $ PHP Composer.Phar إنشاء مشروع picocms/pico-composer pico
ما الخطوة الثانية؟ ليس هناك خطوة ثانية. هذا كل شيء! افتح متصفح الويب المفضل لديك وانتقل إلى ملف CMS الجديد والبسيط والسريع للغاية والمسطح! سوف تشرح محتويات نموذج Pico كيفية إنشاء المحتويات الخاصة بك.
هل تعرف الشعور: تريد تثبيت موقع ويب جديد، لذا تقوم بتحميل جميع ملفات نظام إدارة المحتوى (CMS) المفضل لديك وتشغيل البرنامج النصي للإعداد - فقط لتكتشف أنك نسيت إنشاء قاعدة بيانات SQL أولاً؟ يخبرك برنامج الإعداد لاحقًا أن أذونات الملف خاطئة. تبا، ماذا يعني هذا حتى؟ انس الأمر، بيكو مختلف!
قم بتنزيل أحدث إصدار من Pico وقم بتحميل جميع الملفات إلى دليل التثبيت المطلوب لـ Pico ضمن دليل httpdocs (على سبيل المثال /var/www/html/pico ) الخاص بخادمك.
حسنًا، إليك المشكلة: لا يوجد مشكلة. هذا كل شيء! افتح متصفح الويب المفضل لديك وانتقل إلى ملف CMS الجديد والبسيط والسريع للغاية والمسطح! سوف تشرح محتويات نموذج Pico كيفية إنشاء المحتويات الخاصة بك.
يعد Git نظامًا قويًا للغاية للتحكم في الإصدار الموزع - ويمكن استخدامه لإنشاء سير عمل جيد حول موقع Pico الخاص بك. يساعد استخدام مستودع Git لموقعك على الويب في إنشاء المحتوى ونشره، بما في ذلك التحرير التعاوني والتحكم في الإصدار. إذا كنت تريد إدارة موقع الويب الخاص بك في مستودع Git، فإنك تستخدم التثبيت المستند إلى Composer.
مشروع Fork Pico's Composer المبدئي باستخدام زر شوكة GitHub. إذا كنت لا ترغب في استخدام GitHub، فليس مطلوبًا منك ذلك، يمكنك اختيار أي خادم Git تريده. يتطلب التفرع يدويًا بعض الخطوات الإضافية: أولاً، قم باستنساخ مستودع Git محليًا، وأضف خادم Git كجهاز تحكم عن بعد وادفع المستودع إلى جهاز التحكم عن بعد الجديد هذا.
انسخ شوكتك محليًا وأضف محتوياتك وأصولك. يمكنك تعديل composer.json الخاص بـ Pico ليشمل المكونات الإضافية والموضوعات التابعة لجهات خارجية، أو ببساطة قم بإضافة المكونات الإضافية والموضوعات الخاصة بك إلى قائمة plugins الخاصة بـ Pico. أدلة themes . لا تنسَ الالتزام بالتغييرات التي أجريتها وإرسالها إلى خادم Git الخاص بك.
افتح Shell على خادم الويب الخاص بك وانتقل إلى دليل httpdocs (على سبيل المثال /var/www/html ). قم بتنزيل Composer، وقم باستنساخ مستودع Git الخاص بك إلى الدليل المطلوب (على سبيل المثال /var/www/html/pico ) وتثبيت تبعيات Pico باستخدام خيار install Composer:
$ الضفيرة -sSL https://getcomposer.org/installer | PHP $ git clone https://github.com/<YOUR_USERNAME>/<YOUR_REPOSITORY> بيكو $ php Composer.phar --working-dir=pico install
إذا قمت بتحديث محتويات موقع الويب الخاص بك، فما عليك سوى تنفيذ التغييرات وإرسالها إلى خادم Git الخاص بك. افتح Shell على خادم الويب الخاص بك وانتقل إلى دليل تثبيت Pico داخل دليل httpdocs (على سبيل المثال /var/www/html/pico ) الخاص بخادمك. اسحب جميع التغييرات من خادم Git الخاص بك وقم بتحديث تبعيات Pico باستخدام خيار update Composer:
$ جيت سحب $ تحديث PHP Composer.Phar
إذًا، أنت واحد من هؤلاء الأشخاص الرائعين الذين يجعلون كل هذا ممكنًا؟ نحن نحبكم يا رفاق! كمطور، نوصيك باستنساخ مستودع Pico's Git بالإضافة إلى مستودعات Git الخاصة بسمة Pico الافتراضية والمكون الإضافي PicoDeprecated . يمكنك إعداد مساحة العمل الخاصة بك باستخدام مشروع Pico's Composer المبدئي وتضمين جميع مكونات Pico باستخدام الحزم المحلية.
يختلف استخدام مستودعات Pico's Git عن استخدام إحدى طرق التثبيت الموضحة أعلاه. فهو يوفر لك إصدار التطوير الحالي من Pico، وهو على الأرجح غير مستقر وغير جاهز للاستخدام الإنتاجي !
افتح Shell وانتقل إلى الدليل المطلوب لمساحة عمل تطوير Pico داخل دليل httpdocs (على سبيل المثال /var/www/html/pico ) لخادمك. قم بتنزيل واستخراج مشروع Pico's Composer المبدئي في دليل workspace :
$ الضفيرة -sSL https://github.com/picocms/pico-composer/archive/master.tar.gz | القطران XZ مساحة عمل $ mv pico-composer-master
انسخ مستودعات Git لجميع مكونات Pico (نواة Pico وموضوع Pico الافتراضي والمكون الإضافي PicoDeprecated ) في دليل components :
مكونات $mkdir استنساخ $ git https://github.com/picocms/Pico.git Components/pico استنساخ $ git https://github.com/picocms/pico-theme.gitمكونات/pico-theme استنساخ $ git https://github.com/picocms/pico-deprecated.git Components/pico-deprecated
قم بتوجيه الملحن لاستخدام مستودعات Git المحلية كبديل لحزم picocms/pico (الأساسية لـ Pico)، و picocms/pico-theme (الموضوع الافتراضي لـ Pico) وحزم picocms/pico-deprecated (المكون الإضافي PicoDeprecated ). قم بتحديث composer.json لمساحة عمل التطوير الخاصة بك (أي workspace/composer.json ) وفقًا لذلك:
{"المستودعات": [
{"نوع": "المسار"، "url": "../components/pico"، "options": { "symlink": true }
},
{"نوع": "path"، "url": "../components/pico-theme"، "options": { "symlink": true }
},
{"نوع": "path"، "url": "../components/pico-deprecated"، "options": { "symlink": true }
}
],"require": {"picocms/pico": "dev-master"، "picocms/pico-theme": "dev-master"، "picocms/pico-deprecated": "dev-master"، "picocms/" مُثبت الملحن": "^1.0"}
} قم بتنزيل Composer وتشغيله باستخدام خيار install :
$ الضفيرة -sSL https://getcomposer.org/installer | PHP $ php Composer.phar --working-dir=تثبيت مساحة العمل
يمكنك الآن فتح متصفح الويب الخاص بك والانتقال إلى مساحة عمل تطوير Pico. جميع التغييرات التي تجريها على مكونات Pico سوف تنعكس تلقائيًا في مساحة عمل التطوير.
بالمناسبة، يمكنك أيضًا العثور على جميع مكونات Pico على Packagist.org: جوهر Pico، والموضوع الافتراضي لـ Pico، والمكون الإضافي PicoDeprecated ومشروع Pico’s Composer المبدئي.
هل تتذكر عندما قمت بتثبيت بيكو؟ لقد كانت بسيطة ببراعة، أليس كذلك؟ ترقية بيكو لا يوجد فرق! تختلف عملية الترقية اعتمادًا على ما إذا كنت استخدمت Composer أو إصدارًا مُجمَّعًا مسبقًا لتثبيت Pico. يرجى ملاحظة أنه يجب عليك دائمًا إنشاء نسخة احتياطية من تثبيت Pico الخاص بك قبل الترقية!
يتبع Pico الإصدار Semantic Versioning 2.0 ويستخدم أرقام الإصدارات مثل MAJOR . MINOR . PATCH . عندما نقوم بتحديث إصدار PATCH (على سبيل المثال 2.0.0 إلى 2.0.1 )، قمنا بإجراء إصلاحات للأخطاء متوافقة مع الإصدارات السابقة. إذا قمنا بتغيير الإصدار MINOR (على سبيل المثال 2.0 إلى 2.1 )، فقد أضفنا وظائف بطريقة متوافقة مع الإصدارات السابقة. إن ترقية Pico أمر بسيط جدًا في كلتا الحالتين. ما عليك سوى التوجه إلى أقسام الترقية المناسبة أدناه.
لكن مهلا، لقد نسينا أن نذكر ما يحدث عندما نقوم بتحديث الإصدار MAJOR (على سبيل المثال 2.0 إلى 3.0 ). في هذه الحالة قمنا بإجراء تغييرات غير متوافقة على واجهة برمجة التطبيقات. وسنقدم بعد ذلك برنامجًا تعليميًا مناسبًا للترقية، لذا يرجى التوجه إلى صفحة "الترقية" على موقعنا الإلكتروني.
تعد ترقية Pico أمرًا بسيطًا للغاية إذا كنت قد استخدمت Composer لتثبيت Pico. ما عليك سوى فتح الصدفة والانتقال إلى دليل تثبيت Pico داخل دليل httpdocs (على سبيل المثال /var/www/html/pico ) الخاص بخادمك. يمكنك الآن ترقية Pico باستخدام أمر واحد فقط:
$ تحديث PHP Composer.Phar
هذا كل شيء! سيقوم Composer تلقائيًا بتحديث Pico وجميع المكونات الإضافية والسمات التي قمت بتثبيتها باستخدام Composer. يرجى التأكد من تحديث جميع المكونات الإضافية والموضوعات التي قمت بتثبيتها يدويًا.
حسنًا، كان تثبيت Pico أمرًا سهلاً، لكن ترقية Pico ستكون صعبة، أليس كذلك؟ أخشى أنني يجب أن أخيب ظنك. الأمر بسيط مثل تثبيت Pico!
سيتعين عليك أولاً حذف دليل vendor الخاص بتثبيت Pico (على سبيل المثال، إذا قمت بتثبيت Pico على /var/www/html/pico ، فاحذف /var/www/html/pico/vendor ). ثم قم بتنزيل أحدث إصدار من Pico وقم بتحميل جميع الملفات إلى دليل تثبيت Pico الموجود لديك. سيُطلب منك ما إذا كنت تريد الكتابة فوق ملفات مثل index.php أو .htaccess أو ... - ما عليك سوى الضغط على "Yes".
هذا كل شيء! الآن بعد أن تم تحديث Pico، تحتاج إلى تحديث جميع المكونات الإضافية والموضوعات التي قمت بتثبيتها.
كمطور، يجب أن تعرف كيفية البقاء على اطلاع دائم... ومن أجل الاكتمال، إذا كنت تريد ترقية Pico، فما عليك سوى فتح Shell والانتقال إلى مساحة عمل تطوير Pico (على سبيل المثال /var/www/html/pico ). ثم اسحب أحدث الالتزامات من مستودعات Git الخاصة بـ Pico الأساسية والموضوع الافتراضي لـ Pico والمكون الإضافي PicoDeprecated . اسمح لـ Composer بتحديث تبعياتك وستكون جاهزًا للبدء.
مكونات $ git -C/سحب بيكو مكونات $ git -C/سحب موضوع بيكو مكونات $ git -C/سحب مهمل بيكو $ php Composer.phar --working-dir=تحديث مساحة العمل
إذا كنت تريد البدء في استخدام Pico، فيرجى الرجوع إلى مستندات المستخدم الخاصة بنا. يرجى قراءة ملاحظات الترقية إذا كنت تريد الترقية من Pico 1.0 إلى Pico 2.0. يمكنك العثور على المكونات الإضافية والموضوعات المدعومة رسميًا على موقعنا. يمكن العثور على خيار أكبر من المكونات الإضافية والموضوعات التابعة لجهات خارجية في Wiki الخاص بنا على صفحات المكونات الإضافية أو السمات على التوالي. إذا كنت تريد إنشاء مكون إضافي أو سمة خاصة بك، فيرجى الرجوع إلى قسم "الحصول على المساعدة كمطور" أدناه.
إذا كنت مطورًا، فيرجى الرجوع إلى قسم "المساهمة" أدناه وإرشادات المساهمة الخاصة بنا. للبدء في إنشاء مكون إضافي أو سمة، يرجى قراءة مستندات المطور على موقعنا.
عندما لا تتمكن المستندات من الإجابة على سؤالك، يمكنك الحصول على المساعدة من خلال الانضمام إلينا على #picocms على Libera.Chat (السجلات). عندما تواجه مشكلات مع Pico، من فضلك لا تتردد في إنشاء إصدار جديد على GitHub. فيما يتعلق بمشكلات المكونات الإضافية أو السمات، يرجى الرجوع إلى موقع الويب الخاص بمطور هذا المكون الإضافي أو السمة.
قبل إنشاء مشكلة جديدة، يرجى التأكد من عدم الإبلاغ عن المشكلة بعد باستخدام محرك بحث GitHubs. يرجى وصف مشكلتك بأكبر قدر ممكن من الوضوح، مع تضمين إصدار Pico الذي تستخدمه دائمًا. بشرط أنك تستخدم المكونات الإضافية ، قم بتضمين قائمة بها أيضًا. نحتاج إلى معلومات حول السلوك الفعلي والمتوقع ، وخطوات إعادة إنتاج المشكلة، والخطوات التي اتخذتها لحل المشكلة بنفسك (أي استكشاف الأخطاء وإصلاحها بنفسك ).
هل تريد المساهمة في بيكو؟ نحن نقدر ذلك حقًا! يمكنك المساعدة في تحسين Pico من خلال المساهمة بالرمز أو الإبلاغ عن المشكلات، ولكن يرجى ملاحظة إرشادات المساهمة الخاصة بنا. بشكل عام، يمكنك المساهمة في ثلاثة مجالات مختلفة:
المكونات الإضافية والسمات: هل أنت مطور مكونات إضافية أو مصمم سمات؟ نحن نحبكم يا رفاق! يمكنك العثور على الكثير من المعلومات حول كيفية تطوير المكونات الإضافية والموضوعات على http://picocms.org/development/. إذا قمت بإنشاء مكون إضافي أو سمة، فيرجى إضافتها إلى Wiki الخاص بنا، إما على صفحة المكونات الإضافية أو السمات. يمكنك أيضًا إرساله إلى موقعنا على الويب، حيث سيتم عرضه على المكوّن الإضافي أو صفحات السمات الرسمية!
التوثيق: نحن نقدر دائمًا الأشخاص الذين يقومون بتحسين وثائقنا. يمكنك إما تحسين مستندات المستخدم المضمنة أو مستندات المستخدم الأكثر شمولاً على موقعنا. يمكنك أيضًا تحسين المستندات لمطوري المكونات الإضافية والموضوعات. ما عليك سوى تفرع مستودع Git الخاص بموقعنا على الويب من https://github.com/picocms/picocms.github.io، وتغيير ملفات Markdown وفتح طلب سحب.
نواة بيكو: الانضباط الأسمى هو العمل على نواة بيكو. من المفترض أن تساعد مساهمتك كل مستخدم لـ Pico في الحصول على تجربة أفضل مع Pico. إذا كانت هذه هي الحالة، فافصل Pico من https://github.com/picocms/Pico وافتح طلب سحب. ونحن نتطلع إلى مساهمتك!
من خلال المساهمة في Pico، فإنك تقبل وتوافق على شهادة منشأ المطور لمساهماتك الحالية والمستقبلية المقدمة إلى Pico. يرجى الرجوع إلى قسم "شهادة المنشأ للمطور" في CONTRIBUTING.md .
ليس لديك الوقت للمساهمة بالرمز في Pico، ولكنك لا تزال تريد "تناول القهوة" لمن يفعل ذلك؟ يمكنك المساهمة نقدًا في Pico باستخدام Bountysource، وهو موقع تمويل جماعي يركز على المشكلات الفردية وطلبات الميزات. ما عليك سوى الرجوع إلى قسم "المنح وجمع التبرعات" أدناه لمزيد من المعلومات.
يستخدم Pico Bountysource للسماح بالمساهمات المالية في المشروع. Bountysource هو موقع تمويل جماعي يركز على القضايا الفردية وطلبات الميزات في المشاريع مفتوحة المصدر باستخدام الدفع المصغر. يمكن للمستخدمين، أو "الداعمين"، التعهد بالمال لإصلاح مشكلة معينة، أو تنفيذ ميزات جديدة، أو تطوير مكون إضافي أو سمة جديدة. يمكن لمطوري البرامج مفتوحة المصدر، أو "Bounty Hunters"، التقاط هذه المهام وحلها لكسب المال.
من الواضح أن هذا لن يسمح للمطور باستبدال وظيفة بدوام كامل، بل يهدف بالأحرى إلى "الوقوف لتناول القهوة". ومع ذلك، فهو يساعد على التقريب بين المستخدمين والمطورين، ويظهر للمطورين ما يريده المستخدمون ومدى اهتمامهم بأشياء معينة. ومع ذلك، لا يزال بإمكانك التبرع بالمال للمشروع نفسه، كطريقة سهلة لقول "شكرًا لك" ودعم بيكو.
إذا كنت ترغب في تشجيع المطورين على إصلاح مشكلة معينة أو تنفيذ ميزة ما، فما عليك سوى التعهد بمكافأة جديدة أو دعم مكافأة موجودة.
كمطور، يمكنك الحصول على مكافأة بمجرد المساهمة في Pico (يرجى الرجوع إلى قسم "المساهمة" أعلاه). ليس من الضروري أن تكون مساهمًا رسميًا في Pico! بيكو هو مشروع مفتوح المصدر، يمكن لأي شخص فتح طلبات السحب والمطالبة بالمكافآت.
لن يطالب المساهمون الرسميون في Pico بالمكافآت نيابة عنهم، ولن تحصل Pico أبدًا على أي أموال من Bountysource. يتم استخدام جميع الأموال التي جمعتها بيكو للتعهد بمنح جديدة أو لدعم المشاريع التي يعتمد عليها بيكو.
