الحصول على الموقع لا يعني إخراج البيانات الوصفية
لكل مسار عنصران منفصلان للتحكّم بالموقع. استخدام الموقع الحالي يحدّد ما إذا كان المسار يطلب موقعًا واحدًا وقت الإنشاء. كتابة البيانات الوصفية للموقع يحدّد إن كانت لقطة الموقع المأخوذة تُكتب أيضًا كبيانات تمهيدية أو حقول مضمنة.
| عنصر التحكّم | ما يعنيه | ما لا يعنيه ذلك |
|---|---|---|
| إذن الموقع من النظام | يسمح لـ Vox.md بطلب الموقع أثناء استخدام التطبيق أو واجهة التقاط مدعومة. | لا يفعّل الموقع لأي مسار. |
| استخدام الموقع الحالي | يطلب موقعًا واحدًا لهذا المسار ويتيحه لـ {location}. | لا يكتب YAML أو بيانات وصفية مضمنة تلقائيًا. |
| كتابة البيانات الوصفية للموقع | يكتب الحقول المنظمة المختارة أو YAML المتقدم المتحقق منه من لقطة الموقع المأخوذة. | لا يتحكّم في ما إذا كان {location} يمكن عرضه. |
منح إذن أثناء الاستخدام يفتح بوابة نظام التشغيل فقط. يظل Vox.md لا يطلب الموقع إلا لإجراء الموقع الحالي المستقل في شريط الالتقاط أو لمسار فعّلت فيه استخدام الموقع الحالي.
أعدّ الموقع الحالي لمسار واحد
- افتح المسارات.على iPhone أو iPad، افتح الإعدادات ← المسارات. على Mac افتح الإعدادات واختر المسارات.
- حرّر المسار.اختر المسار الذي سيستخدم موقع إنشائه. يخص الإعداد ذلك المسار ولا يؤثر في غيره.
- افتح الموقع.فعّل استخدام الموقع الحالي. أبقِ كتابة البيانات الوصفية للموقع معطّلًا لسلوك الرمز فقط.
- اختر الدقة.استخدم بالضبط للقياس الأصلي، أو المدينة لإحداثيات مقربة إلى منزلتين عشريتين دون تسمية نقطة اهتمام.
- اختر سلوك عدم التوفر.تحدّد اسأل أو إرسال بدون الموقع أو إلغاء الالتقاط ما يحدث عند تعذّر قياس الموقع الأصلي.
- إضافة
{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 المتقدم لحقول الإدخال المضمنة.
مثال بيانات تمهيدية منظمة
---
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 قيمة غير متوافقة.
إعادة المحاولة تحمل موقعًا قديمًا أو غير متاح
هذا مقصود. يحفظ الطلب نتيجة وقت الإنشاء كيلا تدّعي إعادة محاولة لاحقة بصمت موقعًا مختلفًا. ابدأ التقاطًا جديدًا عندما تحتاج لقطة موقع جديدة.
إذن الموقع مسموح، لكن المسار لا يطلبه
إذن النظام مجرد بوابة. حرّر ذلك المسار وفعّل استخدام الموقع الحالي. الإذن وحده لا يفعّل الموقع لأي مسار.