| 5 | | #!html |
| 6 | | <div style="float: left; margin: 15px;"> |
| | 7 | #!table style="border:1px solid #ccc;" |
| | 8 | {{{#!tr ===== |
| | 9 | {{{#!td valign=top style="border:none;" |
| | 10 | [[Image(source:trunk/images/logo.png, valign=top)]] |
| | 11 | }}} |
| | 12 | {{{#!td valign=top style="border:none; padding: 20px; width: 500px;" |
| | 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 |
| 10 | | #!html |
| 11 | | </div> |
| | 28 | #!table style="border:0; border-collapse:separate; border-spacing:0 10px" |
| | 29 | {{{#!tr ==================================== |
| | 30 | {{{#!td align=left valign=top style="background:#CBEEA7; font-size:120%; padding:0px 15px 15px 13px; border:2px solid #aaa" |
| | 31 | [[Image(source:trunk/images/openlocation.png, valign=middle, link=)]] |
| | 32 | Launch [/download/josm.jnlp josm.jnlp] (version |
| | 33 | [[Version(tested)]])[[br]] |
| | 34 | {{{#!span style="font-size:83%" |
| | 35 | recommended version, all platforms, automatic update ([http://www.java.com/en/download/faq/java_webstart.xml Web Start]) |
| | 36 | }}} |
| | 37 | }}} |
| | 38 | }}} |
| | 39 | {{{#!tr ==================================== |
| | 40 | {{{#!td align=left valign=top style="background:#CBEEA7; font-size:120%; padding:0px 15px 15px 13px; border:2px solid #aaa" |
| | 41 | [[Image(source:trunk/images/download.png, valign=middle, link=)]] |
| | 42 | Download [/josm-tested.jar josm-tested.jar] (version |
| | 43 | [[Version(tested)]])[[br]] |
| | 44 | {{{#!span style="font-size:83%" |
| | 45 | all platforms ([wiki:InstallNotes#Running how to run]) |
| | 46 | }}} |
| | 47 | }}} |
| | 48 | }}} |
| | 49 | {{{#!tr ==================================== |
| | 50 | {{{#!td align=left valign=top style="background:#eee; padding:0px 15px 0px 13px; border:1px solid #ccc;" |
| | 51 | [/download/windows/josm-setup.exe Windows installer] (version |
| | 52 | [[Version(tested)]]) |
| | 53 | }}} |
| | 54 | }}} |
| | 55 | {{{#!tr ==================================== |
| | 56 | {{{#!td align=left valign=top style="background:#eee; padding:0px 15px 0px 13px; border:1px solid #ccc" |
| | 57 | [/download/macosx/josm-macosx.zip Mac OS X package] (version |
| | 58 | [[Version(tested)]]) |
| | 59 | }}} |
| | 60 | }}} |
| 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]. |
| | 71 | == Extensions == |
| | 72 | * [[Image(/svn/trunk/images/preferences/plugin.png,link=wiki:Plugins,24px)]] **[wiki:Plugins]** ([[Help/Preferences/Plugins|installation instruction]]) |
| | 73 | * [[Image(/svn/trunk/images/dialogs/propertiesdialog.png,link=wiki:Presets)]] **[wiki:Presets]** ([[TaggingPresets|installation instruction]]) |
| | 74 | * [[Image(/svn/trunk/images/dialogs/mapstyle.png,link=wiki:Styles)]] **[wiki:Styles]** (installation instruction) |
| | 75 | * [[Image(/svn/trunk/images/imagery_menu.png,link=wiki:Maps)]] **[wiki:Maps]** ([[Help/Preferences/Imagery|installation instruction]]) |
| 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] |
| 58 | | === Problems === |
| 59 | | * For install troubles, look at the InstallNotes page and/or [http://wiki.openstreetmap.org/index.php/JOSM] |
| 60 | | * 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]''). |
| 61 | | * Understand [wiki:Releases JOSM release] system |
| | 89 | == Found a bug? | Have an idea? | Make a suggestion? == |
| | 90 | * Please report any bug found: |
| | 91 | Create a [/newticket new ticket]. 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]). |
| | 92 | * Discuss ideas and suggestions also in the [/newticket bug tracker] or on the [http://lists.openstreetmap.org/listinfo/josm-dev josm-dev] mailinglist |
| 63 | | == How to help == |
| 64 | | * [wiki:DevelopersGuide Help developing code] (e.g. write patches for entries in [/report bug tracker]) |
| 65 | | * Review bugs in [/report bug tracker]: find duplicates, test bugs and add more descriptive texts |
| 66 | | * [wiki:Translations Translate] JOSM and the online help into your language. |
| 67 | | * Update and translate the [wiki:Help online help] |
| 68 | | * Unify and translate all JOSM related Wiki pages and join them with the online help |
| 69 | | * Review translations |
| 70 | | * Review original texts (program, online help, ...) |
| 71 | | * Create fancy new icons for presets or tools without icons |
| 72 | | * ... |
| | 94 | == Contribute == |
| | 95 | |
| | 96 | * **use JOSM** |
| | 97 | * report bugs, discuss ideas, think of possible enhancements (see above) |
| | 98 | * participate in **[/report bug tracking]** |
| | 99 | * review bugs, up/down vote tickets, find duplicates, test bugs, add more descriptive texts |
| | 100 | * update/extend the **[wiki:Help online help]** |
| | 101 | * unify all JOSM related Wiki pages and join them with the online help |
| | 102 | * **[wiki:Translations translate]** program/documentation |
| | 103 | * **design** fancy new icons |
| | 104 | * **write code** – get the code and write patches … |
| | 105 | * from the official Subversion repository: {{{svn co http://josm.openstreetmap.de/svn/trunk josm}}} |
| | 106 | * from the official OSM Subversion repository (including plugins): {{{svn co http://svn.openstreetmap.org/applications/editors/josm}}} |
| | 107 | * from the unofficial [http://github.com/openstreetmap/josm GitHub mirror]: {{{git clone git://github.com/openstreetmap/josm.git}}} |
| | 108 | * see [wiki:DevelopersGuide developers guide] for build instructions and other details |
| | 109 | |
| | 110 | ---- |
