VIKING(1)

Viking 1.11

VIKING(1)

نام (NAME)

viking - برنامه‌ای برای مدیریت داده‌های GPS

خلاصه دستور (SYNOPSIS)

viking [-h | --help]

viking [-v | --version]

توضیحات (DESCRIPTION)

نرم‌افزار Viking برنامه‌ای برای مدیریت داده‌های GPS است.

شما می‌توانید ردپاها (tracks)، مسیرها (routes) و نقاط مسیر (waypoints) را وارد کرده و رسم کنید، نقشه‌های OpenStreetMap (OSM) یا دیگر نقشه‌ها را نمایش دهید، نقشه تولید کنید (با استفاده از Mapnik)، به تصاویر برچسب جغرافیایی (geotag) بزنید، خطوط مختصات اضافه کنید، ردپاها، مسیرها و نقاط مسیر جدید ایجاد کنید، موارد گوناگون را پنهان کنید و غیره. این برنامه عمدتاً به زبان C و تا حدی C++ نوشته شده است و از جعبه‌ابزار GTK+ 3 استفاده می‌کند. این نرم‌افزار برای لینوکس، سایر سیستم‌عامل‌های سازگار با POSIX و ویندوز در دسترس است.

وبگاه: http://viking.sf.net

نرم‌افزار Viking تحت مجوز GNU GPL منتشر شده است.

همچنین Viking دارای راهنمای جامع‌تری است که از درون خود برنامه قابل دسترسی بوده و مفاهیم معرفی‌شده در اینجا را با جزئیات بیشتر بسط می‌دهد.

جزئیات (DETAILS)

جزئیات.

جدول 1. مرجع فایل‌ها (File Reference)

مقادیر	توضیحات
file(s)	خواندن فایل‌های مشخص‌شده به ترتیب از چپ به راست.
-	خواندن ورودی از ورودی استاندارد (standard in). نباید هیچ فایل دیگری مشخص شود.

توجه داشته باشید که ترتیب فایل‌ها بسته به نوع فایل آن‌ها می‌تواند حائز اهمیت باشد. فایل‌های بعدی که از نوع پروژهٔ Viking نیستند، در پروژهٔ قبلی Viking بارگذاری می‌شوند و فایل‌ها از چپ به راست پردازش می‌گردند. چند مثال:

•viking file1.gpx file2.gpx file3.gpx

در اینجا همهٔ فایل‌های GPX در یک پنجره در قالب یک پروژهٔ جدید Viking بارگذاری می‌شوند.

•viking file1.vik file2.vik

هر فایل پروژهٔ Viking در یک پنجرهٔ جدید باز می‌شود.

•viking file1.vik file2.gpx file3.gpx

فایل‌های GPX در یک پنجره درون پروژهٔ Viking بارگذاری می‌شوند.

•viking file2.gpx file3.gpx file1.vik

فایل‌های GPX در یک پنجره درون یک پروژهٔ جدید Viking بارگذاری می‌شوند و پروژهٔ Viking به‌طور جداگانه در یک پنجرهٔ مجزا باز می‌شود.

جدول 2. مرجع خط فرمان (Command Line Reference)

گزینه کوتاه	گزینه بلند	توضیحات
-h	--help	نمایش گزینه‌های خط فرمان و سپس خروج.
-V	--verbose	اجرا در حالت پرگو (verbose). برخی اطلاعات دربارهٔ فعالیت‌های Viking در stdout نمایش داده می‌شود.
-d	--debug	اجرا در حالت اشکال‌زدایی (debug). اطلاعات بیشتری دربارهٔ فعالیت‌های Viking در stdout نمایش داده می‌شود. این گزینه همچنین برخی ویژگی‌های نمایش اطلاعات اضافی را در خود رابط گرافیکی (GUI) فعال می‌کند که عمدتاً برای توسعه‌دهندگان مفید است.
-v	--version	نمایش نسخه و سپس خروج.
N/A	--latitude	تنظیم موقعیت اولیه روی عرض جغرافیایی مشخص‌شده به درجهٔ اعشاری.
N/A	--longitude	تنظیم موقعیت اولیه روی طول جغرافیایی مشخص‌شده به درجهٔ اعشاری.
-z	--zoom	تنظیم سطح بزرگ‌نمایی اولیه. این مقدار، سطح بزرگ‌نمایی OSM (بین 0 تا 22) است.
-m	--map	افزودن یک لایهٔ نقشه با مشخص کردن شناسهٔ نقشه (map id). این مقدار باید با یکی از شناسه‌های داخلی یا شناسه‌ای از Map Source Extensions مطابقت داشته باشد. مشخص کردن مقدار 0 از پیش‌فرض لایهٔ نقشه استفاده خواهد کرد. مشخص کردن هر مقدار منفی، برای مثال -2، هیچ نقشه‌ای را نمایش نمی‌دهد (که تنظیم ترجیحی رابط گرافیکی مبنی بر افزودن خودکار نقشه هنگام راه‌اندازی را لغو می‌کند).
-e	--external	فایل‌های مشخص‌شده در خط فرمان، مطابق با روش ارجاع خارجی، به‌عنوان فایل‌های خارجی (external files) بارگذاری خواهند شد. این گزینه برای انواع GPX، FIT، KML یا TCX اعمال می‌شود و بنابراین روی فایل‌های .vik اثری ندارد.
-c	--config-dir	استفاده از یک مکان جایگزین (که در صورت عدم وجود، ایجاد خواهد شد) برای دایرکتوری پیکربندی. این گزینه برای استفاده یا آزمایش مقادیر پیکربندی خاص برای یک نشست مشخص، بدون تغییر تنظیمات عادی، مفید است.
-r	--running-instance	باز کردن فایل‌های مشخص‌شده در یک نمونهٔ از قبل در حال اجرای Viking. اگر هیچ نمونه‌ای در دسترس نباشد، فایل‌ها باز نخواهند شد. پارامترهای موقعیت مکانی و گزینه‌های نقشه برای نمونهٔ در حال اجرا استفاده یا به آن ارسال نمی‌شوند. .if n .sp 4 نکته این گزینه در Windows(TM) در دسترس نیست.
جدول 3. شناسه‌های داخلی نقشه
allbox tab(	);
lB lB.
نقشه	شناسه
4UMaps	801
Bing Aerial	212
Blue Marble	15
CalTopo	29
CyclOSM	65
pnvkarte Public Transport	101
OpenSeaMap	600
OpenTopo	901 (پیش‌فرض کنونی)
OSM Cycle	17
OSM Humanitarian	22
OSM Mapnik	13
OSM Transport	20
OSM GPS Traces	33
Waymarked Trails Cycling	702
Waymarked Trails Hiking	701
Waymarked Trails MTB	703
Waymarked Trails Riding	705
Waymarked Trails Skating	704
Waymarked Trails Winter	706

