Changes between Version 304 and Version 339 of Help


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

Legend:

Unmodified
Added
Removed
Modified

  • Help

    v304 v339  
    11[[TranslatedPages]]
    22
    3 = 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.
    47
    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 <a href="https://josm.openstreetmap.de/wiki/Portals">portal</a> <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/Help#Recentchanges">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>
     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 [[PageOutline(2-3,Table of Contents,inline,unnumbered)]]
     42\\
    1443
    15 == Getting Started ==
    16 === Your first edits with JOSM ===
    17 * [wiki:Introduction Introduction to JOSM] - briefly covers downloading data, enabling and aligning imagery, main menu items, presets, validation, change-set comments and upload dialogue
    18 * 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?''"
    19 
    20 === OSM-wiki resources ===
    21 * [osmwiki:Get_help Where to get help?] - more general articles and resources (including [osmwiki:Map_Features Map features])
    22 
    23 == Concepts ==
    24 === OSM data model ===
    25 * [=#objects Objects] ([Help/Concepts/Object complete reference]) - explains what '''node''', '''way''', '''relation''' and '''tag''' is; ''Presets'' are introduced at the same page.
    26 * There are [Help/Concepts/Object#Relations many types of relations], currently loaded relations can be selected via [Help/Dialog/RelationList Relations] but there a [Help/Dialog/RelationEditor single interface to edit them]
    27 
    28 === Changesets === #changeset
    29 [Help/Concepts/Changeset Changesets] exists for every of your "edit". They simply group data creations, modifications and deletions - with additional properties {{{comment}}}, {{{created_by}}}, {{{imagery_used}}} [osmwiki:Proposed_features/changeset_tags and several others] (this information stored as simple tags). Similar to other wiki software, one changeset can affect one object (a single character edit in the text), but may contain big changes (removals of paragraphs, partial or complete rewrite of the text) with the only difference that geo information is edited instead of text. Investigating history of one character is equally hard to comparing text at given point in time. Since [osmwiki:Planet.osm complete "text" in OSM is 30-600GB big] therefore users speak of history within several changesets and not about complete history every time.
    30 
    31 
    32 [Help/Action/Upload Upload changeset dialog] - explains why you create a '''changeset''' and low level details about protocol that uploads data to the OSM server
    33 
    34 === JOSM concepts ===
    35 * [=#extensions JOSM Extensions] '''[[JOSM Extensions and installation steps]]'''
    36 * [=#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 [Help/Action/Search#SavesearchqueryinMaintoolbar saved search queries]). Some of the default hotkeys or activation steps may be surprising. All active shortcuts will be present under [wiki:Help/Preferences/Shortcuts "Hotkeys" tab in F12 menu] you can adjust and fine-tune them or reset at any moment.
    37 * [=#preferences Preferences] ([Help/Preferences complete reference]) - some of the settings are unaccessible via [Help/Action/Preferences settings menu] or have [#JOSMinterfacecustomization control elements and menus everywhere in the editor]
    38 * [=#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 [Help/Listofirreversibleoperations list of irreversible operations]. Difference is that all changes can be displayed in [Help/Dialog/CommandStack command stack dialog].
    39 
    40 == Workflow examples ==
    41 * [[Help/Downloading data]] - there are many ways to load existing data in JOSM
    42 * Help/Relations - relation editing may involve multiple windows ([Help/Dialog/RelationList Relations window], [Help/Dialog/SelectionList Selection], [Help/Dialog/RelationEditor Relation editor]) in JOSM. Some plugins may simplify some steps, but provide less clarity about what you do: many tools, states or tags become "hidden" or even worse: simply unaccessible.
    43 * [wiki:Help/Operating_multiple_JOSM_at_once Operating multiple JOSM at once] - you are not limited to run one copy of JOSM, unfortunately we don't have any details about it yet (please help us if you are working this way)
    44 * [Help/AudioMapping Audio mapping]: playing voice notes and synchronizing them with your GPS tracks in JOSM
    45 * [Help/Preferences/Validator Validator messages] - will explain how to fix common mistakes and what do they mean
    46 * [wiki:HowTo How to create runabout from crossing ways]
    47 
    48 {{{
    49 #!html
    50 <!--
    51 candidates:
    52 http://www.openstreetmap.org/user/LLlypuk82/diary/35962
    53 -->
     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.
    5450}}}
    5551
    56 == Recent changes ==
     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.   
    5760
    58 JOSM is in constant development and many features are implemented every year, you can miss some of its recently implemented features
     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.
    5968
    60 * [wiki:StartupPage Startup notes] - most important changes
    61 * [wiki:Changelog Summarized changelog] - nicely summarized
    62 * [/log/?verbose=on SVN changelog] - very detailed, knowledge of Java may be necessary
     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].
    6371
    64 == JOSM tools (incomplete reference) ==
    65 
    66 {{{
    67 #!html
    68 List below contains mosty/only unreplaceable tools with preference to core JOSM tools. "Incomplete" should be stated explicitly to avoid misunderstandings from any part.
    69 }}}
    70 
    71 [wiki:Help/Action/SearchMenuItems Search among all JOSM tools and menu items] - {{{Ctrl+Spacebar}}}
    72 
    73 === Basic shape of objects ===
    74 * [Help/Action/Select Select, move and rotate] tools - you only need subset of tools from this list
    75 * [Help/Action/DrawBuilding Draw a rectangular stub] - optionally aligned along by other objects
    76 * [Help/Action/FastDrawingMode FastDraw] - useful with natural objects;
    77 * [Help/Action/Extrude Extrude], [Help/Action/Draw/AngleSnap Angle snapping], [osmwiki:JOSM/Plugins/CommandLine#Usage Spline or Bezier ''from commandline plugin''] - mostly for man made objects
    78 * both [Help/Action/Draw Draw nodes mode] and [Help/Action/ImproveWayAccuracy Improve Way Accuracy mode] - have their followers and use cases
    79 * [Help/Action/Paste Paste previously copied objects] - not only tags but also their geometries
    80 
    81 === Selection ===
    82 Selection (or list of currently selected objects) is precisely described in Help/Dialog/SelectionList#Selection (because it is visible from this dialogue), it can be modified with following tools (incomplete list):
    83 * [Help/Action/Select#Selecttool Select objects] - contains many modifiers, including [Help/Action/LassoMode lasso mode]
    84 * [Help/Action/Search Search] - a very powerful tool and a query language with [Help/Action/Search#Keywords over 28 keywords] and flexible operators to combine them in flexible manner. Not to mention regex and [wiki:Help/Styles/MapCSSImplementation mapcss] filters.
    85 * (Shift+F3) - search objects by preset
    86 * [wiki:Help/Plugin/UtilsPlugin2#Selection] - multiple selection focused tools ''from UtilsPlugin2''
    87 * [Help/Action/SelectNonBranchingWaySequences Select non branching way sequences] - useful when editing highways, railways, rivers, power networks and networks in general
    88 * [Help/Action/SelectAll Select all] is more useful after you download precise list of objects
    89 
    90 === Tags ===
    91 Tags of currently selected objects displayed in [Help/Dialog/TagsMembership Tags/Memberships Dialog].
    92 * [Help/Action/Copy Copy] - copy selected objects to the buffer
    93 * [Help/Action/PasteTags PasteTags] - paste previously copied tags
    94 * Tabular editor (Ctrl+T) (from [wiki:Help/Plugin/UtilsPlugin2 UtilsPlugin2])
    95 * (Shift+R) (from [wiki:Help/Plugin/UtilsPlugin2 UtilsPlugin2]) copy tags from previous selection
    96 * Standard [Help/Dialog/AddValue Add value] (Alt+A) dialogue provides 5 shortcuts to 5 last used tags without closing this dialogue
    97 
    98 === Topology tools and changes ===
    99 * [Help/Action/MergeNodes Merge] two or more points
    100 * [Help/Action/UnGlue UnGlue] explode single point into multiple
    101 * [Help/Action/MoveNodeWay Join point into a way segment]
    102 * [wiki:Help/Action/DisconnectNodeWay DisconnectNodeWay] - opposite of above, disconnect a node from a way segment
    103 * [wiki:Help/Action/AddIntersections AddIntersections] (Shift+I) (from [wiki:Help/Plugin/UtilsPlugin2 UtilsPlugin2]) - will create nodes at places where current selections intersects (or self intersects)
    104 * [wiki:Help/Action/SplitObject Split geometry by selected line] (Alt+X) (from [wiki:Help/Plugin/UtilsPlugin2 UtilsPlugin2])
    105 * [Help/Action/SplitWay Split way] - split way by a node
    106 * [Help/Action/CombineWay Combine Way] - combine several selected ways in one
    107 * [Help/Action/JoinAreas Join overlapping areas]
    108 * [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 completely replace geometry of one object with partial or a complete geometry of other object
    109 
    110 === Geometry tools ===
    111 ==== Precision in angles ====
    112 * [Help/Action/Draw#Anglesnapping Anglesnapping] will ease drawing way segments in 30°, 45°, 60° and 90° degrees
    113 * [Help/Action/Extrude#Basicusage Extrude] tool will ease drawing of strictly perpendicular segments
    114 
    115 ==== Alignment ====
    116 * [Help/Action/AlignInLine Align in line] will align selected nodes into a line
    117 * [Help/Action/DistributeNodes Distribute] as above, but also place them at equal distances
    118 * "Copy" objects at precise anchor points ''from [osmwiki:JOSM/Plugins/CommandLine commandline]''
    119 * "Move" objects at custom vector ''from [osmwiki:JOSM/Plugins/CommandLine commandline]''
    120 * [Help/Action/AlignInCircle Align selected nodes in circle]
    121 
    122 ===== Parallel =====
    123 * [Help/Action/Parallel Parallel], draw lines and curves parallel to each other, draw nested infrastructure quickly
    124 * [Help/Action/Extrude#MovesegmentinparallelCtrl Extude mode used on segments] - will move them in parallel, preserving angles when it is needed
    125 
    126 
    127 ==== Rotation ====
    128 * [Help/Action/Select#Rotateobjects Rotate objects] at user-defined angle (but exact angle is unknown)
    129 * {{{ShapeTools}}} [wiki:Plugins plugin]:
    130  * Rotate object at predefined angle
    131  * Rotate objects (match building with road)
    132  * Rotate objects (match building with road, don't rotate more than epsilon)
    133 
    134 === Viewport control ===
    135 * Explained at [Help/MapView MapView], [Help/Menu/View "View" menu] and [Help/Action/Zoom Zoom tool]
    136 * [Help/Dialog/Minimap Minimap] window
    137 * [Help/Action/JumpToPosition JumpToPosition]
    138 
    139 
    140 == JOSM interface ==
    141 
    142 === JOSM interface overview ===
    143 
    144 Interface terminology (make sure to study bolded items first):
    145  
    146 Note: Together, 3 and 4 may contain too many items to display at once, use mouse scroll wheel in this case.
    147 
    148 || 1. '''[Help/Menu Main menu]'''[[br]][[br]] 2. [Help/MainToolbar Main toolbar] ('''[Help/Preferences/Toolbar heavily customizable]''')[[br]][[br]][[br]][[br]][[br]][[br]][[br]][[br]] 3. '''[Help/EditToolbar JOSM modes]'''[[br]][[br]][[br]][[br]][[br]][[br]] 4. toggles used to control on/off state of ''Windows''[[br]][[br]][[br]][[br]][[br]][[br]][[br]][[br]][[br]][[br]][[br]][[br]][[br]][[br]][[br]][[br]][[br]][[br]][[br]][[br]][[br]][[br]][[br]] 5. [Help/StatusBar Status bar]|| [[Image(10168-en-expert-false-Vatican-arrows.png,inline,nolink)]] || [[br]][[br]][[br]][[br]][[br]][[br]][[br]] 6. Slider and scaler[[br]][[br]][[br]][[br]][[br]] 7. '''[Help/ToggleDialogs Windows]''' (or dialogs)[[br]]• '''[Help/Dialog/LayerList Layer List]'''[[br]]• '''[Help/Dialog/TagsMembership Tags/Memberships]'''[[br]]• '''[wiki:Help/Dialog/SelectionList Selection]'''[[br]]• '''[Help/Dialog/RelationList Relations List]'''[[br]]• (others)[[br]][[br]][[br]] 8. [Help/MapView Main editing window][[br]][[br]][[br]][[br]][[br]][[br]][[br]][[br]][[br]][[br]][[br]][[br]][[br]][[br]][[br]][[br]][[br]][[br]] 9. Details about [Help/Modes#Activateamode current mode] ||
    149 
    150 === JOSM starting screen ===
    151 
    152 1. In JOSM, [[wiki:Help/Downloading data]] step performed first. For example, [wiki:Introduction#Downloading use simple Download menu]
    153 2. Additional and more complex tools may be activated with [Help/ExpertMode Expert mode] (also, pay attention to the left side of the screen)
    154 
    155 === JOSM interface complete reference ===
    156 
    157 [[wiki:JOSM interface]] - complete reference. Pay attention, that ''menu pages at this wiki are very deep'', just couple of examples below:
    158 
    159 * [[wiki:JOSM interface]] > Help/Menu > Help/Menu/Presets
    160 * [[wiki:JOSM interface]] > Help/ToggleDialogs > 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
    161 * [[wiki:JOSM interface]] > Help/ToggleDialogs > Help/Dialog/LayerList  - most users will stop here, but actually [Help/Dialog/LayerList#Layertypes there are not two, but 7 menus]
    162 
    163 === JOSM interface customization ===
    164 
    165 See [[Help/JOSM interface customization]] for details.
     72----
     73Here is [wikitr:/Help Main help]