منصة لتخزين وتنظيم المعلومات والتوثيق. يمكن العثور على تفاصيل BookStack على الموقع الرسمي على https://www.bookstackapp.com/.
تعليمات التثبيت
التوثيق
مثيل تجريبي
تسجيل دخول المشرف
لقطات الشاشة
مدونة بوكستاك
قائمة القضايا
دردشة الخلاف
خيارات الدعم
BookStack عبارة عن منصة توثيقية توفر تجربة ممتعة وبسيطة خارج الصندوق. يجب أن يجد المستخدمون الجدد للمثيل أن التجربة بديهية ويجب أن تكون مهارات معالجة النصوص الأساسية فقط مطلوبة للمشاركة في إنشاء محتوى على BookStack. يجب أن توفر المنصة ميزات طاقة متقدمة لأولئك الذين يرغبون فيها، ولكن لا ينبغي أن تتداخل مع تجربة المستخدم البسيطة الأساسية.
لم يتم تصميم BookStack كمنصة قابلة للتوسيع لاستخدامها لأغراض تختلف عن البيان أعلاه.
فيما يتعلق بفلسفة التطوير، فإن BookStack يتبع نهجًا مريحًا ومنفتحًا وإيجابيًا. في نهاية المطاف، هذا برنامج مجاني تم تطويره وصيانته بواسطة أشخاص يتبرعون بوقت فراغهم.
يمكنك قراءة المزيد عن المشروع وأصوله في الأسئلة الشائعة هنا.
يظهر أدناه رعاة المشروع البرونزي والفضي والذهبي. الشكر الكبير لهذه الشركات لدعم المشروع. ملاحظة: لا يتم اختبار الخدمات المدرجة أو فحصها أو دعمها بواسطة مشروع BookStack الرسمي بأي شكل من الأشكال.
تفاصيل التبرع للمشروع - صفحة رعاة GitHub - صفحة Ko-fi
يرجى الاطلاع على مستندات التطوير الخاصة بنا للحصول على التفاصيل الكاملة فيما يتعلق بالعمل على كود مصدر BookStack.
إذا كنت تتطلع فقط إلى تخصيص أو توسيع مثيل BookStack الخاص بك، فقم بإلقاء نظرة على صفحة وثائق Hacking BookStack للحصول على تفاصيل حول الخيارات المتنوعة لتحقيق ذلك دون تغيير كود مصدر BookStack.
يمكن العثور على تفاصيل حول نظام إصدار BookStack وعملية الإصدار العامة هنا.
تتم إدارة ترجمات النص داخل BookStack من خلال مشروع BookStack على Crowdin. تحتوي بعض السلاسل على متغيرات مسبوقة بنقطتين مثل :userName
. اترك هذه القيم كما هي حيث سيتم استبدالها في وقت التشغيل.
الرجاء استخدام Crowdin للمساهمة في الترجمات بدلاً من فتح طلب السحب. يمكن أن تكون الترجمات الموجودة في قاعدة التعليمات البرمجية العاملة قديمة، ويمكن أن يؤدي الدمج عبر التعليمات البرمجية إلى حدوث تعارضات ومشكلات في المزامنة. إذا لم تتمكن من استخدام Crowdin لسبب ما، فلا تتردد في فتح مشكلة لمناقشة الخيارات البديلة.
إذا كنت ترغب في إضافة لغة جديدة إلى Crowdin، لكي تتمكن من توفير الترجمات لها، يرجى فتح إصدار جديد هنا.
يرجى ملاحظة أنه يتم توفير الترجمات في BookStack إلى "ذاكرة الترجمة العالمية Crowdin" التي تساعد BookStack والمشاريع الأخرى في العثور على الترجمات. إذا لم تكن راضيًا عن المساهمة في هذا، فلا يُنصح بتقديم الترجمات إلى BookStack، حتى يدويًا عبر GitHub.
لا تتردد في إنشاء مشكلات لطلب ميزات جديدة أو للإبلاغ عن الأخطاء والمشكلات. فقط يرجى اتباع النموذج المقدم عند إنشاء المشكلة.
نرحب بطلبات السحب، ولكن ما لم يكن هناك تعديل بسيط، فقد يكون من الأفضل فتح طلب السحب مبكرًا أو إنشاء مشكلة للتغيير المقصود لمناقشة كيفية ملاءمته للمشروع والتخطيط للدمج. لا يعني مجرد وجود طلب ميزة أو تم وضع علامة عليه أنه سيتم قبول هذه الميزة في المشروع الأساسي.
يجب إنشاء طلبات السحب من فرع development
حيث سيتم دمجها مرة أخرى في development
بمجرد الانتهاء منها. يرجى عدم البناء من فرع release
أو طلب الدمج فيه لأن هذا مخصص لنشر الإصدارات فقط. إذا كنت تتطلع إلى تغيير محتوى CSS أو JavaScript، فيرجى تعديل الملفات المصدر الموجودة في resources/
. يتم إنشاء أي ملفات CSS أو JS ضمن الملفات public
من هذه الملفات المصدر وبالتالي لا ينبغي تحريرها مباشرة.
يمكن العثور على مدونة قواعد السلوك الخاصة بالمشروع هنا.
يمكن العثور على معلومات الأمان لإدارة مثيل BookStack على موقع التوثيق هنا.
إذا كنت ترغب في أن يتم إعلامك بالمخاوف الأمنية المحتملة الجديدة، فيمكنك الاشتراك في القائمة البريدية الأمنية لـ BookStack.
إذا كنت ترغب في الإبلاغ عن مخاوف أمنية، يمكنك العثور على تفاصيل القيام بذلك هنا.
نريد أن يظل BookStack في متناول أكبر عدد ممكن من الأشخاص. نحن نهدف إلى تحقيق معايير WCAG 2.1 المستوى A على الأقل حيثما أمكن ذلك على الرغم من أننا لا نختبر ذلك بدقة عند كل إصدار. إذا واجهت أي مشكلات تتعلق بإمكانية الوصول، فلا تتردد في فتح مشكلة.
يمكن العثور على موقع الويب الذي يحتوي على مستندات المشروع والمدونة في BookStackApp/website repo.
يتم توفير مصدر BookStack بموجب ترخيص MIT.
يتم توفير المكتبات المستخدمة بواسطة BookStack والمضمنة معها بموجب تراخيصها وحقوق الطبع والنشر الخاصة بها. يمكن العثور على تراخيص العديد من التبعيات الأساسية لدينا في قائمة الإسناد أدناه ولكن هذه ليست قائمة شاملة لجميع المشاريع المستخدمة في BookStack.
يمكن رؤية الأشخاص العظماء الذين عملوا على إنشاء BookStack وتحسينه هنا. يمكن رؤية الأشخاص الرائعين الذين قدموا الترجمات، سواء من خلال GitHub أو عبر Crowdin هنا.
فيما يلي المشاريع الرائعة مفتوحة المصدر المستخدمة للمساعدة في بناء BookStack. ملاحظة: هذه ليست قائمة شاملة لجميع المكتبات والمشاريع التي سيتم استخدامها في مثيل BookStack النشط.
لارافيل - معهد ماساتشوستس للتكنولوجيا
تايني إم سي إي - معهد ماساتشوستس للتكنولوجيا
معجمي - معهد ماساتشوستس للتكنولوجيا
كود ميرور - معهد ماساتشوستس للتكنولوجيا
قابل للفرز - معهد ماساتشوستس للتكنولوجيا
أيقونات المواد جوجل - أباتشي-2.0
قوائم المهام وقوائم المهام - معهد ماساتشوستس للتكنولوجيا ومركز الدراسات الدولي
دومبدف - LGPL v2.1
KnpLabs/snappy - معهد ماساتشوستس للتكنولوجيا
WKHTMLtoPDF - LGPL v3.0
Diagrams.net - شروط الإصدار المضمن / المشروع المصدر - Apache-2.0
مجموعة أدوات SAML PHP الخاصة بـ OneLogin - معهد ماساتشوستس للتكنولوجيا
الدوري/المارك العام - BSD-3-بند
الدوري/Flysystem - معهد ماساتشوستس للتكنولوجيا
League/html-to-markdown - معهد ماساتشوستس للتكنولوجيا
League/oauth2-client - معهد ماساتشوستس للتكنولوجيا
pragmarx/google2fa - معهد ماساتشوستس للتكنولوجيا
لحم الخنزير المقدد/لحم الخنزير المقددQrCode - BSD-2-بند
فبسيكليب - معهد ماساتشوستس للتكنولوجيا
الساعة - معهد ماساتشوستس للتكنولوجيا
PHPStan ولاراستان - معهد ماساتشوستس للتكنولوجيا ومعهد ماساتشوستس للتكنولوجيا
PHP_CodeSniffer - فقرة BSD 3
جيك أرشيبالد/IDB-Keyval - أباتشي-2.0
للحصول على تفاصيل تفصيلية لمشروعات JavaScript وPHP التي تم استيرادها واستخدامها عبر مديري حزم NPM & Composer، بالإضافة إلى تراخيصهم، يرجى الاطلاع على تراخيص dev/licensing/js-library-licenses.txt وdev/licensing/php-library-licenses. ملفات تكست.