From 54007ef58485a9bd1010294235901e6b4e3c9f60 Mon Sep 17 00:00:00 2001 From: Harrissou Sant-anna Date: Thu, 13 Jul 2017 12:16:55 +0200 Subject: [PATCH] Delete context help dialogs that are replaced by online links. --- .../context_help/QgsCustomProjectionDialog | 14 - .../context_help/QgsDecorationCopyrightDialog | 31 -- .../QgsDecorationNorthArrowDialog | 4 - .../context_help/QgsDecorationScaleBarDialog | 18 - .../context_help/QgsDelimitedTextSourceSelect | 317 ------------------ resources/context_help/QgsGPSPluginGui | 2 - .../context_help/QgsIdentifyResultsDialog | 9 - resources/context_help/QgsMeasureDialog | 10 - .../context_help/QgsNewSpatialiteLayerDialog | 23 -- .../context_help/QgsNewVectorLayerDialog | 11 - .../context_help/QgsOpenVectorLayerDialog | 6 - resources/context_help/QgsOptions | 73 ---- resources/context_help/QgsOracleNewConnection | 39 --- resources/context_help/QgsOracleSourceSelect | 40 --- resources/context_help/QgsPgNewConnection | 32 -- resources/context_help/QgsPgSourceSelect | 40 --- resources/context_help/QgsPluginManager | 85 ----- resources/context_help/QgsProjectProperties | 127 ------- resources/context_help/QgsQueryBuilder | 45 --- .../context_help/QgsSpatiaLiteSourceSelect | 3 - .../context_help/QgsVectorLayerProperties | 138 -------- .../context_help/QgsVectorLayerSaveAsDialog | 13 - resources/context_help/QgsWMSSourceSelect | 37 -- .../context_help/eVisDatabaseConnectionGui | 1 - 24 files changed, 1118 deletions(-) delete mode 100644 resources/context_help/QgsCustomProjectionDialog delete mode 100644 resources/context_help/QgsDecorationCopyrightDialog delete mode 100644 resources/context_help/QgsDecorationNorthArrowDialog delete mode 100644 resources/context_help/QgsDecorationScaleBarDialog delete mode 100644 resources/context_help/QgsDelimitedTextSourceSelect delete mode 100644 resources/context_help/QgsGPSPluginGui delete mode 100644 resources/context_help/QgsIdentifyResultsDialog delete mode 100644 resources/context_help/QgsMeasureDialog delete mode 100644 resources/context_help/QgsNewSpatialiteLayerDialog delete mode 100644 resources/context_help/QgsNewVectorLayerDialog delete mode 100644 resources/context_help/QgsOpenVectorLayerDialog delete mode 100644 resources/context_help/QgsOptions delete mode 100644 resources/context_help/QgsOracleNewConnection delete mode 100644 resources/context_help/QgsOracleSourceSelect delete mode 100644 resources/context_help/QgsPgNewConnection delete mode 100644 resources/context_help/QgsPgSourceSelect delete mode 100644 resources/context_help/QgsPluginManager delete mode 100644 resources/context_help/QgsProjectProperties delete mode 100644 resources/context_help/QgsQueryBuilder delete mode 100644 resources/context_help/QgsSpatiaLiteSourceSelect delete mode 100644 resources/context_help/QgsVectorLayerProperties delete mode 100644 resources/context_help/QgsVectorLayerSaveAsDialog delete mode 100644 resources/context_help/QgsWMSSourceSelect delete mode 100644 resources/context_help/eVisDatabaseConnectionGui diff --git a/resources/context_help/QgsCustomProjectionDialog b/resources/context_help/QgsCustomProjectionDialog deleted file mode 100644 index 47ce5eebeb32..000000000000 --- a/resources/context_help/QgsCustomProjectionDialog +++ /dev/null @@ -1,14 +0,0 @@ -

Custom Coordinate Reference System Definition

-If QGIS does not provide the coordinate reference system you need, you can define a custom CRS.

-To define a CRS, select from the (Gnome, OSX) or (KDE, Windows) menu. Custom CRS are stored in your QGIS user database. In addition to your custom CRS, this database also contains your spatial bookmarks and other custom data. - -

Define

-To create a new CRS, click the button and enter: - -Note that the Parameters must begin with a +proj=-block, to represent the new coordinate reference -system. -

-Defining a custom CRS in QGIS requires a good understanding of the Proj.4 projection library. To begin, refer to the Cartographic Projection Procedures for the UNIX Environment - A User's Manual by Gerald I. Evenden, U.S. Geological Survey Open-File Report 90-284, 1990. This manual describes the use of the proj.4 and related command line utilities. The cartographic parameters used with proj.4 are described in the user manual, and are the same as those used by QGIS. diff --git a/resources/context_help/QgsDecorationCopyrightDialog b/resources/context_help/QgsDecorationCopyrightDialog deleted file mode 100644 index c10820519328..000000000000 --- a/resources/context_help/QgsDecorationCopyrightDialog +++ /dev/null @@ -1,31 +0,0 @@ -

Copyright Label

-Draws a copyright label with information.
-You can add any random text to the map not only a copyright label. -

-How to
-Text formatting
- - -

How to

