summaryrefslogtreecommitdiff
path: root/docs/configuration/general.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/configuration/general.rst')
-rw-r--r--docs/configuration/general.rst27
1 files changed, 15 insertions, 12 deletions
diff --git a/docs/configuration/general.rst b/docs/configuration/general.rst
index 2ad2874d7..34b201d61 100644
--- a/docs/configuration/general.rst
+++ b/docs/configuration/general.rst
@@ -1,23 +1,22 @@
-==General Options==
+General Options
+===============
Settings which affect Navit's general behaviour are located within the ``<navit .. >`` tag. In a default installation, this is found on line 31 of ``navit.xml``. By default, the ``navit`` tag is set as follows:
.. code-block:: xml
-<source lang="xml">
- <navit center="4808 N 1134 E" zoom="256" tracking="1" orientation="-1" recent_dest="10">
-</source>
+ <navit center="4808 N 1134 E" zoom="256" tracking="1" orientation="-1" recent_dest="10">
+
Some common attributes are discussed below. For more advanced features, see [[Configuration/Full_list_of_options | the full list of options]].
-===Initial map position===
+Initial map position
+--------------------
On Navit's very first startup, it needs a **center** to look at on the map. By default this is set to Munich in Germany, which is conveniently covered by the sample map created on installation.
.. code-block:: xml
-<source lang="xml">
- center="11.5666 48.1333"
-</source>
+ center="11.5666 48.1333"
Coordinates can be written in different formats; see [[Coordinate_format]] for the full list.
To determine a specific latitude and longitude for your location you can use http://itouchmap.com/latlong.html.
@@ -45,7 +44,8 @@ or to orient North:
Orienting the map North whilst in [[3D]] mode will provide visually confusing results, and is not recommended. When in 3D mode, it's best to have the map oriented in the direction of travel.
-===Autozoom===
+Autozoom
+--------
Navit has the ability to **autozoom** the map in or out dependent upon your speed.
autozoom_active="1"
@@ -54,7 +54,8 @@ To de-activate autozoom:
autozoom_active="0"
-===3D pitch===
+3D pitch
+--------
Navit has the capability to display either a 2D map (bird's eye perspective) or a [[3D]] map (some amount of tilt looking to the horizon). Navit's default configuration is to startup in the 2D perspective but it is possible to specify that Navit start with a 3D perspective. The amount of tilt is specified by setting the value of <tt>pitch</tt>.
The **pitch** value defines default camera tilting, with a value from 0 to 359. Note that usable values lie between 0 and 90 where 0 is bird's eye perspective looking down and 90 is human perspective looking forward. Also note that values closer to 90 will slow down map drawing, because the line of sight gets longer and longer and more objects are seen.
@@ -63,14 +64,16 @@ For example, the following added to the <tt>navit</tt> tag will force Navit to s
pitch="30"
-===Imperial units===
+Imperial units
+--------------
By default, Navit use the metric system of measurements when displaying or announcing distances, speeds etc. However, you can configure Navit to display and announce these values in imperial units. Simply add an <tt>imperial</tt> attribute to the Navit tag, and set its value to 1, as shown below:
imperial="1"
Speeds should now be displayed in units of miles-per-hour, whilst distances are converted to miles (large distances) and feet (small distances).
-===Default layout===
+Default layout
+--------------
When no specific layout has been specified by the user, navit uses a default layout to draw maps.
The <tt>default_layout</tt> attribute of the navit tag allows to specify which layout to use as default;