| 8 | | {{{ |
| 9 | | #!html |
| 10 | | <p style="background-color:rgb(253,255,221);padding: 10pt; border-color:rgb(128,128,128);border-style: solid; border-width: 1px;"> |
| 11 | | <strong>Please help to improve online help information.</strong><br/> |
| 12 | | This help might get outdated from time to time. Please help improving it by fixing parts that are missing or outdated - this is a wiki! |
| 13 | | </p> |
| | 3 | = Main Help = |
| | 4 | Welcome to the JOSM Help! |
| | 5 | The [wikitr:/Introduction Introduction] will guide you to your first successful edit. |
| | 6 | The [wikitr:/HowTo How Tos] deal with some use cases. |
| | 7 | |
| | 8 | == Interface ==#Interface |
| | 9 | The **[wikitr:/Help/Menu Main menu]** offers under |
| | 10 | [wikitr:/Help/Menu/File File], |
| | 11 | [wikitr:/Help/Menu/Edit Edit], |
| | 12 | [wikitr:/Help/Menu/View View], |
| | 13 | [wikitr:/Help/Menu/Mode Mode], |
| | 14 | [wikitr:/Help/Menu/Tools Tools], |
| | 15 | [wikitr:/Help/Menu/Selection Selection], |
| | 16 | [wikitr:/Help/Menu/Presets Presets], |
| | 17 | [wikitr:/Help/Menu/Imagery Imagery], |
| | 18 | [wikitr:/Help/Menu/Windows Windows], |
| | 19 | [wikitr:/Help/Menu/Audio Audio] and |
| | 20 | [wikitr:/Help/Menu/Help Help] |
| | 21 | all actions possible in JOSM. |
| | 22 | A search finds every [wikitr:/Help/Action/SearchMenuItems menu item]. |
| | 23 | |
| | 24 | On the **[wikitr:/Help/MapView Mapview]** all mouse clicks depend on the [wikitr:/Help/Menu/Mode#Workingmode Working mode] previously switched to. |
| | 25 | New [wikitr:/Help/Concepts/Object objects] are created in ''Draw mode''. |
| | 26 | In other modes objects are [wikitr:/Help/Action/Select selected] and edited. |
| | 27 | |
| | 28 | * The **[wikitr:/Help/MainToolbar Main toolbar]** has buttons for actions and presets |
| | 29 | * The panels in the **[wikitr:/Help/ToggleDialogs Sidebar]** inform about the loaded data and the [wikitr:/Help/Dialog/SelectionList#Selection Selection] |
| | 30 | * The **[wikitr:/Help/StatusBar Status Bar]** shows the drawing position |
| | 31 | * The Working mode is indicated in the **[wikitr:/Help/EditToolbar Edit toolbar]**. |
| | 32 | Therefore the buttons in its upper part are important screen elements. |
| | 33 | |
| | 34 | \\ |
| | 35 | |
| | 36 | {{{#!table style="margin-left:auto;margin-right:auto;" |
| | 37 | || **[wikitr:/Help/Menu Main menu]**[=#InterfaceMainMenu] || **[wikitr:/Help/MapView Mapview]** || **[wikitr:/Help/MainToolbar Main toolbar]** || |
| | 38 | |||||| [[Image(Josm_main.jpg.svg,link=)]] || |
| | 39 | || **[wikitr:/Help/EditToolbar Edit toolbar]** || **[wikitr:/Help/StatusBar Statusbar]** || **[wikitr:/Help/ToggleDialogs Sidebar]** || |
| 18 | | == Getting Started == |
| 19 | | * [wiki:Introduction Introduction to JOSM] |
| 20 | | * [http://wiki.openstreetmap.org/wiki/Josm JOSM page on the OSM wiki] |
| 21 | | * [wiki:HowTo How Tos] about JOSM |
| 22 | | * [wiki:Help/AudioMapping Audio mapping:] playing voice notes and synchronizing them with your GPS tracks in JOSM |
| 23 | | * [http://wiki.openstreetmap.org/index.php/FAQ FAQ about OSM in general] |
| 24 | | * [wiki:Shortcuts Keyboard shortcuts] |
| | 44 | All screen elements have their own [wikitr:/Help/Action/Help help context] in JOSM. |
| | 45 | Other dialogs exist |
| | 46 | for setting [wikitr:/Help/Action/Preferences Preferences], for managing [wikitr:/Help/Dialog/ChangesetManager Changesets], for resolving [wikitr:/Help/Dialog/Conflict Conflicts], for editing [wikitr:/Help/Dialog/RelationEditor Relations] and for browsing the [wikitr:/Help/Action/ObjectHistory History of an object]. |
| | 47 | {{{#!comment |
| | 48 | Only the non-modal dialogs and the preferences should be listed above |
| | 49 | Please no additional icons. For example JOSMImage(dialogs/relationlist) may mean the Relation editor, but it is already shown twice in the screenshot for other elements. Offering a third meaning brings no benefit. |
| | 50 | }}} |
| 26 | | == Concepts == |
| 27 | | * [wiki:Help/Concepts/Object Objects] - explains what '''objects''' maps consist of and how these objects are described in detail |
| 28 | | * [wiki:Help/Concepts/Conflict Conflict] - explains the basics of '''conflicts''', why they occur, how they are detected and how you can resolve them |
| 29 | | * [wiki:Help/Concepts/Changeset Changeset] - explains why you create a '''changeset''' when you upload data to the OSM server |
| | 52 | === Changing the User Interface Scale === |
| | 53 | You can change the scaling factor of the user interface to better suit your screen or needs: |
| | 54 | 1. Go to Edit -> Preferences (or hit F12) |
| | 55 | 2. Scroll down to the category 'Advanced Preferences' |
| | 56 | 3. In the search box above the list of various configuration entries, enter `gui` to filter the list. This way you will be able to get quickly to the relevant entries. |
| | 57 | 4. Adjust elements to your needs by changing entries starting with `gui.scale` or ending with `.font`. For example, to increase everything by 50%, change all of them from '1.0' to '1.5'. |
| | 58 | 5. In addition, you can also change only certain Icon sets. As in step 4, filter the list by `iconsize` and change according to your needs. For example, increase the default icon size by changing 'iconsize.default' to '36'. |
| | 59 | 6. **Restart** JOSM for the changes to take effect. |
| 31 | | == JOSM interface == |
| 32 | | [[Image(josm-screen-commented.png)]] |
| | 61 | == See also ==#SeeAlso |
| | 62 | The power of JOSM lies in its flexibility, allowing every user to download, create and publish: |
| | 63 | * [wikitr:/Presets Presets] to create a rich map with common object types, |
| | 64 | * [wikitr:/Rules Rules] to tag according to guidelines, |
| | 65 | * [wikitr:/Styles Styles] to paint maps to taste, |
| | 66 | * [wikitr:/Plugins Plugins] to extend JOSM's functionality and |
| | 67 | * [wikitr:/Shortcuts Keyboard shortcuts] of their choosing. |
| 37 | | === Main Menu === |
| 38 | | Depending on which [wiki:Help/Preferences/Plugins plugins] you have installed you may have more options on this menu. |
| 39 | | * [wiki:Help/Menu/File File] |
| 40 | | * [wiki:Help/Menu/Edit Edit] |
| 41 | | * [wiki:Help/Menu/View View] |
| 42 | | * [wiki:Help/Menu/Tools Tools] |
| 43 | | * [wiki:Help/Menu/Presets Presets] |
| 44 | | * [wiki:Help/Menu/Imagery Imagery] |
| 45 | | * [wiki:Help/ToggleDialogs Windows] |
| 46 | | * [wiki:Help/Menu/Audio Audio] |
| 47 | | * [wiki:Help/Menu/Help Help] |
| 48 | | |
| 49 | | === Toolbars === |
| 50 | | * [wiki:Help/MainToolbar Main Toolbar] - the toolbar above the main JOSM window. [[BR]] |
| 51 | | This toolbar is highly customisable, with the ability to add and remove menus items from the [wiki:Help/Action/Preferences preferences] dialog. |
| 52 | | * [wiki:Help/EditToolbar Edit Toolbar] - the toolbar down the left hand side of the main JOSM window |
| 53 | | |
| 54 | | === Toggle Dialogs === |
| 55 | | * [wiki:Help/ToggleDialogs Toggle Dialogs] - lower right part of JOSM window |
| 56 | | |
| 57 | | === Other dialogs === |
| 58 | | * [[Image(source:trunk/images/dialogs/changesetdialog.png)]] [wiki:Help/Dialog/ChangesetManager Changeset Manager] - query, download, view, and close [wiki:Help/Concepts/Changeset changesets] |
| 59 | | * [[Image(source:trunk/images/dialogs/conflict.png)]] [wiki:Help/Dialog/Conflict Conflict Dialog] - use the Conflict Dialog to [wiki:Help/Concepts/Conflict resolve conflicts]. |
| 60 | | * [[Image(source:trunk/images/dialogs/history.png)]] [wiki:Help/Dialog/History History Dialog] - browse the history of a [wiki:Help/Concepts/Object node, way, or relation] |
| 61 | | * [[Image(source:trunk/images/dialogs/relationlist.png)]] [wiki:Help/Dialog/RelationEditor Relation Editor] - use the Relation Editor to create and/or modify [wiki:Help/Concepts/Object relations] |
| 62 | | * [[Image(source:trunk/images/preference.png)]] [wiki:Help/Action/Preferences Preferences Dialog] - view and change the preferences of JOSM. |
| 63 | | * [wiki:Help/Dialog/UnsavedChangesDialog Unsaved Changes Dialog] - dialog to warn and offer upload/save function if a data layer is deleted. |
| 64 | | * [wiki:Help/Action/UploadDialog Upload Dialog] - information about the pending upload, comment-field and many options |
| 65 | | |
| 66 | | == JOSM Plugins == |
| 67 | | * A list of available plugins can be found at the [wiki:Plugins plugin page]. |
| 68 | | * [wiki:Help/Plugins Plugin descriptions] within JOSM help. |
| 69 | | * Information and Documentation about various JOSM plugins can be found here: [http://wiki.openstreetmap.org/index.php/JOSM/Plugins] |
| 70 | | |
| 71 | | == JOSM error messages == |
| 72 | | * [wiki:Help/ErrorMessages Error messages] |
| | 72 | ---- |
| | 73 | Here is [wikitr:/Help Main help] |