- -
    -
  1. Make sure the plugin is loaded. -
  2. Click on . -
  3. Enter the text you want to place on the map. You can use HTML. -
  4. Choose the placement of the label from the drop-down box. -
  5. Make sure the is checked. -
  6. Click . -
- -

Text formatting

-
-This plugin supports basic HTML markup tags for formatting text. For example: - - diff --git a/resources/context_help/QgsDecorationNorthArrowDialog b/resources/context_help/QgsDecorationNorthArrowDialog deleted file mode 100644 index a866944f4baf..000000000000 --- a/resources/context_help/QgsDecorationNorthArrowDialog +++ /dev/null @@ -1,4 +0,0 @@ -

North Arrow Plugin

-Displays a north arrow overlaid onto the map. -

-At present there is only one style available. You can adjust the angle of the arrow or let QGIS set the direction automatically. If you choose to let QGIS determine the direction, it makes its best guess as to how the arrow should be oriented. For placement of the arrow you have four options, corresponding to the four corners of the map canvas. \ No newline at end of file diff --git a/resources/context_help/QgsDecorationScaleBarDialog b/resources/context_help/QgsDecorationScaleBarDialog deleted file mode 100644 index d5b14707837b..000000000000 --- a/resources/context_help/QgsDecorationScaleBarDialog +++ /dev/null @@ -1,18 +0,0 @@ -

Scale bar Plugin

-Draws a scale bar on the map. -

-You can control the style and placement, as well as the labeling of the bar. -QGIS only supports displaying the scale in the same units as your map frame. So -if the units of your layers are in meters, you can't create a scale bar in -feet. Likewise if you are using decimal degrees, you can't create a scale bar -to display distance in meters.

-To add a scale bar: -

    -
  1. Choose the placement from the drop-down list.
  2. -
  3. Choose the style from the list.
  4. -
  5. Select the color for the bar or use the default black color.
  6. -
  7. Set the size of the bar and its label .
  8. -
  9. Make sure the checkbox is checked.
  10. -
  11. Optionally choose to automatically snap to a round number when the canvas is resized .
  12. -
  13. Click .
  14. -
diff --git a/resources/context_help/QgsDelimitedTextSourceSelect b/resources/context_help/QgsDelimitedTextSourceSelect deleted file mode 100644 index 9c8689ac1c2a..000000000000 --- a/resources/context_help/QgsDelimitedTextSourceSelect +++ /dev/null @@ -1,317 +0,0 @@ -

Delimited Text File Layer

-Loads and displays delimited text files -

-Overview
-Creating a delimited text layer
-How the delimiter, quote, and escape characters work
-How regular expression delimiters work
-How WKT text is interpreted
-Attributes in delimited text files
-Example of a text file with X,Y point coordinates
-Example of a text file with WKT geometries
-Using delimited text layers in Python
-

- -

Overview

-

A "delimited text file" contains data in which each record starts on a new line, and -is split into fields by a delimiter such as a comma. -This type of file is commonly exported from spreadsheets (for example CSV files) or databases. -Typically the first line of a delimited text file contains the names of the fields. -

-

-Delimited text files can be loaded into QGIS as a layer. -The records can be displayed spatially either as a point -defined by X and Y coordinates, or using a Well Known Text (WKT) definition of a geometry which may -describe points, lines, and polygons of arbitrary complexity. The file can also be loaded as an attribute -only table, which can then be joined to other tables in QGIS. -

-

-In addition to the geometry definition the file can contain text, integer, and real number fields. By default -QGIS will choose the type of field based on its the non blank values of the field. If all can be interpreted -as integer then the type will be integer, if all can be interpreted as real numbers then the type will -be double, otherwise the type will be text. -

-

-QGIS can also read the types from an OGR CSV driver compatible "csvt" file. -This is a file alongside the data file, but with a "t" appended to the file name. -The file should just contain one line which lists the type of each field. -Valid types are "integer", "long", "longlong", "real", -"string", "date", "time", and "datetime". -The date, time, and datetime types are treated as strings by the delimited text provider. -Each type may be followed by a width and precision, for example "real(10.4)". -The list of types are separated by commas, regardless of the delimiter used in the data file. An -example of a valid format file would be: -

- -
-"integer","string","string(20)","real(20.4)"
-
- -

Creating a delimited text layer

-

Creating a delimited text layer involves choosing the data file, defining the format (how each record is to -be split into fields), and defining the geometry is represented. -This is managed with the delimited text dialog as detailed below. -The dialog box displays a sample from the beginning of the file which shows how the format -options have been applied. -

-
Choosing the data file
-

Use the "Browse..." button to select the data file. Once the file is selected the -layer name will automatically be populated based on the file name. The layer name is used to represent -the data in the QGIS legend. -

-

-By default files are assumed to be encoded as UTF-8. However other file -encodings can be selected. For example "System" uses the default encoding for the operating system. -It is safer to use an explicit coding if the QGIS project needs to be portable. -

-
Specifying the file format
-

The file format can be one of -

-
Record and field options
-

The following options affect the selection of records and fields from the data file

- -
Geometry definition
-

The geometry is can be define as one of

- -

For point coordinates the following options apply:

- -

