| 5 | | #!html |
| 6 | | <div style="float: left; margin: 15px;"> |
| | 7 | #!table style="border:0; border-collapse:separate; border-spacing:0 10px; width: 55em;" |
| | 8 | {{{#!tr ==================================== |
| | 9 | {{{#!td valign=top style="border:1px solid #ccc; border-right:0" |
| | 10 | [[Image(source:trunk/images/logo.png,valign=top,link=,title=JOSM)]] |
| | 11 | }}} |
| | 12 | {{{#!td valign=top style="border:1px solid #ccc; border-left:0; padding: 20px;" |
| | 13 | {{{#!span style="font-size:120%" |
| | 14 | **JOSM** is an extensible editor for [http://www.openstreetmap.org OpenStreetMap] (OSM) written in [http://www.java.com Java] 1.6. |
| | 15 | }}} |
| | 16 | {{{#!comment |
| | 17 | FIXME: add better description here |
| 8 | | [[Image(/svn/trunk/images/logo.png)]] |
| 9 | | {{{ |
| 10 | | #!html |
| 11 | | </div> |
| | 19 | Currently it supports loading stand-alone GPX tracks and GPX track data from the OSM database as well as loading and editing existing nodes, ways, metadata tags and relations from the OSM database. |
| | 20 | }}} |
| | 21 | }}} |
| | 22 | {{{#!tr ==================================== |
| | 23 | {{{#!td colspan=2 align=left valign=top style="background:#CBEEA7; font-size:120%; padding:0px 15px 15px 13px; border:1px solid #ccc" |
| | 24 | [[Image(source:trunk/images/openlocation.png, valign=middle, link=)]] |
| | 25 | Launch [/download/josm.jnlp josm.jnlp] (version |
| | 26 | [[Version(tested)]])[[br]] |
| | 27 | {{{#!span style="font-size:83%" |
| | 28 | recommended version, all platforms, automatic update ([http://www.java.com/en/download/faq/java_webstart.xml Web Start]) |
| | 29 | }}} |
| | 30 | }}} |
| | 31 | }}} |
| | 32 | {{{#!tr ==================================== |
| | 33 | {{{#!td colspan=2 align=left valign=top style="background:#CBEEA7; font-size:120%; padding:0px 15px 15px 13px; border:1px solid #ccc" |
| | 34 | [[Image(source:trunk/images/download.png, valign=middle, link=)]] |
| | 35 | Download [/josm-tested.jar josm-tested.jar] (version |
| | 36 | [[Version(tested)]])[[br]] |
| | 37 | {{{#!span style="font-size:83%" |
| | 38 | all platforms ([wiki:InstallNotes#Running how to run]) |
| | 39 | }}} |
| | 40 | }}} |
| | 41 | }}} |
| | 42 | {{{#!tr ==================================== |
| | 43 | {{{#!td colspan=2 align=left valign=top style="background:#eee; padding:0px 15px 0px 13px; border:1px solid #ccc;" |
| | 44 | [/download/windows/josm-setup.exe Windows installer] (version |
| | 45 | [[Version(windows)]]) |
| | 46 | }}} |
| | 47 | }}} |
| | 48 | {{{#!tr ==================================== |
| | 49 | {{{#!td colspan=2 align=left valign=top style="background:#eee; padding:0px 15px 0px 13px; border:1px solid #ccc" |
| | 50 | [/download/macosx/josm-macosx.zip Mac OS X package] (version |
| | 51 | [[Version(macos)]]) |
| | 52 | }}} |
| | 53 | }}} |
| | 54 | {{{#!tr ==================================== |
| | 55 | {{{#!td colspan=2 align=left valign=top style="background:#eee; padding:0px 15px 0px 13px; border:1px solid #ccc" |
| | 56 | Latest [[Download#DevelopmentVersion|development version]] ([[Version(latest)]]), [[Download#Ubuntu|Ubuntu package repository]] and other [[Download|download]] options. |
| | 57 | }}} |
| | 58 | }}} |
| 18 | | == Download == |
| 19 | | * '''Note that there are fairly regular updates, so always try running a recent version (and also recent plugins).''' |
| 20 | | * Access [/download/josm.jnlp JOSM-WebStart] without installation |
| 21 | | * Download the '''[/josm-tested.jar tested JOSM ]''' version [[Version(tested)]] |
| 22 | | * Download the [/download/windows/josm-setup.exe Windows JOSM installer] version [[Version(windows)]] |
| 23 | | * Download the [/download/macosx/josm-macosx.zip Mac OS X JOSM package] version [[Version(macos)]] |
| 24 | | * Prepare a [wiki:USB_Stick USB flash drive] to use JOSM on any foreign Windows machine. |
| 25 | | * For download scripts use version check for [/latest latest] and [/tested tested] (or [/version both]) to reduce download bandwith |
| 26 | | * View the [[Changelog|summarized changelog]] or the [/log/?verbose=on SVN changelog]. Major changes are noted in the [wiki:StartupPage JOSM startup notes]. |
| 27 | | * If download size is an issue for you, you may append `?lang=..` to the download link for both releases to strip all unused translations (e.g. `?lang=de` would download JOSM in German language only). |
| 28 | | * Other [[Download]] options like Ubuntu package repository |
| 30 | | === Extensions === |
| 31 | | * Get many [wiki:Plugins plugins], [wiki:Presets presets] or [wiki:Styles styles] (Easier installation via JOSM preferences). |
| 32 | | * URLs of usable WMS services can be viewed and added at [wiki:Maps] page. |
| 33 | | * Problems with plugins? Have a look at the [/download/ JOSM download directory]. |
| 34 | | * Requests for new features can also be made via [/newticket trac] or via the JOSM developer mailing list ([mailto:josm-dev@openstreetmap.org josm-dev@openstreetmap.org]). You can [http://lists.openstreetmap.org/cgi-bin/mailman/listinfo/josm-dev subscribe here]. |
| | 68 | == Extensions == |
| | 69 | * [[Image(/svn/trunk/images/preferences/plugin.png,link=wiki:Plugins,24px)]] **[wiki:Plugins]** ([Help/Preferences/Plugins installation instructions]) |
| | 70 | * [[Image(/svn/trunk/images/dialogs/propertiesdialog.png,link=wiki:Presets)]] **[wiki:Presets]** ([TaggingPresets installation instructions]) |
| | 71 | * [[Image(/svn/trunk/images/dialogs/mapstyle.png,link=wiki:Styles)]] **[wiki:Styles]** (installation instructions) |
| | 72 | * [[Image(/svn/trunk/images/imagery_menu.png,link=wiki:Maps)]] **[wiki:Maps Backgrounds]** ([Help/Preferences/Imagery installation instructions]) |
| 36 | | == Development == |
| 37 | | * View the [[Changelog|summarized changelog]] or the [/log/?verbose=on SVN changelog]. Major changes are noted in the [wiki:StartupPage JOSM startup notes]. |
| 38 | | * Download the '''[/josm-latest.jar latest JOSM]''' version [[Version(latest)]] (may have more errors than "tested", be careful with this one). |
| 39 | | * Try '''[/applet JOSM applet]''' after reading the [wiki:Applet applet description]. |
| 40 | | * Get the source: |
| 41 | | * From the official Subversion repository (recommended): {{{svn co http://josm.openstreetmap.de/svn/trunk}}} |
| 42 | | * From the unofficial [http://github.com/openstreetmap/josm GitHub mirror]: {{{git clone git://github.com/openstreetmap/josm.git}}} |
| 43 | | * From the official OSM Subversion repository (including plugins): {{{svn co http://svn.openstreetmap.org/applications/editors/josm josm}}} |
| 44 | | * See [wiki:DevelopersGuide Developers Guide] or [wiki:Translations Translations Guide] |
| 45 | | * The Ubuntu JOSM project on [https://launchpad.net/ubuntu/+source/josm launchpad] |
| 57 | | === Problems === |
| 58 | | * For install troubles, look at the InstallNotes page and/or [http://wiki.openstreetmap.org/index.php/JOSM] |
| 59 | | * Report bugs via [/newticket trac]. When reporting a bug please include the version (version number can be found in menu ''[wiki:Help/Menu/Help Help] -> [wiki:Help/Action/About About]''). |
| 60 | | * Understand [wiki:Releases JOSM release] system |
| | 86 | == Found a bug? | Have an idea? | Make a suggestion? ==#Bugs |
| | 87 | * Please report any bug found: |
| | 88 | Create a [/newticket new ticket]. When reporting a bug, please include the first three blocks of the **status report** (Help -> [wiki:Help/Action/ShowStatusReport Show status report]). |
| | 89 | * Discuss ideas and suggestions also in the [/newticket bug tracker], on the [http://lists.openstreetmap.org/listinfo/josm-dev josm-dev] mailing list, or on the [irc://irc.oftc.net/josm #josm] IRC channel. |
| 62 | | == How to help == |
| 63 | | * [wiki:DevelopersGuide Help developing code] (e.g. write patches for entries in [/report bug tracker]) |
| 64 | | * Review bugs in [/report bug tracker]: find duplicates, test bugs and add more descriptive texts |
| 65 | | * [wiki:Translations Translate] JOSM and the online help into your language. |
| 66 | | * Update and translate the [wiki:Help online help] |
| 67 | | * Unify and translate all JOSM related Wiki pages and join them with the online help |
| 68 | | * Review translations |
| 69 | | * Review original texts (program, online help, ...) |
| 70 | | * Create fancy new icons for presets or tools without icons |
| 71 | | * ... |
| | 91 | == Contribute == |
| | 92 | |
| | 93 | * **Use JOSM** |
| | 94 | * Report bugs, discuss ideas, think of possible enhancements ([#Bugs see above]). |
| | 95 | * Participate in **[/report bug tracking]** |
| | 96 | * Review bugs, up/down vote tickets, find duplicates, test bugs, add more descriptive texts. |
| | 97 | * Correct/update/extend the **[wiki:Help online help]** |
| | 98 | * Unify all JOSM-related Wiki pages and join them with the online help. |
| | 99 | * **[wiki:Translations Translate]** program/documentation. |
| | 100 | * **Design** fancy new icons. |
| | 101 | * **Write code** – get the code and write patches … |
| | 102 | * [wiki:Download#Source get the code] |
| | 103 | * See [wiki:DevelopersGuide developers guide] for build instructions and other details. |
| | 104 | |
| | 105 | ---- |
| 74 | | * This site is a combined online help and bug tracking system for JOSM and JOSM plugins |
| 75 | | * No login is required to use this site (neither for reading nor for changes to wiki or bug tracker) |
| 76 | | * A login has following advantages: |
| 77 | | * The JOSM applet can store settings on the server |
| 78 | | * Mails are sent for changes in own bug tracker tickets (This is possible also by entering an e-mail as username in the tickets, but you are unable to change that later and the address is openly visible). |
| 79 | | * Page settings are remembered (e.g. input field size and a lot of other stuff) |
| | 108 | * This site is a combined online help and bug tracking system for JOSM and JOSM plugins. |
| | 109 | * No login is required to use this site (neither for reading nor for changes to wiki or bug tracker). |
| | 110 | * A login has the following advantages: |
| | 111 | * The JOSM applet can store settings on the server. |
| | 112 | * Mail is sent for changes in your own bug tracker tickets. This is possible by entering an e-mail as user name in the tickets, too, but then be aware that the address is openly visible and you are unable to change that later. |
| | 113 | * Page settings are remembered (e.g. input field size and a lot of other stuff). |
| 86 | | * For problems, ideas, suggestions use the [/newticket bug tracker] |
| 87 | | * The volunteers creating JOSM can be reached using the [http://lists.openstreetmap.org/listinfo/josm-dev josm-dev] mailinglist |
| 88 | | * The server running this service is operated by [http://www.fossgis.de/impressum.html FOSSGIS] society |
| | 121 | {{{ |
| | 122 | #!div class="wikipage compact" style="padding:0px; margin:0px; float:right; color: darkgray; font-size: 80%" |
| | 123 | Server sponsored by: [[br]][[Image(wiki:Sponsoring:hetzner.gif,title=Hetzner,link=http://www.hetzner.de/)]] |
| | 124 | }}} |
| | 125 | * For problems, ideas, suggestions use the [/newticket bug tracker]. |
| | 126 | * The volunteers creating JOSM can be reached using the [http://lists.openstreetmap.org/listinfo/josm-dev josm-dev] mailing list or the [irc://irc.oftc.net/josm #josm] IRC chat. |
| | 127 | * The server running this service is operated by [http://www.fossgis.de/impressum.html FOSSGIS] society. |