فهرست کنونی نقشه‌های موجود و شناسهٔ آن‌ها، شامل موارد توکار فهرست‌شده در بالا به‌همراه هر مورد دیگری که توسط پیکربندی پیشرفته افزوده شده باشد، در برنامهٔ اصلی از مسیر Help → Maps Information قابل مشاهده است.

مثالی برای باز کردن در مکانی مشخص با یک لایهٔ نقشهٔ OSM Mapnik:

viking --latitude 51.4 --longitude -1.3 --zoom 12 --map 13

اگر فایلی نیز در خط فرمان مشخص شده باشد، پارامترهای مکان و بزرگ‌نمایی خط فرمان اولویت خواهند داشت.

برنامهٔ Viking از RFC5870[1]، یعنی طرحوارهٔ نشانی 'geo' پشتیبانی می‌کند. هر 'فایل' در خط فرمان بررسی می‌شود تا مشخص شود آیا در واقع یک geo URI است یا خیر. بدین ترتیب مثال بالا در قالب geo URI عبارت است از:

viking geo:51.4,-1.3?z=12 --map 13

نکته

به‌عنوان یک ترکیب ویژه هنگامی که هر دو گزینهٔ -V و -d هم‌زمان فعال باشند، Viking برخی از فایل‌های موقتی را که در حین اجرای برنامه ایجاد می‌شوند حذف نخواهد کرد. این ویژگی به‌ویژه برای نظارت بر نتایج درخواست‌های بارگیری (که باید تفسیر شوند) در صورت بروز شکست ناگهانی مفید است، چرا که فایل اغلب شامل اطلاعات دقیق‌تری دربارهٔ حالت شکست خواهد بود..sp .5v

برنامه GTK+‎ بودن Viking بدان معناست که برخی گزینه‌ها مانند --display توسط خود GTK+‎ پردازش می‌شوند. برای آگاهی از گزینه‌های موجود در سیستم خود، از دستور زیر استفاده کنید:

viking --help-gtk

گسترش VIKING (EXTENDING VIKING)

گسترش Viking.PP

نمای کلی.PP

در حال حاضر، Viking دارای چند نقطه گسترش بر پایه فایل‌های پیکربندی است. ساختار این فایل به شدت از قالب فایل GtkBuilder الهام گرفته شده است: شما کلاس GObject را برای ساخت مشخص کرده و ویژگی‌های آن را تنظیم می‌کنید. از نظر فنی، این یک فایل XML حاوی عنصر ریشه "objects" است. در داخل این عنصر، مجموعه‌ای از "object" را قرار می‌دهید.

در اینجا یک مثال آورده شده است:

<objects>
  <object class="ClassName">
    <property name="property_name1">Property value</property>
    <property name="property_name2">Property value</property>
  </object>
  ...
<objects>

می‌توانید مثال‌های بیشتری را به صورت نصب‌شده روی سیستم خود و در بخش مستندات توزیع بیابید. معمولاً بسته به سیستم‌عامل، این فایل‌ها در یکی از مکان‌های $XDG_DATA_DIR مانند /usr/share/viking/ یا C:\Program Files\Viking\data نصب می‌شوند.

همچنین این امکان وجود دارد که مقادیر پیش‌فرض داخلی را بازنویسی کنید، مثلاً برای به‌روزرسانی پارامترها در صورتی که در طول زمان تغییر کنند، که با افزودن این مقادیر به فایل پیکربندی شما انجام می‌شود. هنگامی که یک گروه شیء (object group) را تعریف می‌کنید که از قبل وجود دارد (و در مورد Maps این به معنای کلید Id تکراری است، هرچند ممکن است برای یافتن مقادیر Id مرتبط نیاز به بررسی کد منبع داشته باشید)، باید تمام کلیدهای دیگر را نیز تعریف کنید، در غیر این صورت آن‌ها به مقادیر پیش‌فرض بازنشانی خواهند شد.

منابع نقشه.PP امکان افزودن منابع نقشه جدید وجود دارد. فایل مربوطه maps.xml بوده که در User Configuration File Location شما قرار می‌گیرد.

نمونه‌ای از این فایل در بخش مستندات توزیع doc/examples/maps.xml. قرار دارد. مثال‌ها و مقادیر بیشتر به صورت برخط در Maps Wiki[2] در دسترس است.

کلاس VikSlippyMapSource امکان اعلان هر منبع نقشه‌ای را که مشابه با OpenStreetMap کار می‌کند، فراهم می‌سازد. این کلاس از ویژگی‌های زیر پشتیبانی می‌کند:

این یک عدد صحیح است و از آنجا که برای شناسایی منبع نقشه به کار می‌رود، باید یکتا باشد.

name

یک رشته (باید یکتا باشد) که برای نام دایرکتوری حافظه موقت (کَش) به سبک OSM هنگامی که دایرکتوری Map Cache در حالت پیش‌فرض (~/.viking-maps) است، استفاده می‌شود.

label

متنی که در پنجره گفت‌وگوی انتخاب منبع نقشه نمایش داده می‌شود.

hostname

نام میزبان (hostname) کارگزار (مانند "tile.openstreetmap.org").

url

آدرس پارامتربندی‌شده کاشی، مطابق با قالب printf در زبان C، همراه با ۳ فیلد "%d" برای Z، X و Y (به همان ترتیب) (مانند "/%d/%d/%d.png").

نکته
می‌توان کل نشانی پارامتربندی‌شده را صرفاً در فیلد URL قرار داد و در این حالت نیازی به تعیین فیلد hostname نیست.

برای نمونه "https://tile.openstreetmap.org/%d/%d/%d.png"

user-agent (اختیاری)

بازنویسی user-agent پیش‌فرضی که در درخواست HTTP به کار می‌رود.

custom-http-headers (اختیاری)

سرآیندهای سفارشی HTTP برای افزودن به درخواست بارگیری. مقدار پیش‌فرض هیچ (none) است.

می‌توان چند سرآیند را با جدا کردن هر بخش توسط یک '\n' مشخص کرد.

این سرآیند اجازه جایگزینی مقادیر مکانی Z، X و Y (به همان ترتیب) را مطابق با گزینه url در بالا می‌دهد. استفاده از مقادیر چندگانه و/یا با ترتیب متفاوت از طریق مشخص‌کننده‌های آرگومان موقعیتی ()printf امکان‌پذیر است. برای نمونه:

DNT: 1\nLine2: %d %d %d\nReordered: %3$d %1$d %2$d

حق نشر (کپی‌رایت) منبع نقشه.

license (اختیاری)

مجوز منبع نقشه.

license-url (اختیاری)

نشانی URL مجوز منبع نقشه.

zoom-min (اختیاری)

حداقل مقدار بزرگ‌نمایی Tiled Web Map پشتیبانی‌شده توسط کارگزار کاشی. در صورت تعیین نشدن، مقدار پیش‌فرض 0 است.

zoom-max (اختیاری)