For well known text geometry the following options apply:

- -
Layer settings
-

Layer settings control the way the layer is managed in QGIS. The options available are:

- - -

How the delimiter, quote, and escape characters work

-

Records are split into fields using three character sets: -delimiter characters, quote characters, and escape characters. -Other characters in the record are considered as data, split into -fields by delimiter characters. -Quote characters occur in pairs and cause the text between them to be treated as a data. Escape characters cause the character following them to be treated as data. -

-

-Quote and escape characters cannot be the same as delimiter characters - they -will be ignored if they are. Escape characters can be the same as quote characters, but behave differently -if they are.

-

The delimiter characters are used to mark the end of each field. If more than one delimiter character -is defined then any one of the characters can mark the end of a field. The quote and escape characters -can override the delimiter character, so that it is treated as a normal data character.

-

Quote characters may be used to mark the beginning and end of quoted fields. Quoted fields can -contain delimiters and may span multiple lines in the text file. If a field is quoted then it must -start and end with the same quote character. Quote characters cannot occur within a field unless they -are escaped.

-

Escape characters which are not quote characters force the following character to be treated as data. -(that is, to stop it being treated as a new line, delimiter, or quote character). -

-

Escape characters that are also quote characters have much more limited effect. They only apply within quotes and only escape themselves. For example, if -' is a quote and escape character, then the string -'Smith''s Creek' will represent the value Smith's Creek. -

- - -

How regular expression delimiters work

-

Regular expressions are mini-language used to represent character patterns. There are many variations -of regular expression syntax - QGIS uses the syntax provided by the QRegExp class of the Qt framework.

-

In a regular expression delimited file each line is treated as a record. Each match of the regular expression in the line is treated as the end of a field. -If the regular expression contains capture groups (e.g., (cat|dog)) - then these are extracted as fields. - If this is not desired then use non-capturing groups (e.g., (?:cat|dog)). -

-

The regular expression is treated differently if it is anchored to the start of the line (that is, the pattern starts with ^). -In this case the regular expression is matched against each line. If the line does not match it is discarded -as an invalid record. Each capture group in the expression is treated as a field. The regular expression -is invalid if it does not have capture groups. As an example this can be used as a (somewhat -unintuitive) means of loading data with fixed width fields. For example the -expression -

-^(.{5})(.{10})(.{20})(.{20})
-
-

will extract four fields of widths 5, 10, 20, and 20 characters from each line. -Lines less than 55 characters long will be discarded. -

- - -

How WKT text is interpreted

-

-The delimited text layer recognizes the following -well known text types - -POINT, MULTIPOINT, LINESTRING, MULTILINESTRING, POLYGON, and MULTIPOLYGON. -It will accept geometries with -a Z coordinate (e.g., POINT Z), a measure (POINT M), or both (POINT ZM). -

-

-It can also handle the PostGIS EWKT variation, in which the geometry is preceded by an spatial reference -system id (e.g., SRID=4326;POINT(175.3 41.2)), and a variant used by Informix in which the WKT is -preceded by an integer spatial reference id (e.g., 1 POINT(175.3 41.2)). -In both cases the SRID is ignored. -

- - - -

Attributes in delimited text files

-

Each record in the delimited text file is split into fields representing -attributes of the record. Usually the attribute names are taken from the first -data record in the file. However if this does not contain attribute names, then they will be named field_1, field_2, and so on. -Also if records have more fields than are defined in the header record then these -will be named field_#, where # is the field number (note that empty fields at the end of a record are ignored). -QGIS may override -the names in the text file if they are numbers, or have names like field_#, -or are duplicated. -

-

-In addition to the attributes explicitly in the data file QGIS assigns a unique -feature id to each record which is the line number in the source file on which -the record starts. -

-

-Each attribute also has a data type, one of string (text), integer, longlong, -or real number. -The data type is inferred from the content of the fields - if every non blank value -is a valid integer then the type is integer, otherwise if it is a valid long long -number then the type is longlong, otherwise if it is a valid real -number then the type is real, otherwise the type is string. Note that this is -based on the content of the fields - quoting fields does not change the way they -are interpreted. -

- - -

Example of a text file with X,Y point coordinates

-
-X;Y;ELEV
--300120;7689960;13
--654360;7562040;52
-1640;7512840;3
-
-

This file:

- -

Example of a text file with WKT geometries

-
-id|wkt
-1|POINT(172.0702250 -43.6031036)
-2|POINT(172.0702250 -43.6031036)
-3|POINT(172.1543206 -43.5731302)
-4|POINT(171.9282585 -43.5493308)
-5|POINT(171.8827359 -43.5875983)
-
-

This file:

- - -

Using delimited text layers in Python

-

Delimited text data sources can be creating from Python in a similar way to other vector layers. -The pattern is: -

-
-from PyQt4.QtCore import QUrl, QString
-from qgis.core import QgsVectorLayer, QgsMapLayerRegistry
-
-# Define the data source
-filename="test.csv"
-uri=QUrl.fromLocalFile(filename)
-uri.addQueryItem("type","csv")
-uri.addQueryItem("delimiter","|")
-uri.addQueryItem("wktField","wkt")
-# ... other delimited text parameters
-layer=QgsVectorLayer(QString(uri.toEncoded()),"Test CSV layer","delimitedtext")
-# Add the layer to the map
-if layer.isValid():
-    QgsMapLayerRegistry.instance().addMapLayer( layer )
-
-

