تخطَّ إلى المحتوى
تسجيل الدخولاطلب حساب

البداية السريعة

هذا أقصر طريق من الصفر إلى تقرير حقيقي في واردك. بعد ما ينفتح حسابك، الخطوات تحت تاخذ حوالي خمس دقائق. كل خطوة تحت شي تسوّيه فعلاً اليوم. ما فيه شي هنا «قريباً».

  1. سجّل دخولك على app.umarker.com. تنزل على المساحات، وهي شبكة مساحاتك. فيه مساحة اسمها General أُنشئت لك؛ افتحها.

  2. تحقّق من بريدك. فيه بانر بأعلى اللوحة يطلب منك كذا، وله سبب: نشر المشروع ودعوة زميل، الاثنان يحتاجان بريداً مُتحقَّقاً منه. افتح الرابط اللي أرسله لك uMarker، وارجع. البانر يختفي.

الخطوة 1: أنشئ مشروعاً وخلّه يجمع

Section titled “الخطوة 1: أنشئ مشروعاً وخلّه يجمع”

المشروع = موقع واحد تجمع عليه الملاحظات. إنشاؤه يبي اسماً بس، والباقي شاشتان.

  1. المشاريع ← مشروع جديد. اكتب له اسماً (تقدر تكتبه باللغتين) وأنشئه. وuMarker يسكّ المفتاح العام للمشروع (md_…) على طول.

  2. افتح المشروع ← الودجت ← الإعداد. أضف موقعك تحت النطاقات المسموحة. ولو كنت تجرّب محلياً، localhost مدخَل صالح. هذي القائمة حدّ أمان مو راحة: قائمة فاضية تعني إن الودجت ما يشتغل بأي مكان، وهذا مقصود، وuMarker يرفض ينشر المشروع بلا نطاق حيّ.

  3. انشر. استخدم زرّ نشر في ترويسة المشروع (أو على صفّ المشروع في القائمة). الشارة تنقلب من مسودّة إلى منشور، وهذا هو المفتاح اللي يخلّي الودجت مباشراً. ولو تخطّيت النطاق، النشر يُرفَض ويقول لك السبب.

السنيبت هو المسار السريع: وسم <script> واحد، وزوّارك ما يركّبون ولا شي.

  1. انسخ السنيبت. داخل المشروع، افتح الودجت ← السنيبت. uMarker يعرض السنيبت بالضبط، وفيه مفتاحك الحقيقي أصلاً. شكله كذا:

    index.html
    <script>
    (function(w,d){
    var t=0;try{t=w.localStorage.getItem('md_mode_md_your_public_key')==='technical';}catch(e){}
    if(t&&!w.__mdCap){
    w.__mdCap=1;
    var L=w.__mdLogs=w.__mdLogs||[];
    var rec=function(lvl,msg){try{L.push({level:lvl,message:String(msg).slice(0,2000)});if(L.length>200)L.shift();}catch(e){}};
    ['log','info','warn','error'].forEach(function(k){var o=console[k];if(o)console[k]=function(){try{rec(k,Array.prototype.map.call(arguments,String).join(' '));}catch(e){}return o.apply(console,arguments);};});
    w.addEventListener('error',function(e){rec('error',(e.message||'Script error')+' @ '+(e.filename||'')+':'+(e.lineno||''));},true);
    w.addEventListener('unhandledrejection',function(e){var m='Unhandled promise rejection';try{var r=e&&e.reason;m+=': '+((r&&(r.stack||r.message))||String(r));}catch(x){}rec('error',m);});
    }
    var s=d.createElement('script');
    s.async=1; s.src='https://api.umarker.com/widget/v1.js'; s.setAttribute('data-umarker-key','md_your_public_key');
    (d.head||d.documentElement).appendChild(s);
    })(window,document);
    </script>

    انسخ المولَّد، لا تكتبه بيدك.

  2. ألصقه بأعلى <head> ما تقدر، قبل سكربتاتك أنت. لمّا يكون المشروع على وضع الالتقاط التقني، الجزء الصغير المضمّن يبدأ يخزّن مخرجات الكونسول والأخطاء على طول، فالأعطال اللي تطلع قبل لا يخلص الودجت تنزيله تظل توصل في التقرير. وفي الوضع العادي ما يسجّل شي. والودجت نفسه يُحمَّل بشكل غير متزامن وما يبطّئ صفحتك.

  3. افتح صفحتك. زرّ uMarker يظهر أسفل اليمين (أو وين ما حرّكته)، وحسب قواعد الاستهداف اللي ضبطتها. واللوحة تكتشف أول تحميل لحالها وتقلب حالة التثبيت إلى مُثبَّت بلا ما تحدّث الصفحة.

  4. التقط. انقر الزرّ، وأداة الالتقاط تفتح مباشرة على صفحتك، وما فيه نموذج تعبّيه أول.

    • فحص عنصر هي الأداة الافتراضية. مرّر: أعمق عنصر تحت المؤشّر يُضيء بنموذج صندوقه. والأسهم تصعد وتنزل في شجرة الـDOM. انقر عشان تربط ملاحظة بذاك العنصر. وأشرطة الهوامش البرتقالية قابلة للنقر بعد، لو كانت المسافة هي الغلط.
    • تعليق وتظليل ورسم موجودات لأي شي مو عنصراً.
    • كل علامة تصير دبوساً مرقّماً له ملاحظته. اضغط حفظ (أو Enter) عشان ترتبط؛ والعلامة اللي تُقفل بلا ملاحظة تنحذف، فما فيه شي يُدبَّس على الصفحة بلا كلام.
    • اضغط مراجعة تشوف كل الدبابيس على خريطة مصغّرة، ثم إرسال للمراجعة.

    اللقطة تُؤخذ في تلك اللحظة، لصفحة نظيفة وأداتنا مخفيّة. ورابط الصفحة وبيانات الجهاز تُرفَق تلقائياً، وفي وضع الالتقاط التقني معها رسائل الكونسول والطلبات الفاشلة وباقي السجلّ التقني.