حداکثر مقدار بزرگ‌نمایی Tiled Web Map پشتیبانی‌شده توسط کارگزار کاشی. در صورت تعیین نشدن، مقدار پیش‌فرض 18 است.

lat-min (اختیاری)

حداقل مقدار عرض جغرافیایی بر حسب درجه پشتیبانی‌شده توسط کارگزار کاشی. در صورت تعیین نشدن، مقدار پیش‌فرض -90 درجه است.

lat-max (اختیاری)

حداکثر مقدار عرض جغرافیایی بر حسب درجه پشتیبانی‌شده توسط کارگزار کاشی. در صورت تعیین نشدن، مقدار پیش‌فرض 90 درجه است.

lon-min (اختیاری)

حداقل مقدار طول جغرافیایی بر حسب درجه پشتیبانی‌شده توسط کارگزار کاشی. در صورت تعیین نشدن، مقدار پیش‌فرض -180 درجه است.

lon-max (اختیاری)

حداکثر مقدار طول جغرافیایی بر حسب درجه پشتیبانی‌شده توسط کارگزار کاشی. در صورت تعیین نشدن، مقدار پیش‌فرض 180 درجه است.

file-extension (اختیاری)

پسوند فایل‌ها بر روی دیسک. مقدار پیش‌فرض .png است.

اگر منبع کاشی یک فایل PNG نباشد، می‌توان از این پارامتر برای تعیین نام‌گذاری جهت اختصاص پسوند فایل‌های یکدست بر روی دیسک استفاده کرد.

این پارامتر همچنین در خواندن یک مجموعه کاشی (tileset) از نرم‌افزارهای دیگری که ممکن است کاشی‌ها را به شکلی متفاوت نام‌گذاری کنند کاربردی است، برای نمونه در Mobile Atlas creator آن‌ها به صورت .png.tile نام‌گذاری می‌شوند.

نکته
انواع فایل‌هایی که در عمل قابل استفاده هستند مواردی می‌باشند که توسط کتابخانه GDK Pixbuf پشتیبانی می‌شوند که حداقل شامل PNG و JPEG است..sp .5v

نکته
به یاد داشته باشید که هنگام مشخص کردن این پارامتر، '.' ابتدایی را لحاظ کنید.

use-direct-file-access (اختیاری)

تنها از فایل‌های روی دیسک استفاده می‌کند. مقدار پیش‌فرض FALSE است.

این گزینه همچنین می‌تواند برای مجموعه‌کاشی‌هایی (tilesets) که از قبل روی دیسک موجود هستند مفید باشد، زیرا از تلاش برای بارگیری هرگونه کاشی جلوگیری می‌کند.

بنابراین با این نوع، پارامترهای hostname و url ضروری نبوده و نادیده گرفته می‌شوند.

offset-x (اختیاری)

انحراف (offset) نقشه در صفحه x (به سمت شرق) بر حسب متر. در صورت عدم تعیین، مقدار پیش‌فرض 0.0 است.

برای تنظیم به سمت غرب، از اعداد منفی استفاده کنید.

کاربرد متداول آن برای هم‌تراز کردن نقشه‌های متفاوت است؛ برای مثال تصاویر هوایی ممکن است نسبت به نقشه‌های کاداستر دارای انحراف باشند.

در حال حاضر این یک مقدار واحد است که برای تمام سطوح بزرگ‌نمایی اعمال می‌شود.

offset-y (اختیاری)

انحراف نقشه در صفحه y (به سمت شمال) بر حسب متر. در صورت عدم تعیین، مقدار پیش‌فرض 0.0 است.

برای تنظیم به سمت جنوب، از اعداد منفی استفاده کنید.

switch-xy (اختیاری)

جابه‌جایی مقادیر X و Y در ترتیب پارامتربندی‌شده‌ی URL.

مقدار پیش‌فرض false است.

check-file-server-time (اختیاری)

برچسب زمانی (timestamp) کاشی را به کارساز ارسال می‌کند، تا کارساز بتواند تصمیم بگیرد که آیا باید کاشی جدیدی ارسال کند یا خیر.

مقدار پیش‌فرض true است.

use-etag (اختیاری)

استفاده و مقایسه مقدار ETag[3] برای تعیین اینکه آیا کاشی جدیدتری بارگیری شود یا خیر. مقدار پیش‌فرض false است.

مقدار ETag در یک فایل جداگانه در همان دایرکتوری کاشی ذخیره می‌شود تا امکان بررسی مقدار در بین چندین بار اجرای برنامه فراهم شود.

referer (اختیاری)

یک URL برای عمل به عنوان ارجاع‌دهنده (referrer) برای درخواست HTTP (مانند "http://hostname").

follow-location (اختیاری)

حداکثر تعداد تغییرمسیرهای مجاز. مقدار پیش‌فرض برای تعداد نامحدود تغییرمسیر، -1 است. اگر نمی‌خواهید تغییرمسیرها دنبال شوند از 0 استفاده کنید.

tilesize-x (اختیاری)

اندازه x کاشی. در صورت عدم تعیین، مقدار پیش‌فرض 256 پیکسل است.

tilesize-y (اختیاری)

اندازه y کاشی. در صورت عدم تعیین، مقدار پیش‌فرض 256 پیکسل است.

scale (اختیاری)

مقیاس کاشی. در صورت عدم تعیین، مقیاس 1 است.

نکته
برای نشان دادن کاشی‌های با وضوح بالا از مقدار 2 استفاده کنید. اندازه کاشی (tilesize) را تغییر ندهید زیرا اندازه نمایش داخلی همچنان بر پایه 256 پیکسل است.

ابزار VikTmsMapSource امکان تعریف هر سرویس TMS را می‌دهد. یک TMS (سرویس کاشی نقشه یا Tile Map Service) در Tile Map Service Specification[4] تعریف شده است. این پیکربندی از ویژگی‌های زیر پشتیبانی می‌کند (مشابه VikSlippyMapSource در بالا):

label

hostname

url

custom-http-headers (اختیاری)

license (اختیاری)

license-url (اختیاری)

check-file-server-time (اختیاری)

follow-location (اختیاری)

referer (اختیاری)

user-agent (اختیاری)

zoom-min (اختیاری)

zoom-max (اختیاری)

lat-min (اختیاری)

lat-max (اختیاری)

lon-min (اختیاری)

lon-max (اختیاری)

file-extension (اختیاری)

scale (اختیاری)

tilesize-x (اختیاری)

tilesize-y (اختیاری)

offset-x (اختیاری)

offset-y (اختیاری)

VikWmscMapSource امکان تعریف هر سرویس WMS یا WMS-C را فراهم می‌کند. یک WMS (سرویس نقشه وب یا Web Map Service) در WMS Tile Caching[5] تعریف شده است. این پیکربندی از ویژگی‌های زیر (مشابه با VikSlippyMapSource در بالا) پشتیبانی می‌کند:

label

hostname

url

custom-http-headers (اختیاری)

license (اختیاری)