This could be used to load the second example file above.

-

The configuration of the delimited text layer is defined by adding query items to the uri. -The following options can be added -

- - - diff --git a/resources/context_help/QgsGPSPluginGui b/resources/context_help/QgsGPSPluginGui deleted file mode 100644 index ae9e55fbc1a6..000000000000 --- a/resources/context_help/QgsGPSPluginGui +++ /dev/null @@ -1,2 +0,0 @@ -

GPS Plugin

- diff --git a/resources/context_help/QgsIdentifyResultsDialog b/resources/context_help/QgsIdentifyResultsDialog deleted file mode 100644 index d63a7729c99f..000000000000 --- a/resources/context_help/QgsIdentifyResultsDialog +++ /dev/null @@ -1,9 +0,0 @@ -

Identify Features

-

-The result dialog shows all the features identified within the search tolerance. To see the results details, expand the feature information on the left of each feature. -

-

-The search radius can be set in the options dialog , Identify section, as a percentage of map width. In this section you may also set identify mode to , , .
-You may also tick an option.
-Identifiable layers can be set in the Project Properties dialog where all the layers names are listed, their type (vector, raster, etc.) and ability to be identified. -

diff --git a/resources/context_help/QgsMeasureDialog b/resources/context_help/QgsMeasureDialog deleted file mode 100644 index 8ccb4c524653..000000000000 --- a/resources/context_help/QgsMeasureDialog +++ /dev/null @@ -1,10 +0,0 @@ -

Measure Tools

-There are three measure tools: length, area and angle. With them, you can measure distances, areas and angles on the map canvas. The tools provide results in the units set in . -

Measuring Lengths

-To measure lengths, select the tool and click along the path you want to measure. The length of each segment is displayed as is the total length for the path. -A single right mouse click stops the measuring. -

Measuring Areas

-To measure areas, select the tool and click to create the area. The total area is dynamically displayed as you click. -A single right mouse click stops the measuring, while two right mouse clicks starts measuring a new. -

Measuring Angles

-To measure angles, select the tool and click on three points to create an angle between these points. The second point selected is the vertex of the angle. The angle is dynamically displayed once you clicked the second point. diff --git a/resources/context_help/QgsNewSpatialiteLayerDialog b/resources/context_help/QgsNewSpatialiteLayerDialog deleted file mode 100644 index 0a15c162b886..000000000000 --- a/resources/context_help/QgsNewSpatialiteLayerDialog +++ /dev/null @@ -1,23 +0,0 @@ -

Create a New SpatiaLite Layer

-You can use this dialog to create a new SpatiaLite database and/or an empty SpatiaLite layer for editing. See below for an explanation of the dialog inputs. -

Database

-Choose the database from the drop-down list. This list is created from your saved SpatiaLite connections. If you don't have a saved connection or want to create a new database, click on the button () to the right of the drop-down. -

Layer name

-Enter a name for the layer you want to create. The name should be one word. You can use underscores in the name if you like. -

Geometry column

-Enter a name for the geometry column or accept the default. -

Type

-Choose the type of layer you want to create. -

EPSG SRID

-Enter the EPSG number for the spatial reference id (SRID). By default the SRID for WGS 84 is filled in for you. Click on button to change the coordinate reference system of the layer if needed. The SRID must exist within the spatial_ref_sys in your SpatiaLite database. You can search for the SRID using partial matches on both name and SRID. -

Create an auto-incrementing Primary Key

-Clicking this checkbox will add a primary key to the new layer. This key field will be auto-incrementing, meaning you don't have to enter a value for it when adding features to the attribute table of the layer. -

New attribute

-Add the desired attributes by clicking on the button after you have specified a name and type for the attribute. Only real, integer, and string attributes are supported.
-Width and precision are irrelevant in a SpatiaLite database so you do not have to specify these. -

Attributes list

-In this section you can see the list of attributes. To delete one of them, click on it and choose button. - -

-Click on to create the layer and close the dialog. - will close the layer without further changes. diff --git a/resources/context_help/QgsNewVectorLayerDialog b/resources/context_help/QgsNewVectorLayerDialog deleted file mode 100644 index 9ca6ede23bb3..000000000000 --- a/resources/context_help/QgsNewVectorLayerDialog +++ /dev/null @@ -1,11 +0,0 @@ -

Create New Vector Layer

-To create a new layer for editing, choose from the menu.
-With this dialog you can create a shape file layer. -

Type

-Choose the type of layer , or .
-Click on button to change the coordinate reference system of the layer if needed. -

New attribute

-Add the desired attributes by clicking on the button after you have specified a name and type for the attribute. Only real, integer, and string attributes are supported.
-You can also define the width and precision of the new attribute column. -

Attributes list

-In this section you can see the list of attributes. To delete one of them, click on it and choose button. diff --git a/resources/context_help/QgsOpenVectorLayerDialog b/resources/context_help/QgsOpenVectorLayerDialog deleted file mode 100644 index 666844542e11..000000000000 --- a/resources/context_help/QgsOpenVectorLayerDialog +++ /dev/null @@ -1,6 +0,0 @@ -

