منشئ رمز QR لحدث في التقويم

محتوى iCalendar، بالضبط

يحمل الرمز كائن RFC 5545 كاملا، لا رابطا إليه. يفتح بـ BEGIN:VCALENDAR، ويحمل VERSION:2.0 و PRODID يعرّف هذا المنشئ، ويلف مكون VEVENT واحدا، ويغلق بـ END:VCALENDAR. وداخل الحدث يجلس UID و DTSTAMP اللذان تفرضهما المواصفة، إلى جانب DTSTART و DTEND و SUMMARY وما ملأته من LOCATION و DESCRIPTION و URL.

وكل سطر محتوى ينتهي بإرجاع سطر ثم تغذية سطر، بهذا الترتيب. والمحللات صارمة في هذا: فالكائن الذي يستخدم تغذية سطر مجردة هو ما يجعل حدثا صحيحا في كل ما عداه يفشل عند الاستيراد. والأسطر التي تتجاوز 75 ثمانية تُطوى بإدراج CRLF متبوعا بمسافة واحدة، ويعيد القارئ ضمها قبل التحليل، ولهذا لا يكسر وصف طويل الكائن.

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

التوقيت المحلي العائم مقابل UTC

في الوضع العائم يكتب DTSTART بصيغة YYYYMMDDTHHMMSS بلا حرف Z في آخره وبلا معامِل TZID. ويسمي RFC 5545 هذا توقيتا عائما، ومعناه ما يقوله بالضبط: 19:00 هي 19:00 على أي جهاز يفتحه، أيا كان مكانه. ولحفل موسيقي أو بسطة في سوق أو يوم مفتوح في مدرسة، هذا هو المطلوب دائما تقريبا، لأن كل من يقرأ الملصق واقف في المنطقة الزمنية نفسها التي فيها المكان.

وفي وضع UTC تكتب الخاصية نفسها بصيغة YYYYMMDDTHHMMSSZ، وحرف Z في آخرها يثبّت اللحظة. فيحول كل جهاز ذلك إلى توقيته المحلي عند الاستيراد، فحدث مضبوط على 14:00 بتوقيت UTC يظهر 15:00 في برلين و09:00 في نيويورك. وهذا هو الخيار الصحيح لندوة عبر الإنترنت، والخيار الخطأ لمهرجان قرية.

والمنطقة المسماة — ‎DTSTART;TZID=Europe/London‎ — هي الاحتمال الثالث في المواصفة، وهذه الأداة لا تقدمه. ففعله على الوجه الصحيح يتطلب تضمين مكون VTIMEZONE مع مجموعة قواعد انتقال التوقيت الصيفي كاملة، وهذا يضيف عدة مئات من البايتات إلى محتوى يجب أن يسع في رمز واحد، والكائن الذي يشير إلى TZID لا يعرّفه كائن غير صالح. والعائم وUTC يغطيان حالات الملصق المطبوع دون تلك التكلفة.

التهريب والأحداث اليومية والحجم

تُهرَّب القيم النصية كما تفرض المواصفة قبل دخولها المحتوى. فالشرطات المائلة العكسية تُهرَّب أولا، ثم الفواصل المنقوطة والفواصل، ثم فواصل الأسطر؛ والتهريب بأي ترتيب آخر يهرّب مرتين الشرطات العكسية التي أدخلتها للتو. أما النقطتان داخل قيمة نصية فتُترك وشأنها — إذ يمنع RFC 5545 صراحة تهريبها، وإن كان RFC 2445 الأقدم يفرضه، ولهذا ما زالت بعض المنشئات المكتوبة يدويا تخطئ فيه.

والحدث الذي يستغرق يوما كاملا يستخدم صيغة التاريخ: ‎DTSTART;VALUE=DATE:20260904‎. ونهايته حصرية، فاليوم الواحد في 4 سبتمبر يكتب بـ ‎DTEND;VALUE=DATE:20260905‎. والخطأ في هذا هو ما ينتج حدثا يمتد يوما أقل أو يوما أكثر مما ينبغي.

والحجم هو الحد العملي هنا. فالرمز الواحد يحمل 2,953 بايت على الأكثر عند أدنى مستوى استرجاع، وغلاف التقويم وحده ينفق نحو مئتين قبل أن يبدأ نصك. والوصف الطويل يدفع الرمز إلى إصدار أعلى بوحدات أصغر، وهذا يحتاج طباعة أكبر أو مسحا أقرب. والمعاينة تعرض الإصدار أثناء الكتابة، فراقب حركته.

• الشرطة العكسية تصير \\، والفاصلة المنقوطة تصير \;، والفاصلة تصير \,
• وفاصل السطر يصير الحرفين \n
• والنقطتان لا تُهرَّبان أبدا في القيم النصية في RFC 5545