license-url (اختیاری)

check-file-server-time (اختیاری)

follow-location (اختیاری)

referer (اختیاری)

user-agent (اختیاری)

zoom-min (اختیاری)

zoom-max (اختیاری)

lat-min (اختیاری)

lat-max (اختیاری)

lon-min (اختیاری)

lon-max (اختیاری)

file-extension (اختیاری)

scale (اختیاری)

tilesize-x (اختیاری)

tilesize-y (اختیاری)

offset-x (اختیاری)

offset-y (اختیاری)

موتورهای جستجوی Go-to.PP امکان افزودن موتورهای جستجوی جدید برای قابلیت «Go-To» وجود دارد. این فایل goto_tools.xml است که در محل فایل‌های پیکربندی کاربر (User Configuration File Location) شما قرار می‌گیرد.

نمونه‌ای از این فایل در توزیع: doc/examples/goto_tools.xml.

در حال حاضر، تنها یک کلاس شیء در دسترس است: VikGotoXmlTool. این قابلیت امکان تعریف هر موتور جستجویی را که از قالب XML به‌عنوان نتیجه استفاده می‌کند، فراهم می‌سازد.

ویژگی‌های مرتبط عبارتند از:

label

متن نمایش‌یافته در کادر محاوره‌ای Go-To

url-format

نشانی پارامتربندی‌شده پرس‌وجو، با ساختاری مشابه قالب printf در C، با یک فیلد یکتای "%s" (که با رشته پرس‌وجو جایگزین می‌شود)

lat-path

مسیر XML عرض جغرافیایی (برای نمونه: /root/parent/elem)

lat-attr (اختیاری)

نام صفت (از عنصر پیشین) حاوی عرض جغرافیایی

lon-path

مسیر XML طول جغرافیایی (برای نمونه: /root/parent/elem)

lon-attr (اختیاری)

نام صفت (از عنصر پیشین) حاوی طول جغرافیایی

referer (اختیاری)

یک URL برای استفاده به‌عنوان referer در درخواست HTTP (برای نمونه "http://hostname")

follow-location (اختیاری)

حداکثر تعداد تغییر مسیرهای مجاز. مقدار پیش‌فرض -1 برای تعداد نامحدود تغییر مسیر است. اگر نمی‌خواهید تغییر مسیرها دنبال شوند، از 0 استفاده کنید.

user-agent (اختیاری)

بازنویسی user-agent پیش‌فرض استفاده‌شده در درخواست HTTP.

custom-http-headers (اختیاری)

سرآیندهای سفارشی HTTP برای افزودن به درخواست HTTP. مقدار پیش‌فرض هیچ (none) است.

توجه داشته باشید که برخلاف custom-http-headers برای درخواست‌های دانلود کاشی (Tile)، هیچ جایگزینی مقداری در این رشته انجام نمی‌شود.

برای سهولت (یا خوانایی) این امکان وجود دارد که هر دو مقدار مسیر و نام صفت را در یک ویژگی واحد، مانند یک عبارت XPath، مشخص کرد. برای این کار، کافی است هر دو اطلاعات را در lat-path (یا lon-path) به قالب زیر تنظیم کنید: /root/parent/elem@attribute. ابزارهای خارجی.PP امکان افزودن ابزارهای خارجی جدید وجود دارد. این فایل external_tools.xml است که در محل فایل‌های پیکربندی کاربر (User Configuration File Location) شما قرار می‌گیرد.

نمونه‌ای از این فایل در توزیع: doc/examples/external_tools.xml.

VikWebtoolCenter امکان تعریف هر Webtool را با استفاده از منطقی بر پایه مختصات مرکز و مقدار سطح بزرگ‌نمایی فراهم می‌کند.

ویژگی‌های مرتبط عبارتند از:

label

متن نمایش‌یافته در مدخل منو

url

نشانی اینترنتی (URL) پارامتربندی‌شده برای باز کردن، با ساختاری مشابه قالب printf در زبان C، همراه با ۲ فیلد "%s" و یک فیلد "%d" برای X، Y و Z (سطح بزرگ‌نمایی) (برای نمونه: "http://hostname/?lat=%s&lon=%s&zoom=%d")

VikWebtoolBounds امکان تعریف هر Webtool را با استفاده از منطقی بر پایه مختصات مرزها (bounds) فراهم می‌کند..PP ویژگی‌های مرتبط عبارتند از:

label

متن نمایش‌داده‌شده در مدخل منو

url

نشانی پارامتربندی‌شده کاشی، به سبک قالب printf در C، با ۴ فیلد "%s" برای چپ (left)، راست (right)، پایین (bottom) و بالا (top) (برای نمونه: "http://hostname:8111/load_and_zoom?left=%s&right=%s&bottom=%s&top=%s")

موتورهای مسیریابی.PP امکان تعریف موتورهای مسیریابی جدید وجود دارد. این فایل، routing.xml است که در «محل فایل پیکربندی کاربر» شما قرار دارد.

نمونه‌ای از این فایل در توزیع موجود است: doc/examples/routing.xml.

عنصر VikRoutingWebEngine امکان تعریف یک موتور مسیریابی دردسترس از طریق HTTP را فراهم می‌کند.

ویژگی‌های مرتبط عبارتند از:

یک رشته، که باید یکتا باشد زیرا برای شناسایی موتور مسیریابی به کار می‌رود

label

متن نمایش‌داده‌شده در مدخل منو

format

کد قالب GPSBabel برای تفسیر پاسخ سرویس. به‌طور پیش‌فرض یک پاسخ GPX انتظار می‌رود و به‌صورت داخلی پردازش می‌شود. با این حال اگر سرویس قالب متفاوتی را بازگرداند، آن‌گاه GPSBabel برای تبدیل متن به قالبی که Viking بتواند آن را متوجه شود به کار می‌رود. تنها قالب‌هایی که GPSBabel پشتیبانی می‌کند قابل استفاده هستند: برای نمونه gtrnctr (برای فایل‌های tcx در Garmin Training Center) و غیره...

از gpsbabel --help در خط فرمان استفاده کنید تا از انواع فایل پشتیبانی‌شده و کدهای مربوط به پردازش آن‌ها مطلع شوید.

برخی کدهای قالب به‌طور بومی توسط Viking مدیریت می‌شوند، مانند gpx و kml.

کد قالب ویژه‌ای به صورت viking-geojson-osrm برای مدیریت پاسخ‌های کارگزارهای مسیریابی OSRM[6] در دسترس است.

url-base

نشانی URL پایه برای وب‌سرویس (برای نمونه: "http://hostname/service?")

url-start-ll

بخشی از URL که مکان نقطه شروع را تعیین می‌کند، پارامتربندی‌شده به سبک قالب printf در C، با ۲ فیلد "%s" برای مختصات (برای نمونه: "&start=%s,%s")

url-stop-ll