Open Vector Layer Dialog

- -The open vector layer dialog is used to add vector data to the QGIS map view. Vector data are spatial data described using geometries of points, lines and polygons (enclosed areas).

-QGIS supports vector data in a number of formats, including those supported by the OGR library data provider plugin, such as ESRI shape files, MapInfo MIF (interchange format) and MapInfo TAB (native format).

-QGIS supports PostGIS layers in a PostgreSQL database and SpatiaLite layers. Support for additional data types (e.g., delimited text) is provided by additional data provider plugins. A list of OGR supported vector formats can be found in Appendix A.1 of the User Guide.

-Detailed description how to proceed with vector data is described in chapter 5 'Working with Vector Data'. diff --git a/resources/context_help/QgsOptions b/resources/context_help/QgsOptions deleted file mode 100644 index ceb734c5a2e8..000000000000 --- a/resources/context_help/QgsOptions +++ /dev/null @@ -1,73 +0,0 @@ -

Options

-This dialog allows you to select some basic options for QGIS. There are eight tabs: -

- -General
-Rendering & SVG
-Map tools
-Overlay
-Digitizing
-CRS
-Locale
-Network & Proxy
- - -

General

- -On this tab you can set general options for project behavior on opening/saving, default map appearance, your favorite icon theme and many others. - -

Rendering & SVG

-
-Within this tab you can set general rendering options for map layers.
-By default, QGIS renders all visible layers whenever the map canvas must be refreshed. The events that trigger a refresh of the map canvas include: - -QGIS allows you to control the rendering process in a number of ways:

-You can set an option to always load new layers without drawing them.
-This means the layer will be added to the map, but its visibility checkbox in the legend will be unchecked by default. To set this option, uncheck the checkbox.

-You can set an option to update the map display as features are drawn.
-By default, QGIS does not display any features for a layer until the entire layer has been rendered. To update the display as features are read from the data store, set the to an appropriate value. Setting a value of 0 disables update during drawing (this is the default). Setting a value too low will result in poor performance as the map canvas is continually updated during the reading of the features. A suggested value to start with is 500. - -

Map tools

- -
Identify
-The setting determines which layers will be shown by the tool. By switching to instead of attributes for all identifiable layers will be shown with the tool. -
Measure tool
-Here you can set an ellipsoid for distance calculations, measurement units and preferred color of rubber band. -
Panning and zooming
-Allows defining mouse wheel action and zoom factor. - -

Overlay

-
-Define placement algorithm for labels. Choose between , , , and . - - -

Digitizing

-
-
Rubber band
-In the tab you can define settings for digitizing line width and color. -
Snapping
-Here you can define a general, project wide snapping tolerance.

-You can select between , or as default snap mode. You can also define a default snapping tolerance and a search radius for vertex edits. The tolerance can be set either in map units or in pixels. The advantage of choosing pixels, is that the snapping tolerance doesn't have to be changed after zoom operations.

-A layer based snapping tolerance can be defined by choosing (or ) > . In the tab, section you can click on to enable and adjust snapping mode and tolerance on a layer basis. -

Vertex markers
-You can define marker style as , or and size; you can also set showing markers only for selected features. -
Enter attribute values
-By default, after digitizing a new feature, QGIS asks you to enter attribute values for that feature. Ticking allows you to enter the attributes later. - -

CRS

-
-QGIS no longer sets the map CRS to the coordinate reference system of the first layer loaded. When you start a QGIS session with layers that do not have a CRS, you need to check and define the CRS definition for these layers. This can be done globally on this tab.

-The global default CRS proj=longlat +ellps=WGS84 +datum=WGS84 +no_defs comes predefined in QGIS but can of course be changed, and the new definition will be saved for subsequent QGIS sessions. - -

Locale

- -Informs you about active system locale. To change it tick and restart QGIS. - -

Network & Proxy

-
-Tick to define host, port, user, and password. diff --git a/resources/context_help/QgsOracleNewConnection b/resources/context_help/QgsOracleNewConnection deleted file mode 100644 index 49d2ad6417d4..000000000000 --- a/resources/context_help/QgsOracleNewConnection +++ /dev/null @@ -1,39 +0,0 @@ -

Create a New Oracle Connection

-This dialog allows you to define the settings for a connection to a Oracle database. -

-

diff --git a/resources/context_help/QgsOracleSourceSelect b/resources/context_help/QgsOracleSourceSelect deleted file mode 100644 index bf1d9d4cbaf6..000000000000 --- a/resources/context_help/QgsOracleSourceSelect +++ /dev/null @@ -1,40 +0,0 @@ -

Add Oracle Tables

-This dialog allows you to add Oracle layers (tables with a geometry column) to the QGIS map canvas. -

-Connections
-Adding Layers
-Filtering a Layer
-Search options
- - -

Connections

- - - -

Adding Layers

-
-To add a layer: -
    -
  1. Choose the desired connection from the drop-down box. -
  2. Click . -
  3. Find the layer you want to add in the list and click on it to select it. -
  4. You can select additional layers by holding down the Ctrl key and clicking. -
  5. Click to add the layer(s) to the map. -
