Changes between Version 238 and Version 339 of Help


Ignore:
Timestamp:
(multiple changes)
Author:
(multiple changes)
Comment:
(multiple changes)

Legend:

Unmodified
Added
Removed
Modified

  • Help

    v238 v339  
    1 [[PageOutline(2-3,Table of Contents,inline,unnumbered)]]
    21[[TranslatedPages]]
    32
    4 = Welcome to the JOSM online help system =
     3= Main Help =
     4Welcome to the JOSM Help!
     5The [wikitr:/Introduction Introduction] will guide you to your first successful edit.
     6The [wikitr:/HowTo How Tos] deal with some use cases.
    57
    6 {{{
    7 #!html
    8 <p style="background-color:rgb(221,255,221);padding: 10pt; border-color:rgb(128,128,128);border-style: solid; border-width: 1px; width: 60%;">
    9 This help <strong>can be corrected</strong> at <a href="https://josm.openstreetmap.de/wiki/Help">josm.openstreetmap.de/wiki/Help</a><br/>
    10 Some information might be outdated, because JOSM is constantly enhanced with more features and tools. <a href="https://josm.openstreetmap.de/wiki#Whathasbeenchangedrecently">Recently implemented features</a> may miss good illustrations, animations, examples and text explanation. Please help improving by adding them or your personal tips and experience - this is a wiki!
    11 </p>
     8== Interface ==#Interface
     9The **[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]
     21all actions possible in JOSM.
     22A search finds every [wikitr:/Help/Action/SearchMenuItems menu item].
     23
     24On the **[wikitr:/Help/MapView Mapview]** all mouse clicks depend on the [wikitr:/Help/Menu/Mode#Workingmode Working mode] previously switched to.
     25New [wikitr:/Help/Concepts/Object objects] are created in ''Draw mode''.
     26In 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]**  ||
    1240}}}
    1341
    14 == Getting Started ==
    15 === Your first edits with JOSM ===
    16 * [wiki:Introduction Introduction to JOSM] - briefly covers downloading data, enabling and aligning imagery, main menu items, presets, validation, change-set comments and upload dialogue
    17 * Migration assist from [wiki:iD], [wiki:Potlatch2] or [wiki:Vespucci] - only if you have difficulties or questions related to respective editor "''I'm used to do (function) in (an editor) but what should I do in JOSM?''"
     42\\
    1843
    19 === OSM-wiki resources ===
    20 * [osmwiki:Get_help Where to get help?] - more general articles and resources (including [osmwiki:Map_Features Map features])
    21 
    22 == Concepts ==
    23 === OSM data model ===
    24 * [=#objects Objects] ([wiki:Help/Concepts/Object complete reference]) - explains what '''node''', '''way''', '''relation''' and '''tag''' is; ''Presets'' are introduced at the same page.
    25 * There are [wiki:Help/Concepts/Object#Relations many types of relations], currently loaded relations can be selected via [wiki:Help/Dialog/RelationList Relation list] but there a [wiki:Help/Dialog/RelationEditor single interface to edit them]
    26 
    27 === JOSM ===
    28 * [=#hotkeys Hotkeys] or shortcuts ([wiki:Shortcuts complete reference]). **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#SavesearchqueryinMaintoolbar saved search queries]). Some of the default hotkeys may surprise editors from iD and Poltrach. All shortcuts will be present under [Help/Preferences/Shortcuts "Hotkeys" tab in F12 menu] you can adjust and fine-tune them or reset at any moment.
    29 * [=#preferences Preferences] ([wiki:Help/Preferences complete reference]) - some of the settings [Help/Preferences/Advanced#Explanation are not accessible via settings menu] or just spread everywhere in the editor
    30 * [=#changeset Changeset] ([wiki:Help/Action/Upload upload changeset dialog]) - explains why you create a '''changeset''' and low level details when you upload data to the OSM server
    31 * [=#undoredo Undo/redo mechanism] - used to spot mistakes, but these tools are especially useful when ''learning new tools'' in JOSM. Similar to other editors, ''most operations'' in JOSM can be [Help/Action/Undo undone] and [Help/Action/Redo redone], unless they are listed in [wiki:Help/Listofirreversibleoperations list of irreversible operations]. Difference is that all changes can be displayed in [Help/Dialog/CommandStack command stack dialog].
    32 
    33 == Workflow examples ==
    34 * [[Help/Downloading data]] - there are many ways to load existing data in JOSM
    35 * [wiki:Help/AudioMapping Audio mapping:] playing voice notes and synchronizing them with your GPS tracks in JOSM
    36 * [wiki:Help/Preferences/Validator Validator messages] - will explain how to fix common mistakes and what do they mean
    37 * [wiki:HowTo How to create runabout from crossing ways]
    38 
    39 {{{
    40 #!html
    41 <!--
    42 candidates:
    43 http://www.openstreetmap.org/user/LLlypuk82/diary/35962
    44 -->
     44All screen elements have their own [wikitr:/Help/Action/Help help context] in JOSM.
     45Other dialogs exist
     46for 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
     48Only the non-modal dialogs and the preferences should be listed above
     49Please 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.
    4550}}}
    4651
    47 == JOSM tools (incomplete reference) ==
     52=== Changing the User Interface Scale ===
     53You can change the scaling factor of the user interface to better suit your screen or needs:
     541. Go to Edit -> Preferences (or hit F12)
     552. Scroll down to the category 'Advanced Preferences'
     563. 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.
     574. 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'.
     585. 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'.
     596. **Restart** JOSM for the changes to take effect.   
    4860
    49 {{{
    50 #!html
    51 List below contains mosty/only unreplaceable tools with preference to core JOSM tools. "Incomplete" should be stated explicitly to avoid misunderstandings from any part.
    52 }}}
     61== See also ==#SeeAlso
     62The 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.
    5368
    54 Search among all JOSM tools and menu items - Ctrl+Spacebar
     69As a companion for [osmwiki:Main_Page OpenStreetMap] since 2005, [osmwiki:JOSM]'s growth rate has been fast.
     70You are invited to help keep the wiki up to date, to translate it and to improve the [wikitr:/WikiStart#Contribute whole JOSM].
    5571
    56 === Basic shape of objects ===
    57 * [Help/Action/Select Select, move and rotate] tools - you only need subset of tools from this list
    58 * [Help/Action/DrawBuilding Draw a rectangular stub] - optionally aligned along by other objects
    59 * [Help/Action/FastDrawingMode FastDraw] - useful with natural objects;
    60 * [Help/Action/Extrude Extrude], [Help/Action/Draw#Anglesnapping Angle snapping], Spline or Bezier ''from commandline'' - mostly for man made objects
    61 * both [Help/Action/Draw Draw nodes mode] (A) and [Help/Action/ImproveWayAccuracy Improve Way Accuracy mode] (W) - have their followers and use cases
    62 * [Help/Action/Paste Paste previously copied objects] (Ctrl+V) - not only tags but also their geometries
    63 
    64 === Selection ===
    65 Selection (or list of currently selected objects) is preciesly described in [[Help/Dialog/SelectionList#Selection]] (because it is visible from this dialogue), it can be modified with following tools (incomplete list):
    66 * [Help/Action/Select#Selecttool Select objects] (S) - contains many modifiers, including [Help/Action/LassoMode lasso mode]
    67 * [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.
    68 * (Shift+F3) - search objects by preset
    69 * [[Help/Plugin/UtilsPlugin2#Selection]] - multiple selection focused tools ''from UtilsPlugin2''
    70 * [Help/Action/SelectNonBranchingWaySequences Select non branching way sequences] (Shift+W) - useful when editing highways, railways, rivers, power networks and networks in general
    71 * [Help/Action/SelectAll Select all] (CTRL+A) is more useful after you download precise list of objects
    72 
    73 === Tags ===
    74 Tags of currently selected objects displayed in [wiki:Help/Dialog/TagsMembership Tags/Memberships Dialog].
    75 * [Help/Action/Copy Copy] (Ctrl+C) - copy selected objects to the buffer
    76 * [Help/Action/PasteTags PasteTags] (Ctrl+Shift+V) - paste previously copied tags
    77 * Tabular editor (Ctrl+T) from ([[Help/Plugin/UtilsPlugin2]])
    78 * (Shift+R) (from [[Help/Plugin/UtilsPlugin2]]) copy tags from previous selection
    79 * Standard [Help/Dialog/AddValue Add value] (Alt+A) dialogue provides 5 shortcuts to 5 last used tags without closing this dialogue
    80 
    81 === Topology tools and changes ===
    82 * [Help/Action/MergeNodes Merge] (M) two or more points
    83 * [Help/Action/UnGlue UnGlue] (G, opposite of above) explode single point into multiple
    84 * [Help/Action/MoveNodeWay Join point into a way segment] (N)
    85 * [Help/Action/DisconnectNodeWay DisconnectNodeWay] (Alt+J, opposite of above) disconnect a node from a way segment
    86 * [Help/Action/AddIntersections AddIntersections] (Shift+I) (from [[Help/Plugin/UtilsPlugin2]]) - will create nodes at places where current selections intersects (or self intersects)
    87 * [Help/Action/SplitObject Split geometry by selected line] (Alt+X) (from [[Help/Plugin/UtilsPlugin2]])
    88 * [Help/Action/SplitWay Split way] (P) - split way by a node
    89 * [Help/Action/CombineWay Combine Way] (С) - combine several selected ways in one
    90 * [Help/Action/JoinAreas Join overlapping areas] (Shift+J)
    91 * [Help/Plugin/ContourMerge ContourMerge] mode can used to glue complex parts that would require too many ''Merges'' otherwise; it could also used to partially or full replace geometry of one object with partial or a complete geometry of other object
    92 
    93 === Geometry tools ===
    94 ==== Precision in angles ====
    95 * [Help/Action/Draw#Anglesnapping Anglesnapping] (A, twice) will ease drawing way segments in 30°, 45°, 60° and 90° degrees
    96 * [Help/Action/Extrude#Basicusage Extrude] (X, with modifiers) tool will ease drawing of strictly perpendicular segments
    97 
    98 ==== Alignment ====
    99 * [Help/Action/AlignInLine Align in line] (L) will align selected nodes into a line
    100 * [Help/Action/DistributeNodes Distribute] (Shift+B) as above, but also place them at equal distances
    101 * [Help/Action/Parallel Parallel] (Shift+P), draw lines and curves parallel to each other, draw nested infrastructure quickly
    102 * "Copy" objects at precise anchor points ''from commandline''
    103 * "Move" objects at custom vector ''from commandline''
    104 * [Help/Action/AlignInCircle Align selected nodes in circle] (O)
    105 
    106 === Viewport control ===
    107 * Explained at [Help/MapView MapView], [Help/Menu/View "View" menu] and [Help/Action/Zoom Zoom tool]
    108 * [Help/Action/JumpToPosition JumpToPosition]
    109 
    110 
    111 == JOSM interface ==
    112 
    113 === JOSM interface overview ===
    114 
    115 (stub)
    116 
    117 === JOSM starting screen ===
    118 {{{
    119 #!html
    120 <!-- images may appear with 0 height in JOSM help, not sure how to fix it -->
    121 }}}
    122 || [[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)]] ||
    123 || 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:Help/Menu 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]] ||
    124 
    125 === JOSM interface complete reference ===
    126 
    127 [[wiki:JOSM interface]] - complete reference. Pay attention, that ''menus in JOSM are very deep'', just couple of examples below:
    128 
    129 * [[wiki:JOSM interface]] > [[wiki:Help/Menu]] > [[Help/Menu/Presets]]
    130 * [[wiki:JOSM interface]] > [[wiki:Help/ToggleDialogs]] > [[wiki:Help/Dialog/TagsMembership]] - most users will stop here, but actually there are at least two menus: [[Help/Menu/TagsMembershipMenu#Rightclickonitemsintagspart]] and [[Help/Menu/TagsMembershipMenu#Rightclickonitemsinmembershipspart]]
    131 * [[wiki:JOSM interface]] > [[wiki:Help/ToggleDialogs]] > [[wiki:Help/Dialog/LayerList]]  - most users will stop here, but actually [Help/Dialog/LayerList#Layertypes there are not two, but 7 menus]
     72----
     73Here is [wikitr:/Help Main help]