Changes between Version 210 and Version 339 of Help


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

Legend:

Unmodified
Added
Removed
Modified

  • Help

    v210 v339  
    11[[TranslatedPages]]
    2 [[PageOutline(2-10,Table of Contents)]]
    3 = Welcome to the JOSM online help system =
    42
    5 {{{
    6 #!html
    7 <p style="background-color:rgb(221,255,221);padding: 10pt; border-color:rgb(128,128,128);border-style: solid; border-width: 1px; width: 60%;">
    8 This help <strong>can be corrected</strong> at <a href="https://josm.openstreetmap.de/wiki/Help">josm.openstreetmap.de/wiki/Help</a><br/>
    9 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!
    10 </p>
     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.
     7
     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]**  ||
    1140}}}
    1241
    13 == Getting Started ==
    14 === Within this help/wiki ===
    15 * [wiki:Introduction Introduction to JOSM]
    16 * [wiki:HowTo How Tos] about JOSM
    17 * Migration assist from [wiki:iD], [wiki:Potlatch2] or [wiki:Vespucci]
     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 * [wiki:Help/Concepts/Object Objects] - explains what '''node''', '''way''', '''relation''' and '''tag''' is
    25 * There [wiki:Help/Concepts/Object#Relations many types of relations], currently loaded relations can be selected via [wiki:Help/Dialog/RelationList Relation list] but there [wiki:Help/Dialog/RelationEditor single interface to edit them]
    26 
    27 === JOSM ===
    28 * **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 [wiki:Shortcuts 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 * [wiki:Help/Preferences Preferences] - some of the settings [Help/Preferences/Advanced#Explanation are not acceptable via settings menu] or just spread everywhere in the editor
    30 * [wiki:Help/Action/Upload Upload changeset] - explains why you create a '''changeset''' and low level details when you upload data to the OSM server
    31 
    32 == Workflow examples ==
    33 * [[Help/Downloading data]] - there many ways to load existing data in JOSM
    34 * [wiki:Help/AudioMapping Audio mapping:] playing voice notes and synchronizing them with your GPS tracks in JOSM
    35 * [wiki:Help/Preferences/Validator Validator messages] - will explain how to fix common mistakes and what do they mean
    36 
    37 {{{
    38 #!html
    39 <!--
    40 candidates:
    41 http://www.openstreetmap.org/user/LLlypuk82/diary/35962
    42 -->
     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.
    4350}}}
    4451
    45 == JOSM tools ==
     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.   
    4660
    47 Search among all JOSM tools and menu items - Ctrl+Spacebar
     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.
    4868
    49 === Basic shape of objects ===
    50 * [Help/Action/Select Select, move and rotate] tools - you only need subset of tools from this list
    51 * [Help/Action/DrawBuilding Draw a rectangular stub] - optionally aligned along by other objects
    52 * [Help/Action/FastDrawingMode FastDraw] - useful with natural objects;
    53 * [Help/Action/Extrude Extrude], [Help/Action/Draw#Anglesnapping Angle snapping], Spline or Bezier ''from commandline'' - mostly for man made objects
    54 * both [Help/Action/Draw Draw nodes mode] (A) and [Help/Action/ImproveWayAccuracy Improve Way Accuracy mode] (W) - have their followers and use cases
     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 === Selection ===
    57 Current selection displayed in [wiki:/Help/Dialog/SelectionList Selection Dialog].
    58 * [Help/Action/Select#Selecttool Select] (S) - contain many modifiers, including [Help/Action/LassoMode lasso mode]
    59 * [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.
    60 * (Shift+F3) - search objects by preset
    61 * [[Help/Plugin/UtilsPlugin2#Selection]] - multiple selection focused tools ''from UtilsPlugin2''
    62 * [Help/Action/SelectNonBranchingWaySequences Select non branching way sequences] (Shift+W) - useful when editing highways, railways, rivers, power networks and networks in general
    63 * [Help/Action/SelectAll Select all] (CTRL+A) is more useful after you download precise list of objects
    64 
    65 === Tags ===
    66 Tags of currently selected objects displayed in [wiki:Help/Dialog/TagsMembership Tags/Memberships Dialog].
    67 * [Help/Action/Copy Copy] (Ctrl+C) - copy selected objects to the buffer
    68 * [Help/Action/PasteTags PasteTags] (Ctrl+Shift+V) - paste previously copied tags
    69 * Tabular editor (Ctrl+T) from ([[Help/Plugin/UtilsPlugin2]])
    70 * [Help/Action/Duplicate Duplicate] (Ctrl+D) not only tags but also their geometries
    71 * (Shift+R) (from [[Help/Plugin/UtilsPlugin2]]) copy tags from previous selection
    72 * Standard [Help/Dialog/AddValue Add value] (Alt+A) dialogue provides 5 shortcuts to 5 last used tags without closing this dialogue
    73 
    74 === Topology tools and changes ===
    75 * [Help/Action/MergeNodes Merge] (M) two or more points
    76 * [Help/Action/UnGlue UnGlue] (G, opposite of above) explode single point into multiple
    77 * [Help/Action/MoveNodeWay Join point into a way segment] (N)
    78 * [Help/Action/DisconnectNodeWay DisconnectNodeWay] (Alt+J, opposite of above) disconnect a node from a way segment
    79 * [Help/Action/AddIntersections AddIntersections] (Shift+I) (from [[Help/Plugin/UtilsPlugin2]]) - will create nodes at places where current selections intersects (or self intersects)
    80 * [Help/Action/SplitObject Split geometry by selected line] (Alt+X) (from [[Help/Plugin/UtilsPlugin2]])
    81 * [Help/Action/SplitWay Split way] (P) - split way by a node
    82 * [Help/Action/CombineWay Combine Way] (С) - combine several selected ways in one
    83 * [Help/Action/JoinAreas Join overlapping areas] (Shift+J)
    84 * [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
    85 
    86 === Geometry tools ===
    87 ==== Precision in angles ====
    88 * [Help/Action/Draw#Anglesnapping Anglesnapping] (A, twice) will ease drawing way segments in 30°, 45°, 60° and 90° degrees
    89 * [Help/Action/Extrude#Basicusage Extrude] (X, with modifiers) tool will ease drawing of strictly perpendicular segments
    90 
    91 ==== Alignment ====
    92 * [Help/Action/AlignInLine Align in line] (L) will align selected nodes into a line
    93 * [Help/Action/DistributeNodes Distribute] (Shift+B) as above, but also place them at equal distances
    94 * [Help/Action/Parallel Parallel] (Shift+P), draw lines and curves parallel to each other, draw nested infrastructure quickly
    95 * "Copy" objects at precise anchor points ''from commandline''
    96 * "Move" objects at custom vector ''from commandline''
    97 
    98 === Viewport control ===
    99 * Explained at [Help/MapView MapView], [Help/Menu/View "View" menu] and [Help/Action/Zoom Zoom tool]
    100 * [Help/Action/JumpToPosition JumpToPosition]
    101 
    102 
    103 == JOSM interface ==
    104 
    105 {{{
    106 #!html
    107 <!-- images may appear with 0 height in JOSM help, not sure how to fix it -->
    108 }}}
    109 || [[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)]] ||
    110 || 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]] ||
     72----
     73Here is [wikitr:/Help Main help]