- -

Filtering a Layer

-
-To filter a layer before adding it to the map, double-click on its name or use button. This will open the Query Builder, allowing you to build up a SQL statement to use in filtering the records. - - -

Options

-
- diff --git a/resources/context_help/QgsPgNewConnection b/resources/context_help/QgsPgNewConnection deleted file mode 100644 index d77c01ca7cf7..000000000000 --- a/resources/context_help/QgsPgNewConnection +++ /dev/null @@ -1,32 +0,0 @@ -

Create a New PostGIS Connection

-This dialog allows you to define the settings for a connection to a PostgreSQL/PostGIS database. -

-

diff --git a/resources/context_help/QgsPgSourceSelect b/resources/context_help/QgsPgSourceSelect deleted file mode 100644 index a6a216c1c51d..000000000000 --- a/resources/context_help/QgsPgSourceSelect +++ /dev/null @@ -1,40 +0,0 @@ -

Add PostGIS Tables

-This dialog allows you to add PostGIS layers (tables with a geometry column) to the QGIS map canvas. -

-Connections
-Adding Layers
-Filtering a Layer
-Search options
- - -

Connections

- - - -

Adding Layers

-
-To add a layer: -
    -
  1. Choose the desired connection from the drop-down box. -
  2. Click . -
  3. Find the layer you want to add in the list and click on it to select it. -
  4. You can select additional layers by holding down the Ctrl key and clicking. -
  5. Click to add the layer(s) to the map. -
- -

Filtering a Layer

-
-To filter a layer before adding it to the map, double-click on its name or use button. This will open the Query Builder, allowing you to build up a SQL statement to use in filtering the records. - - -

Options

-
- diff --git a/resources/context_help/QgsPluginManager b/resources/context_help/QgsPluginManager deleted file mode 100644 index 04014476917c..000000000000 --- a/resources/context_help/QgsPluginManager +++ /dev/null @@ -1,85 +0,0 @@ -

Manage and install Plugins

- -

-Manage and install plugins. -

- - -Installed tab
-Get more tab
-New tab
-Upgradable tab
-Invalid tab
-Settings tab
- - -

Installed tab

-
-

-This tab shows you the list of currently installed plugins on your system. Both -python and C++ plugins are listed. -

-

-You can enable or disable them by clicking the checkbox in front of the name.
-Selecting an item show the plugin information in the detail pane. -

-

-There is a context menu (right click) available, to change the sorting on: -name, number of downloads, votes and status. -

- - - -

Get more tab

-
-

-This tab shows you the list of available plugins from the remote repositories. -It is downloaded once if you start up. But you can change that in the Settings -

-

-Selecting an item shows you the plugin information in the detail pane. -

- - -

New tab

-
-

-This tab will be shown when a new plugin is made available! It will be shown -just once. -

- - -

Upgradable tab

-
-

-This tab is only available if one of your installed plugins can be upgraded -from the remote repositories. -

- - -

Invalid tab

-
-

-This tab is only available if there is a invalid plugin. Mostly caused by an error -during loading the plugin. -

- - -

Settings tab

-
-

-In this tab you can change the Settings for the plugin manager. -

-

-It is possible to check how often QGIS will download the list and update information -from the available repositories. -

-

-By checking the 'Show experimental plugins' checkbox, all plugins will be shown -in the lists, even the ones that are considered 'experimental' by the author. - -
-Note: Experimental plugins are generally unsuitable for production use. These plugins are in the early stages of development, and should be considered "incomplete" or "proof of concept" tools. The QGIS development team does not recommend installing these plugins unless you intend to use them for testing purposes. -
- -

diff --git a/resources/context_help/QgsProjectProperties b/resources/context_help/QgsProjectProperties deleted file mode 100644 index d2ef3fc4edb5..000000000000 --- a/resources/context_help/QgsProjectProperties +++ /dev/null @@ -1,127 +0,0 @@ -

Project Properties

-

- This dialog allows you to set a number of properties related to the - . A Project is a saved set of layers and their settings, - as well as other information required to restore the project from disk. -

- -

-General Tab
-Coordinate Reference System (CRS) Tab
-Identify layers Tab
-

- - -

General Tab

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-

- A descriptive title for the project. This title will be displayed in the - title bar of the QGIS window. -

-
-

- Selected features are displayed on the map using this color. -

-

The color of the map canvas.

-

- Reference files by their absolute path or a path relative to the project - file. If you are sharing your project file with others, or accessing it - from another machine, choose "relative". -

-
-

- Which ellipsoid should be used to calculate distances when using 'on the - fly' CRS transformation. -

-
-

- Choose the units appropriate for the layers in the project. -

-
-

- Use the manual setting to set the precision of the display in the status - bar. As the mouse is moved over the map canvas, the coordinates are updated and - displayed in the status bar using the precision you choose. Automatic (the - default) results in a default precision based on the map units. -

-
-

- The option enables editing and - maintaining common boundaries in polygon mosaics. Editing a vertex in shared - boundary will result in updating both boundaries. -

-

