.TH JOSM 1 "March 22, 2021" .\" Please adjust this date whenever revising the manpage. .SH "نام (NAME)" josm \- ویرایشگر مبتنی بر جاوا برای سامانه نقشه‌برداری OpenStreetMap .SH "خلاصه دستور (SYNOPSIS)" .B josm .SH "توضیحات (DESCRIPTION)" .B JOSM یک ویرایشگر برای پروژه OpenStreetMap است که به زبان جاوا ۸ (Java 8) نوشته شده است. .PP .B OpenStreetMap پروژه‌ای با هدف تولید و فراهم‌سازی داده‌های جغرافیایی رایگان، از جمله نقشه‌های شهری و جاده‌ای، برای همگان است. این سامانه به شما اجازه می‌دهد تا داده‌های جغرافیایی را به‌صورت مشارکتی از هر نقطه‌ای از کره زمین مشاهده، ویرایش و استفاده کنید. این پروژه به این دلیل آغاز شد که اکثر نقشه‌هایی که عموم افراد آنها را رایگان می‌پندارند، در واقعیت دارای محدودیت‌های حقوقی یا فنی در استفاده هستند و مانع از به‌کارگیری آنها به شیوه‌های خلاقانه، سازنده یا پیش‌بینی‌نشده می‌شوند. .SH "گزینه‌ها (OPTIONS)" .TP .B \-h, \-?, \-\-help نمایش راهنما .TP .B \-\-geometry=x(+|-)x(+|-)y آرگومان استاندارد ابعاد و جایگاه هندسی پنجره X (X geometry) .TP .B [\-\-download=]minlat,minlon,maxlat,maxlon بارگیری محدوده جغرافیایی محصور (bounding box) .TP .B [\-\-download=] بارگیری موقعیت جغرافیایی در پیوند وب داده‌شده (با متغیرهای lat=x&lon=y&zoom=z) .TP .B [\-\-download=] باز کردن فایل (هر نوع فایلی که با منوی File/Open قابل گشودن باشد) .TP .B \-\-downloadgps=minlat,minlon,maxlat,maxlon بارگیری محدوده جغرافیایی به‌صورت داده‌های خام GPS .TP .B \-\-selection= انتخاب عناصر با استفاده از عبارت جستجوی داده‌شده .TP .B \-\-[no\-]maximize اجرا شدن یا نشدن برنامه در حالت تمام‌صفحه (Maximize) .TP .B \-\-reset\-preferences بازنشانی اولویت‌ها و تنظیمات به مقادیر پیش‌فرض .TP .B \-\-load\-preferences= تغییر اولویت‌ها و پیکربندی بر اساس فایل XML مشخص‌شده .TP .B \-\-set== تنظیم کلید مشخص‌شده به مقدار داده‌شده .TP .B \-\-language= تنظیم زبان برنامه .TP .B \-\-version نمایش نگارش برنامه JOSM .TP .B \-\-status-report نمایش گزارش وضعیت با اطلاعات سودمند جهت پیوست به گزارش باگ‌ها .TP .B \-\-debug چاپ پیام‌های اشکال‌زدایی (Debug) در پایانه .TP .B \-\-offline= غیرفعال کردن دسترسی به منبع یا منابع مشخص‌شده (جداشده با کاما) .SH "فایل‌ها (FILES)" فایل‌های JOSM مطابق با مشخصات دایرکتوری‌های پایه XDG ذخیره می‌شوند: .TP .B $HOME/.config/JOSM ترجیحات و تنظیمات (Preferences) .TP .B $HOME/.local/share/JOSM داده‌های کاربر .TP .B $HOME/.cache/JOSM حافظه موقت و کش (Cache) .TP اگر پوشه $HOME/.josm وجود داشته باشد، تمام فایل‌ها در آن ذخیره می‌شوند. .SH "ویژگی‌های جاوا (JAVA PROPERTIES)" گزینه‌های زیر را می‌توان با استفاده از مشخصه‌های سیستمی جاوا (یعنی \-Dkey=value پاس داده‌شده به جاوا، یا مشخص‌شده درون متغیر JAVA_OPTS) تنظیم کرد. .TP .B josm.pref= تنظیم دایرکتوری تنظیمات و اولویت‌های JOSM. .TP .B josm.userdata= تنظیم دایرکتوری داده‌های کاربری JOSM. .TP .B josm.cache= تنظیم دایرکتوری حافظه کش JOSM. .TP .B josm.home= انتقال هر ۳ پوشه بالا به دایرکتوری homedir. پوشه کش در /cache قرار خواهد گرفت. .TP .B josm.dir.name= تغییر نام دایرکتوری JOSM. .SH "محیط (ENVIRONMENT)" .IP JAVA_HOME مشخص کردن یک محیط جاوای جایگزین. .IP JAVA_OPTS مشخص کردن گزینه‌های جاوا. برای مثال، جهت استفاده از یک سرور پراکسی HTTP با این برنامه، این متغیر محیطی را پیش از اجرای josm به مقداری مشابه زیر تنظیم کنید: .I JAVA_OPTS="-Dhttp.proxyHost=yourProxyURL" .SH "نویسندگان (AUTHORS)" برنامه JOSM در ابتدا توسط Immanuel Scholz طراحی و کدنویسی شد و اکنون توسط جامعه OpenStreetMap نگهداری و توسعه داده می‌شود. .PP نگهدارنده فعلی JOSM آقای Dirk Stöcker است. بخش عمده‌ای از کارهای اداری و مدیریتی توسط Paul Hartmann و Vincent Privat انجام می‌شود. .PP مشارکت‌کنندگان اصلی کد (به ترتیب الفبایی): .PP Stefan Breunig David Earl Gabriel Ebner Dave Hansen Paul Hartmann Karl Guggisberg Matthias Julius Alexei Kasatkin Jiri Klement Ulf Lamping Simon Legner Raphael Mack Upliner Mikhalych Vincent Privat Frederik Ramm Dirk Stöcker .PP مشارکت‌های جزئی و وصله‌های بسیار از سوی دیگران؛ برای جزئیات به تاریخچه مخزن SVN در نشانی https://josm.openstreetmap.de/svn مراجعه کنید. جهت تماس با نویسندگان فعال پروژه، از آدرس «josm-dev AT openstreetmap.org» استفاده فرمایید. نشان‌واره پروژه توسط Ilya Palikov طراحی شده است. .PP این صفحه راهنما در اصل توسط Andreas Putzo برای پروژه دبیان نوشته شده است (اما توسط دیگران نیز قابل استفاده است).