بخشی از URL که مکان نقطه پایان را تعیین می‌کند، پارامتربندی‌شده به سبک قالب printf در C، با ۲ فیلد "%s" برای مختصات (برای نمونه: "&stop=%s,%s")

url-via-ll (اختیاری)

بخشی از URL که مکان نقطه میانی را تعیین می‌کند، پارامتربندی‌شده به سبک قالب printf در C، با ۲ فیلد "%s" برای مختصات (برای نمونه: "&via=%s,%s")

url-start-dir (اختیاری)

بخشی از URL که مکان نقطه شروع را برای مسیریابی مبتنی بر جهت تعیین می‌کند، پارامتربندی‌شده به سبک قالب printf در C، با یک "%s" برای جهت (برای نمونه: "&start=%s")

url-stop-dir (اختیاری)

بخشی از URL که مکان نقطه پایان را برای مسیریابی مبتنی بر جهت تعیین می‌کند، پارامتربندی‌شده به سبک قالب printf در C، با یک "%s" برای جهت (برای نمونه: "&stop=%s")

url-ll-lat-first (اختیاری)

ترتیب عبارت‌های lat/long (عرض/طول جغرافیایی) در تنظیمات URL مربوط به Start، Stop و Via. به‌طور پیش‌فرض این مقدار TRUE است.

برای نمونه با استفاده از سرویس‌های Brouter، نشانی URL از یک جفت مقدار استفاده می‌کند که ابتدا طول و سپس عرض جغرافیایی است. بنابراین، تنظیم این مقدار روی FALSE اطمینان می‌دهد که جایگزینی مقادیر با ترتیب لازم انجام می‌شود.

referer (اختیاری)

یک URL برای ایفای نقش ارجاع‌دهنده (referer) در درخواست HTTP (برای نمونه: "http://hostname")

follow-location (اختیاری)

حداکثر تعداد مجاز تغییر مسیرها. مقدار پیش‌فرض -1 برای تعداد نامحدود تغییر مسیر است. اگر نمی‌خواهید تغییر مسیرها دنبال شوند از 0 استفاده کنید.

user-agent (اختیاری)

بازنویسی user-agent پیش‌فرض استفاده‌شده در درخواست HTTP.

custom-http-headers (اختیاری)

سرآیندهای سفارشی HTTP برای افزوده شدن به درخواست HTTP. مقدار پیش‌فرض هیچ (none) است.

توجه داشته باشید که بر خلاف custom-http-headers برای درخواست‌های بارگیری کاشی، هیچ جایگزینی مقداری در این رشته انجام نمی‌شود.

منابع داده فایل‌های دوردست.PP امکان افزودن ارجاع‌های وبی وجود دارد که انتظار می‌رود فایلی را بازگردانند که سپس می‌تواند مستقیماً باز شود یا از طریق GPSBabel تبدیل گردد.

این فایل، datasources.xml است که در «محل فایل پیکربندی کاربر» شما قرار دارد.

نمونه‌ای از این فایل در توزیع کد منبع موجود است: doc/examples/datasources.xml.

عنصر VikWebtoolDatasource امکان تعریف هر نشانی URL را با استفاده از منطق مبتنی بر مختصات فراهم می‌کند.

ویژگی‌های مرتبط عبارتند از:

label

متن نمایش‌داده‌شده در مدخل منو

url

نشانی URL پارامتربندی‌شده برای باز کردن، به سبک قالب printf در C، با حداکثر ۹ مقدار "%s". برای نمونه: http://hostname/getfile?lat=%s&lon=%s

ترتیب و معنای این پارامترها با url_format_code در زیر مشخص می‌شود

url_format_code

رشته‌ای که پارامترهای جایگزینی URL پارامتربندی‌شده را توصیف می‌کند؛ هر نویسه نشان‌دهنده نحوه تفسیر هر عبارت است.

B = پایین نمای جاری (Bottom)، یعنی کمینه عرض جغرافیایی

L = چپ نمای جاری (Left)، یعنی کمینه طول جغرافیایی

T = بالای نمای جاری (Top)، یعنی بیشینه عرض جغرافیایی

R = راست نمای جاری (Right)، یعنی بیشینه طول جغرافیایی

A = عرض جغرافیایی مرکز نمای جاری (lAtitude)

O = طول جغرافیایی مرکز نمای جاری (lOngitude)

Z = مقدار بزرگ‌نمایی OSM برای نمای جاری. ببینید: Zoom Levels[7]