الخطوة 3: شوفه في الوارد

Section titled “الخطوة 3: شوفه في الوارد”
  1. افتح مساحتك وروح الوارد. تقريرك في عمود جديد بحالة new — وبالأعلى، لأنه البطاقة الوحيدة هناك. اللوحة ترتّب بالأولوية قبل الحداثة، فلمّا يصير عندك تراكم، التقرير الجديد اللي بلا أولوية ينزل تحت اللي لها أولوية؛ وعرض القائمة يرتّب الأحدث أولاً افتراضياً.

  2. افتحه. صفحة التقرير تعيد رسم علاماتك فوق اللقطة الحقيقية: إطارات العناصر، وأشرطة برتقالية فوق الهامش اللي أُشّر عليه، والدبابيس المرقّمة بنصوصها. وشارة تقول بأي وضع التقاط انرسل التقرير. وفي التقرير التقني، بجانبها السياق المُلتقَط: رسائل الكونسول والطلبات الفاشلة وبيانات المتصفّح، بخطّ أحادي المسافة ومُعامَلة كمعطى من الدرجة الأولى. والتقرير العادي يوضّح إنه يحمل اللقطة والملاحظات والصفحة والجهاز بس.

  3. انقر دبوساً. له خيط نقاش مستقل وزرّ تمّ مستقل، منفصلان عن حالة التقرير.

  1. حطّ أولوية، وطبّق تسمية أو أكثر، واختر مُسنَداً إليه. شوف التسميات والأولوية والإسناد. مساحة General عندك تبدأ بأربع تسميات مبذورة — علة وفكرة وسؤال وتحسين — وكل وحدة تحمل الكتابتين، فكل قارئ يشوفها بلغته ويكون فيه شي تنقر عليه من أول يوم.

  2. حرّك الحالة من new إلى in_progress، وبعدين إلى resolved. وكل تغيير يُسجَّل باسمك في سجلّ التدقيق، والسجلّ يُحفَظ 30 يوماً. وهو مو شاشة في لوحتك: توصلك صفوفه في تصدير بيانات حسابك. شوف دورة حياة الحالة.

  3. ولو تبي، اكتب تعليقاً داخلياً بمنشن، أو ادفع التقرير إلى GitHub أو Linear أو Jira كتذكرة — GitHub من باقة البداية فما فوق، والثلاثة من الاحترافي. وإغلاق التذكرة يحرّك التقرير عنك بعد ما تشغّل المزامنة العكسية: انسخ رابط مزامنة الحالة العكسية للاتصال من التكاملات ← إدارة وحطّه في webhooks أحداث التذاكر عند متتبّعك. وقبل كذا، إغلاق التذكرة ما يغيّر شي هنا، والتقرير المؤرشف ما يتحرّك بأي حال.

هذي الحلقة كاملة: يُلتقَط بأقل من دقيقة، ويُفرَز بأقل من ثلاثين ثانية. وكل شي ثاني في uMarker مبني فوقها.