Changes between Version 143 and Version 300 of Help


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

Legend:

Unmodified
Added
Removed
Modified
  • Help

    v143 v300  
    11[[TranslatedPages]]
    2 [[PageOutline(2-10,Table of Contents)]]
     2
    33= Welcome to the JOSM online help system =
    4 From JOSM you can reach this page
    5 * by clicking the menu item **''Help -> [[Image(source:trunk/images/help.png,20,middle)]] Help''**
    6 * by clicking on a [[Image(source:trunk/images/help.png,20,middle)]] **help button** in one of the JOSM dialogs
    7 * by pressing **{{{F1}}}**
    84
    95{{{
    106#!html
    11 <p style="background-color:rgb(253,255,221);padding: 10pt; border-color:rgb(128,128,128);border-style: solid; border-width: 1px; width: 60%;">
    12 <strong>Please help to improve online help information.</strong><br/>
    13 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!
     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%;">
     8This 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/>
     9Some 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!
    1410</p>
    1511}}}
    1612
     13[[PageOutline(2-3,Table of Contents,inline,unnumbered)]]
     14
    1715== Getting Started ==
    18 === Within this wiki ===
    19 * [wiki:Introduction Introduction to JOSM]
    20 * [wiki:HowTo How Tos] about JOSM
    21 * [wiki:Help/AudioMapping Audio mapping:] playing voice notes and synchronizing them with your GPS tracks in JOSM
    22 * [wiki:Shortcuts Keyboard shortcuts]
     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?''"
    2319
    24 === In the OSM-wiki ===
    25 * [osmwiki:JOSM JOSM page]
    26 * [osmwiki:JOSM/Guide JOSM Guide]
     20=== OSM-wiki resources ===
     21* [osmwiki:Get_help Where to get help?] - more general articles and resources (including [osmwiki:Map_Features Map features])
    2722
    28 === Openstreetmap in general ===
    29 * [osmwiki:Main_Page Openstreetmap wiki]
    30 * [osmwiki:FAQ FAQ about OSM in general]
    31 * [osmwiki:Map_Features Map features]
     23=== Other channels ===
     24* [[JOSM channels]]
    3225
    3326== Concepts ==
    34 * [wiki:Help/Concepts/Object Objects] - explains what '''objects''' maps consist of and how these objects are described in detail
    35 * [wiki:Help/Concepts/Conflict Conflict] - explains the basics of '''conflicts''', why they occur, how they are detected and how you can resolve them
    36 * [wiki:Help/Concepts/Changeset Changeset] - explains why you create a '''changeset''' when you upload data to the OSM server
     27=== OSM data model ===
     28* [=#objects Objects] ([Help/Concepts/Object complete reference]) - explains what '''node''', '''way''', '''relation''' and '''tag''' is; ''Presets'' are introduced at the same page.
     29* 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]
     30
     31=== Changesets === #changeset
     32[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.
     33
     34
     35[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
     36
     37=== JOSM concepts ===
     38* [=#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.
     39* [=#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]
     40* [=#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].
     41
     42== Workflow examples ==
     43* [[Help/Downloading data]] - there are many ways to load existing data in JOSM
     44* 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.
     45* [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)
     46* [Help/AudioMapping Audio mapping]: playing voice notes and synchronizing them with your GPS tracks in JOSM
     47* [Help/Preferences/Validator Validator messages] - will explain how to fix common mistakes and what do they mean
     48* [wiki:HowTo How to create runabout from crossing ways]
     49
     50{{{
     51#!html
     52<!--
     53candidates:
     54http://www.openstreetmap.org/user/LLlypuk82/diary/35962
     55-->
     56}}}
     57
     58== JOSM tools (incomplete reference) ==
     59
     60{{{
     61#!html
     62List below contains mosty/only unreplaceable tools with preference to core JOSM tools. "Incomplete" should be stated explicitly to avoid misunderstandings from any part.
     63}}}
     64
     65[wiki:Help/Action/SearchMenuItems Search among all JOSM tools and menu items] - {{{Ctrl+Spacebar}}}
     66
     67=== Basic shape of objects ===
     68* [Help/Action/Select Select, move and rotate] tools - you only need subset of tools from this list
     69* [Help/Action/DrawBuilding Draw a rectangular stub] - optionally aligned along by other objects
     70* [Help/Action/FastDrawingMode FastDraw] - useful with natural objects;
     71* [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
     72* both [Help/Action/Draw Draw nodes mode] and [Help/Action/ImproveWayAccuracy Improve Way Accuracy mode] - have their followers and use cases
     73* [Help/Action/Paste Paste previously copied objects] - not only tags but also their geometries
     74
     75=== Selection ===
     76Selection (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):
     77* [Help/Action/Select#Selecttool Select objects] - contains many modifiers, including [Help/Action/LassoMode lasso mode]
     78* [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.
     79* (Shift+F3) - search objects by preset
     80* [wiki:Help/Plugin/UtilsPlugin2#Selection] - multiple selection focused tools ''from UtilsPlugin2''
     81* [Help/Action/SelectNonBranchingWaySequences Select non branching way sequences] - useful when editing highways, railways, rivers, power networks and networks in general
     82* [Help/Action/SelectAll Select all] is more useful after you download precise list of objects
     83
     84=== Tags ===
     85Tags of currently selected objects displayed in [Help/Dialog/TagsMembership Tags/Memberships Dialog].
     86* [Help/Action/Copy Copy] - copy selected objects to the buffer
     87* [Help/Action/PasteTags PasteTags] - paste previously copied tags
     88* Tabular editor (Ctrl+T) (from [wiki:Help/Plugin/UtilsPlugin2 UtilsPlugin2])
     89* (Shift+R) (from [wiki:Help/Plugin/UtilsPlugin2 UtilsPlugin2]) copy tags from previous selection
     90* Standard [Help/Dialog/AddValue Add value] (Alt+A) dialogue provides 5 shortcuts to 5 last used tags without closing this dialogue
     91
     92=== Topology tools and changes ===
     93* [Help/Action/MergeNodes Merge] two or more points
     94* [Help/Action/UnGlue UnGlue] explode single point into multiple
     95* [Help/Action/MoveNodeWay Join point into a way segment]
     96* [wiki:Help/Action/DisconnectNodeWay DisconnectNodeWay] - opposite of above, disconnect a node from a way segment
     97* [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)
     98* [wiki:Help/Action/SplitObject Split geometry by selected line] (Alt+X) (from [wiki:Help/Plugin/UtilsPlugin2 UtilsPlugin2])
     99* [Help/Action/SplitWay Split way] - split way by a node
     100* [Help/Action/CombineWay Combine Way] - combine several selected ways in one
     101* [Help/Action/JoinAreas Join overlapping areas]
     102* [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
     103
     104=== Geometry tools ===
     105==== Precision in angles ====
     106* [Help/Action/Draw#Anglesnapping Anglesnapping] will ease drawing way segments in 30°, 45°, 60° and 90° degrees
     107* [Help/Action/Extrude#Basicusage Extrude] tool will ease drawing of strictly perpendicular segments
     108
     109==== Alignment ====
     110* [Help/Action/AlignInLine Align in line] will align selected nodes into a line
     111* [Help/Action/DistributeNodes Distribute] as above, but also place them at equal distances
     112* "Copy" objects at precise anchor points ''from [osmwiki:JOSM/Plugins/CommandLine commandline]''
     113* "Move" objects at custom vector ''from [osmwiki:JOSM/Plugins/CommandLine commandline]''
     114* [Help/Action/AlignInCircle Align selected nodes in circle]
     115
     116===== Parallel =====
     117* [Help/Action/Parallel Parallel], draw lines and curves parallel to each other, draw nested infrastructure quickly
     118* [Help/Action/Extrude#MovesegmentinparallelCtrl Extude mode used on segments] - will move them in parallel, preserving angles when it is needed
     119
     120
     121==== Rotation ====
     122* [Help/Action/Select#Rotateobjects Rotate objects] at user-defined angle (but exact angle is unknown)
     123* {{{ShapeTools}}} [wiki:Plugins plugin]:
     124 * Rotate object at predefined angle
     125 * Rotate objects (match building with road)
     126 * Rotate objects (match building with road, don't rotate more than epsilon)
     127
     128=== Viewport control ===
     129* Explained at [Help/MapView MapView], [Help/Menu/View "View" menu] and [Help/Action/Zoom Zoom tool]
     130* [Help/Dialog/Minimap Minimap] window
     131* [Help/Action/JumpToPosition JumpToPosition]
     132
    37133
    38134== JOSM interface ==
    39 [[Image(josm-screen-commented2.png)]]
    40135
    41 === Map View ===
    42 * [wiki:Help/MapView Map View] - The main area, where editing takes place
     136=== JOSM interface overview ===
    43137
    44 === Main Menu ===
    45 Depending on which [wiki:Help/Preferences/Plugins plugins] you have installed you may have more options on this menu.
    46 * [wiki:Help/Menu/File File]
    47 * [wiki:Help/Menu/Edit Edit]
    48 * [wiki:Help/Menu/View View]
    49 * [wiki:Help/Menu/Tools Tools]
    50 * [wiki:Help/Menu/Selection Selection]
    51 * [wiki:Help/Menu/Presets Presets]
    52 * [wiki:Help/Menu/Imagery Imagery]
    53 * [wiki:Help/ToggleDialogs Windows]
    54 * [wiki:Help/Menu/Audio Audio]
    55 * [wiki:Help/Menu/Help Help]
    56 * a search box which allows to search for menu items
     138Interface terminology (make sure to study bolded items first):
     139 
     140Note: Together, 3 and 4 may contain too many items to display at once, use mouse scroll wheel in this case.
    57141
    58 === Toolbars ===
    59 * [wiki:Help/MainToolbar Main Toolbar] - the toolbar above the main JOSM window. [[BR]] 
    60  This toolbar is highly customisable, with the ability to add and remove menus items from the [wiki:Help/Action/Preferences preferences] dialog.
    61 * [wiki:Help/EditToolbar Edit Toolbar] - the toolbar down the left hand side of the main JOSM window
     142|| 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] ||
    62143
    63 === Toggle Dialogs ===
    64 * [wiki:Help/ToggleDialogs Toggle Dialogs] - right part of JOSM window
     144=== JOSM starting screen ===
    65145
    66 === Status Bar ===
    67 * [wiki:Help/StatusBar Status Bar] - bottom panel of JOSM window
     1461. In JOSM, [[wiki:Help/Downloading data]] step performed first. For example, [wiki:Introduction#Downloading use simple Download menu]
     1472. Additional and more complex tools may be activated with [Help/ExpertMode Expert mode] (also, pay attention to the left side of the screen)
    68148
    69 === Other dialogs ===
    70 * [wiki:Help/Dialog/AddValue Add Value Dialog] - add tags to any object
    71 * [[Image(source:trunk/images/dialogs/changeset/changesetmanager.svg,24,middle)]] [wiki:Help/Dialog/ChangesetManager Changeset Manager] - query, download, view, and close [wiki:Help/Concepts/Changeset changesets]
    72 * [[Image(source:trunk/images/dialogs/conflict.png,middle)]] [wiki:Help/Dialog/Conflict Conflict Dialog] - use the Conflict Dialog to [wiki:Help/Concepts/Conflict resolve conflicts].
    73 * [[Image(source:trunk/images/dialogs/relationlist.png,middle)]] [wiki:Help/Dialog/RelationEditor Relation Editor] - use the Relation Editor to create and/or modify [wiki:Help/Concepts/Object relations]
    74 * [[Image(source:trunk/images/preference.png,middle)]] [wiki:Help/Action/Preferences Preferences Dialog] - view and change the preferences of JOSM.
    75 * [wiki:Help/Dialog/UnsavedChangesDialog Unsaved Changes Dialog] - dialog to warn and offer upload/save function if a data layer is deleted.
    76 * [wiki:Help/Action/Upload#TheUploadDialog Upload Dialog] - information about the pending upload, comment-field and many options
     149=== JOSM interface complete reference ===
    77150
    78 == JOSM Plugins ==
    79 * A list of available plugins can be found at the [wiki:Plugins plugin page]
    80 * [wiki:Help/Plugins Plugin descriptions] within JOSM help
    81 * Information and Documentation about various JOSM plugins can also be found starting from the [osmwiki:JOSM/Plugins JOSM-Plugin page] in the OSM-wiki
     151[[wiki:JOSM interface]] - complete reference. Pay attention, that ''menu pages at this wiki are very deep'', just couple of examples below:
    82152
    83 == JOSM error messages ==
    84 * [wiki:Help/ErrorMessages Error messages]
     153* [[wiki:JOSM interface]] > Help/Menu > Help/Menu/Presets
     154* [[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
     155* [[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]
     156
     157=== JOSM interface customization ===
     158
     159See [[Help/JOSM interface customization]] for details.