- To avoid digitizing all vertices of the common boundary select - . In the dialog window - tick appropriate layers to which the new polygon will be adjusted. Draw - the new polygon in the way it overlap the existing one, it will be cut - automatically. -

-

- allows you to set the snapping tolerance - in pixels or map units and the snapping mode: , - , for every - layer separately. -

- - -

Coordinate Reference System (CRS) Tab

-
- -

- The Coordinate Reference System (CRS) tab allows you to set the projection for - the current project and enable on the fly transformation. You do not need to - have a saved project to setup and enable 'on the fly' CRS transformation. -

-

- To use 'on the fly' CRS transformation, click the checkbox. Then choose the projection for the - project (map canvas) from the list of Geographic or Projected coordinate - systems. -

-

- You can find a coordinate system by entering its name, EPSG code or the QGIS ID - into the text field. The list of recently used - coordinate systems are available at the top for quick access. -

- - -

Identify layers Tab

-
-

- On this tab you can choose on which layers the identify tool will work. -

diff --git a/resources/context_help/QgsQueryBuilder b/resources/context_help/QgsQueryBuilder deleted file mode 100644 index 153565221147..000000000000 --- a/resources/context_help/QgsQueryBuilder +++ /dev/null @@ -1,45 +0,0 @@ -

Query Builder

-The query builder allows you to create provider specific filter expressions. - -These are usually evaluated much faster than the generic QGIS expressions, but -are sometimes limited (e.g. for shape files) or behave diffently. - -

Providers

- - - - - - - - - - - - - - - - - - - - - - - - - -
ProviderDocumentation
OGRwhere clauses depending on the - format (e.g., - OGR SQL - for shape files) -
PostgreSQL/PostGISwhere clauses using - PostgreSQL and - PostGIS -
SpatiaLitewhere clauses using - SQLite and - SpatiaLite -
Oracle Spatial/Locatorwhere clauses using - Oracle Spatial/Locator -
...
diff --git a/resources/context_help/QgsSpatiaLiteSourceSelect b/resources/context_help/QgsSpatiaLiteSourceSelect deleted file mode 100644 index 36882301c99c..000000000000 --- a/resources/context_help/QgsSpatiaLiteSourceSelect +++ /dev/null @@ -1,3 +0,0 @@ -

Add SpatiaLite Tables

-To define a new connection, click on button and use the file browser to point to your SpatiaLite database, which is a file with a .sqlite extension.

-The connections you define will be remembered for further use and available to choose from the drop-down menu. diff --git a/resources/context_help/QgsVectorLayerProperties b/resources/context_help/QgsVectorLayerProperties deleted file mode 100644 index b77438e83774..000000000000 --- a/resources/context_help/QgsVectorLayerProperties +++ /dev/null @@ -1,138 +0,0 @@ -

Vector Layer Properties

-This dialog allows you to work with vector layer settings and properties. There are seven tabs: -

-Symbology
-Labels
-Attributes
-General
-Metadata
-Actions
-Diagram Overlay
- - -

Symbology

- -To change the symbology for a layer, simply double-click on its legend entry and the vector dialog will be shown.

-Within this dialog you can style your vector layer. Depending on the selected rendering option you have the possibility to also classify your map features. - -

Legend type
-QGIS supports a number of symbology renderers to control how vector features are displayed. Currently the following renderers are available: - - -
New symbology
-Click button to use new symbology implementation for the layer. - -
Vector transparency
-QGIS allows setting a transparency for every vector layer. This can be done with the slider . This is very useful for overlaying several vector layers. - -
Saving styles
-Once you have styled your layer you also could save your layer-style to a separate file (with *.qml ending). To do this, use the button . No need to say that loads your saved layer-style-file.
-If you wish to always use a particular style whenever the layer is loaded, use the button to make your style the default. Also, if you make changes to the style that you are not happy with, use the button to revert to your default style. - - -

Labels

-
-The Labels tab allows you to enable labeling features and control a number of options related to fonts, placement, style, alignment and buffering.
-Check the checkbox to enable labeling. - -
Basic Label options
-Choose the field to label with.

-Select the use the and buttons to set the font and color. You can also change the angle and the placement of the text-label.

-If have labels extending over several lines, check . QGIS will check for a true line return in your label field and insert the line breaks accordingly. A true line return is a single character \n, (not two separate characters, like a backslash \ followed by the character n). - -

Placement
-Change the label placement by selecting one of the radio buttons in the group. - -
Font size units
-The allows you to select between or . - -
Buffer labels
-To buffer the labels means putting a backdrop around them to make them stand out better. To buffer the lakes labels: -
    -
  1. Click the checkbox to enable buffering. -
  2. Choose a size for the buffer using the spin box. -
  3. Choose a color by clicking on and choosing your favorite from the color selector. You can also set some transparency for the buffer if you prefer. -
  4. Click to see if you like the changes. -
-Notice you can also specify the buffer size in map -units if that works out better for you. - -
Data defined placement, properties, buffer, position
-The remaining entries inside the tab allow you control the appearance of the labels using attributes stored in the layer. The entries beginning with allow you to set all the parameters for the labels using fields in the layer. - - - -

Attributes

