CSS مخصص
مظهر Mitra مكتوب بـ CSS عادي، ويمكنك أن تضيف فوقه ما تشاء. أخفِ ما لا تستخدمه أبدًا، أو ضع إطارًا حول اليوم، أو امنح الخادم كله ألوانك. لذلك مكانان: الإعدادات → عام → CSS مخصص لنفسك، وحيث يسجّل الناس الدخول، الإعدادات → الإدارة → CSS مخصص للجميع لكل من على الخادم.

WARNING
حتى الإصدار Mitra 1.0، قد يغيّر أي تحديث العناصر والسمات والمتغيرات التي تستهدفها قواعدك. القاعدة التي تعمل اليوم قد تتوقف عن العمل بعد تحديث، أو تبدأ بإخفاء شيء ما. اجعل ورقة أنماطك قصيرة، وألقِ نظرة على Mitra بعد كل تحديث.
ورقة أنماطك الخاصة
Section titled “ورقة أنماطك الخاصة”افتح الإعدادات → عام واكتب CSS في المربع تحت CSS مخصص. يطبّقه Mitra أثناء كتابتك، ويحفظه بعد لحظة من توقفك، ويتبع حسابك إلى كل جهاز ومتصفح تسجّل الدخول منه.
يوقف المفتاح بجانب CSS مخصص ورقة أنماطك دون أن تفقدها، وتعرض لوحة الأوامر الأمرين CSS مخصص: إيقاف وCSS مخصص: تشغيل.
يُحذف @import عند حفظ ورقة أنماطك: الصق ورقة الأنماط كاملة بدلًا من الربط بها.
ورقة أنماط الخادم
Section titled “ورقة أنماط الخادم”حيث يسجّل الناس الدخول، يستطيع المسؤول تغيير مظهر Mitra لكل من على الخادم: افتح الإعدادات → الإدارة واكتب CSS في المربع تحت CSS مخصص للجميع. تراه أنت أثناء الكتابة، ويراه الآخرون في المرة التالية التي يحمّلون فيها Mitra. يوقفها مفتاحها للجميع دون أن تفقدها. أول من يسجّل الدخول إلى الخادم هو مسؤوله. ودون تسجيل دخول، تصل ورقة أنماطك الخاصة أصلًا إلى كل من يستخدم Mitra، فهي الوحيدة.
تناسب ما يجعل الخادم خادمك، مثل ألوانه أو خطه أو الاسم الذي يحمله. تأتي ورقة أنماط كل شخص بعدها، فتفوز ورقته حيث تضبط الاثنتان الشيء نفسه.
قاعدتك تفوز
Section titled “قاعدتك تفوز”تقع قواعد Mitra نفسه في طبقة تتالٍ اسمها mitra، أما قواعدك فلا، لذا تتغلب قاعدتك على قاعدة Mitra أيًّا كان محددها. لا تحتاج إلى !important. أما تصريحات !important القليلة الخاصة بـ Mitra فتبقى في الأعلى، لأن الطبقات ترتّبها بالعكس: فهي تحفظ تماسك التخطيط.
لتزيل شيئًا يضبطه Mitra بدلًا من الطلاء فوقه، اضبط الخاصية على revert. هذا يزيل سطح الأيام في عرض الشهر:
mitra-weeks mitra-day { background: revert;}إخفاء الأيام خارج الشهر
Section titled “إخفاء الأيام خارج الشهر”mitra-weeks [data-outside] { visibility: hidden;}في عرض الشهر، يخفي هذا الأيام التي قبل الشهر المعروض وبعده، وتواريخها وخلفيتها. أما العناصر التي عليها فتبقى. تُبقي visibility الشبكة في مكانها، بينما كانت display: none ستفككها. كبّر العرض لتمنح أيام الشهر نفسه مساحة أكبر.
إطار حول اليوم
Section titled “إطار حول اليوم”mitra-weeks mitra-day[today] { outline: 2px solid var(--color-accent); outline-offset: -2px;}outline بدلًا من border: فالحد سيكبّر اليوم ويحرّك الشبكة.
ألوانك الخاصة
Section titled “ألوانك الخاصة”:root { --color-accent: light-dark(#2e7d32, #81c784); --border-radius: 8px;}تأخذ light-dark() لون السمة الفاتحة، ثم لون السمة الداكنة. كل ما يلوّنه Mitra بهذه المتغيرات يتبعها، ومنه شريط عنوان التطبيق المثبّت:
| المتغير | ما يلوّنه |
|---|---|
--color-accent | اليوم، وما هو محدد، وحلقات التركيز، والأزرار الرئيسية |
--color-background-seed | الأرضية خلف كل شيء؛ ومنها تأخذ مربعات الحوار أرضيتها |
--color-surface | الأيام في طرق العرض، وما يقع على الأرضية، مثل لوحة الأوامر |
--color-text | النص |
--color-text-muted | النص الثانوي، مثل التلميحات والأوقات |
--color-error | الأخطاء والتحذيرات |
--border-radius | زوايا الأزرار والعناصر ومعظم عناصر التحكم |
--font-family | خط النص |
اعثر على ما تستهدفه
Section titled “اعثر على ما تستهدفه”تعرض أدوات المطوّر في متصفحك ما على الصفحة: انقر بزر الفأرة الأيمن على شيء واختر فحص. عناصر Mitra نفسه تُسمّى mitra-…، مثل طرق العرض mitra-days (الأسبوع) وmitra-weeks (الشهر) وmitra-months (السنة) وmitra-timeline وmitra-table، واليوم mitra-day، والعنصر mitra-entry-segment، والشريط الجانبي mitra-sidebar. وتذكر السمات حقائق، مثل today وdata-outside وdata-date.
تحتفظ الأزرار والحقول والمفاتيح والقوائم وسائر عناصر التحكم بدواخلها لنفسها. صِل إليها عبر أجزائها، مثل mitra-switch::part(switch)، وعبر متغيرات --mitra-… التي تقرؤها. وإن احتجت أن تصل أبعد، فاطلب جزءًا في بلاغ.
ما ينبغي تركه
Section titled “ما ينبغي تركه”أشياء قليلة تحفظ تماسك Mitra، وتغييرها يكسره:
displayأوpositionعلىmitra-day، أو على.entriesداخل طريقة عرض: فهي تقع على شبكة تتشاركها طريقة العرض كلها، ويصبح عرض الأسبوع بطيئًا جدًا دونها.- المتغيرات التي تبدأ بـ
--_: فهي تتغير في كل إطار من التكبير، وضبطها يعاركه. - حجم العنصر: فعنوانه يختار تخطيطًا بحسب عرضه، لذا قد يبدّله تحديد الحجم من الخارج.
all: unsetيلغي الإخفاء أيضًا، فأعد كتابة[hidden] { display: none }بجانبه.
حين تخفي قاعدةٌ طريق العودة
Section titled “حين تخفي قاعدةٌ طريق العودة”أضف ?css=off إلى العنوان، مثل https://mitra.example.com/?css=off. عندها يُحمَّل Mitra مرة واحدة دون أي من ورقتي الأنماط، فتستطيع فتح الإعدادات وإصلاح ورقتك. ويصلح المسؤول ورقة الجميع بالطريقة نفسها.
قبل أن تلصق
Section titled “قبل أن تلصق”لا تشغّل ورقة الأنماط أي شيفرة، لكنها تستطيع تحميل عناوين، وورقة مكتوبة لهذا الغرض قد ترسل إليها ما على شاشتك. لا تلصق إلا CSS تفهمه. ورقة أنماطك الخاصة لا تصل إلا إليك، وورقة الخادم تصل إلى كل من عليه.
شارك ورقتك
Section titled “شارك ورقتك”تحت المربع، يفتح شارك على GitHub نقاشًا جديدًا في فئة Custom CSS وفيه ورقة أنماطك. قل ما تفعله، وأضف لقطة شاشة إن كانت تُظهر شيئًا، ثم انشره. أما ورقة الأنماط الأطول من أن يحملها الرابط فتُنسخ إلى الحافظة بدلًا من ذلك، لتلصقها في النقاش. وفي الفئة أيضًا تجد أوراق أنماط شاركها آخرون: اقرأها قبل أن تلصقها.