الوثائق · المسارات

الموقع الحالي، {location}، والبيانات الوصفية

استخدم موقعًا واحدًا وقت الإنشاء في تنسيق الإدخال دون إضافة YAML أو حقول مضمنة تلقائيًا. الحصول على الموقع وإخراج بياناته الوصفية خياران منفصلان وصريحان في كل مسار.

حُدّث في 21 أغسطس 2026 الحصول لمرة واحدة لا تتبع في الخلفية دليل الميزات الكامل

الحصول على الموقع لا يعني إخراج البيانات الوصفية

لكل مسار عنصران منفصلان للتحكّم بالموقع. استخدام الموقع الحالي يحدّد ما إذا كان المسار يطلب موقعًا واحدًا وقت الإنشاء. كتابة البيانات الوصفية للموقع يحدّد إن كانت لقطة الموقع المأخوذة تُكتب أيضًا كبيانات تمهيدية أو حقول مضمنة.

عنصر التحكّمما يعنيهما لا يعنيه ذلك
إذن الموقع من النظاميسمح لـ Vox.md بطلب الموقع أثناء استخدام التطبيق أو واجهة التقاط مدعومة.لا يفعّل الموقع لأي مسار.
استخدام الموقع الحالييطلب موقعًا واحدًا لهذا المسار ويتيحه لـ {location}.لا يكتب YAML أو بيانات وصفية مضمنة تلقائيًا.
كتابة البيانات الوصفية للموقعيكتب الحقول المنظمة المختارة أو YAML المتقدم المتحقق منه من لقطة الموقع المأخوذة.لا يتحكّم في ما إذا كان {location} يمكن عرضه.
إشارة النية هي المسار لا الإذن

منح إذن أثناء الاستخدام يفتح بوابة نظام التشغيل فقط. يظل Vox.md لا يطلب الموقع إلا لإجراء الموقع الحالي المستقل في شريط الالتقاط أو لمسار فعّلت فيه استخدام الموقع الحالي.

أعدّ الموقع الحالي لمسار واحد

  1. افتح المسارات.على iPhone أو iPad، افتح الإعدادات ← المسارات. على Mac افتح الإعدادات واختر المسارات.
  2. حرّر المسار.اختر المسار الذي سيستخدم موقع إنشائه. يخص الإعداد ذلك المسار ولا يؤثر في غيره.
  3. افتح الموقع.فعّل استخدام الموقع الحالي. أبقِ كتابة البيانات الوصفية للموقع معطّلًا لسلوك الرمز فقط.
  4. اختر الدقة.استخدم بالضبط للقياس الأصلي، أو المدينة لإحداثيات مقربة إلى منزلتين عشريتين دون تسمية نقطة اهتمام.
  5. اختر سلوك عدم التوفر.تحدّد اسأل أو إرسال بدون الموقع أو إلغاء الالتقاط ما يحدث عند تعذّر قياس الموقع الأصلي.
  6. إضافة {location} إن أردت.ضع الرمز في قالب إدخال أو بادئة أو لاحقة إدخال مخصصة أو قالب Markdown من الخزنة.

قد يظهر طلب إذن الموقع للنظام عند أول استخدام. إذا رُفض سابقًا، فعّل وصول Vox.md إلى الموقع في إعدادات iOS أو iPadOS أو macOS.

اختر أصغر مساحة موقع تحتاجها

النتيجة المطلوبةاستخدام الموقع الحاليكتابة البيانات الوصفية للموقعمعبد
دون موقع للمسارمعطّلمعطّللا تستخدم {location}، وإلا يُعرض فارغًا.
رابط قابل للنقر فقطمُفعّلمعطّلإضافة {location}. لا تُكتب حقول موقع.
بيانات وصفية فقطمُفعّلمُفعّلتجاوز {location}. تُكتب الحقول المضبوطة فقط.
الرابط والبيانات الوصفيةمُفعّلمُفعّلإضافة {location} واضبط حقول البيانات الوصفية.

يمنع تعطيل استخدام الموقع الحالي عرض الرمز وإخراج البيانات الوصفية لذلك المسار، حتى لو بقيت اختيارات تنسيق البيانات السابقة مضبوطة لاستخدام لاحق.

استخدم {location} دون تغيير بيانات الملاحظة الوصفية

عندما يُفعّل استخدام الموقع الحالي وتتوفر لقطة موقع الإنشاء، {location} يعرض رابط Google Maps بصيغة Markdown متحققًا منه:

