| 5 | | {{{ |
| 6 | | #!html |
| 7 | | <p style="background-color:rgb(253,255,221);padding: 10pt; border-color:rgb(128,128,128);border-style: solid; border-width: 1px; width: 60%;"> |
| 8 | | <strong>Please help to improve online help information.</strong><br/> |
| 9 | | 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! |
| 10 | | </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 | | === OSM-wiki resources === |
| 19 | | * [osmwiki:JOSM JOSM] page and [osmwiki:JOSM/Guide JOSM Guide] |
| 20 | | * [osmwiki:Get_help Where to get help?] - more general articles and resources (including [osmwiki:Map_Features Map features]) |
| 21 | | |
| 22 | | == Concepts == |
| 23 | | * [wiki:Help/Concepts/Object Objects] - explains what '''objects''' maps consist of and how these objects are described in detail |
| 24 | | * **EVERY** "button" and menu item may be assigned with hot-key (including menu items provided with [wiki:Plugins plugins]; popular [wiki:Presets presets] and [wiki:Help/Action/Search#AddSearchToMainToolbar saved search queries]). Some [wiki:Shortcuts default hotkeys] may surprise editors from iD and Poltrach. All shortcuts will be present [Help/Preferences/Shortcuts "Hotkeys" tab in F12 menu] you can adjust and fine-tune them or reset at any moment. |
| 25 | | * [wiki:Help/Preferences Preferences] - some of the setting are not acceptable via settings menu or just spread everywhere in the editor |
| 26 | | * [wiki:Help/Action/Upload Upload changeset] - explains why you create a '''changeset''' and low level details when you upload data to the OSM server |
| 27 | | |
| 28 | | == Workflow examples == |
| 29 | | * [wiki:Help/AudioMapping Audio mapping:] playing voice notes and synchronizing them with your GPS tracks in JOSM |
| 30 | | * [wiki:Help/HowTo/ValidatorExamples Validator examples] - will explain how to fix common mistakes |
| 31 | | |
| 32 | | {{{ |
| 33 | | #!html |
| 34 | | <!-- |
| 35 | | candidates: |
| 36 | | http://www.openstreetmap.org/user/LLlypuk82/diary/35962 |
| 37 | | --> |
| | 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. |
| 40 | | == JOSM tools == |
| | 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. |
| 42 | | Selection: |
| 43 | | * [Help/Action/Select#Selecttool Select] (S) - contain many modifiers, including [Help/Action/LassoMode lasso mode] |
| 44 | | * [Help/Action/Search Search] (CTRL+F) - a very powerful tool and a query language with [wiki:Help/Action/Search#Keywords over 28 keywords] and flexible operators to combine them in flexible manner. Not to mention regex and mapcss filters. |
| 45 | | * [[Help/Plugin/UtilsPlugin2#Selection]] |
| 46 | | * Select non branching way sequences (Shift+W) - useful when editing highways, railways, rivers, powernet works and networks in general |
| 47 | | * Select all (CTRL+A) is more useful after you download precise list of objects |
| | 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. |
| 49 | | Tags: |
| 50 | | * [Help/Action/Copy Copy] (Ctrl+C) - copy selected objects to the buffer |
| 51 | | * [Help/Action/PasteTags PasteTags] (Ctrl+Shift+V) - paste previously copied tags |
| 52 | | * Tabular editor (CTRL+T) from ([[Help/Plugin/UtilsPlugin2]]) |
| 53 | | * [Help/Action/Duplicate Duplicate] (Ctrl+D) not only tags but also their geometries |
| 54 | | * (Shift+R) (from [[Help/Plugin/UtilsPlugin2]]) copy tags from previous selection |
| 55 | | * Standard [Help/Dialog/AddValue Add value] (Alt+A) dialogue provides 5 shortcuts to 5 last used tags without closing this dialogue |
| | 69 | As a companion for [osmwiki:Main_Page OpenStreetMap] since 2005, [osmwiki:JOSM]'s growth rate has been fast. |
| | 70 | You are invited to help keep the wiki up to date, to translate it and to improve the [wikitr:/WikiStart#Contribute whole JOSM]. |
| 57 | | Topology tools and changes: |
| 58 | | * [Help/Action/MergeNodes Merge] (M) two or more points |
| 59 | | * [Help/Action/UnGlue UnGlue] (G, opposite of above) explode single point into multiple |
| 60 | | * [Help/Action/JoinNodeWay Join point into a way segment] (J) |
| 61 | | * [Help/Action/DisconnectNodeWay DisconnectNodeWay] (Alt+J, opposite of above) disconnect a node from a way segment |
| 62 | | * [Help/Action/AddIntersections AddIntersections] (SHIFT+I) (from [[Help/Plugin/UtilsPlugin2]]) - will create nodes at places where current selections intersects (or self intersects) |
| 63 | | * [Help/Action/SplitObject Split geometry by selected line] (Alt+X) (from [[Help/Plugin/UtilsPlugin2]]) |
| 64 | | * [Help/Action/SplitWay Split way] (P) - split way by a node |
| 65 | | |
| 66 | | Geometry tools (precision in angles): |
| 67 | | * [Help/Action/Draw#Anglesnapping Anglesnapping] (A, twice) will ease drawing way segments in 30°, 45°, 60° and 90° degrees |
| 68 | | * [Help/Action/Extrude#Basicusage Extrude] (X, with modifiers) tool will ease drawing of strictly perpendicular segments |
| 69 | | |
| 70 | | Geometry tools (alignment): |
| 71 | | * [Help/Action/AlignInLine Align in line] (L) will align selected nodes into a line |
| 72 | | * [Help/Action/DistributeNodes Distribute] (Shift+B) as above, but also place them at equal distances |
| 73 | | * [Help/Action/Parallel Parallel] (Shift+P), draw lines parallel and draw nested rectangles quickly |
| 74 | | |
| 75 | | Viewport control: |
| 76 | | * Explained at [Help/MapView MapView], [Help/Menu/View "View" menu] and [Help/Action/Zoom Zoom tool] |
| 77 | | * [Help/Action/JumpToPosition JumpToPosition] |
| 78 | | |
| 79 | | |
| 80 | | == JOSM interface == |
| 81 | | |
| 82 | | {{{ |
| 83 | | #!html |
| 84 | | <!-- images may appear with 0 height in JOSM help, not sure how to fix it --> |
| 85 | | }}} |
| 86 | | || [[Image(9229-en.png, 300px)]] || [[Image(9229-en-expert-false-Moscow Kremlin.png, 300px)]] || [[Image(9229-en-expert-true-Moscow Kremlin.png, 300px)]] || [[Image(9229-en-expert-true-Moscow Kremlin-terminology.png, 300px)]] || |
| 87 | | || Starting screen may be confusing for newcomers, you need to get data first using [Help/Action/Download Download menu] || Here is what you will see if you choose Moscow Kremlin || Additional and more complex tools may be activated with [Help/ExpertMode Expert mode] (pay attention to the left side of the screen) || [[wiki:JOSM interface]]: 1 - '''[[wiki:JOSM interface|main menu]]''', 2 - [Help/MainToolbar main toolbar], 3 - [Help/EditToolbar edit toolbar], 4 - [Help/StatusBar status bar], 5 - ..., 6 - '''[Help/ToggleDialogs toggle dialogs]''', 7 - Search menu items, 8 - [Help/MapView map view]. See also [[Help/JOSM interface customization]] || |
| 88 | | |
| 89 | | == JOSM error messages == |
| 90 | | * [wiki:Help/ErrorMessages Error messages] |
| | 72 | ---- |
| | 73 | Here is [wikitr:/Help Main help] |