P = عرض جغرافیایی نقطه انتخاب‌شده (selected Point's latitude)

N = طول جغرافیایی نقطه انتخاب‌شده (selected poiNt's longitude)

S = یک رشته ورودی مشخص‌شده توسط کاربر که از طریق یک کادر محاوره از کاربر درخواست می‌شود

بنابراین برای نمونه URL بالا، کد قالب باید AO باشد. file_type

این مقدار برای پارامتر -i در برقراری ارتباط با GPSBabel ارسال می‌شود.

اگر تعریف نشده باشد، فایل بازگردانده‌شده به‌صورت داخلی به‌عنوان یک فایل GPX تفسیر می‌شود.

مقادیر ممکن مانند 'kml'، 'mapsource' و غیره می‌توانند استفاده شوند. برای فهرست کامل به GPSBabel File Formats[8] مراجعه کنید.

babel_filter_args

این مقدار برای آرگومان‌های فیلتر در برقراری ارتباط با GPSBabel ارسال می‌شود.

به‌عنوان مثال، "-x nuketypes,routes" می‌تواند برای پالایش تمام مسیرها از نتایج استفاده شود.

input_label

این مقدار هنگام درخواست ورودی از کاربر استفاده می‌شود.

این مقدار برچسب کادر ورودی متن است.

referer (اختیاری)

یک URL برای ایفای نقش ارجاع‌دهنده در درخواست HTTP (مانند "http://hostname").

follow-location (اختیاری)

حداکثر تعداد مجاز تغییرمسیرها. مقدار پیش‌فرض برای تعداد نامحدود تغییرمسیر -1 است. اگر نمی‌خواهید تغییرمسیرها دنبال شوند از 0 استفاده کنید.

user-agent (اختیاری)

جایگزینی user-agent پیش‌فرض استفاده‌شده در درخواست HTTP.

custom-http-headers (اختیاری)

سرفصل‌های سفارشی HTTP برای افزودن به درخواست HTTP. مقدار پیش‌فرض none (هیچ) است.

مکان‌های فایل‌های افزونه سیستم.PP توجه داشته باشید که در سیستم‌های شبه UNIX(TM)، فایل‌های افزونه (maps.xml، goto_tools.xml، datasources.xml، external_tools.xml و routing.xml) در دایرکتوری‌های /etc/viking و /usr/share/viking (یا موارد مرتبط در سیستم شما) نیز جستجو می‌شوند.

متغیر محیطی $XDG_DATA_DIRS می‌تواند برای تغییر این دایرکتوری‌ها استفاده شود.

متغیر محیطی $XDG_DATA_HOME نیز (در صورت تنظیم بودن) برای جستجوی این فایل‌های افزونه استفاده می‌شود.

فایل‌ها (FILES)

پیکربندی Viking.PP

مکان فایل پیکربندی کاربر.PP

برنامهٔ Viking فایل‌های پیکربندی خود (viking.prefs، viking.ini، viking.ini و keys.rc) را در یک دایرکتوری مشخص جستجو می‌کند و پیش از امتحان مکان‌های جدید، مکان‌های قدیمی را بررسی می‌کند. بنابراین اگر Viking را ارتقا دهید، همچنان به استفاده از برپایی موجود شما ادامه خواهد داد.

برای سیستم‌های شبه UNIX(TM):

تا v1.8

~/.viking/

(معمولاً /home/username/.viking)

از v1.9 به بعد

سازگار با XDG Base Directory[9]

معمولاً ~/config/viking/

برای سیستم‌های Windows(TM):

v1.8 یا قدیمی‌تر

C:\Users\username\.viking

از v1.9 به بعد

C:\Users\username\AppData\Local\viking

برای Mac(TM):

/Library/Application Support/Viking

نکته

اگر Viking را به v1.9 ارتقا داده‌اید و می‌خواهید از مکان جدید استفاده کند، باید دایرکتوری موجود را به‌صورت دستی (زمانی که Viking در حال اجرا نیست) منتقل کنید؛ برای نمونه در خط فرمان: mv ~/.viking ~/.config/viking

نکته

دایرکتوری مکان فایل پیکربندی کاربر را می‌توان برای نشست فعلی از طریق تعیین صریح دایرکتوری پیکربندی با گزینهٔ خط فرمان --config-dir بازنویسی کرد. برای جزئیات بیشتر به بخش موسوم به “Details” مراجعه کنید.

تنظیمات اصلی.PP گزینه‌های پیکربندی اصلی Viking از طریق رابط کاربری گرافیکی (GUI) قابل کنترل هستند، همان‌طور که پیش‌تر در Preferences:??? مطرح شد.

این مقادیر در فایل متنی سادهٔ viking.prefs ذخیره می‌شوند. تنظیمات متفرقه.PP مقادیر منفرد گوناگون به‌طور خودکار بین نشست‌های Viking در فایل viking.ini واقع در مکان فایل پیکربندی کاربر شما ذخیره می‌شوند.

این فایل برای ویرایش دستی در نظر گرفته نشده است، اما از آنجا که یک فایل متنی ساده است، در صورت تمایل می‌توان آن را تغییر داد.

برخی مقادیر در این فایل non-GUI (غیرگرافیکی) هستند، به این معنی که راهی برای تنظیم آن‌ها جز وارد کردن دستی کلیدها و مقادیر وجود ندارد (در غیر این صورت کلید در فایل وجود نخواهد داشت). این امکان تنظیم دقیق برخی از رفتارهای Viking را بدون نیاز به کامپایل مجدد کد فراهم می‌کند. با این حال انتظار نمی‌رود که این مقادیر برای یک کاربر عادی نیاز به تغییر داشته باشند، از این رو هیچ گزینه‌ای در رابط گرافیکی برای آن‌ها ارائه نشده است.

در اینجا فهرست کلیدهای non-GUI و مقادیر پیش‌فرض آن‌ها آمده است.

•curl_cainfo=NULL

ببینید: CURLOPT_CAINFO[10]

•برای سیستم‌های شبه UNIX(TM): curl_ssl_verifypeer=1

برای سیستم‌های Windows(TM): curl_ssl_verifypeer=0

ببینید: CURLOPT_SSL_VERIFYPEER[11]

نکته
اگر هنگام بارگیری از منابع https با مشکل مواجه شدید، تنظیم این مقدار روی 0 باید اتصالات HTTPS را برقرار کند. در سیستم‌های عامل شبه UNIX(TM) مدیریت گواهی‌های SSL معمولاً در سطح کل سیستم انجام می‌شود و صادرکنندگان گواهی معتبر به‌طور منظم به‌روزرسانی می‌شوند. در حالی که برای Viking در Windows این کار فقط هنگام نصب یا به‌روزرسانی نسخه انجام می‌گیرد و بنابراین ممکن است قدیمی شده یا با منابع ناشناخته مواجه گردد و در نتیجه احتمال بروز خطاهای اعتبارسنجی بیشتر شود. به همین دلیل این گزینه به‌طور پیش‌فرض در Windows(TM) غیرفعال است - به‌ویژه برای اطمینان از اینکه نقشه‌های پیش‌فرض OpenTopoMap بدون دخالت دستی کاربر کار کنند.

•curl_user_agent=NULL

مقدار پیش‌فرض HTTP User-Agent (که در غیر این صورت به‌طور خودکار از ترکیب نام Viking، نسخه و اطلاعات curl تولید می‌شود) تنظیم‌شده در تمام درخواست‌های بارگیری را با مقدار مشخص‌شده جایگزین می‌کند.

همچنین ببینید: CURLOPT_USERAGENT[12]

توجه: User Agent برای بارگیری‌ها/درخواست‌های مجزا را می‌توان هنگام تعریف استفاده از منابع اضافی، از طریق ویژگی مرتبط user-agent تنظیم کرد.

•export_gpsmapper_option=false

برای فعال‌کردن گزینهٔ برون‌بری به قالب کم‌استفادهٔ GPS Mapper، این مقدار را روی true قرار دهید.

•export_gpspoint_option=false

برای فعال‌کردن گزینهٔ برون‌بری به قالب کم‌استفادهٔ GPS Point، این مقدار را روی true قرار دهید.

•geoclue_accuracy_level=4

مقدار عدد صحیح سطح دقت درخواستی از سرویس GeoClue را تعیین می‌کند. مقادیر مطابق با GClueAccuracyLevel[13]:

•0 = GCLUE_ACCURACY_LEVEL_NONE

•1 = GCLUE_ACCURACY_LEVEL_COUNTRY

•4 = GCLUE_ACCURACY_LEVEL_CITY

•5 = GCLUE_ACCURACY_LEVEL_NEIGHBORHOOD

•6 = GCLUE_ACCURACY_LEVEL_STREET

•8 = GCLUE_ACCURACY_LEVEL_EXACT

•gpx_tidy_points=true

در حال حاضر تنها تلاش می‌کند نخستین نقطه مشکوک یک ردپای GPX را حذف کند (در مقابل حذف هر نقطه‌ای در طول یک ردپا).

•gpx_tidy_points_max_speed=340

فراتر از این سرعت (بر حسب متر بر ثانیه) برای نخستین جفت نقطه - اولین نقطه حذف می‌شود.

•layers_create_trw_auto_default=false

ایجاد لایه‌های جدید TrackWaypoint بدون نمایش اولیه پنجره ویژگی‌های لایه.

•layers_panel_calendar_markup_mode=3

0=بدون نشانه‌گذاری. 1=روز علامت‌گذاری می‌شود. 2=روز علامت‌گذاری شده و راهنمای شناور (tooltip) ایجاد می‌شود. 3=خودکار (ایجاد زمان‌بندی‌شده راهنماهای شناور، بنابراین در صورت کندی بیش از حد به 1 بازمی‌گردد).

اگر پیام زیر در گزارش پیام‌ها نمایش داده شد:vik_layers_panel_calendar_update: detail level reduced as taking too longدر این صورت تنظیم این مقدار روی 2 را مد نظر قرار دهید - اگرچه با این هشدار که نوسازی‌های تقویم ممکن است تأخیرهای محسوسی ایجاد کند.

•maps_cache_status_no_file_color=red

•maps_cache_status_expired_color=yellow

•maps_cache_status_download_error_color=darkred

•maps_cache_status_okay_color=teal

نکته
رشته‌های مقدار maps_cache_status_*_color به‌طور مستقیم به تابع سطح پایین gdk_color_parse()[14] ارسال می‌شوند.

این رشته می‌تواند یکی از نام‌های استاندارد پرتعداد (برگرفته از فایل rgb.txt در X11) باشد، یا مقداری در مبنای ۱۶ به قالب "#rgb"، "#rrggbb"، "#rrrgggbbb" یا "#rrrrggggbbbb" باشد که در آن 'r'، 'g' و 'b' به ترتیب ارقام هگزادسیمال مؤلفه‌های قرمز، سبز و آبی رنگ هستند.

•maps_max_tiles=1000

•maps_min_shrinkfactor=0.0312499

•maps_max_shrinkfactor=8.0000001

•maps_real_min_shrinkfactor=0.0039062499

•maps_scale_inc_down=4

•maps_scale_inc_up=2

•maps_scale_smaller_zoom_first=true

•modifications_ignore_visibility_toggle=false

به‌ویژه اگر اغلب فایل‌های بزرگ .vik را مشاهده می‌کنید، تغییر وضعیت نمایانی موارد ممکن است صرفاً بخشی از فرایند مشاهده در نظر گرفته شود. بنابراین شاید مایل نباشید هنگام خروج درباره این موارد به شما اطلاع داده شود - در این حالت می‌توانید این مقدار را روی true تنظیم کنید.

•srtm_http_base_url=https://dds.cr.usgs.gov/srtm/version2_1/SRTM3

امکان استفاده از یک سرویس جایگزین را برای دریافت فایل‌های DEM SRTM فراهم می‌کند. توجه داشته باشید که ساختار روی سرور باید به دایرکتوری‌های مربوط به قاره‌ها (Continent) تقسیم شده باشد.

•mapnik_buffer_size=128 (برحسب پیکسل)

•osm_basic_auth=false

برای اجبار به استفاده از HTTP Basic Authentication حتی در صورت در دسترس بودن OAuth، روی true تنظیم کنید

•background_max_threads=10

•background_max_threads_local=تعداد CPUها

•window_default_tool=Select

گزینه‌ها عبارتند از: Pan، Zoom، Ruler یا Select

•window_menubar=true

•window_copy_centre_full_format=false

•window_move_scroll_timeout=5 (برحسب میلی‌ثانیه)

مدت زمان انتظار میان رویدادهای پیمایش جابه‌جایی پیش از ترسیم مجدد

•window_zoom_scroll_timeout=150 (برحسب میلی‌ثانیه)

مدت زمان انتظار میان رویدادهای پیمایش بزرگ‌نمایی پیش از ترسیم مجدد

•window_pinch_gesture_factor=1.5

ضریب حساسیت برای بزرگ‌نمایی دو انگشتی (pinch zooming). بهتر است این مقدار بین 0.5 و 3.0 نگه داشته شود - مقادیر بالاتر حساس‌تر هستند.

•window_mount_device_id=NULL

اگر محیط رومیزی شما دستگاه‌های ذخیره‌سازی USB را به‌طور خودکار سوار (mount) نمی‌کند یا تمایل دارید آن را در Viking نیز مدیریت کنید - این مقدار را روی برچسب درایو دستگاه، برای نمونه GARMIN یا مقدار UUID تنظیم کنید.

سپس Viking گزینه‌هایی را در منوی Help قرار می‌دهد تا بتوانید عملیات مورد نیاز را به‌صورت دستی انجام دهید.

این قابلیت به‌صورت یک ویژگی پایه‌ای و اختیاری ارائه شده است و تنها امکان مشخص کردن و مدیریت یک دستگاه را از طریق چند گزینه منوی اضافی فراهم می‌کند. در حال حاضر هیچ قصدی برای تبدیل این قابلیت به یک ویژگی کامل‌تر وجود ندارد؛ مدیریت دستگاه‌های USB به برنامه‌های دیگر واگذار شده است.

•version_check_period_days=14

•trackwaypoint_start_end_distance_diff=100.0

•trackwaypoint_tab_default=0

امکان تغییر برگهٔ پیش‌فرضی که هنگام باز شدن کادر گفتگوی ویژگی‌های لایه نشان داده می‌شود را فراهم می‌کند.

•gps_statusbar_format=GSA

این رشته در قالب کد قالب‌بندی پیام (Message Format Code) است.

•geoclue_statusbar_format=SA

این رشته در قالب کد قالب‌بندی پیام (Message Format Code) است.

•trkpt_selected_statusbar_format=KEATDN

این رشته در قالب کد قالب‌بندی پیام (Message Format Code) است.

•utils_nearest_tz_factor=1.0

•viewport_history_size=20

•viewport_history_diff_dist=500

به متر.

درخواست‌های «Go Back» یا «Go Forward» که فاصله‌شان از آخرین موقعیت تاریخچه فراتر از این محدوده باشد، به آن موقعیت بازمی‌گردند. اگر در این محدوده باشند، از این موقعیت صرف‌نظر شده و به موقعیت ذخیره‌شدهٔ بعدی در تاریخچه حرکت خواهد کرد.

•viewport_scale=1

اگر Viking به‌طور خودکار نمایشگر با وضوح بالا را تشخیص نداد، می‌توانید تنظیمات را از اینجا اجبار کنید - معمولاً با تنظیم این مقدار روی 2.

•viewport_popup_delay=200

به میلی‌ثانیه.

برنامه Viking باید یک پنجرهٔ بازشو با نام ردپای انتخاب‌شدهٔ فعلی نمایش دهد. اگر نشان داده نمی‌شود (شاید دستگاه شما تا حدی کُند است)، این مقدار را افزایش دهید.

•external_diary_program=rednotebook[15]

یا در Windows از این استفاده می‌کند: C:/Progra~1/Rednotebook/rednotebook.exe - این مقدار رشته‌ای باید از جداکننده‌های یونیکس استفاده کرده و بدون فاصله باشد.

•external_astro_program=stellarium[16]

یا در Windows از این استفاده کنید: C:/Progra~1/Stellarium/stellarium.exe - این مقدار رشته‌ای باید از جداکننده‌های یونیکس استفاده کرده و بدون فاصله باشد. باید نسخهٔ 0.15.0 یا بالاتر باشد (در غیر این صورت به دلیل این باگ[17] در عمل کار نخواهد کرد).

•external_text_program=gedit

یا در Windows از این استفاده می‌کند: notepad - این مقدار رشته‌ای باید از جداکننده‌های یونیکس استفاده کرده و بدون فاصله باشد.

•bfilter_simplify=100

•bfilter_compress=0.001

•list_date_format=%Y-%m-%d %H:%M

یک توضیحات قالب تاریخ[18] همان‌طور که به strftime() ارسال می‌شود. توجه داشته باشید که هنگام نمایش در جدول‌ها، مرتب‌سازی بر اساس این ستون صرفاً از مقدار متنی استفاده می‌کند، نه از مقدار تاریخ/زمان مبنا.

•export_device_path=بسته به سیستم‌عامل

UNIX = "/media/user/GARMIN/Garmin/GPX"

WINDOWS = ":/Garmin/GPX"

•export_device_trackpoint_limit=10000 (محدودیت معمول Garmin Edge)

محدودیت دستگاه‌های قدیمی‌تر Garmin معمولاً بسیار کمتر است - برای Etrex 20/30 برابر ۵۰۰ است

•export_device_routepoint_limit=250

•kmz_default_maps_dir=خالی

ممکن است بخواهید از مقداری مانند این استفاده کنید: "/media/user/GARMIN/Garmin/CustomMaps"

•geotag_photo_dir="/home/user/Pictures"

تغییر مکان جستجوی پایه برای عکس‌ها

تلاش می‌شود پوشه‌ای تاریخ‌دار منطبق بر ردپا با قالب /geotag_photo_dir/YYYY/MM/DD جستجو شود

•gpx_comment_time_format="%d-%B-%y %H:%M:%S"

قالب جایگزین مورد استفاده برای تولید برچسب‌های زمانی نقاط مسیر (waypoints) از روی توضیحات آن‌ها

•use_env_browser=false

به‌طور پیش‌فرض Viking برای باز کردن URLها از تابع سطح پایین gtk_show_uri_on_window() استفاده می‌کند که معمولاً منجر به باز شدن یک نمونهٔ جدید از مرورگر وب می‌شود.

می‌توان با تنظیم این مقدار پیکربندی روی true و تعیین متغیر محیطی BROWSER برای فراخوانی مرورگر دلخواه، این رفتار را تغییر داد؛ همچنین می‌توان پارامترهای خط فرمان اختیاری را برای اعمال رفتار دلخواه گنجاند؛ مانند «firefox --new-tab».

حتی می‌توان از یک رشتهٔ پیچیده‌تر برای اجرای نگارشی خاص با نمایه‌ای (profile) مشخص استفاده کرد، مانند: BROWSER="/home/rob/Downloads/firefox/firefox -P 'Nightly' --new-tab" viking

توجه داشته باشید که در صورت تنظیم BROWSER، سایر برنامه‌ها نیز ممکن است از این مقدار استفاده کنند.

این قابلیت روی Windows کاربرد ندارد، چرا که Viking در حال حاضر از تابع سطح پایین ShellExecute() برای باز کردن URLها استفاده می‌کند.

کد قالب پیام

در حال حاضر برای سهولت در پیاده‌سازی، کد قالب پیام یک رشته از نویسه‌ها است.

هر نویسه نشان‌دهنده آن است که چه چیزی باید در ارتباط با یک Trackpoint درج شود.

شاید روزی به چیزی کاربرپسندتر به همراه یک رابط کاربری برای کنترل آن تکامل یابد، شاید حتی امکان درج متن دلخواه را نیز بدهد. با این حال فعلاً حداقل سطحی از کنترل فراهم شده است :)

کد نویسه

G = متنی برای نمایش در ابتدای پیام - GPSD

K = متنی برای نمایش در ابتدای پیام - Trkpt

A = ارتفاع یک Trackpoint

S = سرعت یک Trackpoint

B = سرعت عمودی (صعود)

C = جهت حرکتی (Course) یک Trackpoint

L = مکان یک Trackpoint

T = زمان یک Trackpoint

M = اختلاف زمانی یک Trackpoint نسبت به Trackpoint قبلی

X = تعداد ماهواره‌های استفاده‌شده برای تثبیت موقعیت (fix) یک Trackpoint

D = فاصله Trackpoint از ابتدای ردپا (در امتداد ردپا)

F = فاصله Trackpoint تا پایان (انتهای) ردپا (در امتداد ردپا)

P = اختلاف فاصله Trackpoint نسبت به Trackpoint قبلی

N = نام ردپایی که Trackpoint متعلق به آن است.sp E = نام trackpoint

نکات خروجی

اگر خروجی دارای * پس از خود باشد، آنگاه مقدار از طریق درون‌یابی محاسبه شده است (مانند سرعت هنگامی که Trackpoint فاقد مقدار سرعت است).

اگر خروجی دارای ** پس از خود باشد، در تلاش برای به‌دست آوردن مقدار مشکلاتی پیش آمده است، بنابراین احتمالاً مقدار پیش‌فرض 0 نمایش داده خواهد شد.

تنظیمات کلیدهای میانبر (Accelerator)

این مورد در فایل keys.rc در User Configuration File Location نگهداری می‌شود.

این مورد در قالب استاندارد GTK Accelerator map است. مقادیر به‌طور خودکار خوانده شده و بین نشست‌های Viking ذخیره می‌شوند.

محیط (ENVIRONMENT)

XDG_DATA_HOME

دایرکتوری اختیاری برای جستجوی فایل‌های افزونه (maps.xml، goto_tools.xml، datasources.xml، external_tools.xml، routing.xml).

XDG_DATA_DIRS

مسیری که برای تغییر دایرکتوری‌های بررسی‌شده برای فایل‌های افزونه استفاده می‌شود (maps.xml، goto_tools.xml، datasources.xml، external_tools.xml، routing.xml).

VIKING_MAPS

مسیری که برای مکان ریشه پیش‌فرض نقشه‌ها استفاده می‌شود.

نویسندگان (AUTHORS)

این صفحه راهنما در ابتدا توسط Ralf Meyer <ranfyy@gmail.com> برای سیستم Debian(TM) نوشته شده است (اما ممکن است توسط دیگران نیز استفاده شود). اجازه کپی، توزیع و/یا تغییر این سند تحت شرایط مجوز عمومی همگانی GNU نسخه ۲ یا هر نسخه جدیدتر منتشرشده توسط بنیاد نرم‌افزارهای آزاد (Free Software Foundation) داده می‌شود.

در سیستم‌های Debian، متن کامل مجوز عمومی همگانی GNU را می‌توان در /usr/share/common-licenses/GPL یافت.