Changes between Version 314 and Version 315 of Help


Ignore:
Timestamp:
2016-12-19T00:51:02+01:00 (9 years ago)
Author:
bastiK
Comment:

roll back to version 143, see #12801, comment 26

Legend:

Unmodified
Added
Removed
Modified

  • Help

    v314 v315  
    11[[TranslatedPages]]
    2 
     2[[PageOutline(2-10,Table of Contents)]]
    33= Welcome to the JOSM online help system =
     4From 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}}}**
    48
    59{{{
    610#!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!
     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/>
     13This help might get outdated from time to time. Please help improving it by fixing parts that are missing or outdated - this is a wiki!
    1014</p>
    1115}}}
    1216
    13 [[PageOutline(2-3,Table of Contents,inline,unnumbered)]]
     17== 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]
    1423
    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?''"
     24=== In the OSM-wiki ===
     25* [osmwiki:JOSM JOSM page]
     26* [osmwiki:JOSM/Guide JOSM Guide]
    1927
    20 === OSM-wiki resources ===
    21 * [osmwiki:Get_help Where to get help?] - more general articles and resources (including [osmwiki:Map_Features Map features])
     28=== Openstreetmap in general ===
     29* [osmwiki:Main_Page Openstreetmap wiki]
     30* [osmwiki:FAQ FAQ about OSM in general]
     31* [osmwiki:Map_Features Map features]
    2232
    2333== 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 * [Help/Concepts/Changeset Changeset] exists for every of your "edit"
    27 
    28 === JOSM concepts ===
    29 * [=#extensions JOSM Extensions] '''[[JOSM Extensions and installation steps]]'''
    30 * [=#hotkeys Hotkeys] or shortcuts ([wiki:Shortcuts complete reference]).
    31 * [=#preferences Preferences] ([Help/Preferences complete reference]).
    32 * [=#validator Validator] ([Help/Validator complete reference]).
    33 
    34 == Workflow examples ==
    35 * [[Help/Downloading data]] - there are many ways to load existing data in JOSM
    36 * Help/Relations - relation editing may involve multiple windows in JOSM.
    37 * [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)
    38 * [Help/AudioMapping Audio mapping]: playing voice notes and synchronizing them with your GPS tracks in JOSM
    39 * [wiki:HowTo How to create runabout from crossing ways]
    40 
    41 {{{
    42 #!html
    43 <!--
    44 candidates:
    45 http://www.openstreetmap.org/user/LLlypuk82/diary/35962
    46 -->
    47 }}}
    48 
    49 == Recent changes ==
    50 
    51 JOSM is in constant development and many features are implemented every year, you can miss some of its recently implemented features
    52 
    53 * [wiki:StartupPage Startup notes] - most important changes
    54 * [wiki:Changelog Summarized changelog] - nicely summarized
    55 * [/log/?verbose=on SVN changelog] - very detailed, knowledge of Java may be necessary
    56 
    57 == JOSM tools (incomplete reference) ==
    58 
    59 {{{
    60 #!html
    61 List below contains mosty/only unreplaceable tools with preference to core JOSM tools. "Incomplete" should be stated explicitly to avoid misunderstandings from any part.
    62 }}}
    63 
    64 [wiki:Help/Action/SearchMenuItems Search among all JOSM tools and menu items] - {{{Ctrl+Spacebar}}}
    65 
    66 === Basic shape of objects ===
    67 * [Help/Action/Select Select, move and rotate] tools - you only need subset of tools from this list
    68 * [Help/Action/DrawBuilding Draw a rectangular stub] - optionally aligned along by other objects
    69 * [Help/Action/FastDrawingMode FastDraw] - useful with natural objects;
    70 * [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
    71 * both [Help/Action/Draw Draw nodes mode] and [Help/Action/ImproveWayAccuracy Improve Way Accuracy mode] - have their followers and use cases
    72 * [Help/Action/Paste Paste previously copied objects] - not only tags but also their geometries
    73 
    74 === Selection ===
    75 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):
    76 * [Help/Action/Select#Selecttool Select objects] - contains many modifiers, including [Help/Action/LassoMode lasso mode]
    77 * [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.
    78 * (Shift+F3) - search objects by preset
    79 * [wiki:Help/Plugin/UtilsPlugin2#Selection] - multiple selection focused tools ''from UtilsPlugin2''
    80 * [Help/Action/SelectNonBranchingWaySequences Select non branching way sequences] - useful when editing highways, railways, rivers, power networks and networks in general
    81 * [Help/Action/SelectAll Select all] is more useful after you download precise list of objects
    82 
    83 === Tags ===
    84 Tags of currently selected objects displayed in [Help/Dialog/TagsMembership Tags/Memberships Dialog].
    85 * [Help/Action/Copy Copy] - copy selected objects to the buffer
    86 * [Help/Action/PasteTags PasteTags] - paste previously copied tags
    87 * Tabular editor (Ctrl+T) (from [wiki:Help/Plugin/UtilsPlugin2 UtilsPlugin2])
    88 * (Shift+R) (from [wiki:Help/Plugin/UtilsPlugin2 UtilsPlugin2]) copy tags from previous selection
    89 * Standard [Help/Dialog/AddValue Add value] (Alt+A) dialogue provides 5 shortcuts to 5 last used tags without closing this dialogue
    90 
    91 === Topology tools and changes ===
    92 * [Help/Action/MergeNodes Merge] two or more points
    93 * [Help/Action/UnGlue UnGlue] explode single point into multiple
    94 * [Help/Action/MoveNodeWay Join point into a way segment]
    95 * [wiki:Help/Action/DisconnectNodeWay DisconnectNodeWay] - opposite of above, disconnect a node from a way segment
    96 * [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)
    97 * [wiki:Help/Action/SplitObject Split geometry by selected line] (Alt+X) (from [wiki:Help/Plugin/UtilsPlugin2 UtilsPlugin2])
    98 * [Help/Action/SplitWay Split way] - split way by a node
    99 * [Help/Action/CombineWay Combine Way] - combine several selected ways in one
    100 * [Help/Action/JoinAreas Join overlapping areas]
    101 * [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
    102 
    103 === Geometry tools ===
    104 ==== Precision in angles ====
    105 * [Help/Action/Draw#Anglesnapping Anglesnapping] will ease drawing way segments in 30°, 45°, 60° and 90° degrees
    106 * [Help/Action/Extrude#Basicusage Extrude] tool will ease drawing of strictly perpendicular segments
    107 
    108 ==== Alignment ====
    109 * [Help/Action/AlignInLine Align in line] will align selected nodes into a line
    110 * [Help/Action/DistributeNodes Distribute] as above, but also place them at equal distances
    111 * "Copy" objects at precise anchor points ''from [osmwiki:JOSM/Plugins/CommandLine commandline]''
    112 * "Move" objects at custom vector ''from [osmwiki:JOSM/Plugins/CommandLine commandline]''
    113 * [Help/Action/AlignInCircle Align selected nodes in circle]
    114 
    115 ===== Parallel =====
    116 * [Help/Action/Parallel Parallel], draw lines and curves parallel to each other, draw nested infrastructure quickly
    117 * [Help/Action/Extrude#MovesegmentinparallelCtrl Extude mode used on segments] - will move them in parallel, preserving angles when it is needed
    118 
    119 
    120 ==== Rotation ====
    121 * [Help/Action/Select#Rotateobjects Rotate objects] at user-defined angle (but exact angle is unknown)
    122 * {{{ShapeTools}}} [wiki:Plugins plugin]:
    123  * Rotate object at predefined angle
    124  * Rotate objects (match building with road)
    125  * Rotate objects (match building with road, don't rotate more than epsilon)
    126 
    127 === Viewport control ===
    128 * Explained at [Help/MapView MapView], [Help/Menu/View "View" menu] and [Help/Action/Zoom Zoom tool]
    129 * [Help/Dialog/Minimap Minimap] window
    130 * [Help/Action/JumpToPosition JumpToPosition]
    131 
     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
    13237
    13338== JOSM interface ==
     39[[Image(josm-screen-commented2.png)]]
    13440
    135 === JOSM interface overview ===
     41=== Map View ===
     42* [wiki:Help/MapView Map View] - The main area, where editing takes place
    13643
    137 Interface terminology (make sure to study bolded items first):
    138  
    139 Note: Together, 3 and 4 may contain too many items to display at once, use mouse scroll wheel in this case.
     44=== Main Menu ===
     45Depending 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
    14057
    141 || 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] ||
     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
    14262
    143 === JOSM starting screen ===
     63=== Toggle Dialogs ===
     64* [wiki:Help/ToggleDialogs Toggle Dialogs] - right part of JOSM window
    14465
    145 1. In JOSM, [[wiki:Help/Downloading data]] step performed first. For example, [wiki:Introduction#Downloading use simple Download menu]
    146 2. Additional and more complex tools may be activated with [Help/ExpertMode Expert mode] (also, pay attention to the left side of the screen)
     66=== Status Bar ===
     67* [wiki:Help/StatusBar Status Bar] - bottom panel of JOSM window
    14768
    148 === JOSM interface complete reference ===
     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
    14977
    150 [[wiki:JOSM interface]] - complete reference. Pay attention, that ''menu pages at this wiki are very deep'', just couple of examples below:
     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
    15182
    152 * [[wiki:JOSM interface]] > Help/Menu > Help/Menu/Presets
    153 * [[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
    154 * [[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]
    155 
    156 === JOSM interface customization ===
    157 
    158 See [[Help/JOSM interface customization]] for details.
     83== JOSM error messages ==
     84* [wiki:Help/ErrorMessages Error messages]