منصوبے کے بارے میں

Etherpad ایک ریئل ٹائم تعاونی دستاویز ایڈیٹر ہے جو ان دستاویزات کے لیے ڈیزائن کیا گیا ہے جہاں تصنیف اور تاریخ اہمیت رکھتی ہے۔ اسے 2009 سے ایک چھوٹی رضاکار ٹیم نے برقرار رکھا ہے اور Apache License v2 کے تحت جاری کیا گیا ہے۔ README میں بیان کردہ بنیادی صلاحیتیں: - ریئل ٹائم تعاونی تدوین جس میں ہر کی اسٹروک اس کے مصنف سے منسوب ہے اور مصنف کے رنگ ان لائن دکھائے گئے ہیں۔ - مکمل نظرثانی کی تاریخ محفوظ ہے، جس میں دستاویز کی تاریخ کو حرف بہ حرف اسکرَب کرنے کے لیے ٹائم سلائیڈر موجود ہے۔ - بلٹ ان مکمل ڈیٹا ایکسپورٹ، تاکہ دستاویز کی تاریخ آپریٹر کے لیے قابل رسائی رہے۔ - خود میزبان آپریشن: پروجیکٹ بیان کرتا ہے کہ کوئی ٹیلی میٹری اور کوئی اپ سیل نہیں ہے، اور AI فعالیت پلگ انز کے ذریعے آپٹ ان ہے جو آپریٹر کی پسند کے ماڈل کی طرف اشارہ کرتی ہے۔ ایک PRIVACY.md دستاویز دو آپٹ آؤٹ نیٹ ورک کالز بیان کرتی ہے جو Etherpad کے اپنے کوڈ کے ذریعے کی جاتی ہیں۔ - اسکیل ایبلٹی کا دعوی: پروجیکٹ ایک اسکیل ٹیسٹ صفحہ سے لنک کرتا ہے جو فی پیڈ ہزاروں بیک وقت ایڈیٹرز کے لیے سپورٹ ظاہر کرتا ہے۔ - بین الاقوامی کاری: 105 زبانوں میں ترجمہ شدہ، زیادہ تر TranslateWiki کے ذریعے۔ - توسیع پذیری: ایک پلگ ان فریم ورک جس میں سینکڑوں پلگ انز پلگ ان سائٹ کے ذریعے دستیاب ہیں، ایڈمن ویب انٹرفیس یا کمانڈ لائن سے انسٹال کیے جا سکتے ہیں۔ - ایمبیڈ ایبلٹی: پیڈز، صارفین اور گروپس کے انتظام کے لیے ایک HTTP API، جس میں /api/openapi.json پر OpenAPI تعریفیں ظاہر ہوتی ہیں، نیز ویب سائٹس میں پیڈز ایمبیڈ کرنے کے لیے ایک jQuery پلگ ان۔ README میں شامل انسٹالیشن کے اختیارات: - macOS/Linux/WSL (شیل) اور Windows (PowerShell) کے لیے ایک لائن انسٹالرز، جو ریپوزٹری کلون کرتے ہیں، انحصار انسٹال کرتے ہیں اور فرنٹ اینڈ بناتے ہیں۔ Node.js >= 24 اور git درکار ہیں۔ ایک ماحولیاتی متغیر ایک قدم میں انسٹال اور شروع کرنے کے لیے سیٹ کیا جا سکتا ہے۔ - Docker Compose مثال جو Docker Hub اور GitHub Container Registry پر شائع شدہ سرکاری تصویر استعمال کرتی ہے، جس میں PostgreSQL سروس، پلگ انز اور var ڈیٹا کے لیے مستقل والیوم، اور ایڈمن پاس ورڈ، ڈیٹا بیس کنکشن اور دیگر ترتیبات کے لیے ماحولیاتی متغیرات شامل ہیں۔ - دستی اقدامات: pnpm انسٹال کریں، ریپوزٹری کلون کریں، pnpm i چلائیں، pnpm run build:etherpad، پھر pnpm run prod، اور localhost:9001 دیکھیں۔ ترتیب اور انتظام: - ترتیبات settings.json میں رہتی ہیں، متبادل ترتیبات فائلوں، اسناد اوور رائڈز، API کلید اور سیشن کلید فائلوں، اور ${ENV_VAR} یا ${ENV_VAR:default_value} نحو کا استعمال کرتے ہوئے ماحولیاتی متغیر متبادل کے لیے سپورٹ کے ساتھ۔ - ترتیبات /admin ویب انٹرفیس کے ذریعے بھی تبدیل کی جا سکتی ہیں۔ - README پروڈکشن میں MySQL یا PostgreSQL جیسے مخصوص ڈیٹا بیس استعمال کرنے کا مشورہ دیتا ہے، نوٹ کرتے ہوئے کہ dirtyDB ڈرائیور صرف جانچ یا ترقی کے لیے ہے۔ - تصدیق کے لیے، یہ سادہ متن کے پاس ورڈ کے بجائے ہیشز ذخیرہ کرنے کی سفارش کرتا ہے، اور ep_hash_auth پلگ ان کی طرف اشارہ کرتا ہے۔ - OpenID Connect تصدیق کے لیے تجویز کردہ پلگ انز میں ep_openid_connect، ep_guest، ep_user_displayname اور ep_stable_authorid شامل ہیں۔ - بھرپور تدوین خصوصیات کے لیے تجویز کردہ پلگ ان سیٹ میں ep_align، ep_comments_page، ep_embedded_hyperlinks2، ep_font_color، ep_headings2، ep_markdown اور ep_webrtc شامل ہیں۔ - سکن مختلف حالتوں کو skinvariantsbuilder URL کے ذریعے دریافت کیا جا سکتا ہے۔ ترقی اور پروجیکٹ کی حیثیت: - bin/debugRun.sh کے ذریعے ڈیبگنگ اور ایک تیز اسٹارٹ اسکرپٹ bin/fastRun.sh جو انحصار اپ ڈیٹس کو چھوڑ دیتا ہے۔ - ریئل ٹائم رویے کی بنیاد رکھنے والی Easysync لائبریری ریپوزٹری میں ایک PDF میں دستاویز شدہ ہے۔ - تعاون کنندہ رہنما خطوط CONTRIBUTING.md میں فراہم کیے گئے ہیں۔ - README بیان کرتا ہے کہ پروجیکٹ فعال طور پر Node.js، ریئل ٹائم سسٹمز یا ادارہ جاتی تعاون ٹولنگ میں تجربہ رکھنے والے مینٹینرز کی تلاش میں ہے۔ - CI بیجز کوڈ کوالٹی (CodeQL)، بیک اینڈ ٹیسٹ، نقلی بوجھ، ریٹ لمیٹنگ، Docker، اور فرنٹ اینڈ/ایڈمن ٹیسٹ کا احاطہ کرتے ہیں۔ بیان کردہ صارفین میں Wikimedia Foundation، EU میں عوامی شعبے کے ادارے، یونیورسٹیاں اور اسکول، شہری ٹیک اور مشاورتی جمہوریت کے منصوبے، نیوز رومز، اور بہت سے خود میزبان ادارے شامل ہیں۔ سافٹ ویئر آزمانے کے لیے ایک عوامی مثال دستیاب ہے۔ سپورٹ چینلز GitHub مسائل، ایک Discord سرور، اور ذمہ دار کمزوری انکشاف کے لیے ای میل رابطے ہیں۔