CalvinBackup/iD
1
0
Fork 0
mirror of https://github.com/FoggedLens/iD.git synced 2026-05-15 13:38:26 +02:00
Code Issues Packages Projects Releases Wiki Activity

Move more of the content from the walkthrough into the help sections

Browse Source
This commit is contained in:
Bryan Housel
2017-11-21 16:33:58 -05:00
committed by Minh Nguyễn
parent 467fcb8b9a
commit 1f6c8d9132
3 changed files with 207 additions and 207 deletions
Download Patch File Download Diff File Expand all files Collapse all files
data/core.yaml
+168 -169
View File
@@ -590,38 +590,33 @@ en:
intro: |
# Overview
navigation: |
### Navigation
You can drag the map by pressing and holding the left mouse button while
moving the mouse around. You can also use the arrow keys on your keyboard.
You can zoom in or out by scrolling with the mouse wheel or trackpad,
or by clicking the {plus} / {minus} buttons along the side of the map.
features: |
### Map Features
We use the word *features* to describe things that appear on the map,
such as roads, buildings, or points of interest. Anything in the real
world can be mapped as a feature on OpenStreetMap. Features are
world can be mapped as a feature on OpenStreetMap. Map features are
represented on the map using *points*, *lines*, or *areas*.
In OpenStreetmap, points are sometimes called *nodes*, and lines and areas
are sometimes called *ways*.
navigation: |
### Navigation
You can drag the map by pressing and holding the left mouse button
while moving the mouse around. This is also called *panning*.
You can zoom in or out by scrolling with the mouse wheel or trackpad,
or by clicking the {plus} / {minus} buttons along the side of the map.
keyboard: |
### Keyboard Shortcuts
You can view a list of keyboard shortcuts by pressing the `?` key.
editing:
intro: |
# Editing & Saving
`Left-Click` on a feature to select it. This will highlight the
feature with a pusling glow, and the sidebar will display more details,
such as its name or address.
`Left-click` on a feature to select it. This will highlight the
feature with a pusling glow, and the sidebar will display details
about that feature, such as it's name or address.
`Right-click` on a map feature to display the editing menu, which shows
the commands that are available, such as rotating, moving, and deleting.
@@ -636,8 +631,8 @@ en:
then press and hold the left mouse button, and drag the mouse to draw a
selection lasso. All of the points inside the lasso area will be selected.
edit: |
### Edit
undo_redo: |
### Undo and Redo
When you make changes to the map, these are stored locally until you save
them to the server. Don't worry if you make a mistake - until the edits are
@@ -647,11 +642,11 @@ en:
save: |
### Save
Click `Save` to finish your edits and send them to the OpenStreetMap
server. You should remember to save your work frequently!
Click {save} `Save` to finish your edits and send them to OpenStreetMap.
You should remember to save your work frequently!
On the save screen, you'll have a chance to review what you've done.
The editor will perform a basic check for missing data and may offer
iD will also perform some basic checks for missing data and may offer
helpful suggestions and warnings if something doesn't seem right.
upload: |
@@ -662,187 +657,191 @@ en:
Then click `Upload` to send your changes to OpenStreetMap, where they will be
merged into the map and publicly visible to everyone.
comeback: |
backups: |
### Automatic Backups
If you can't finish your edits in one sitting, for example if your computer
crashes or you close the browser tab, your edits are still saved locally.
You can come back later (on the same browser and computer), and the
editor will offer to restore your work.
crashes or you close the browser tab, your edits are still saved locally
in your browser's storage. You can come back later (on the same browser
and computer), and iD will offer to restore your work.
roads:
keyboard: |
### Keyboard Shortcuts
You can view a list of keyboard shortcuts by pressing the `?` key.
points:
intro: |
# Roads & Lines
# Points
You can create, fix, and delete roads with this editor. Roads can be all
kinds: paths, highways, trails, cycle ways, and more - any used segment
is mappable. Roads are the most used type of line. Other examples of
lines are waterways, walls, and fences. What you can do with roads
applies to most types of lines.
*Points* can be used to represent features such as shops, restaurants, and
monuments. They mark a specific location, and describe what's there.
modifying: |
### Modifying
add_point: |
### Adding Points
Often you'll see roads that aren't aligned to the imagery or
to a GPS track. You can adjust these roads so they are in the correct place.
Click on a road to select it. All nodes of the road will be shown as small circles.
You can drag the nodes to better locations.
You can also create new nodes either by double-clicking on the road or by
moving the small triangles at the midpoints between nodes.
To add a point, click the {point} `Point` button on the toolbar
at the top of the map, or press the shortcut key `1`. This will
change the mouse cursor to a cross symbol.
move: |
### Moving
To place the new point on the map, position the mouse cursor where the point
should go, then `left-click` or press the `spacebar`.
If you `right-click` the road, the editing menu will appear.
You can select the {move} 'Move' tool to move the entire road at one time.
Then click again to place the road in its new location.
You can also press the `M` shortcut key to move a road.
move_point: |
### Moving Points
connect: |
### Connecting
To move a point, place the mouse cursor over the point, then press the left
mouse button and hold it down while dragging the point to its new location.
delete_point: |
### Deleting Points
It's OK to delete features that don't exist in the real world. Deleting a feature
from OpenStreetMap removes it from the map that everyone uses, so you should make
sure a feature is really gone before you delete it.
To delete a point, `right-click` on the point to select it and
show the edit menu, then use the {delete} `Delete` command.
You can also press the `delete` key on your keyboard.
lines:
intro: |
# Lines & Roads
*Lines* are used to represent features such as roads, railroads, and rivers.
Lines should be drawn down the center of the feature that they represent.
add_line: |
### Adding Lines
To add a line, click the {line} `Line` button on the toolbar
at the top of the map, or press the shortcut key `2`. This will
change the mouse cursor to a cross symbol.
Next, position the mouse cursor where the line should begin and `left-click`
or press the `spacebar` to begin placing nodes along the line.
Continue placing more nodes by `left-clicking` or pressing `spacebar`.
While drawing, you can zoom in or drag the map in order to add more detail.
To finish a line, press `enter` or click on the last node again.
modify_line: |
### Modifying Lines
Often you'll see lines that aren't shaped correctly, for example a road
that does not match up with the background imagery. To adjust the shape
of a line, first `left-click` to select it. All nodes of the line will be
drawn as small circles. You can then drag the nodes to better locations.
You can also create new nodes along a line either by `double-clicking` on
the line or by dragging the small triangles at the midpoints between nodes.
connect_line: |
### Connecting Lines
Having roads connected properly is important for the map
and essential for providing driving directions.
The connections between roads are drawn with grey circles.
The endpoints of a road are drawn with larger white circles if they
The endpoints of a line are drawn with larger white circles if they
don't connect to anything.
To connect a road to another feature, drag one of its nodes onto the
other feature in order to join them.
To disconnect a road from another feature, right-click the connecting
node and select the {disconnect} 'Disconnect' tool or press the `D`
shortcut key.
To connect a line to another feature, drag one of its nodes onto the
other feature to connect them.
If you know that the connection has traffic lights or crosswalks,
you can add them by selecting the connecting node and using the
feature editor to select the correct feature's type.
attributes: |
### Attributtes
disconnect_line: |
### Disconnecting Lines
When a road is selected, the feature editor in the sidebar will show
the type of the road and many attributes like name, speed limit,
and surface. You can modify fields or even add new ones.
To disconnect a road from another feature, `right-click` the connecting
node and select the {disconnect} `Disconnect` tool.
delete: |
### Deleting
move_line: |
### Moving Lines
If a road is entirely incorrect - you can see that it doesn't exist in satellite
imagery and ideally have confirmed locally that it's not present - you can delete
it, which removes it from the map. Be cautious when deleting features -
like any other edit, the results are seen by everyone and satellite imagery
is often out of date, so the road could simply be newly built.
To move an entire line, `right-click` the line and select the {move}
`Move` tool from the editing menu. Then move the mouse, and `left-click`
to place the line in a new location.
You can delete a road by clicking on it to select it, then pressing the 'Delete'
key or right-clicking it and then using the {delete} 'Delete' tool.
Lines that are connected to other features will stay connected as you
move the line to a new location. iD may prevent you from moving a line
across another connected line.
create: |
### Creating
delete_line: |
### Deleting Lines
Found somewhere there should be a road but there isn't? Click the {line} Line
icon in the top-left of the map or press the shortcut key `2` to start drawing
a line.
If a line is entirely incorrect, for example a road that doesn't exist
in the real world, it's OK to delete it. Be cautious when deleting features -
the background imagery you are using might be outdated, and a road that
looks wrong could simply be newly built.
Click on the start of the road on the map to start drawing. If the road
branches off from an existing road, start by clicking on the place where they connect.
To delete a line, `right-click` on the line to select it and
show the edit menu, then use the {delete} `Delete` command.
You can also press the `delete` key on your keyboard.
Then click on points along the road so that it follows the right path, according
to satellite imagery or GPS. If the road you are drawing crosses another road, connect
it by clicking on the intersection point. When you're done drawing, double-click
or press `Return` or `Enter` on your keyboard.
buildings:
areas:
intro: |
# Buildings & Areas
# Areas & Buildings
OpenStreetMap is the world's largest freely-available database of buildings.
You can improve this database. Buildings are the most used type
of areas, others are residential areas, farmland, forests, lakes, or ponds.
What you can do with buildings applies to most types of areas.
*Areas* are used to show the boundaries of features like lakes, buildings,
and residential areas. Areas should be traced around the edge of the
feature that they represent, for example, around the base of a building.
select: |
### Selecting
point_or_area: |
### Points or Areas?
You can select a building by clicking on its border. the pulsing glow will
will become visible, all nodes will be shown as circles and the
feature editor on the left will show the type of the building and
attributes like name, levels, and address.
Many features can be represented as points or areas.
It is recommended to map buildings and property outlines as areas
whenever possible, and to map businesses, amenities, and other features
that operate within buildings as points placed inside the building area.
modify: |
### Modifying
add_area: |
### Adding Areas
Sometimes buildings are incorrectly placed or have incorrect tags.
To move an entire building, select it and press the `M` shortcut key,
or right-click it and select the {move} 'Move' tool. Move your
mouse to shift the building, and click when it's correctly placed.
To add an area, click the {area} `Area` button on the toolbar
at the top of the map, or press the shortcut key `3`. This will
change the mouse cursor to a cross symbol.
To fix the specific shape of a building, click and drag the nodes that form
its border into better places.
Next, position the mouse cursor at one of the corners of the feature and `left-click`
or press the `spacebar` to begin placing nodes around the outer edge of
the area. Continue placing more nodes by `left-clicking` or pressing `spacebar`.
While drawing, you can zoom in or drag the map in order to add more detail.
create: |
### Creating
To finish an area, press `enter` or click again on either the first or last node.
One of the main questions around adding buildings to the map is that
OpenStreetMap records buildings both as shapes and points. The rule of thumb
is to _map a building as a shape whenever possible_, and map companies, homes,
amenities, and other things that operate out of buildings as points placed
within the building shape.
square_area: |
### Square Corners
Start drawing a building as a shape by clicking the {area} Area button in the top
left of the map, and end it either by pressing 'Return' on your keyboard
or clicking on the first node drawn or clicking again on the last node drawn
to close the shape.
Many area features like buildings have square corners.
To square the corners of an area, `right-click` the edge of the area
and select the {square} `Square` tool.
Then you assign the type of the building to the outline with the feature editor.
Most buildings are houses, if you're not sure choose the generic Building type.
modify_area: |
### Modifying Areas
delete: |
### Deleting
Often you'll see areas that aren't shaped correctly, for example a building
that does not match up with the background imagery. To adjust the shape
of an area, first `left-click` to select it. All nodes of the area will be
drawn as small circles. You can then drag the nodes to better locations.
If a building is entirely incorrect - you can see that it doesn't exist in satellite
imagery and ideally have confirmed locally that it's not present - you can delete
it, which removes it from the map. Be cautious when deleting features -
like any other edit, the results are seen by everyone and satellite imagery
is often out of date, so the building could simply be newly built.
You can also create new nodes along an area either by `double-clicking` on
the edge of the area or by dragging the small triangles at the midpoints
between nodes.
You can delete a building by clicking on it to select it and then pressing the `Delete`
key, or by right-clicking it and then using the {delete} 'Delete' tool.
delete_area: |
### Deleting Areas
addresses:
intro: |
# Addresses & Points
If an area is entirely incorrect, for example a building that doesn't exist
in the real world, it's OK to delete it. Be cautious when deleting features -
the background imagery you are using might be outdated, and a building that
looks wrong could simply be newly built.
Addresses are some of the most useful information for the map.
Address information can be added to OpenStreetMap using a variety of methods,
such as adding a simple point containing an address, adding address information
to a building, site or other area, or alternatively to an entrance node.
nodup: |
### No duplication
Usually address information doesn't need to be duplicated, e.g. when there
is a building outline on the map and several shops as points inside,
only the building should have an address.
recommendation: |
### Recommendation
Most buildings and sites have only one address and it is recommended to add
the address to the building as a whole. If there is no building on the map
and you cannot draw one, you should add an address point to the map.
Some buildings or sites have more than one address. You can add the
addresses as separate points inside the building.
points: |
### Other Points
While addresses are still the most common type of point feature,
there are other often used types like trees, towers, or poles.
To create a point feature click the {point} Point icon in the top-left
of the map or press the shortcut key `1` to insert a point.
To delete an area, `right-click` on the area to select it and
show the edit menu, then use the {delete} `Delete` command.
You can also press the `delete` key on your keyboard.
feature_editor:
intro: |
@@ -859,7 +858,7 @@ en:
The feature editor will display buttons for common feature types, and you can
find others by typing what you're looking for in the search box.
Click the 'i' in the top-right-hand corner of a feature type button to
Click the {inspect} icon next to the feature name to
learn more about it. Click a button to choose that type.
fields: |
@@ -885,8 +884,8 @@ en:
### Undo & Redo
Changes you make in the feature editor are automatically applied.
You can undo them at any time by clicking the {undo} 'Undo' button and redo
changes by clicking the {redo} 'Redo' button.
You can undo them at any time by clicking the {undo} `Undo` button and redo
changes by clicking the {redo} `Redo` button.
imagery:
intro: |
@@ -897,14 +896,14 @@ en:
from satellites, airplanes, and drones, or it can be scanned historical
maps or other freely available source data.
To see which imagery sources are available for editing, click on
the {layers} 'Background settings' panel on the side of the map.
To see which imagery sources are available for editing, click the
{layers} `Background settings` button on the side of the map.
sources: |
### Sources
By default, a [Bing Maps](https://www.bing.com/maps/) satellite layer is
displayed in the editor. Depending on where you are editing, other imagery
chosen as the background image. Depending on where you are editing, other imagery
sources will be available. Some may be newer or have higher resolution,
so it is always useful to check and see which layer is the best one to use
as a mapping reference.
@@ -920,8 +919,8 @@ en:
'Adjust Imagery Offset' section at the bottom of the Background Settings pane.
Click on the small triangles to adjust the imagery offset in small steps,
or press the mouse down and drag within the grey square to slide the imagery
into alignment.
or hold the left mouse botton and drag within the grey square to slide
the imagery into alignment.
streetlevel:
intro: |
@@ -935,7 +934,7 @@ en:
using: |
### Using
To use street level photos for mapping, click on the {data} 'Map data' panel on the
To use street level photos for mapping, click the {data} `Map data` panel on the
side of the map to enable or disable the available photo layers.
When enabled, the photo layer will display a line along the sequence of photos.
@@ -966,7 +965,7 @@ en:
To use a GPS trace for mapping, drag and drop the data file onto the map
editor. If it's recognized, it will be drawn on the map as a bright purple
line. Click on the {data} 'Map data' panel on the side of the map to enable,
line. Click the {data} `Map data` panel on the side of the map to enable,
disable, or zoom to your GPS data.
The GPS track isn't sent to OpenStreetMap - the best way to use it is to
dist/locales/en.json
Vendored
+34 -33
View File
@@ -688,60 +688,61 @@
},
"overview": {
"intro": "# Overview\n",
"features": "### Map Features\n\nWe use the word *features* to describe things that appear on the map,\nsuch as roads, buildings, or points of interest. Anything in the real\nworld can be mapped as a feature on OpenStreetMap. Features are\nrepresented on the map using *points*, *lines*, or *areas*.\n\nIn OpenStreetmap, points are sometimes called *nodes*, and lines and areas\nare sometimes called *ways*.\n",
"navigation": "### Navigation\n\nYou can drag the map by pressing and holding the left mouse button\nwhile moving the mouse around. This is also called *panning*.\n\nYou can zoom in or out by scrolling with the mouse wheel or trackpad,\nor by clicking the {plus} / {minus} buttons along the side of the map.\n",
"keyboard": "### Keyboard Shortcuts\n\nYou can view a list of keyboard shortcuts by pressing the `?` key.\n"
"navigation": "### Navigation\n\nYou can drag the map by pressing and holding the left mouse button while\nmoving the mouse around. You can also use the arrow keys on your keyboard.\n\nYou can zoom in or out by scrolling with the mouse wheel or trackpad,\nor by clicking the {plus} / {minus} buttons along the side of the map.\n",
"features": "### Map Features\n\nWe use the word *features* to describe things that appear on the map,\nsuch as roads, buildings, or points of interest. Anything in the real\nworld can be mapped as a feature on OpenStreetMap. Map features are\nrepresented on the map using *points*, *lines*, or *areas*.\n\nIn OpenStreetmap, points are sometimes called *nodes*, and lines and areas\nare sometimes called *ways*.\n"
},
"editing": {
"intro": "# Editing & Saving\n\n`Left-Click` on a feature to select it. This will highlight the\nfeature with a pusling glow, and the sidebar will display more details,\nsuch as its name or address.\n\n`Right-click` on a map feature to display the editing menu, which shows\nthe commands that are available, such as rotating, moving, and deleting.\n",
"intro": "# Editing & Saving\n\n`Left-click` on a feature to select it. This will highlight the\nfeature with a pusling glow, and the sidebar will display details\nabout that feature, such as it's name or address.\n\n`Right-click` on a map feature to display the editing menu, which shows\nthe commands that are available, such as rotating, moving, and deleting.\n",
"multiselect": "### Multiselect\n\n`Shift-click` to select several features together. This makes\nit easier to move or delete multiple items.\n\nAnother way to select multiple features is to hold down the `Shift` key,\nthen press and hold the left mouse button, and drag the mouse to draw a\nselection lasso. All of the points inside the lasso area will be selected.\n",
"edit": "### Edit\n\nWhen you make changes to the map, these are stored locally until you save\nthem to the server. Don't worry if you make a mistake - until the edits are\nsaved, you can undo changes by clicking the {undo} `Undo` button, and redo\nchanges by clicking the {redo} `Redo` button.\n",
"save": "### Save\n\nClick `Save` to finish your edits and send them to the OpenStreetMap\nserver. You should remember to save your work frequently!\n\nOn the save screen, you'll have a chance to review what you've done.\nThe editor will perform a basic check for missing data and may offer\nhelpful suggestions and warnings if something doesn't seem right.\n",
"undo_redo": "### Undo and Redo\n\nWhen you make changes to the map, these are stored locally until you save\nthem to the server. Don't worry if you make a mistake - until the edits are\nsaved, you can undo changes by clicking the {undo} `Undo` button, and redo\nchanges by clicking the {redo} `Redo` button.\n",
"save": "### Save\n\nClick {save} `Save` to finish your edits and send them to OpenStreetMap.\nYou should remember to save your work frequently!\n\nOn the save screen, you'll have a chance to review what you've done.\niD will also perform some basic checks for missing data and may offer\nhelpful suggestions and warnings if something doesn't seem right.\n",
"upload": "### Upload\n\nBefore uploading your changes you must enter a\n[changeset comment](https://wiki.openstreetmap.org/wiki/Good_changeset_comments).\nThen click `Upload` to send your changes to OpenStreetMap, where they will be\nmerged into the map and publicly visible to everyone.\n",
"comeback": "If you can't finish your edits in one sitting, for example if your computer\ncrashes or you close the browser tab, your edits are still saved locally.\nYou can come back later (on the same browser and computer), and the\neditor will offer to restore your work.\n"
"backups": "### Automatic Backups\n\nIf you can't finish your edits in one sitting, for example if your computer\ncrashes or you close the browser tab, your edits are still saved locally\nin your browser's storage. You can come back later (on the same browser\nand computer), and iD will offer to restore your work.\n",
"keyboard": "### Keyboard Shortcuts\n\nYou can view a list of keyboard shortcuts by pressing the `?` key.\n"
},
"roads": {
"intro": "# Roads & Lines\n\nYou can create, fix, and delete roads with this editor. Roads can be all\nkinds: paths, highways, trails, cycle ways, and more - any used segment\nis mappable. Roads are the most used type of line. Other examples of\nlines are waterways, walls, and fences. What you can do with roads\napplies to most types of lines.\n",
"modifying": "### Modifying\n\nOften you'll see roads that aren't aligned to the imagery or\nto a GPS track. You can adjust these roads so they are in the correct place.\nClick on a road to select it. All nodes of the road will be shown as small circles.\nYou can drag the nodes to better locations.\nYou can also create new nodes either by double-clicking on the road or by\nmoving the small triangles at the midpoints between nodes.\n",
"move": "### Moving\n\nIf you `right-click` the road, the editing menu will appear.\nYou can select the {move} 'Move' tool to move the entire road at one time.\nThen click again to place the road in its new location.\nYou can also press the `M` shortcut key to move a road.\n",
"connect": "### Connecting\n\nHaving roads connected properly is important for the map\nand essential for providing driving directions.\n\nThe connections between roads are drawn with grey circles.\nThe endpoints of a road are drawn with larger white circles if they\ndon't connect to anything.\n\nTo connect a road to another feature, drag one of its nodes onto the\nother feature in order to join them.\n\nTo disconnect a road from another feature, right-click the connecting\nnode and select the {disconnect} 'Disconnect' tool or press the `D`\nshortcut key.\n\nIf you know that the connection has traffic lights or crosswalks,\nyou can add them by selecting the connecting node and using the\nfeature editor to select the correct feature's type.\n",
"attributes": "### Attributtes\n\nWhen a road is selected, the feature editor in the sidebar will show\nthe type of the road and many attributes like name, speed limit,\nand surface. You can modify fields or even add new ones.\n",
"delete": "### Deleting\n\nIf a road is entirely incorrect - you can see that it doesn't exist in satellite\nimagery and ideally have confirmed locally that it's not present - you can delete\nit, which removes it from the map. Be cautious when deleting features -\nlike any other edit, the results are seen by everyone and satellite imagery\nis often out of date, so the road could simply be newly built.\n\nYou can delete a road by clicking on it to select it, then pressing the 'Delete'\nkey or right-clicking it and then using the {delete} 'Delete' tool.\n",
"create": "### Creating\n\nFound somewhere there should be a road but there isn't? Click the {line} Line\nicon in the top-left of the map or press the shortcut key `2` to start drawing\na line.\n\nClick on the start of the road on the map to start drawing. If the road\nbranches off from an existing road, start by clicking on the place where they connect.\n\nThen click on points along the road so that it follows the right path, according\nto satellite imagery or GPS. If the road you are drawing crosses another road, connect\nit by clicking on the intersection point. When you're done drawing, double-click\nor press `Return` or `Enter` on your keyboard.\n"
"points": {
"intro": "# Points\n\n*Points* can be used to represent features such as shops, restaurants, and\nmonuments. They mark a specific location, and describe what's there.\n",
"add_point": "### Adding Points\n\nTo add a point, click the {point} `Point` button on the toolbar\nat the top of the map, or press the shortcut key `1`. This will\nchange the mouse cursor to a cross symbol.\n\nTo place the new point on the map, position the mouse cursor where the point\nshould go, then `left-click` or press the `spacebar`.\n",
"move_point": "### Moving Points\n\nTo move a point, place the mouse cursor over the point, then press the left\nmouse button and hold it down while dragging the point to its new location.\n",
"delete_point": "### Deleting Points\n\nIt's OK to delete features that don't exist in the real world. Deleting a feature\nfrom OpenStreetMap removes it from the map that everyone uses, so you should make\nsure a feature is really gone before you delete it.\n\nTo delete a point, `right-click` on the point to select it and\nshow the edit menu, then use the {delete} `Delete` command.\nYou can also press the `delete` key on your keyboard.\n"
},
"buildings": {
"intro": "# Buildings & Areas\n\nOpenStreetMap is the world's largest freely-available database of buildings.\nYou can improve this database. Buildings are the most used type\nof areas, others are residential areas, farmland, forests, lakes, or ponds.\nWhat you can do with buildings applies to most types of areas.\n",
"select": "### Selecting\n\nYou can select a building by clicking on its border. the pulsing glow will\nwill become visible, all nodes will be shown as circles and the\nfeature editor on the left will show the type of the building and\nattributes like name, levels, and address.\n",
"modify": "### Modifying\n\nSometimes buildings are incorrectly placed or have incorrect tags.\nTo move an entire building, select it and press the `M` shortcut key,\nor right-click it and select the {move} 'Move' tool. Move your\nmouse to shift the building, and click when it's correctly placed.\n\nTo fix the specific shape of a building, click and drag the nodes that form\nits border into better places.\n",
"create": "### Creating\n\nOne of the main questions around adding buildings to the map is that\nOpenStreetMap records buildings both as shapes and points. The rule of thumb\nis to _map a building as a shape whenever possible_, and map companies, homes,\namenities, and other things that operate out of buildings as points placed\nwithin the building shape.\n\nStart drawing a building as a shape by clicking the {area} Area button in the top\nleft of the map, and end it either by pressing 'Return' on your keyboard\nor clicking on the first node drawn or clicking again on the last node drawn\nto close the shape.\n\nThen you assign the type of the building to the outline with the feature editor.\nMost buildings are houses, if you're not sure choose the generic Building type.\n",
"delete": "### Deleting\n\nIf a building is entirely incorrect - you can see that it doesn't exist in satellite\nimagery and ideally have confirmed locally that it's not present - you can delete\nit, which removes it from the map. Be cautious when deleting features -\nlike any other edit, the results are seen by everyone and satellite imagery\nis often out of date, so the building could simply be newly built.\n\nYou can delete a building by clicking on it to select it and then pressing the `Delete`\nkey, or by right-clicking it and then using the {delete} 'Delete' tool.\n"
"lines": {
"intro": "# Lines & Roads\n\n*Lines* are used to represent features such as roads, railroads, and rivers.\nLines should be drawn down the center of the feature that they represent.\n",
"add_line": "### Adding Lines\n\nTo add a line, click the {line} `Line` button on the toolbar\nat the top of the map, or press the shortcut key `2`. This will\nchange the mouse cursor to a cross symbol.\n\nNext, position the mouse cursor where the line should begin and `left-click`\nor press the `spacebar` to begin placing nodes along the line.\nContinue placing more nodes by `left-clicking` or pressing `spacebar`.\nWhile drawing, you can zoom in or drag the map in order to add more detail.\n\nTo finish a line, press `enter` or click on the last node again.\n",
"modify_line": "### Modifying Lines\n\nOften you'll see lines that aren't shaped correctly, for example a road\nthat does not match up with the background imagery. To adjust the shape\nof a line, first `left-click` to select it. All nodes of the line will be\ndrawn as small circles. You can then drag the nodes to better locations.\n\nYou can also create new nodes along a line either by `double-clicking` on\nthe line or by dragging the small triangles at the midpoints between nodes.\n",
"connect_line": "### Connecting Lines\n\nHaving roads connected properly is important for the map\nand essential for providing driving directions.\n\nThe connections between roads are drawn with grey circles.\nThe endpoints of a line are drawn with larger white circles if they\ndon't connect to anything.\n\nTo connect a line to another feature, drag one of its nodes onto the\nother feature to connect them.\n\nIf you know that the connection has traffic lights or crosswalks,\nyou can add them by selecting the connecting node and using the\nfeature editor to select the correct feature's type.\n",
"disconnect_line": "### Disconnecting Lines\n\nTo disconnect a road from another feature, `right-click` the connecting\nnode and select the {disconnect} `Disconnect` tool.\n",
"move_line": "### Moving Lines\n\nTo move an entire line, `right-click` the line and select the {move}\n`Move` tool from the editing menu. Then move the mouse, and `left-click`\nto place the line in a new location.\n\nLines that are connected to other features will stay connected as you\nmove the line to a new location. iD may prevent you from moving a line\nacross another connected line.\n",
"delete_line": "### Deleting Lines\n\nIf a line is entirely incorrect, for example a road that doesn't exist\nin the real world, it's OK to delete it. Be cautious when deleting features -\nthe background imagery you are using might be outdated, and a road that\nlooks wrong could simply be newly built.\n\nTo delete a line, `right-click` on the line to select it and\nshow the edit menu, then use the {delete} `Delete` command.\nYou can also press the `delete` key on your keyboard.\n"
},
"addresses": {
"intro": "# Addresses & Points\n\nAddresses are some of the most useful information for the map.\n\nAddress information can be added to OpenStreetMap using a variety of methods,\nsuch as adding a simple point containing an address, adding address information\nto a building, site or other area, or alternatively to an entrance node.\n",
"nodup": "### No duplication\n\nUsually address information doesn't need to be duplicated, e.g. when there\nis a building outline on the map and several shops as points inside,\nonly the building should have an address.\n",
"recommendation": "### Recommendation\n\nMost buildings and sites have only one address and it is recommended to add\nthe address to the building as a whole. If there is no building on the map\nand you cannot draw one, you should add an address point to the map.\n\nSome buildings or sites have more than one address. You can add the\naddresses as separate points inside the building.\n",
"points": "### Other Points\n\nWhile addresses are still the most common type of point feature,\nthere are other often used types like trees, towers, or poles.\n\nTo create a point feature click the {point} Point icon in the top-left\nof the map or press the shortcut key `1` to insert a point.\n"
"areas": {
"intro": "# Areas & Buildings\n\n*Areas* are used to show the boundaries of features like lakes, buildings,\nand residential areas. Areas should be traced around the edge of the\nfeature that they represent, for example, around the base of a building.\n",
"point_or_area": "### Points or Areas?\n\nMany features can be represented as points or areas.\nIt is recommended to map buildings and property outlines as areas\nwhenever possible, and to map businesses, amenities, and other features\nthat operate within buildings as points placed inside the building area.\n",
"add_area": "### Adding Areas\n\nTo add an area, click the {area} `Area` button on the toolbar\nat the top of the map, or press the shortcut key `3`. This will\nchange the mouse cursor to a cross symbol.\n\nNext, position the mouse cursor at one of the corners of the feature and `left-click`\nor press the `spacebar` to begin placing nodes around the outer edge of\nthe area. Continue placing more nodes by `left-clicking` or pressing `spacebar`.\nWhile drawing, you can zoom in or drag the map in order to add more detail.\n\nTo finish an area, press `enter` or click again on either the first or last node.\n",
"square_area": "### Square Corners\n\nMany area features like buildings have square corners.\nTo square the corners of an area, `right-click` the edge of the area\nand select the {square} `Square` tool.\n",
"modify_area": "### Modifying Areas\n\nOften you'll see areas that aren't shaped correctly, for example a building\nthat does not match up with the background imagery. To adjust the shape\nof an area, first `left-click` to select it. All nodes of the area will be\ndrawn as small circles. You can then drag the nodes to better locations.\n\nYou can also create new nodes along an area either by `double-clicking` on\nthe edge of the area or by dragging the small triangles at the midpoints\nbetween nodes.\n",
"delete_area": "### Deleting Areas\n\nIf an area is entirely incorrect, for example a building that doesn't exist\nin the real world, it's OK to delete it. Be cautious when deleting features -\nthe background imagery you are using might be outdated, and a building that\nlooks wrong could simply be newly built.\n\nTo delete an area, `right-click` on the area to select it and\nshow the edit menu, then use the {delete} `Delete` command.\nYou can also press the `delete` key on your keyboard.\n"
},
"feature_editor": {
"intro": "# Feature Editor\n\nThe feature editor is the section on the left side of the page that allows you to\nedit the details of the selected feature.\n",
"select": "### Selecting a Feature Type\n\nAfter you add a point, line, or area, you can choose what type of feature it\nis, like whether it's a highway or residential road, supermarket or cafe.\nThe feature editor will display buttons for common feature types, and you can\nfind others by typing what you're looking for in the search box.\n\nClick the 'i' in the top-right-hand corner of a feature type button to\nlearn more about it. Click a button to choose that type.\n",
"select": "### Selecting a Feature Type\n\nAfter you add a point, line, or area, you can choose what type of feature it\nis, like whether it's a highway or residential road, supermarket or cafe.\nThe feature editor will display buttons for common feature types, and you can\nfind others by typing what you're looking for in the search box.\n\nClick the {inspect} icon next to the feature name to\nlearn more about it. Click a button to choose that type.\n",
"fields": "### Fields\n\nAfter you choose a feature type, or when you select a feature that already\nhas a type assigned, the feature editor will display fields with details about\nthe feature like its name or speed limit for a road or levels and address for a building.\n\nBelow the fields you see, you can click the `Add field` dropdown to add\nother details, like a Wikipedia link, wheelchair access, and more.\n",
"tags": "### Tags\n\nBelow that you see the tags which are actually stored in OpenStreetMap.\nIf you cannot find the feature's type with the feature editor or you\ncannot add required fields, then you can add additional tags with the `+` button.\n[Taginfo](https://taginfo.openstreetmap.org/) is a great resource to learn more\nabout popular tag combinations.\n",
"undo": "### Undo & Redo\n\nChanges you make in the feature editor are automatically applied.\nYou can undo them at any time by clicking the {undo} 'Undo' button and redo\nchanges by clicking the {redo} 'Redo' button.\n"
"undo": "### Undo & Redo\n\nChanges you make in the feature editor are automatically applied.\nYou can undo them at any time by clicking the {undo} `Undo` button and redo\nchanges by clicking the {redo} `Redo` button.\n"
},
"imagery": {
"intro": "# Background Imagery\n\nBackground imagery is an important resource for mapping, and is displayed\nbeneath the map data. This imagery can be aerial photos collected\nfrom satellites, airplanes, and drones, or it can be scanned historical\nmaps or other freely available source data.\n\nTo see which imagery sources are available for editing, click on\nthe {layers} 'Background settings' panel on the side of the map.\n",
"sources": "### Sources\n\nBy default, a [Bing Maps](https://www.bing.com/maps/) satellite layer is\ndisplayed in the editor. Depending on where you are editing, other imagery\nsources will be available. Some may be newer or have higher resolution,\nso it is always useful to check and see which layer is the best one to use\nas a mapping reference.\n",
"offset": "### Offset\n\nImagery is sometimes offset slightly from accurate map data.\n\nIf you see a lot of roads or buildings shifted from the background imagery,\ndon't move them all to match the background. Instead, you can adjust\nthe background so that it matches the existing data by expanding the\n'Adjust Imagery Offset' section at the bottom of the Background Settings pane.\n\nClick on the small triangles to adjust the imagery offset in small steps,\nor press the mouse down and drag within the grey square to slide the imagery\ninto alignment.\n"
"intro": "# Background Imagery\n\nBackground imagery is an important resource for mapping, and is displayed\nbeneath the map data. This imagery can be aerial photos collected\nfrom satellites, airplanes, and drones, or it can be scanned historical\nmaps or other freely available source data.\n\nTo see which imagery sources are available for editing, click the\n{layers} `Background settings` button on the side of the map.\n",
"sources": "### Sources\n\nBy default, a [Bing Maps](https://www.bing.com/maps/) satellite layer is\nchosen as the background image. Depending on where you are editing, other imagery\nsources will be available. Some may be newer or have higher resolution,\nso it is always useful to check and see which layer is the best one to use\nas a mapping reference.\n",
"offset": "### Offset\n\nImagery is sometimes offset slightly from accurate map data.\n\nIf you see a lot of roads or buildings shifted from the background imagery,\ndon't move them all to match the background. Instead, you can adjust\nthe background so that it matches the existing data by expanding the\n'Adjust Imagery Offset' section at the bottom of the Background Settings pane.\n\nClick on the small triangles to adjust the imagery offset in small steps,\nor hold the left mouse botton and drag within the grey square to slide\nthe imagery into alignment.\n"
},
"streetlevel": {
"intro": "# Street Level Photos\n\nStreet level photos provide a ground-truth prespective of an area, useful\nfor mapping traffic signs, businesses, and other details that you can't\nsee from satellite and aerial images. The iD editor supports street level\nphotos from [Mapillary](https://www.mapillary.com) and [OpenStreetCam](https://www.openstreetcam.org).\n",
"using": "### Using\n\nTo use street level photos for mapping, click on the {data} 'Map data' panel on the\nside of the map to enable or disable the available photo layers.\n\nWhen enabled, the photo layer will display a line along the sequence of photos.\nAt higher zooms you will see a circle at each photo location, and at even higher\nzooms you will see a viewfield to indicate the direction that the photo was taken.\n",
"using": "### Using\n\nTo use street level photos for mapping, click the {data} `Map data` panel on the\nside of the map to enable or disable the available photo layers.\n\nWhen enabled, the photo layer will display a line along the sequence of photos.\nAt higher zooms you will see a circle at each photo location, and at even higher\nzooms you will see a viewfield to indicate the direction that the photo was taken.\n",
"viewer": "\nWhen you click on one of the photo locations, a photo viewer will appear in the\nbottom corner of the map. The photo viewer contains controls to step forward and\nbackward in the image sequence. It will also show the username of the person who\ncaptured the image, the date it was captured, and a link to view the image on\nthe original site.\n"
},
"gps": {
"intro": "# GPS Traces\n\nCollected GPS traces are a valuable source of data for OpenStreetMap. This editor\nsupports `.gpx`, `.geojson`, and `.kml` files on your local computer. You can collect\nGPS traces with a smartphone, sports watch, or other GPS device.\n\nFor information on how to perform a GPS survey, read\n[Mapping with a smartphone, GPS, or paper](http://learnosm.org/en/mobile-mapping/).\n",
"using": "### Using\n\nTo use a GPS trace for mapping, drag and drop the data file onto the map\neditor. If it's recognized, it will be drawn on the map as a bright purple\nline. Click on the {data} 'Map data' panel on the side of the map to enable,\ndisable, or zoom to your GPS data.\n\nThe GPS track isn't sent to OpenStreetMap - the best way to use it is to\ndraw on the map, using it as a guide for the new features that you add.\n\nYou can also [upload your GPS data to OpenStreetMap](https://www.openstreetmap.org/trace/create)\nfor other users to use.\n"
"using": "### Using\n\nTo use a GPS trace for mapping, drag and drop the data file onto the map\neditor. If it's recognized, it will be drawn on the map as a bright purple\nline. Click the {data} `Map data` panel on the side of the map to enable,\ndisable, or zoom to your GPS data.\n\nThe GPS track isn't sent to OpenStreetMap - the best way to use it is to\ndraw on the map, using it as a guide for the new features that you add.\n\nYou can also [upload your GPS data to OpenStreetMap](https://www.openstreetmap.org/trace/create)\nfor other users to use.\n"
},
"relations": {
"intro": "# Relations & Members\n\nA *relation* is a special type of feature in OpenStreetMap that groups together other\nfeatures, called *members* of the relation. Every member of a relation can have a\n*role* for the relation. At the bottom of the feature editor, you can see which\nrelations a feature is a member of, and the click on a relation there will select it.\nWhen the relation is selected, you can see all of its members highlighted on the map\nand listed in the feature editor together with their role for the relation.\n",
modules/ui/help.js
+5 -5
View File
@@ -20,12 +20,12 @@ export function uiHelp(context) {
var docKeys = [
['help.help.',['intro','opendata','beforestart','opensource']],
['help.overview.',['intro','features','navigation','keyboard']],
['help.editing.',['intro','multiselect','edit','save','upload','comeback']],
['help.roads.',['intro','move','connect','attributes','delete','create']],
['help.buildings.',['intro','select','modify','create','delete']],
['help.addresses.',['intro','nodup','recommendation','points']],
['help.overview.',['intro','features','navigation']],
['help.editing.',['intro','multiselect','undo_redo','save','upload','backups','keyboard']],
['help.feature_editor.',['intro','select','fields','tags','undo']],
['help.points.',['intro','add_point','move_point','delete_point']],
['help.lines.',['intro','add_line','modify_line','connect_line','disconnect_line','move_line','delete_line']],
['help.areas.',['intro','point_or_area','add_area','square_area','modify_area','delete_area']],
['help.imagery.',['intro','sources','offset']],
['help.streetlevel.',['intro','using','viewer']],
['help.gps.',['intro','using']],