[Location](https://www.google.com/maps/search/?api=1&query=45.501235%2C-73.567890)

يعمل الرمز في قوالب الإدخال القابلة لإعادة الاستخدام وبادئات الإدخال ولواحقه المخصصة وقوالب Markdown للخزنة. يستخدم إحداثيات بالضبط أو المدينة نفسها المختارة للمسار.

مثال باستخدام الرمز فقط

للاحقة مثل:

Captured from {location}

يمكن لـ Vox.md إنتاج:

Captured from [Location](https://www.google.com/maps/search/?api=1&query=45.501235%2C-73.567890)

مع تعطيل كتابة البيانات الوصفية للموقع، يكون هذا الرابط محتوى الموقع الوحيد الذي يضيفه المسار. لا يوجد locations: مجموعة، ولا توجد location.*:: حقول تُكتب.

إصلاح المحرّر بضغطة واحدة

إذا كانت بادئة الإدخال الفعلية أو لاحقته أو قالب الإدخال القابل لإعادة الاستخدام يستخدم {location} مع تعطيل الموقع الحالي في المسار المختار، يشرح المحرّر أن الرمز سيظهر فارغًا ويعرض استخدام الموقع الحالي لـ [Route]. يفعّل ذلك الإجراء الموقع الحالي للمسار مع إبقاء كتابة البيانات الوصفية للموقع معطّلة عمدًا، فيحل الإرسال التالي الرمز دون تغيير بيانات الملاحظة. لا تُقرأ ملفات قوالب الخزنة الحية إلا أثناء التسليم، فلا يطلق محتواها تلميح المحرّر هذا؛ فعّل الموقع الحالي يدويًا عندما يستخدم قالب خزنة الرمز.

عندما يكون الرمز فارغًا

{location} يصبح سلسلة فارغة عندما يُعطّل الموقع الحالي أو يتعذّر أو يستمر الالتقاط دون موقع. انتبه إلى الترقيم والتسميات المحيطة عند تصميم أسطر قوالب اختيارية.

إجراء شريط التقاط مستقل

السماح بسرعة الموقع الحالي إجراء يدرج مباشرة رابط Google Maps لمرة واحدة في المسودة الحالية. هو مستقل عن المسارات ولا يغيّر استخدام الموقع الحالي أو كتابة البيانات الوصفية للموقع.

اكتب الحقول المنظمة فقط عندما تختار ذلك

فعّل كتابة البيانات الوصفية للموقع عندما يجب أن تتلقى الملاحظة حقول موقع مقروءة آليًا إضافةً إلى أو بدلًا من {location} رابط.

البيانات التمهيدية للملاحظة

يضيف كل موقع إلى مجموعة باسم locations افتراضيًا، باستخدام معرّف الالتقاط مفتاحًا. تُحفظ البيانات التمهيدية الموجودة غير المرتبطة.

حقول الإدخال المضمنة

يكتب بنمط Dataview location.key:: value أسطر بجوار الإدخال الملتقط. لا تُضاف مجموعة بيانات تمهيدية.

الحقول المنظمة

اختر وأعد تسمية الإحداثيات وخط العرض وخط الطول والمكان والمدينة والمنطقة والبلد وروابط الموفّرين وgeo URI والدقة والختم الزمني والمصدر والمعرّف.

YAML متقدم

يستخدم قالب YAML محدودًا متحققًا منه للبيانات التمهيدية للملاحظة. لا يتوفر YAML المتقدم لحقول الإدخال المضمنة.

مثال بيانات تمهيدية منظمة

---
title: Field Notes
locations:
  - id: "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
    coordinates: [45.501235, -73.567890]
    place: "Café & Main"
    appleMapsURL: "https://maps.apple.com/?ll=45.501235%2C-73.567890&q=Caf%C3%A9%20%26%20Main"
    timestamp: "2023-11-14T22:13:20.000Z"
    source: "app"
---

يمكن للملاحظات الدورية حفظ عدة التقاطات في المجموعة. حماية إعادة المحاولة مدمجة في دمج الموقع: لا يمكن للمحاولة بمعرّف الالتقاط نفسه إضافة الموقع مرتين. إن احتوى مفتاح المجموعة على قيمة غير متوافقة كتبها المستخدم، يتوقف Vox.md بدل استبدالها.

مثال إدخال مضمن

location.id:: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
location.coordinates:: [45.501235, -73.567890]
location.place:: "Café & Main"

Captured text

عناصر YAML المتقدمة النائبة

يمكن للقوالب المتقدمة استخدام عناصر نائبة مثل {{coordinates}}, {{latitude}}, {{longitude}}, {{place}}, {{city}}, {{region}}, {{country}}, {{appleMapsURL}}, {{googleMapsURL}}, {{openStreetMapURL}}, {{geoURI}}, {{accuracy}}, {{timestamp}}, {{source}}، و {{id}}. عاين التهيئة في إعدادات المسار قبل الحفظ.

يستخدم بالضبط والمدينة لقطة موقع واحدة متسقة

الدقةالإحداثياتالتسمياتالروابط والحقول
بالضبطيحفظ القياس الأصلي مع عرض ست منازل عشرية.قد يتضمن تسمية نقطة اهتمام عند حاجة حقل بيانات وصفية مختار إليها.تستخدم كل قيمة مشتقة إحداثيات بالضبط.
المدينةيقرّب خط العرض وخط الطول إلى منزلتين عشريتين قبل الاحتفاظ بلقطة الموقع.يحذف تسميات نقاط الاهتمام؛ قد تبقى المدينة والمنطقة والبلد.يستخدم كل URL موفّر وgeo URI ورمز وحقل الإحداثيات المقربة.

لا يُستخدم محوّل Apple الجغرافي العكسي إلا إذا فُعّلت كتابة البيانات الوصفية للموقع واحتاج حقل منظم أو عنصر نائب متقدم إلى مكان أو مدينة أو منطقة أو بلد. يتجاوز مسار الرمز فقط الترميز العكسي. إن فشل بحث التسميات، يظل المخرج القائم على الإحداثيات متاحًا.

لقطة الموقع تخص منشأ الالتقاط

يُقيّم الموقع الحالي عند نقطة نشوء الالتقاط. وتعيد المحاولة والاستعادة استخدام تلك النتيجة الدائمة بدلًا من الحصول بصمت على موقع أحدث.

مصدر الالتقاطنقطة الحصول على الموقع
السماح بسرعة على iPhone وiPadإرسال
ورقة المشاركةإرسال من امتداد المشاركة
مقاصد نص ورابط وملف مباشرة إلى قائمة الانتظاراستدعاء المقصد
الاختصارات والأدوات وعناصر التحكّم والروابط العميقة التي تفتح السماح بسرعةإرسال من المحرّر
اختصار وأداة وعنصر تحكّم وصوت فوري وتسجيل مسار بلوحة المفاتيحتوقف التسجيل
تسليم الالتقاط العادي من Apple Watchتوقف التسجيل على Watch؛ ولا يستبدل iPhone الموقع بموقعه الخاص
التقاط Macإرسال، أو توقف التسجيل للتسليم الصوتي الفوري

التسجيل فقط على Watch يصدّر M4A خامًا إلى الملفات دون موضع Markdown، فلا يطلب الموقع حتى إن كان المسار يستخدم الموقع الحالي في غير ذلك.

اختر سلوك كل مسار عند تعذّر قياس الموقع

  • اسأل: يمكن للالتقاطات التفاعلية إعادة المحاولة أو الإلغاء أو الإرسال مرة دون موقع أو اختيار الإرسال دائمًا دون موقع لذلك المسار.
  • إرسال بدون الموقع: يتابع التسليم دون قيمة رمز أو إخراج بيانات وصفية.
  • إلغاء الالتقاط: يوقف التسليم بدل إنشاء ملاحظة دون موقع الإنشاء المطلوب.
  • أعد ضبط اختيار محفوظ: استخدم إعادة ضبط اختيار عدم توفر الموقع في إعدادات موقع المسار.

يخزّن طلب اسأل غير المراقب نتيجة عدم التوفر وقت الإنشاء لمراجعتها لاحقًا. لا تستبدل إعادة محاولة التقاط منتظر أو فاشل الموقع بموقع أحدث مطلقًا. لا يحفظ العمل المنتظر إلا لقطة الموقع المعدلة للخصوصية أو نتيجة عدم التوفر اللازمة للاستعادة المحلية.

الترقيات تحفظ سلوك البيانات الوصفية السابق

الفصل بين الحصول على الموقع وإخراجه آمن عند الترحيل:

  • مسارات جديدة: يبدأ استخدام الموقع الحالي وكتابة البيانات الوصفية للموقع معطّلين.
  • المسارات التي كان الموقع مفعّلًا فيها: يبقى العنصران مفعّلين بعد الترقية، حفاظًا على البيانات الوصفية التي كانت المسارات تكتبها.
  • مسارات كان الموقع معطّلًا فيها: يبقى العنصران معطّلين؛ ولا تُدخل الترقية إخراج بيانات وصفية جديدًا.

لتحويل مسار يكتب البيانات الوصفية إلى سلوك الرمز فقط، أبقِ استخدام الموقع الحالي مفعّلًا وعطّل كتابة البيانات الوصفية للموقع. لا يُعاد كتابة Markdown الموجود أو حذفه.

لقطة موقع صريحة واحدة، لا تتبع في الخلفية مطلقًا

  • لا يراقب Vox.md الموقع باستمرار ولا يشغّل تتبعًا خلفيًا له.
  • لا يُرسل الموقع إلى خوادم Vox.md أو أنظمة التحليلات أو الإعلانات أو خدمات الذكاء الاصطناعي الخارجية.
  • تُنسّق عناوين URL للرمز والموفّرين محليًا. لا تتلقى Apple Maps أو Google Maps أو OpenStreetMap الإحداثيات إلا عند فتح رابطها.
  • قد يرسل محوّل الترميز الجغرافي العكسي في نظام Apple طلب شبكة فقط عندما تحتاج البيانات الوصفية المختارة إلى تسمية مكان. يتجاوز الموقع القائم على الرمز وحده هذا البحث.
  • بعد التسليم الناجح، تُختزل الطلبات القابلة للاستعادة إلى إيصالات بلا محتوى، ولا يحتفظ سجل الالتقاط المكتمل بالإحداثيات أو التسميات أو URL الموفّرين أو قوالب الموقع.
  • إذا كُتبت بيانات موقع وصفية أو رابط رمز في Markdown، تصبح جزءًا من الملف المختار. وقد يعالج موفّر مزامنتك الملف بموجب شروطه.
يمكن أن يبقى الإذن مفعّلًا وتظل المسارات خاصة

يمكنك إبقاء إذن النظام متاحًا لإجراء الموقع الحالي المستقل مع إبقاء استخدام الموقع الحالي معطّلًا في كل مسار.

راجع سياسة الخصوصية لتفاصيل التعامل مع البيانات والاحتفاظ بها كاملة.

أصلح مشكلات الموقع والقوالب الشائعة

{location} يُعرض فارغًا

أكّد أن قالب الإدخال أو البادئة أو اللاحقة أو قالب الخزنة الفعلي يستخدم الرمز التالي بحروفه الصغيرة تمامًا {location}. ثم فعّل استخدام الموقع الحالي للمسار المسلّم. يمكن لإصلاح المحرّر بضغطة واحدة فعل ذلك لتنسيق الإدخال المضمن المكتشف دون تفعيل البيانات الوصفية؛ تتطلب ملفات قوالب الخزنة الحية إعداد المسار يدويًا. إذا رُفض الإذن أو تعذّر قياس الموقع، فراجع سلوك المسار عند عدم التوفر وإعدادات موقع النظام.

الرابط يعمل لكن البيانات الوصفية لا تظهر

هذا متوقع لإعداد الرمز فقط. افتح إعدادات الموقع للمسار وفعّل كتابة البيانات الوصفية للموقع، ثم اختر البيانات التمهيدية للملاحظة أو حقول الإدخال المضمنة وحدّد الحقول المطلوبة.

تظهر البيانات الوصفية ولا يظهر رابط في الإدخال

لا يدرج إخراج البيانات الوصفية رابطًا تلقائيًا. أضف {location} إلى تنسيق الإدخال الفعلي أو قالب Markdown في الخزنة.

المكان أو المدينة مفقود

أكّد اختيار حقل التسمية. قد يفشل محوّل Apple العكسي مع بقاء الإحداثيات متاحة. تحذف دقة المدينة تسميات نقاط الاهتمام عمدًا.

تسليم البيانات التمهيدية يبلغ عن تعارض

مفتاح المجموعة المضبوط، locations افتراضيًا، ويجب أن تكون قائمة مواقع متوافقة. أعد تسمية المجموعة في إعدادات المسار أو عدّل البيانات التمهيدية التي كتبها المستخدم. لن يستبدل Vox.md قيمة غير متوافقة.

إعادة المحاولة تحمل موقعًا قديمًا أو غير متاح

هذا مقصود. يحفظ الطلب نتيجة وقت الإنشاء كيلا تدّعي إعادة محاولة لاحقة بصمت موقعًا مختلفًا. ابدأ التقاطًا جديدًا عندما تحتاج لقطة موقع جديدة.

إذن الموقع مسموح، لكن المسار لا يطلبه

إذن النظام مجرد بوابة. حرّر ذلك المسار وفعّل استخدام الموقع الحالي. الإذن وحده لا يفعّل الموقع لأي مسار.