-
-Within the tab the attributes of the selected data set can be manipulated. The buttons and can be used, when the data set is in editing mode. The OGR library supports to add new columns, but not to remove them, if you have a GDAL version >= 1.6 installed. Otherwise only columns from PostGIS layers can be edited.

-The button toggles this mode.

-Within the Attributes tab you also find an edit widget column. This column can be used to define values or a range of values that are allowed to be added to the specific attribute table column. If you click on the button, a dialog opens, where you can define different widgets. These widgets are:
-

- - -

General

-
-The General tab allows you to change the display name, set scale dependent rendering options, create a spatial index of the vector file (only for OGR supported formats and PostGIS) and view or change the projection of the specific vector layer.

-You can also set a provider specific filter expressions using the . - -

Subset
-The button allows you to limit the features of a layer to a subset matching an provider specific filter expression. - - -

Metadata

-
-The tab contains information about the layer, including specifics about the type and location, number of features, feature type, and the editing capabilities. The Layer Spatial Reference System section, providing projection information, is displayed on this tab. This is a quick way to get information about the layer. - - -

Actions

-
-QGIS provides the ability to perform an action based on the attributes of a feature. This can be used to perform any number of actions, for example, running a program with arguments built from the attributes of a feature or passing parameters to a web reporting tool.
-Actions are useful when you frequently want to run an external application or view a web page based on one or more values in your vector layer.

- -The new implementation of actions uses the QGIS expression engine to do evaluations. Each expression is evaluated and replaced by its result at runtime.

-An expression must be enclosed between [% and %] - the GUI has some buttons which do that for you automatically. -The button launches the which allows writing an expression easily, the button inserts into the action a placeholder like [% "fieldname" %] where fieldname is the name of the field selected in the field dropdown list.

- -See the User Guide for further information. - -

Using Actions
-Actions can be invoked from the dialog or using the tool on the toolbar.

- -Each action adds a little set of custom expressions to the default set available in the .
-While running actions from the dialog the custom expression $currfield will be replaced with the value of the selected field in the dialog, using the tool the following custom expressions are available (instead of $currfield): -

- -Note: the tool executes the actions on all the matching features, where as allows you to select which specific feature to run action on.

- - -

Action Examples
-You can add some example actions by clicking on the button. - - - -

Diagram Overlay

-
-The Diagram tab allows you to add a graphic overlay to a vector layer. To activate this feature, open the and select the plugin. After this, there is a new tab in the vector dialog where the settings for diagrams may be entered.

-The current implementation of diagrams provides support for pie- and bar charts and for linear scaling -of the diagram size according to a classification attribute. diff --git a/resources/context_help/QgsVectorLayerSaveAsDialog b/resources/context_help/QgsVectorLayerSaveAsDialog deleted file mode 100644 index 15434276178b..000000000000 --- a/resources/context_help/QgsVectorLayerSaveAsDialog +++ /dev/null @@ -1,13 +0,0 @@ -

Save vector layer as...

- -

This dialog allows you to save vector data in various formats using GDAL/OGR. - -

- -See OGR Vector formats for a list of supported formats and the available options. diff --git a/resources/context_help/QgsWMSSourceSelect b/resources/context_help/QgsWMSSourceSelect deleted file mode 100644 index 94694d1973e5..000000000000 --- a/resources/context_help/QgsWMSSourceSelect +++ /dev/null @@ -1,37 +0,0 @@ -

Create a new WMS connection

-WMS layers can be added quite simply, as long as you know the URL to access the WMS server, you have a serviceable connection to that server, and the server understands HTTP as the data transport mechanism.

-QGIS currently can act as a WMS client that understands WMS 1.1, 1.1.1 and 1.3 servers. -

-Servers
-Loading WMS Layers
-Layer Order
-Server Search
- - -

Servers

- -To define a new WMS server in the section, select . Then enter the parameters to connect to your desired WMS server.

-You can add some servers to play with by clicking the button. This will add at least three WMS servers for you to use.

-Once the new WMS Server connection has been created, it will be preserved for future QGIS sessions. - - -

Loading WMS Layers
- -Select the button to retrieve the capabilities of the selected server. This includes the Image encoding, Layers, Layer Styles and Projections.
-While downloading data from the WMS server, the download progress is visualized in the left bottom of the WMS Plugin dialog.

-The section now lists the formats that are supported by both the client and server.
-Choose one depending on your image accuracy requirements.

-You can select several layers at once, they will be combined at the WMS Server and transmitted to QGIS in one go.

-Each WMS Layer can be presented in multiple CRSs, depending on the capability of the WMS server. To choose a CRS, select - - -

Layer Order

- -On this tab you can change the order of loaded WMS layers. - - -

Server Search

-
-On this tab you can search for WMS servers. It is possible to enter a search-string in the text field an hit the button.

-To visualize the results, select an table entry, press the button and change back to the tab.

-You only need to request the list of layers by clicking the button. diff --git a/resources/context_help/eVisDatabaseConnectionGui b/resources/context_help/eVisDatabaseConnectionGui deleted file mode 100644 index e9ea231a2e99..000000000000 --- a/resources/context_help/eVisDatabaseConnectionGui +++ /dev/null @@ -1 +0,0 @@ -

Database connection