diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..7ef10df --- /dev/null +++ b/.gitignore @@ -0,0 +1,5 @@ +# ignore pyc files (if any) +*.pyc +_build + + diff --git a/Makefile b/Makefile new file mode 100644 index 0000000..bdc4cd4 --- /dev/null +++ b/Makefile @@ -0,0 +1,153 @@ +# Makefile for Sphinx documentation +# + +# You can set these variables from the command line. +SPHINXOPTS = +SPHINXBUILD = sphinx-build +PAPER = +BUILDDIR = _build + +# Internal variables. +PAPEROPT_a4 = -D latex_paper_size=a4 +PAPEROPT_letter = -D latex_paper_size=letter +ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) source +# the i18n builder cannot share the environment and doctrees with the others +I18NSPHINXOPTS = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) . + +.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext + +help: + @echo "Please use \`make ' where is one of" + @echo " html to make standalone HTML files" + @echo " dirhtml to make HTML files named index.html in directories" + @echo " singlehtml to make a single large HTML file" + @echo " pickle to make pickle files" + @echo " json to make JSON files" + @echo " htmlhelp to make HTML files and a HTML help project" + @echo " qthelp to make HTML files and a qthelp project" + @echo " devhelp to make HTML files and a Devhelp project" + @echo " epub to make an epub" + @echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter" + @echo " latexpdf to make LaTeX files and run them through pdflatex" + @echo " text to make text files" + @echo " man to make manual pages" + @echo " texinfo to make Texinfo files" + @echo " info to make Texinfo files and run them through makeinfo" + @echo " gettext to make PO message catalogs" + @echo " changes to make an overview of all changed/added/deprecated items" + @echo " linkcheck to check all external links for integrity" + @echo " doctest to run all doctests embedded in the documentation (if enabled)" + +clean: + -rm -rf $(BUILDDIR)/* + +html: + $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html + @echo + @echo "Build finished. The HTML pages are in $(BUILDDIR)/html." + +dirhtml: + $(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml + @echo + @echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml." + +singlehtml: + $(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml + @echo + @echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml." + +pickle: + $(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle + @echo + @echo "Build finished; now you can process the pickle files." + +json: + $(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json + @echo + @echo "Build finished; now you can process the JSON files." + +htmlhelp: + $(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp + @echo + @echo "Build finished; now you can run HTML Help Workshop with the" \ + ".hhp project file in $(BUILDDIR)/htmlhelp." + +qthelp: + $(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp + @echo + @echo "Build finished; now you can run "qcollectiongenerator" with the" \ + ".qhcp project file in $(BUILDDIR)/qthelp, like this:" + @echo "# qcollectiongenerator $(BUILDDIR)/qthelp/QGISDocumentation.qhcp" + @echo "To view the help file:" + @echo "# assistant -collectionFile $(BUILDDIR)/qthelp/QGISDocumentation.qhc" + +devhelp: + $(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp + @echo + @echo "Build finished." + @echo "To view the help file:" + @echo "# mkdir -p $$HOME/.local/share/devhelp/QGISDocumentation" + @echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/QGISDocumentation" + @echo "# devhelp" + +epub: + $(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub + @echo + @echo "Build finished. The epub file is in $(BUILDDIR)/epub." + +latex: + $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex + @echo + @echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex." + @echo "Run \`make' in that directory to run these through (pdf)latex" \ + "(use \`make latexpdf' here to do that automatically)." + +latexpdf: + $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex + @echo "Running LaTeX files through pdflatex..." + $(MAKE) -C $(BUILDDIR)/latex all-pdf + @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex." + +text: + $(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text + @echo + @echo "Build finished. The text files are in $(BUILDDIR)/text." + +man: + $(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man + @echo + @echo "Build finished. The manual pages are in $(BUILDDIR)/man." + +texinfo: + $(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo + @echo + @echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo." + @echo "Run \`make' in that directory to run these through makeinfo" \ + "(use \`make info' here to do that automatically)." + +info: + $(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo + @echo "Running Texinfo files through makeinfo..." + make -C $(BUILDDIR)/texinfo info + @echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo." + +gettext: + $(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale + @echo + @echo "Build finished. The message catalogs are in $(BUILDDIR)/locale." + +changes: + $(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes + @echo + @echo "The overview file is in $(BUILDDIR)/changes." + +linkcheck: + $(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck + @echo + @echo "Link check complete; look for any errors in the above output " \ + "or in $(BUILDDIR)/linkcheck/output.txt." + +doctest: + $(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest + @echo "Testing of doctests in the sources finished, look at the " \ + "results in $(BUILDDIR)/doctest/output.txt." diff --git a/build.sh b/build.sh new file mode 100755 index 0000000..c58832c --- /dev/null +++ b/build.sh @@ -0,0 +1,10 @@ +# use this in crontab +rm -rf _build/ +# compile messages +msgfmt source/translated/it/index.po -o source/translated/it/LC_MESSAGES/index.mo +msgfmt source/translated/it/introduction.po -o source/translated/it/LC_MESSAGES/introduction.mo +msgfmt source/translated/it/getting_started.po -o source/translated/it/LC_MESSAGES/getting_started.mo +# build html +sphinx-build -b html -a -Dlanguage=en source _build/html/en +sphinx-build -b html -a -Dlanguage=it source _build/html/it + diff --git a/make.bat b/make.bat new file mode 100644 index 0000000..2f94b98 --- /dev/null +++ b/make.bat @@ -0,0 +1,190 @@ +@ECHO OFF + +REM Command file for Sphinx documentation + +if "%SPHINXBUILD%" == "" ( + set SPHINXBUILD=sphinx-build +) +set BUILDDIR=_build +set ALLSPHINXOPTS=-d %BUILDDIR%/doctrees %SPHINXOPTS% . +set I18NSPHINXOPTS=%SPHINXOPTS% . +if NOT "%PAPER%" == "" ( + set ALLSPHINXOPTS=-D latex_paper_size=%PAPER% %ALLSPHINXOPTS% + set I18NSPHINXOPTS=-D latex_paper_size=%PAPER% %I18NSPHINXOPTS% +) + +if "%1" == "" goto help + +if "%1" == "help" ( + :help + echo.Please use `make ^` where ^ is one of + echo. html to make standalone HTML files + echo. dirhtml to make HTML files named index.html in directories + echo. singlehtml to make a single large HTML file + echo. pickle to make pickle files + echo. json to make JSON files + echo. htmlhelp to make HTML files and a HTML help project + echo. qthelp to make HTML files and a qthelp project + echo. devhelp to make HTML files and a Devhelp project + echo. epub to make an epub + echo. latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter + echo. text to make text files + echo. man to make manual pages + echo. texinfo to make Texinfo files + echo. gettext to make PO message catalogs + echo. changes to make an overview over all changed/added/deprecated items + echo. linkcheck to check all external links for integrity + echo. doctest to run all doctests embedded in the documentation if enabled + goto end +) + +if "%1" == "clean" ( + for /d %%i in (%BUILDDIR%\*) do rmdir /q /s %%i + del /q /s %BUILDDIR%\* + goto end +) + +if "%1" == "html" ( + %SPHINXBUILD% -b html %ALLSPHINXOPTS% %BUILDDIR%/html + if errorlevel 1 exit /b 1 + echo. + echo.Build finished. The HTML pages are in %BUILDDIR%/html. + goto end +) + +if "%1" == "dirhtml" ( + %SPHINXBUILD% -b dirhtml %ALLSPHINXOPTS% %BUILDDIR%/dirhtml + if errorlevel 1 exit /b 1 + echo. + echo.Build finished. The HTML pages are in %BUILDDIR%/dirhtml. + goto end +) + +if "%1" == "singlehtml" ( + %SPHINXBUILD% -b singlehtml %ALLSPHINXOPTS% %BUILDDIR%/singlehtml + if errorlevel 1 exit /b 1 + echo. + echo.Build finished. The HTML pages are in %BUILDDIR%/singlehtml. + goto end +) + +if "%1" == "pickle" ( + %SPHINXBUILD% -b pickle %ALLSPHINXOPTS% %BUILDDIR%/pickle + if errorlevel 1 exit /b 1 + echo. + echo.Build finished; now you can process the pickle files. + goto end +) + +if "%1" == "json" ( + %SPHINXBUILD% -b json %ALLSPHINXOPTS% %BUILDDIR%/json + if errorlevel 1 exit /b 1 + echo. + echo.Build finished; now you can process the JSON files. + goto end +) + +if "%1" == "htmlhelp" ( + %SPHINXBUILD% -b htmlhelp %ALLSPHINXOPTS% %BUILDDIR%/htmlhelp + if errorlevel 1 exit /b 1 + echo. + echo.Build finished; now you can run HTML Help Workshop with the ^ +.hhp project file in %BUILDDIR%/htmlhelp. + goto end +) + +if "%1" == "qthelp" ( + %SPHINXBUILD% -b qthelp %ALLSPHINXOPTS% %BUILDDIR%/qthelp + if errorlevel 1 exit /b 1 + echo. + echo.Build finished; now you can run "qcollectiongenerator" with the ^ +.qhcp project file in %BUILDDIR%/qthelp, like this: + echo.^> qcollectiongenerator %BUILDDIR%\qthelp\QGISDocumentation.qhcp + echo.To view the help file: + echo.^> assistant -collectionFile %BUILDDIR%\qthelp\QGISDocumentation.ghc + goto end +) + +if "%1" == "devhelp" ( + %SPHINXBUILD% -b devhelp %ALLSPHINXOPTS% %BUILDDIR%/devhelp + if errorlevel 1 exit /b 1 + echo. + echo.Build finished. + goto end +) + +if "%1" == "epub" ( + %SPHINXBUILD% -b epub %ALLSPHINXOPTS% %BUILDDIR%/epub + if errorlevel 1 exit /b 1 + echo. + echo.Build finished. The epub file is in %BUILDDIR%/epub. + goto end +) + +if "%1" == "latex" ( + %SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex + if errorlevel 1 exit /b 1 + echo. + echo.Build finished; the LaTeX files are in %BUILDDIR%/latex. + goto end +) + +if "%1" == "text" ( + %SPHINXBUILD% -b text %ALLSPHINXOPTS% %BUILDDIR%/text + if errorlevel 1 exit /b 1 + echo. + echo.Build finished. The text files are in %BUILDDIR%/text. + goto end +) + +if "%1" == "man" ( + %SPHINXBUILD% -b man %ALLSPHINXOPTS% %BUILDDIR%/man + if errorlevel 1 exit /b 1 + echo. + echo.Build finished. The manual pages are in %BUILDDIR%/man. + goto end +) + +if "%1" == "texinfo" ( + %SPHINXBUILD% -b texinfo %ALLSPHINXOPTS% %BUILDDIR%/texinfo + if errorlevel 1 exit /b 1 + echo. + echo.Build finished. The Texinfo files are in %BUILDDIR%/texinfo. + goto end +) + +if "%1" == "gettext" ( + %SPHINXBUILD% -b gettext %I18NSPHINXOPTS% %BUILDDIR%/locale + if errorlevel 1 exit /b 1 + echo. + echo.Build finished. The message catalogs are in %BUILDDIR%/locale. + goto end +) + +if "%1" == "changes" ( + %SPHINXBUILD% -b changes %ALLSPHINXOPTS% %BUILDDIR%/changes + if errorlevel 1 exit /b 1 + echo. + echo.The overview file is in %BUILDDIR%/changes. + goto end +) + +if "%1" == "linkcheck" ( + %SPHINXBUILD% -b linkcheck %ALLSPHINXOPTS% %BUILDDIR%/linkcheck + if errorlevel 1 exit /b 1 + echo. + echo.Link check complete; look for any errors in the above output ^ +or in %BUILDDIR%/linkcheck/output.txt. + goto end +) + +if "%1" == "doctest" ( + %SPHINXBUILD% -b doctest %ALLSPHINXOPTS% %BUILDDIR%/doctest + if errorlevel 1 exit /b 1 + echo. + echo.Testing of doctests in the sources finished, look at the ^ +results in %BUILDDIR%/doctest/output.txt. + goto end +) + +:end diff --git a/readme.rst b/readme.rst new file mode 100644 index 0000000..e3cbfb9 --- /dev/null +++ b/readme.rst @@ -0,0 +1,54 @@ +******************************************************************************** +QGIS Documentation +******************************************************************************** + +Introduction +================================================================================ + +`View Online (html) `_ +or `download the pdf +`_ + +This repository stores official QGIS documentation. + +http://qgis.org + +To build:: + + ./build.sh + +Paolo Corti +April, 2012 + +Some quick note on internationalization +================================================================================ + +Project administrators must have generated .pot files:: + + $ sphinx-build -b gettext source/ source/translated/pot/ + +To add a new language +-------------------------------------------------------------------------------- + +#. copy the source/translated/pot directory to + source/transated/your-language-code directory, where your-language-code is + the `ISO language code with 2 digits + `_ +#. rename the files .pot to .po and edit them +#. compile the .po files you have edited:: + + $ msgfmt introduction.po -o translated/it/LC_MESSAGES/introduction.mo + +#. to build/rebuild (updating them) all the template files (for Italian):: + + $ sphinx-build -b gettext source/ source/translated/it/ + +#. This will check if a .po file needs to be updated:: + + $ msgmerge source/translated/it/getting_started.po + source/translated/pot/getting_started.pot -U + +Editors +-------------------------------------------------------------------------------- + +#. Check out Gtranslator diff --git a/source/conf.py b/source/conf.py new file mode 100644 index 0000000..7597d1f --- /dev/null +++ b/source/conf.py @@ -0,0 +1,249 @@ +# -*- coding: utf-8 -*- +# +# QGIS Documentation documentation build configuration file, created by +# sphinx-quickstart on Tue Apr 3 18:38:04 2012. +# +# This file is execfile()d with the current directory set to its containing dir. +# +# Note that not all possible configuration values are present in this +# autogenerated file. +# +# All configuration values have a default; values that are commented out +# serve to show the default. + +import sys, os + +# If extensions (or modules to document with autodoc) are in another directory, +# add these directories to sys.path here. If the directory is relative to the +# documentation root, use os.path.abspath to make it absolute, like shown here. +#sys.path.insert(0, os.path.abspath('.')) + +# -- General configuration ----------------------------------------------------- + +# If your documentation needs a minimal Sphinx version, state it here. +#needs_sphinx = '1.0' + +# Add any Sphinx extension module names here, as strings. They can be extensions +# coming with Sphinx (named 'sphinx.ext.*') or your custom ones. +extensions = ['sphinx.ext.intersphinx', 'sphinx.ext.todo'] + +# Add any paths that contain templates here, relative to this directory. +templates_path = ['_templates'] + +# The suffix of source filenames. +source_suffix = '.rst' + +# The encoding of source files. +#source_encoding = 'utf-8-sig' + +# The master toctree document. +master_doc = 'index' + +# General information about the project. +project = u'QGIS Documentation' +copyright = u'2012, aavv' + +# The version info for the project you're documenting, acts as replacement for +# |version| and |release|, also used in various other places throughout the +# built documents. +# +# The short X.Y version. +version = '1.8' +# The full version, including alpha/beta/rc tags. +release = '1.8' + +# The language for content autogenerated by Sphinx. Refer to documentation +# for a list of supported languages. +#language = None + +# There are two options for replacing |today|: either, you set today to some +# non-false value, then it is used: +#today = '' +# Else, today_fmt is used as the format for a strftime call. +#today_fmt = '%B %d, %Y' + +# List of patterns, relative to source directory, that match files and +# directories to ignore when looking for source files. +exclude_patterns = ['_build'] + +# The reST default role (used for this markup: `text`) to use for all documents. +#default_role = None + +# If true, '()' will be appended to :func: etc. cross-reference text. +#add_function_parentheses = True + +# If true, the current module name will be prepended to all description +# unit titles (such as .. function::). +#add_module_names = True + +# If true, sectionauthor and moduleauthor directives will be shown in the +# output. They are ignored by default. +#show_authors = False + +# The name of the Pygments (syntax highlighting) style to use. +pygments_style = 'sphinx' + +# A list of ignored prefixes for module index sorting. +#modindex_common_prefix = [] + + +# -- Options for HTML output --------------------------------------------------- + +# The theme to use for HTML and HTML Help pages. See the documentation for +# a list of builtin themes. +html_theme = 'qgis-theme' + +# Theme options are theme-specific and customize the look and feel of a theme +# further. For a list of options available for each theme, see the +# documentation. +#html_theme_options = {} + +# Add any paths that contain custom themes here, relative to this directory. +html_theme_path = ['../../QGIS-Governance'] + +# The name for this set of Sphinx documents. If None, it defaults to +# " v documentation". +#html_title = None + +# A shorter title for the navigation bar. Default is the same as html_title. +#html_short_title = None + +# The name of an image file (relative to this directory) to place at the top +# of the sidebar. +#html_logo = None + +# The name of an image file (within the static path) to use as favicon of the +# docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32 +# pixels large. +#html_favicon = None + +# Add any paths that contain custom static files (such as style sheets) here, +# relative to this directory. They are copied after the builtin static files, +# so a file named "default.css" will overwrite the builtin "default.css". +html_static_path = ['_static'] + +# If not '', a 'Last updated on:' timestamp is inserted at every page bottom, +# using the given strftime format. +#html_last_updated_fmt = '%b %d, %Y' + +# If true, SmartyPants will be used to convert quotes and dashes to +# typographically correct entities. +#html_use_smartypants = True + +# Custom sidebar templates, maps document names to template names. +#html_sidebars = {} + +# Additional templates that should be rendered to pages, maps page names to +# template names. +#html_additional_pages = {} + +# If false, no module index is generated. +#html_domain_indices = True + +# If false, no index is generated. +#html_use_index = True + +# If true, the index is split into individual pages for each letter. +#html_split_index = False + +# If true, links to the reST sources are added to the pages. +#html_show_sourcelink = True + +# If true, "Created using Sphinx" is shown in the HTML footer. Default is True. +#html_show_sphinx = True + +# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True. +#html_show_copyright = True + +# If true, an OpenSearch description file will be output, and all pages will +# contain a tag referring to it. The value of this option must be the +# base URL from which the finished HTML is served. +#html_use_opensearch = '' + +# This is the file name suffix for HTML files (e.g. ".xhtml"). +#html_file_suffix = None + +# Output file base name for HTML help builder. +htmlhelp_basename = 'QGISDocumentationdoc' + + +# -- Options for LaTeX output -------------------------------------------------- + +latex_elements = { +# The paper size ('letterpaper' or 'a4paper'). +#'papersize': 'letterpaper', + +# The font size ('10pt', '11pt' or '12pt'). +#'pointsize': '10pt', + +# Additional stuff for the LaTeX preamble. +#'preamble': '', +} + +# Grouping the document tree into LaTeX files. List of tuples +# (source start file, target name, title, author, documentclass [howto/manual]). +latex_documents = [ + ('index', 'QGISDocumentation.tex', u'QGIS Documentation Documentation', + u'various', 'manual'), +] + +# The name of an image file (relative to this directory) to place at the top of +# the title page. +#latex_logo = None + +# For "manual" documents, if this is true, then toplevel headings are parts, +# not chapters. +#latex_use_parts = False + +# If true, show page references after internal links. +#latex_show_pagerefs = False + +# If true, show URL addresses after external links. +#latex_show_urls = False + +# Documents to append as an appendix to all manuals. +#latex_appendices = [] + +# If false, no module index is generated. +#latex_domain_indices = True + + +# -- Options for manual page output -------------------------------------------- + +# One entry per manual page. List of tuples +# (source start file, name, description, authors, manual section). +man_pages = [ + ('index', 'qgisdocumentation', u'QGIS Documentation Documentation', + [u'various'], 1) +] + +# If true, show URL addresses after external links. +#man_show_urls = False + + +# -- Options for Texinfo output ------------------------------------------------ + +# Grouping the document tree into Texinfo files. List of tuples +# (source start file, target name, title, author, +# dir menu entry, description, category) +texinfo_documents = [ + ('index', 'QGISDocumentation', u'QGIS Documentation Documentation', + u'various', 'QGISDocumentation', 'One line description of project.', + 'Miscellaneous'), +] + +# Documents to append as an appendix to all manuals. +#texinfo_appendices = [] + +# If false, no module index is generated. +#texinfo_domain_indices = True + +# How to display URL addresses: 'footnote', 'no', or 'inline'. +#texinfo_show_urls = 'footnote' + + +# Example configuration for intersphinx: refer to the Python standard library. +intersphinx_mapping = {'http://docs.python.org/': None} + +locale_dirs = ['translated'] + diff --git a/source/getting_started.rst b/source/getting_started.rst new file mode 100644 index 0000000..61e2fd8 --- /dev/null +++ b/source/getting_started.rst @@ -0,0 +1,170 @@ +.. role:: cmd-txt +.. role:: button-name +.. role:: tool-name +.. role:: dialog-name +.. role:: tab-name +.. role:: radio-name +.. role:: check-name + +******************************************************************************** +Getting Started +******************************************************************************** + +This chapter gives a very quick overview of installing |qg|, some sample +data from the web page and running a first and simple session +visualizing raster and vector layers. + +Installation +================================================================================ + +Installation of |qg| is very simple. +Standard installer packages are available for MS Windows and Mac OS +X. For many flavors of GNU/Linux binary packages (rpm and deb) or +software repositories to add to your installation manager are +provided. Get the latest information on binary packages at the +website at http://download.qgis.org. + +Installation from source +-------------------------------------------------------------------------------- + +If you need to build from source, please +refer to the coding and compiling guide available at +http://www.qgis.org/en/documentation/manuals.html. The installation +instructions are also distributed with the source code. + +Installation on external media +-------------------------------------------------------------------------------- + +QGIS allows to define a -configpath +option that overrides the default path (e.g. :cmd-txt:`/.qgis` under Linux) +for user configuration and forces QSettings to use this directory, +too. This allows users to e.g. carry a QGIS installation on a flash +drive together with all plugins and settings. + +Sample Data +================================================================================ + +The user guide contains examples based on the |qg| sample dataset. + +|win| The Windows installer has an option to download the |qg| sample dataset. +If checked, the data will be downloaded to your +:cmd-txt:`My Documents` folder and placed in a folder called +:cmd-txt:`GIS Database`. You may use Windows Explorer to move this folder to +any convenient location. If you did not select the checkbox to install the +sample dataset during the initial installation, you can either + +* use GIS data that you already have; +* download the sample data from the qgis website at + http://download.qgis.org; or +* uninstall and reinstall with the data download option checked, + only if the above solutions are unsuccessful. + + +|nix| |osx| For GNU/Linux and Mac OSX there are not yet dataset +installation packages available as rpm, deb or dmg. To use the +sample dataset download the file :cmd-txt:`qgis_sample_data` as ZIP or +TAR archive from http://download.osgeo.org/qgis/data/ and unzip or +untar the archive on your system. The Alaska dataset includes all +GIS data that are used as examples and screenshots in the user +guide, and also includes a small GRASS database. The projection for +the qgis sample dataset is Alaska Albers Equal Area with unit feet. +The EPSG code is 2964. + +:: + + PROJCS["Albers Equal Area", + GEOGCS["NAD27", + DATUM["North_American_Datum_1927", + SPHEROID["Clarke 1866",6378206.4,294.978698213898, + AUTHORITY["EPSG","7008"]], + TOWGS84[-3,142,183,0,0,0,0], + AUTHORITY["EPSG","6267"]], + PRIMEM["Greenwich",0, + AUTHORITY["EPSG","8901"]], + UNIT["degree",0.0174532925199433, + AUTHORITY["EPSG","9108"]], + AUTHORITY["EPSG","4267"]], + PROJECTION["Albers_Conic_Equal_Area"], + PARAMETER["standard_parallel_1",55], + PARAMETER["standard_parallel_2",65], + PARAMETER["latitude_of_center",50], + PARAMETER["longitude_of_center",-154], + PARAMETER["false_easting",0], + PARAMETER["false_northing",0], + UNIT["us_survey_feet",0.3048006096012192]] + +If you intend to use as graphical frontend for GRASS, you can find +a selection of sample locations (e.g. Spearfish or South Dakota) at +the official GRASS GIS website +http://grass.osgeo.org/download/data.php. + +Sample Session +================================================================================ + +Now that you have installed and a sample dataset available, we +would like to demonstrate a short and simple sample session. We +will visualize a raster and a vector layer. We will use the +landcover raster layer +|qg| :cmd-txt:`_sample_data/raster/landcover.img` and the lakes vector +layer :cmd-txt:`_sample_data/gml/lakes.gml`. + +Start |qg| + +* |nix| Start |qg| by typing: |qg| at a command prompt, or + if using precompiled binary, using the Applications menu. +* |win| Start |qg| using the Start menu or desktop shortcut, + or double click on a |qg| project file. +* |osx| Double click the icon in your Applications folder. + + +.. figure:: images/getting_started_screenies/simple_session.png + :width: 100% + + A Simple |qg| Session |nix| + +Load raster and vector layers from the sample dataset + +#. Click on the |mActionAddRasterLayer| :tool-name:`Load Raster` icon. +#. Browse to the folder :cmd-txt:`qgis_sample_data/raster/`, select the + ERDAS Img file :cmd-txt:`landcover.img` and click + :button-name:`Open`. +#. If the file is not listed, check if the Filetype combobox at the + bottom of the dialog is set on the right type, in this case "Erdas + Imagine Images (\*.img, \*.IMG)" +#. Now click on the |mActionAddOgrLayer| :tool-name:`Load Vector` icon. +#. :radio-name:`File` should be selected as Source Type in the new + :dialog-name:`Add Vector Layer` dialog. Now click + :button-name:`Browse` to select the vector + layer. +#. Browse to the folder :cmd-txt:`qgis_sample_data/gml/`, select "GML" + from the filetype combobox, then select the GML file :cmd-txt:`lakes.gml` + and click :button-name:`Open`, then in Add Vector dialog click + :button-name:`OK`. +#. Zoom in a bit to your favorite area with some lakes. +#. Double click the :cmd-txt:`lakes` layer in the map legend to open the + :dialog-name:`Properties` dialog. +#. Click on the :tab-name:`Style` tab and select a blue as fill color. +#. Click on the :tab-name:`Labels` tab and check the :check-name:`Display + labels` checkbox to + enable labeling. Choose NAMES field as field containing label. +#. To improve readability of labels, you can add a white buffer around + them, by clicking "Buffer" in the list on the left, checking + :check-name:`Buffer labels?` and choosing 3 as buffer size. +#. Click :button-name:`Apply`, check if the result looks good and + finally click :button-name:`OK`. + +You can see how easy it is to visualize raster and vector layers +in . Let's move on to the sections that follow to learn more about +the available functionality, features and settings and how to use +them. + +.. |qg| replace:: QGIS +.. |osx| image:: images/operating_system_icons/osx.png + :height: 12 +.. |win| image:: images/operating_system_icons/win.png + :height: 12 +.. |nix| image:: images/operating_system_icons/nix.png + :height: 12 +.. |mActionAddRasterLayer| image:: images/images/mActionAddRasterLayer.png +.. |mActionAddOgrLayer| image:: images/images/mActionAddOgrLayer.png + diff --git a/source/images/getting_started_screenies/simple_session.png b/source/images/getting_started_screenies/simple_session.png new file mode 100644 index 0000000..9ae239a Binary files /dev/null and b/source/images/getting_started_screenies/simple_session.png differ diff --git a/source/images/images/cap_flat.png b/source/images/images/cap_flat.png new file mode 100644 index 0000000..b7bc9b9 Binary files /dev/null and b/source/images/images/cap_flat.png differ diff --git a/source/images/images/cap_round.png b/source/images/images/cap_round.png new file mode 100644 index 0000000..bd72fc9 Binary files /dev/null and b/source/images/images/cap_round.png differ diff --git a/source/images/images/cap_square.png b/source/images/images/cap_square.png new file mode 100644 index 0000000..6ec55b9 Binary files /dev/null and b/source/images/images/cap_square.png differ diff --git a/source/images/images/clearInput.png b/source/images/images/clearInput.png new file mode 100644 index 0000000..061cb24 Binary files /dev/null and b/source/images/images/clearInput.png differ diff --git a/source/images/images/extents.png b/source/images/images/extents.png new file mode 100644 index 0000000..a64d3f8 Binary files /dev/null and b/source/images/images/extents.png differ diff --git a/source/images/images/favourites.png b/source/images/images/favourites.png new file mode 100644 index 0000000..aaba163 Binary files /dev/null and b/source/images/images/favourites.png differ diff --git a/source/images/images/geographic.png b/source/images/images/geographic.png new file mode 100644 index 0000000..f4c6dd1 Binary files /dev/null and b/source/images/images/geographic.png differ diff --git a/source/images/images/grass_mapset.png b/source/images/images/grass_mapset.png new file mode 100644 index 0000000..4d5be2a Binary files /dev/null and b/source/images/images/grass_mapset.png differ diff --git a/source/images/images/join_bevel.png b/source/images/images/join_bevel.png new file mode 100644 index 0000000..a7d3d1c Binary files /dev/null and b/source/images/images/join_bevel.png differ diff --git a/source/images/images/join_miter.png b/source/images/images/join_miter.png new file mode 100644 index 0000000..801684c Binary files /dev/null and b/source/images/images/join_miter.png differ diff --git a/source/images/images/join_round.png b/source/images/images/join_round.png new file mode 100644 index 0000000..2962feb Binary files /dev/null and b/source/images/images/join_round.png differ diff --git a/source/images/images/locked.png b/source/images/images/locked.png new file mode 100644 index 0000000..4b637f9 Binary files /dev/null and b/source/images/images/locked.png differ diff --git a/source/images/images/mAction.png b/source/images/images/mAction.png new file mode 100644 index 0000000..f368883 Binary files /dev/null and b/source/images/images/mAction.png differ diff --git a/source/images/images/mActionAddAllToOverview.png b/source/images/images/mActionAddAllToOverview.png new file mode 100644 index 0000000..19d2d81 Binary files /dev/null and b/source/images/images/mActionAddAllToOverview.png differ diff --git a/source/images/images/mActionAddArrow.png b/source/images/images/mActionAddArrow.png new file mode 100755 index 0000000..616a56d Binary files /dev/null and b/source/images/images/mActionAddArrow.png differ diff --git a/source/images/images/mActionAddBasicShape.png b/source/images/images/mActionAddBasicShape.png new file mode 100755 index 0000000..86adc2a Binary files /dev/null and b/source/images/images/mActionAddBasicShape.png differ diff --git a/source/images/images/mActionAddImage.png b/source/images/images/mActionAddImage.png new file mode 100644 index 0000000..364167f Binary files /dev/null and b/source/images/images/mActionAddImage.png differ diff --git a/source/images/images/mActionAddIsland.png b/source/images/images/mActionAddIsland.png new file mode 100644 index 0000000..fbecdea Binary files /dev/null and b/source/images/images/mActionAddIsland.png differ diff --git a/source/images/images/mActionAddLayer.png b/source/images/images/mActionAddLayer.png new file mode 100644 index 0000000..fd46e2b Binary files /dev/null and b/source/images/images/mActionAddLayer.png differ diff --git a/source/images/images/mActionAddLegend.png b/source/images/images/mActionAddLegend.png new file mode 100644 index 0000000..335afb0 Binary files /dev/null and b/source/images/images/mActionAddLegend.png differ diff --git a/source/images/images/mActionAddMap.png b/source/images/images/mActionAddMap.png new file mode 100644 index 0000000..29728ab Binary files /dev/null and b/source/images/images/mActionAddMap.png differ diff --git a/source/images/images/mActionAddNonDbLayer.png b/source/images/images/mActionAddNonDbLayer.png new file mode 100644 index 0000000..d5dd2c1 Binary files /dev/null and b/source/images/images/mActionAddNonDbLayer.png differ diff --git a/source/images/images/mActionAddOgrLayer.png b/source/images/images/mActionAddOgrLayer.png new file mode 100644 index 0000000..d5dd2c1 Binary files /dev/null and b/source/images/images/mActionAddOgrLayer.png differ diff --git a/source/images/images/mActionAddPart.png b/source/images/images/mActionAddPart.png new file mode 100644 index 0000000..fbecdea Binary files /dev/null and b/source/images/images/mActionAddPart.png differ diff --git a/source/images/images/mActionAddRasterLayer.png b/source/images/images/mActionAddRasterLayer.png new file mode 100644 index 0000000..d579199 Binary files /dev/null and b/source/images/images/mActionAddRasterLayer.png differ diff --git a/source/images/images/mActionAddRing.png b/source/images/images/mActionAddRing.png new file mode 100644 index 0000000..d6300d0 Binary files /dev/null and b/source/images/images/mActionAddRing.png differ diff --git a/source/images/images/mActionAddSpatiaLiteLayer.png b/source/images/images/mActionAddSpatiaLiteLayer.png new file mode 100644 index 0000000..d10cf5a Binary files /dev/null and b/source/images/images/mActionAddSpatiaLiteLayer.png differ diff --git a/source/images/images/mActionAddVertex.png b/source/images/images/mActionAddVertex.png new file mode 100644 index 0000000..23843eb Binary files /dev/null and b/source/images/images/mActionAddVertex.png differ diff --git a/source/images/images/mActionAddWmsLayer.png b/source/images/images/mActionAddWmsLayer.png new file mode 100644 index 0000000..4965641 Binary files /dev/null and b/source/images/images/mActionAddWmsLayer.png differ diff --git a/source/images/images/mActionAlignBottom.png b/source/images/images/mActionAlignBottom.png new file mode 100644 index 0000000..3eec918 Binary files /dev/null and b/source/images/images/mActionAlignBottom.png differ diff --git a/source/images/images/mActionAlignHCenter.png b/source/images/images/mActionAlignHCenter.png new file mode 100644 index 0000000..e477c15 Binary files /dev/null and b/source/images/images/mActionAlignHCenter.png differ diff --git a/source/images/images/mActionAlignLeft.png b/source/images/images/mActionAlignLeft.png new file mode 100644 index 0000000..5f18c58 Binary files /dev/null and b/source/images/images/mActionAlignLeft.png differ diff --git a/source/images/images/mActionAlignRight.png b/source/images/images/mActionAlignRight.png new file mode 100644 index 0000000..98f7916 Binary files /dev/null and b/source/images/images/mActionAlignRight.png differ diff --git a/source/images/images/mActionAlignTop.png b/source/images/images/mActionAlignTop.png new file mode 100644 index 0000000..287d078 Binary files /dev/null and b/source/images/images/mActionAlignTop.png differ diff --git a/source/images/images/mActionAlignVCenter.png b/source/images/images/mActionAlignVCenter.png new file mode 100644 index 0000000..d2e0108 Binary files /dev/null and b/source/images/images/mActionAlignVCenter.png differ diff --git a/source/images/images/mActionAnnotation.png b/source/images/images/mActionAnnotation.png new file mode 100644 index 0000000..2152499 Binary files /dev/null and b/source/images/images/mActionAnnotation.png differ diff --git a/source/images/images/mActionArrowDown.png b/source/images/images/mActionArrowDown.png new file mode 100644 index 0000000..ea9c00c Binary files /dev/null and b/source/images/images/mActionArrowDown.png differ diff --git a/source/images/images/mActionArrowUp.png b/source/images/images/mActionArrowUp.png new file mode 100644 index 0000000..d6c2b99 Binary files /dev/null and b/source/images/images/mActionArrowUp.png differ diff --git a/source/images/images/mActionCalculateField.png b/source/images/images/mActionCalculateField.png new file mode 100644 index 0000000..8c47c68 Binary files /dev/null and b/source/images/images/mActionCalculateField.png differ diff --git a/source/images/images/mActionCaptureLine.png b/source/images/images/mActionCaptureLine.png new file mode 100644 index 0000000..301928f Binary files /dev/null and b/source/images/images/mActionCaptureLine.png differ diff --git a/source/images/images/mActionCapturePoint.png b/source/images/images/mActionCapturePoint.png new file mode 100644 index 0000000..18dedd6 Binary files /dev/null and b/source/images/images/mActionCapturePoint.png differ diff --git a/source/images/images/mActionCapturePolygon.png b/source/images/images/mActionCapturePolygon.png new file mode 100644 index 0000000..cd72569 Binary files /dev/null and b/source/images/images/mActionCapturePolygon.png differ diff --git a/source/images/images/mActionChangeLabelProperties.png b/source/images/images/mActionChangeLabelProperties.png new file mode 100644 index 0000000..67523e5 Binary files /dev/null and b/source/images/images/mActionChangeLabelProperties.png differ diff --git a/source/images/images/mActionCheckQgisVersion.png b/source/images/images/mActionCheckQgisVersion.png new file mode 100644 index 0000000..31c064b Binary files /dev/null and b/source/images/images/mActionCheckQgisVersion.png differ diff --git a/source/images/images/mActionCollapseTree.png b/source/images/images/mActionCollapseTree.png new file mode 100644 index 0000000..eea15e4 Binary files /dev/null and b/source/images/images/mActionCollapseTree.png differ diff --git a/source/images/images/mActionComposerManager.png b/source/images/images/mActionComposerManager.png new file mode 100644 index 0000000..6ddf8ea Binary files /dev/null and b/source/images/images/mActionComposerManager.png differ diff --git a/source/images/images/mActionContextHelp.png b/source/images/images/mActionContextHelp.png new file mode 100644 index 0000000..d200458 Binary files /dev/null and b/source/images/images/mActionContextHelp.png differ diff --git a/source/images/images/mActionCopySelected.png b/source/images/images/mActionCopySelected.png new file mode 100644 index 0000000..35bc307 Binary files /dev/null and b/source/images/images/mActionCopySelected.png differ diff --git a/source/images/images/mActionCustomProjection.png b/source/images/images/mActionCustomProjection.png new file mode 100644 index 0000000..1c077bf Binary files /dev/null and b/source/images/images/mActionCustomProjection.png differ diff --git a/source/images/images/mActionDeleteAttribute.png b/source/images/images/mActionDeleteAttribute.png new file mode 100644 index 0000000..5bb3a9e Binary files /dev/null and b/source/images/images/mActionDeleteAttribute.png differ diff --git a/source/images/images/mActionDeletePart.png b/source/images/images/mActionDeletePart.png new file mode 100644 index 0000000..ba90095 Binary files /dev/null and b/source/images/images/mActionDeletePart.png differ diff --git a/source/images/images/mActionDeleteRing.png b/source/images/images/mActionDeleteRing.png new file mode 100644 index 0000000..6785481 Binary files /dev/null and b/source/images/images/mActionDeleteRing.png differ diff --git a/source/images/images/mActionDeleteSelected.png b/source/images/images/mActionDeleteSelected.png new file mode 100644 index 0000000..7f10703 Binary files /dev/null and b/source/images/images/mActionDeleteSelected.png differ diff --git a/source/images/images/mActionDeleteVertex.png b/source/images/images/mActionDeleteVertex.png new file mode 100644 index 0000000..9271598 Binary files /dev/null and b/source/images/images/mActionDeleteVertex.png differ diff --git a/source/images/images/mActionDeselectAll.png b/source/images/images/mActionDeselectAll.png new file mode 100644 index 0000000..d7f0846 Binary files /dev/null and b/source/images/images/mActionDeselectAll.png differ diff --git a/source/images/images/mActionDraw.png b/source/images/images/mActionDraw.png new file mode 100644 index 0000000..3fa8db7 Binary files /dev/null and b/source/images/images/mActionDraw.png differ diff --git a/source/images/images/mActionEditCopy.png b/source/images/images/mActionEditCopy.png new file mode 100644 index 0000000..78687de Binary files /dev/null and b/source/images/images/mActionEditCopy.png differ diff --git a/source/images/images/mActionEditCut.png b/source/images/images/mActionEditCut.png new file mode 100644 index 0000000..4d7ee3d Binary files /dev/null and b/source/images/images/mActionEditCut.png differ diff --git a/source/images/images/mActionEditPaste.png b/source/images/images/mActionEditPaste.png new file mode 100644 index 0000000..d9ff986 Binary files /dev/null and b/source/images/images/mActionEditPaste.png differ diff --git a/source/images/images/mActionExpandTree.png b/source/images/images/mActionExpandTree.png new file mode 100644 index 0000000..32bfb77 Binary files /dev/null and b/source/images/images/mActionExpandTree.png differ diff --git a/source/images/images/mActionExportMapServer.png b/source/images/images/mActionExportMapServer.png new file mode 100644 index 0000000..fdb7c4e Binary files /dev/null and b/source/images/images/mActionExportMapServer.png differ diff --git a/source/images/images/mActionFileExit.png b/source/images/images/mActionFileExit.png new file mode 100644 index 0000000..3ce5300 Binary files /dev/null and b/source/images/images/mActionFileExit.png differ diff --git a/source/images/images/mActionFileNew.png b/source/images/images/mActionFileNew.png new file mode 100644 index 0000000..7be37e8 Binary files /dev/null and b/source/images/images/mActionFileNew.png differ diff --git a/source/images/images/mActionFileOpen.png b/source/images/images/mActionFileOpen.png new file mode 100644 index 0000000..0cc5e3b Binary files /dev/null and b/source/images/images/mActionFileOpen.png differ diff --git a/source/images/images/mActionFilePrint.png b/source/images/images/mActionFilePrint.png new file mode 100644 index 0000000..6ddf8ea Binary files /dev/null and b/source/images/images/mActionFilePrint.png differ diff --git a/source/images/images/mActionFileSave.png b/source/images/images/mActionFileSave.png new file mode 100644 index 0000000..3bc2a37 Binary files /dev/null and b/source/images/images/mActionFileSave.png differ diff --git a/source/images/images/mActionFileSaveAs.png b/source/images/images/mActionFileSaveAs.png new file mode 100644 index 0000000..c8d4816 Binary files /dev/null and b/source/images/images/mActionFileSaveAs.png differ diff --git a/source/images/images/mActionFileSmall.png b/source/images/images/mActionFileSmall.png new file mode 100644 index 0000000..ddb6d8d Binary files /dev/null and b/source/images/images/mActionFileSmall.png differ diff --git a/source/images/images/mActionFolder.png b/source/images/images/mActionFolder.png new file mode 100644 index 0000000..0cc5e3b Binary files /dev/null and b/source/images/images/mActionFolder.png differ diff --git a/source/images/images/mActionFormAnnotation.png b/source/images/images/mActionFormAnnotation.png new file mode 100644 index 0000000..9fe10ea Binary files /dev/null and b/source/images/images/mActionFormAnnotation.png differ diff --git a/source/images/images/mActionFromSelectedFeature.png b/source/images/images/mActionFromSelectedFeature.png new file mode 100644 index 0000000..bc7b66f Binary files /dev/null and b/source/images/images/mActionFromSelectedFeature.png differ diff --git a/source/images/images/mActionFullHistogramStretch.png b/source/images/images/mActionFullHistogramStretch.png new file mode 100644 index 0000000..bb62b87 Binary files /dev/null and b/source/images/images/mActionFullHistogramStretch.png differ diff --git a/source/images/images/mActionGroupItems.png b/source/images/images/mActionGroupItems.png new file mode 100644 index 0000000..6bfdbce Binary files /dev/null and b/source/images/images/mActionGroupItems.png differ diff --git a/source/images/images/mActionHelpAPI.png b/source/images/images/mActionHelpAPI.png new file mode 100644 index 0000000..e2a44ec Binary files /dev/null and b/source/images/images/mActionHelpAPI.png differ diff --git a/source/images/images/mActionHelpAbout.png b/source/images/images/mActionHelpAbout.png new file mode 100644 index 0000000..27ff9d3 Binary files /dev/null and b/source/images/images/mActionHelpAbout.png differ diff --git a/source/images/images/mActionHelpContents.png b/source/images/images/mActionHelpContents.png new file mode 100644 index 0000000..e2a44ec Binary files /dev/null and b/source/images/images/mActionHelpContents.png differ diff --git a/source/images/images/mActionHelpSponsors.png b/source/images/images/mActionHelpSponsors.png new file mode 100644 index 0000000..72ddb7e Binary files /dev/null and b/source/images/images/mActionHelpSponsors.png differ diff --git a/source/images/images/mActionHideAllLayers.png b/source/images/images/mActionHideAllLayers.png new file mode 100644 index 0000000..d8e420c Binary files /dev/null and b/source/images/images/mActionHideAllLayers.png differ diff --git a/source/images/images/mActionIdentify.png b/source/images/images/mActionIdentify.png new file mode 100644 index 0000000..6212588 Binary files /dev/null and b/source/images/images/mActionIdentify.png differ diff --git a/source/images/images/mActionInOverview.png b/source/images/images/mActionInOverview.png new file mode 100644 index 0000000..40928a5 Binary files /dev/null and b/source/images/images/mActionInOverview.png differ diff --git a/source/images/images/mActionInvertSelection.png b/source/images/images/mActionInvertSelection.png new file mode 100644 index 0000000..7070809 Binary files /dev/null and b/source/images/images/mActionInvertSelection.png differ diff --git a/source/images/images/mActionLabel.png b/source/images/images/mActionLabel.png new file mode 100644 index 0000000..d2ffecd Binary files /dev/null and b/source/images/images/mActionLabel.png differ diff --git a/source/images/images/mActionLabeling.png b/source/images/images/mActionLabeling.png new file mode 100644 index 0000000..ad48c16 Binary files /dev/null and b/source/images/images/mActionLabeling.png differ diff --git a/source/images/images/mActionLocalHistogramStretch.png b/source/images/images/mActionLocalHistogramStretch.png new file mode 100644 index 0000000..1e6dc0d Binary files /dev/null and b/source/images/images/mActionLocalHistogramStretch.png differ diff --git a/source/images/images/mActionLowerItems.png b/source/images/images/mActionLowerItems.png new file mode 100644 index 0000000..d600120 Binary files /dev/null and b/source/images/images/mActionLowerItems.png differ diff --git a/source/images/images/mActionMapTips.png b/source/images/images/mActionMapTips.png new file mode 100644 index 0000000..6d4ec4d Binary files /dev/null and b/source/images/images/mActionMapTips.png differ diff --git a/source/images/images/mActionMeasure.png b/source/images/images/mActionMeasure.png new file mode 100644 index 0000000..6c9b6dd Binary files /dev/null and b/source/images/images/mActionMeasure.png differ diff --git a/source/images/images/mActionMeasureAngle.png b/source/images/images/mActionMeasureAngle.png new file mode 100644 index 0000000..534e593 Binary files /dev/null and b/source/images/images/mActionMeasureAngle.png differ diff --git a/source/images/images/mActionMeasureArea.png b/source/images/images/mActionMeasureArea.png new file mode 100644 index 0000000..8bc9ebf Binary files /dev/null and b/source/images/images/mActionMeasureArea.png differ diff --git a/source/images/images/mActionMergeFeatureAttributes.png b/source/images/images/mActionMergeFeatureAttributes.png new file mode 100644 index 0000000..727482a Binary files /dev/null and b/source/images/images/mActionMergeFeatureAttributes.png differ diff --git a/source/images/images/mActionMergeFeatures.png b/source/images/images/mActionMergeFeatures.png new file mode 100644 index 0000000..727482a Binary files /dev/null and b/source/images/images/mActionMergeFeatures.png differ diff --git a/source/images/images/mActionMoveFeature.png b/source/images/images/mActionMoveFeature.png new file mode 100644 index 0000000..a0e4ce8 Binary files /dev/null and b/source/images/images/mActionMoveFeature.png differ diff --git a/source/images/images/mActionMoveItemContent.png b/source/images/images/mActionMoveItemContent.png new file mode 100644 index 0000000..4bf07be Binary files /dev/null and b/source/images/images/mActionMoveItemContent.png differ diff --git a/source/images/images/mActionMoveItemsToBottom.png b/source/images/images/mActionMoveItemsToBottom.png new file mode 100644 index 0000000..353a808 Binary files /dev/null and b/source/images/images/mActionMoveItemsToBottom.png differ diff --git a/source/images/images/mActionMoveItemsToTop.png b/source/images/images/mActionMoveItemsToTop.png new file mode 100644 index 0000000..9accab9 Binary files /dev/null and b/source/images/images/mActionMoveItemsToTop.png differ diff --git a/source/images/images/mActionMoveLabel.png b/source/images/images/mActionMoveLabel.png new file mode 100644 index 0000000..fd96c2f Binary files /dev/null and b/source/images/images/mActionMoveLabel.png differ diff --git a/source/images/images/mActionMoveVertex.png b/source/images/images/mActionMoveVertex.png new file mode 100644 index 0000000..07b39fd Binary files /dev/null and b/source/images/images/mActionMoveVertex.png differ diff --git a/source/images/images/mActionNewAttribute.png b/source/images/images/mActionNewAttribute.png new file mode 100644 index 0000000..a529ed9 Binary files /dev/null and b/source/images/images/mActionNewAttribute.png differ diff --git a/source/images/images/mActionNewBookmark.png b/source/images/images/mActionNewBookmark.png new file mode 100644 index 0000000..f0ac62e Binary files /dev/null and b/source/images/images/mActionNewBookmark.png differ diff --git a/source/images/images/mActionNewComposer.png b/source/images/images/mActionNewComposer.png new file mode 100644 index 0000000..c2c34ea Binary files /dev/null and b/source/images/images/mActionNewComposer.png differ diff --git a/source/images/images/mActionNewFolder.png b/source/images/images/mActionNewFolder.png new file mode 100644 index 0000000..130e35e Binary files /dev/null and b/source/images/images/mActionNewFolder.png differ diff --git a/source/images/images/mActionNewVectorLayer.png b/source/images/images/mActionNewVectorLayer.png new file mode 100644 index 0000000..a48e252 Binary files /dev/null and b/source/images/images/mActionNewVectorLayer.png differ diff --git a/source/images/images/mActionNodeTool.png b/source/images/images/mActionNodeTool.png new file mode 100644 index 0000000..5db4b3d Binary files /dev/null and b/source/images/images/mActionNodeTool.png differ diff --git a/source/images/images/mActionOpenTable.png b/source/images/images/mActionOpenTable.png new file mode 100644 index 0000000..f789dda Binary files /dev/null and b/source/images/images/mActionOpenTable.png differ diff --git a/source/images/images/mActionOptions.png b/source/images/images/mActionOptions.png new file mode 100644 index 0000000..96ba433 Binary files /dev/null and b/source/images/images/mActionOptions.png differ diff --git a/source/images/images/mActionPan.png b/source/images/images/mActionPan.png new file mode 100644 index 0000000..095c0a4 Binary files /dev/null and b/source/images/images/mActionPan.png differ diff --git a/source/images/images/mActionProjectProperties.png b/source/images/images/mActionProjectProperties.png new file mode 100644 index 0000000..ce8b226 Binary files /dev/null and b/source/images/images/mActionProjectProperties.png differ diff --git a/source/images/images/mActionPropertyItem.png b/source/images/images/mActionPropertyItem.png new file mode 100644 index 0000000..78f1593 Binary files /dev/null and b/source/images/images/mActionPropertyItem.png differ diff --git a/source/images/images/mActionQgisHomePage.png b/source/images/images/mActionQgisHomePage.png new file mode 100644 index 0000000..37a5231 Binary files /dev/null and b/source/images/images/mActionQgisHomePage.png differ diff --git a/source/images/images/mActionRaiseItems.png b/source/images/images/mActionRaiseItems.png new file mode 100644 index 0000000..0d6dc69 Binary files /dev/null and b/source/images/images/mActionRaiseItems.png differ diff --git a/source/images/images/mActionRedo.png b/source/images/images/mActionRedo.png new file mode 100644 index 0000000..a4d342e Binary files /dev/null and b/source/images/images/mActionRedo.png differ diff --git a/source/images/images/mActionRemove.png b/source/images/images/mActionRemove.png new file mode 100644 index 0000000..6d0d29d Binary files /dev/null and b/source/images/images/mActionRemove.png differ diff --git a/source/images/images/mActionRemoveAllFromOverview.png b/source/images/images/mActionRemoveAllFromOverview.png new file mode 100644 index 0000000..01f1f0d Binary files /dev/null and b/source/images/images/mActionRemoveAllFromOverview.png differ diff --git a/source/images/images/mActionRemoveLayer.png b/source/images/images/mActionRemoveLayer.png new file mode 100644 index 0000000..b67e166 Binary files /dev/null and b/source/images/images/mActionRemoveLayer.png differ diff --git a/source/images/images/mActionRemoveSelectedFeature.png b/source/images/images/mActionRemoveSelectedFeature.png new file mode 100644 index 0000000..55fdf57 Binary files /dev/null and b/source/images/images/mActionRemoveSelectedFeature.png differ diff --git a/source/images/images/mActionReshape.png b/source/images/images/mActionReshape.png new file mode 100644 index 0000000..ec5ce87 Binary files /dev/null and b/source/images/images/mActionReshape.png differ diff --git a/source/images/images/mActionRotateLabel.png b/source/images/images/mActionRotateLabel.png new file mode 100644 index 0000000..e9b4cea Binary files /dev/null and b/source/images/images/mActionRotateLabel.png differ diff --git a/source/images/images/mActionRotatePointSymbols.png b/source/images/images/mActionRotatePointSymbols.png new file mode 100644 index 0000000..258093d Binary files /dev/null and b/source/images/images/mActionRotatePointSymbols.png differ diff --git a/source/images/images/mActionSaveAsPDF.png b/source/images/images/mActionSaveAsPDF.png new file mode 100644 index 0000000..41bbe56 Binary files /dev/null and b/source/images/images/mActionSaveAsPDF.png differ diff --git a/source/images/images/mActionSaveAsSVG.png b/source/images/images/mActionSaveAsSVG.png new file mode 100644 index 0000000..8f86258 Binary files /dev/null and b/source/images/images/mActionSaveAsSVG.png differ diff --git a/source/images/images/mActionSaveEdits.png b/source/images/images/mActionSaveEdits.png new file mode 100644 index 0000000..3bc2a37 Binary files /dev/null and b/source/images/images/mActionSaveEdits.png differ diff --git a/source/images/images/mActionSaveMapAsImage.png b/source/images/images/mActionSaveMapAsImage.png new file mode 100644 index 0000000..27ed624 Binary files /dev/null and b/source/images/images/mActionSaveMapAsImage.png differ diff --git a/source/images/images/mActionScaleBar.png b/source/images/images/mActionScaleBar.png new file mode 100644 index 0000000..14796be Binary files /dev/null and b/source/images/images/mActionScaleBar.png differ diff --git a/source/images/images/mActionSelect.png b/source/images/images/mActionSelect.png new file mode 100644 index 0000000..bb39393 Binary files /dev/null and b/source/images/images/mActionSelect.png differ diff --git a/source/images/images/mActionSelectFreehand.png b/source/images/images/mActionSelectFreehand.png new file mode 100644 index 0000000..80b268f Binary files /dev/null and b/source/images/images/mActionSelectFreehand.png differ diff --git a/source/images/images/mActionSelectPan.png b/source/images/images/mActionSelectPan.png new file mode 100644 index 0000000..2b85e1c Binary files /dev/null and b/source/images/images/mActionSelectPan.png differ diff --git a/source/images/images/mActionSelectPolygon.png b/source/images/images/mActionSelectPolygon.png new file mode 100644 index 0000000..78992cc Binary files /dev/null and b/source/images/images/mActionSelectPolygon.png differ diff --git a/source/images/images/mActionSelectRadius.png b/source/images/images/mActionSelectRadius.png new file mode 100644 index 0000000..242967e Binary files /dev/null and b/source/images/images/mActionSelectRadius.png differ diff --git a/source/images/images/mActionSelectRectangle.png b/source/images/images/mActionSelectRectangle.png new file mode 100644 index 0000000..5b329e8 Binary files /dev/null and b/source/images/images/mActionSelectRectangle.png differ diff --git a/source/images/images/mActionSelectedToTop.png b/source/images/images/mActionSelectedToTop.png new file mode 100644 index 0000000..45f68bb Binary files /dev/null and b/source/images/images/mActionSelectedToTop.png differ diff --git a/source/images/images/mActionShowAllLayers.png b/source/images/images/mActionShowAllLayers.png new file mode 100644 index 0000000..a416b6e Binary files /dev/null and b/source/images/images/mActionShowAllLayers.png differ diff --git a/source/images/images/mActionShowBookmarks.png b/source/images/images/mActionShowBookmarks.png new file mode 100644 index 0000000..f363139 Binary files /dev/null and b/source/images/images/mActionShowBookmarks.png differ diff --git a/source/images/images/mActionShowPluginManager.png b/source/images/images/mActionShowPluginManager.png new file mode 100644 index 0000000..0b752fc Binary files /dev/null and b/source/images/images/mActionShowPluginManager.png differ diff --git a/source/images/images/mActionSimplify.png b/source/images/images/mActionSimplify.png new file mode 100644 index 0000000..3262a73 Binary files /dev/null and b/source/images/images/mActionSimplify.png differ diff --git a/source/images/images/mActionSplitFeatures.png b/source/images/images/mActionSplitFeatures.png new file mode 100644 index 0000000..07139c6 Binary files /dev/null and b/source/images/images/mActionSplitFeatures.png differ diff --git a/source/images/images/mActionTextAnnotation.png b/source/images/images/mActionTextAnnotation.png new file mode 100644 index 0000000..7d61970 Binary files /dev/null and b/source/images/images/mActionTextAnnotation.png differ diff --git a/source/images/images/mActionToggleEditing.png b/source/images/images/mActionToggleEditing.png new file mode 100644 index 0000000..a2779c9 Binary files /dev/null and b/source/images/images/mActionToggleEditing.png differ diff --git a/source/images/images/mActionUndo.png b/source/images/images/mActionUndo.png new file mode 100644 index 0000000..7c73dba Binary files /dev/null and b/source/images/images/mActionUndo.png differ diff --git a/source/images/images/mActionUngroupItems.png b/source/images/images/mActionUngroupItems.png new file mode 100644 index 0000000..9d9b1f7 Binary files /dev/null and b/source/images/images/mActionUngroupItems.png differ diff --git a/source/images/images/mActionUnselectAttributes.png b/source/images/images/mActionUnselectAttributes.png new file mode 100644 index 0000000..cc4867d Binary files /dev/null and b/source/images/images/mActionUnselectAttributes.png differ diff --git a/source/images/images/mActionZoomActual.png b/source/images/images/mActionZoomActual.png new file mode 100644 index 0000000..4697a60 Binary files /dev/null and b/source/images/images/mActionZoomActual.png differ diff --git a/source/images/images/mActionZoomFullExtent.png b/source/images/images/mActionZoomFullExtent.png new file mode 100644 index 0000000..99e5d31 Binary files /dev/null and b/source/images/images/mActionZoomFullExtent.png differ diff --git a/source/images/images/mActionZoomIn.png b/source/images/images/mActionZoomIn.png new file mode 100644 index 0000000..5784916 Binary files /dev/null and b/source/images/images/mActionZoomIn.png differ diff --git a/source/images/images/mActionZoomLast.png b/source/images/images/mActionZoomLast.png new file mode 100644 index 0000000..e594924 Binary files /dev/null and b/source/images/images/mActionZoomLast.png differ diff --git a/source/images/images/mActionZoomNext.png b/source/images/images/mActionZoomNext.png new file mode 100644 index 0000000..aaa30ba Binary files /dev/null and b/source/images/images/mActionZoomNext.png differ diff --git a/source/images/images/mActionZoomOut.png b/source/images/images/mActionZoomOut.png new file mode 100644 index 0000000..a91c24f Binary files /dev/null and b/source/images/images/mActionZoomOut.png differ diff --git a/source/images/images/mActionZoomToLayer.png b/source/images/images/mActionZoomToLayer.png new file mode 100644 index 0000000..5f10f75 Binary files /dev/null and b/source/images/images/mActionZoomToLayer.png differ diff --git a/source/images/images/mActionZoomToSelected.png b/source/images/images/mActionZoomToSelected.png new file mode 100644 index 0000000..e69b926 Binary files /dev/null and b/source/images/images/mActionZoomToSelected.png differ diff --git a/source/images/images/mIconDelete.png b/source/images/images/mIconDelete.png new file mode 100644 index 0000000..7128b63 Binary files /dev/null and b/source/images/images/mIconDelete.png differ diff --git a/source/images/images/mIconEditable.png b/source/images/images/mIconEditable.png new file mode 100644 index 0000000..7b212b5 Binary files /dev/null and b/source/images/images/mIconEditable.png differ diff --git a/source/images/images/mIconFirst.png b/source/images/images/mIconFirst.png new file mode 100644 index 0000000..e7277ac Binary files /dev/null and b/source/images/images/mIconFirst.png differ diff --git a/source/images/images/mIconGeometryLayer.png b/source/images/images/mIconGeometryLayer.png new file mode 100644 index 0000000..e9fa191 Binary files /dev/null and b/source/images/images/mIconGeometryLayer.png differ diff --git a/source/images/images/mIconLast.png b/source/images/images/mIconLast.png new file mode 100644 index 0000000..6f7109c Binary files /dev/null and b/source/images/images/mIconLast.png differ diff --git a/source/images/images/mIconLayer.png b/source/images/images/mIconLayer.png new file mode 100644 index 0000000..608fa16 Binary files /dev/null and b/source/images/images/mIconLayer.png differ diff --git a/source/images/images/mIconLineLayer.png b/source/images/images/mIconLineLayer.png new file mode 100644 index 0000000..34139c7 Binary files /dev/null and b/source/images/images/mIconLineLayer.png differ diff --git a/source/images/images/mIconLock.png b/source/images/images/mIconLock.png new file mode 100644 index 0000000..7136b01 Binary files /dev/null and b/source/images/images/mIconLock.png differ diff --git a/source/images/images/mIconNew.png b/source/images/images/mIconNew.png new file mode 100644 index 0000000..58f8ba8 Binary files /dev/null and b/source/images/images/mIconNew.png differ diff --git a/source/images/images/mIconNext.png b/source/images/images/mIconNext.png new file mode 100644 index 0000000..aadef43 Binary files /dev/null and b/source/images/images/mIconNext.png differ diff --git a/source/images/images/mIconNoPyramid.png b/source/images/images/mIconNoPyramid.png new file mode 100644 index 0000000..d634bfc Binary files /dev/null and b/source/images/images/mIconNoPyramid.png differ diff --git a/source/images/images/mIconPointLayer.png b/source/images/images/mIconPointLayer.png new file mode 100644 index 0000000..ce6084a Binary files /dev/null and b/source/images/images/mIconPointLayer.png differ diff --git a/source/images/images/mIconPolygonLayer.png b/source/images/images/mIconPolygonLayer.png new file mode 100644 index 0000000..3f344c5 Binary files /dev/null and b/source/images/images/mIconPolygonLayer.png differ diff --git a/source/images/images/mIconPrevious.png b/source/images/images/mIconPrevious.png new file mode 100644 index 0000000..1f91e08 Binary files /dev/null and b/source/images/images/mIconPrevious.png differ diff --git a/source/images/images/mIconProjectionDisabled.png b/source/images/images/mIconProjectionDisabled.png new file mode 100644 index 0000000..8c46acd Binary files /dev/null and b/source/images/images/mIconProjectionDisabled.png differ diff --git a/source/images/images/mIconProjectionEnabled.png b/source/images/images/mIconProjectionEnabled.png new file mode 100644 index 0000000..30e3d0b Binary files /dev/null and b/source/images/images/mIconProjectionEnabled.png differ diff --git a/source/images/images/mIconProjectionProblem.png b/source/images/images/mIconProjectionProblem.png new file mode 100644 index 0000000..a603c99 Binary files /dev/null and b/source/images/images/mIconProjectionProblem.png differ diff --git a/source/images/images/mIconProperties.png b/source/images/images/mIconProperties.png new file mode 100644 index 0000000..95bd319 Binary files /dev/null and b/source/images/images/mIconProperties.png differ diff --git a/source/images/images/mIconPyramid.png b/source/images/images/mIconPyramid.png new file mode 100644 index 0000000..de810a0 Binary files /dev/null and b/source/images/images/mIconPyramid.png differ diff --git a/source/images/images/mIconRenderingDisabled.png b/source/images/images/mIconRenderingDisabled.png new file mode 100644 index 0000000..5c876f3 Binary files /dev/null and b/source/images/images/mIconRenderingDisabled.png differ diff --git a/source/images/images/mIconRenderingEnabled.png b/source/images/images/mIconRenderingEnabled.png new file mode 100644 index 0000000..9a61f36 Binary files /dev/null and b/source/images/images/mIconRenderingEnabled.png differ diff --git a/source/images/images/mIconStopRendering.png b/source/images/images/mIconStopRendering.png new file mode 100644 index 0000000..c039175 Binary files /dev/null and b/source/images/images/mIconStopRendering.png differ diff --git a/source/images/images/mIconSymbology.png b/source/images/images/mIconSymbology.png new file mode 100644 index 0000000..f41ed60 Binary files /dev/null and b/source/images/images/mIconSymbology.png differ diff --git a/source/images/images/mIconTableLayer.png b/source/images/images/mIconTableLayer.png new file mode 100644 index 0000000..436b9b0 Binary files /dev/null and b/source/images/images/mIconTableLayer.png differ diff --git a/source/images/images/mIconUnknownLayerType.png b/source/images/images/mIconUnknownLayerType.png new file mode 100644 index 0000000..cdf52fb Binary files /dev/null and b/source/images/images/mIconUnknownLayerType.png differ diff --git a/source/images/images/mIconWaitingForLayerType.png b/source/images/images/mIconWaitingForLayerType.png new file mode 100644 index 0000000..edc2508 Binary files /dev/null and b/source/images/images/mIconWaitingForLayerType.png differ diff --git a/source/images/images/mIconWms.png b/source/images/images/mIconWms.png new file mode 100644 index 0000000..c98c7fa Binary files /dev/null and b/source/images/images/mIconWms.png differ diff --git a/source/images/images/mIconWmsLayer.png b/source/images/images/mIconWmsLayer.png new file mode 100644 index 0000000..82325d4 Binary files /dev/null and b/source/images/images/mIconWmsLayer.png differ diff --git a/source/images/images/mMapserverExport.png b/source/images/images/mMapserverExport.png new file mode 100644 index 0000000..a30a402 Binary files /dev/null and b/source/images/images/mMapserverExport.png differ diff --git a/source/images/images/plugin.png b/source/images/images/plugin.png new file mode 100644 index 0000000..c801ab9 Binary files /dev/null and b/source/images/images/plugin.png differ diff --git a/source/images/images/plugin_installer.png b/source/images/images/plugin_installer.png new file mode 100644 index 0000000..b8bf9fa Binary files /dev/null and b/source/images/images/plugin_installer.png differ diff --git a/source/images/images/qgislogo.png b/source/images/images/qgislogo.png new file mode 100644 index 0000000..c33fcd8 Binary files /dev/null and b/source/images/images/qgislogo.png differ diff --git a/source/images/images/raster-info.png b/source/images/images/raster-info.png new file mode 100644 index 0000000..de5cb4e Binary files /dev/null and b/source/images/images/raster-info.png differ diff --git a/source/images/images/rendererCategorizedSymbol.png b/source/images/images/rendererCategorizedSymbol.png new file mode 100644 index 0000000..0cce452 Binary files /dev/null and b/source/images/images/rendererCategorizedSymbol.png differ diff --git a/source/images/images/rendererGraduatedSymbol.png b/source/images/images/rendererGraduatedSymbol.png new file mode 100644 index 0000000..a85bb2c Binary files /dev/null and b/source/images/images/rendererGraduatedSymbol.png differ diff --git a/source/images/images/rendererSingleSymbol.png b/source/images/images/rendererSingleSymbol.png new file mode 100644 index 0000000..916fa64 Binary files /dev/null and b/source/images/images/rendererSingleSymbol.png differ diff --git a/source/images/images/splash.png b/source/images/images/splash.png new file mode 100644 index 0000000..2b0ce50 Binary files /dev/null and b/source/images/images/splash.png differ diff --git a/source/images/images/symbologyAdd.png b/source/images/images/symbologyAdd.png new file mode 100644 index 0000000..e2823ba Binary files /dev/null and b/source/images/images/symbologyAdd.png differ diff --git a/source/images/images/symbologyDown.png b/source/images/images/symbologyDown.png new file mode 100644 index 0000000..ea9c00c Binary files /dev/null and b/source/images/images/symbologyDown.png differ diff --git a/source/images/images/symbologyEdit.png b/source/images/images/symbologyEdit.png new file mode 100644 index 0000000..ce8b226 Binary files /dev/null and b/source/images/images/symbologyEdit.png differ diff --git a/source/images/images/symbologyRemove.png b/source/images/images/symbologyRemove.png new file mode 100644 index 0000000..bb16f03 Binary files /dev/null and b/source/images/images/symbologyRemove.png differ diff --git a/source/images/images/symbologyUp.png b/source/images/images/symbologyUp.png new file mode 100644 index 0000000..d6c2b99 Binary files /dev/null and b/source/images/images/symbologyUp.png differ diff --git a/source/images/images/tracking.png b/source/images/images/tracking.png new file mode 100644 index 0000000..90d0e3c Binary files /dev/null and b/source/images/images/tracking.png differ diff --git a/source/images/images/transformed.png b/source/images/images/transformed.png new file mode 100644 index 0000000..30f853d Binary files /dev/null and b/source/images/images/transformed.png differ diff --git a/source/images/images/unlocked.png b/source/images/images/unlocked.png new file mode 100644 index 0000000..bdac7c1 Binary files /dev/null and b/source/images/images/unlocked.png differ diff --git a/source/images/images/user.png b/source/images/images/user.png new file mode 100644 index 0000000..0ea4aa0 Binary files /dev/null and b/source/images/images/user.png differ diff --git a/source/images/images/zoom2point_icon.png b/source/images/images/zoom2point_icon.png new file mode 100644 index 0000000..20d3668 Binary files /dev/null and b/source/images/images/zoom2point_icon.png differ diff --git a/source/images/operating_system_icons/nix.png b/source/images/operating_system_icons/nix.png new file mode 100644 index 0000000..2d4d909 Binary files /dev/null and b/source/images/operating_system_icons/nix.png differ diff --git a/source/images/operating_system_icons/osx.png b/source/images/operating_system_icons/osx.png new file mode 100644 index 0000000..2b79d3d Binary files /dev/null and b/source/images/operating_system_icons/osx.png differ diff --git a/source/images/operating_system_icons/win.png b/source/images/operating_system_icons/win.png new file mode 100644 index 0000000..f035e00 Binary files /dev/null and b/source/images/operating_system_icons/win.png differ diff --git a/source/index.rst b/source/index.rst new file mode 100644 index 0000000..ff07819 --- /dev/null +++ b/source/index.rst @@ -0,0 +1,24 @@ +.. QGIS Documentation documentation master file, created by + sphinx-quickstart on Tue Apr 3 18:38:04 2012. + You can adapt this file completely to your liking, but it should at least + contain the root `toctree` directive. + +Welcome to QGIS Documentation's documentation! +============================================== + +Contents: + +.. toctree:: + :maxdepth: 2 + + introduction + getting_started + + +Indices and tables +================== + +* :ref:`genindex` +* :ref:`modindex` +* :ref:`search` + diff --git a/source/introduction.rst b/source/introduction.rst new file mode 100644 index 0000000..256e603 --- /dev/null +++ b/source/introduction.rst @@ -0,0 +1,159 @@ +******************************************************************************** +Introduction To GIS +******************************************************************************** + +A Geographical Information System (GIS) [1]_ is a +collection of software that allows you to create, visualize, query +and analyze geospatial data. Geospatial data refers to information +about the geographic location of an entity. This often involves the +use of a geographic coordinate, like a latitude or longitude value. +Spatial data is another commonly used term, as are: geographic +data, GIS data, map data, location data, coordinate data and +spatial geometry data. + +Applications using geospatial data perform a variety of functions. +Map production is the most easily understood function of geospatial +applications. Mapping programs take geospatial data and render it +in a form that is viewable, usually on a computer screen or printed +page. Applications can present static maps (a simple image) or +dynamic maps that are customised by the person viewing the map +through a desktop program or a web page. + +Many people mistakenly assume that geospatial applications just +produce maps, but geospatial data analysis is another primary +function of geospatial applications. Some typical types of analysis +include computing: + + +#. distances between geographic locations + +#. the amount of area (e.g., square meters) within a certain + geographic region + +#. what geographic features overlap other features + +#. the amount of overlap between features + +#. the number of locations within a certain distance of another + +#. and so on... + + +These may seem simplistic, but can be applied in all sorts of ways +across many disciplines. The results of analysis may be shown on a +map, but are often tabulated into a report to support management +decisions. + +The recent phenomena of location-based services promises to +introduce all sorts of other features, but many will be based on a +combination of maps and analysis. For example, you have a cell +phone that tracks your geographic location. If you have the right +software, your phone can tell you what kind of restaurants are +within walking distance. While this is a novel application of +geospatial technology, it is essentially doing geospatial data +analysis and listing the results for you. + +Why is all this so new? +================================================================================ + +Well, it's not. There are many new hardware devices that are +enabling mobile geospatial services. Many open source geospatial +applications are also available, but the existence of geospatially +focused hardware and software is nothing new. Global positioning +system (GPS) receivers are becoming commonplace, but have been used +in various industries for more than a decade. Likewise, desktop +mapping and analysis tools have also been a major commercial +market, primarily focused on industries such as natural resource +management. + +What is new is how the latest hardware and software is being +applied and who is applying it. Traditional users of mapping and +analysis tools were highly trained GIS Analysts or digital mapping +technicians trained to use CAD-like tools. Now, the processing +capabilities of home PCs and open source software (OSS) packages +have enabled an army of hobbyists, professionals, web developers, +etc. to interact with geospatial data. The learning curve has come +down. The costs have come down. The amount of geospatial technology +saturation has increased. + +How is geospatial data stored? In a nutshell, there are two types +of geospatial data in widespread use today. This is in addition to +traditional tabular data that is also widely used by geospatial +applications. + +Raster Data +-------------------------------------------------------------------------------- + +One type of geospatial data is called raster data or simply "a +raster". The most easily recognised form of raster data is digital +satellite imagery or air photos. Elevation shading or digital +elevation models are also typically represented as raster data. Any +type of map feature can be represented as raster data, but there +are limitations. + +A raster is a regular grid made up of cells, or in the case of +imagery, pixels. They have a fixed number of rows and columns. Each +cell has a numeric value and has a certain geographic size (e.g. +30x30 meters in size). + +Multiple overlapping rasters are used to represent images using +more than one colour value (i.e. one raster for each set of red, +green and blue values is combined to create a colour image). +Satellite imagery also represents data in multiple "bands". Each +band is essentially a separate, spatially overlapping raster, where +each band holds values of certain wavelengths of light. As you can +imagine, a large raster takes up more file space. A raster with +smaller cells can provide more detail, but takes up more file +space. The trick is finding the right balance between cell size for +storage purposes and cell size for analytical or mapping purposes. + +Vector Data +-------------------------------------------------------------------------------- + +Vector data is also used in geospatial applications. If you stayed +awake during trigonometry and coordinate geometry classes, you will +already be familiar with some of the qualities of vector data. In +its simplest sense, vectors are a way of describing a location by +using a set of coordinates. Each coordinate refers to a geographic +location using a system of x and y values. + +This can be thought of in reference to a Cartesian plane - you +know, the diagrams from school that showed an x and y-axis. You +might have used them to chart declining retirement savings or +increasing compound mortgage interest, but the concepts are +essential to geospatial data analysis and mapping. + +There are various ways of representing these geographic coordinates +depending on your purpose. This is a whole area of study for +another day - map projections. + +Vector data takes on three forms, each progressively more complex +and building on the former. + + +#. Points - A single coordinate (x y) represents a discrete + geographic location + +#. Lines - Multiple coordinates (x1 y1, x2 y2, x3 y4, ... xn yn) + strung together in a certain order, like drawing a line from Point + (x1 y1) to Point (x2 y2) and so on. These parts between each point + are considered line segments. They have a length and the line can + be said to have a direction based on the order of the points. + Technically, a line is a single pair of coordinates connected + together, whereas a line string is multiple lines connected + together. + +#. Polygons - When lines are strung together by more than two + points, with the last point being at the same location as the + first, we call this a polygon. A triangle, circle, rectangle, etc. + are all polygons. The key feature of polygons is that there is a + fixed area within them. + + +.. [1] + This chapter is by Tyler Mitchell + (http://www.oreillynet.com/pub/wlg/7053) and used under the + Creative Commons License. Tyler is the author of + *Web Mapping Illustrated*, published by O'Reilly, 2005. + + diff --git a/source/translated/it/.doctrees/environment.pickle b/source/translated/it/.doctrees/environment.pickle new file mode 100644 index 0000000..231ac41 Binary files /dev/null and b/source/translated/it/.doctrees/environment.pickle differ diff --git a/source/translated/it/.doctrees/getting_started.doctree b/source/translated/it/.doctrees/getting_started.doctree new file mode 100644 index 0000000..b1d7b86 Binary files /dev/null and b/source/translated/it/.doctrees/getting_started.doctree differ diff --git a/source/translated/it/.doctrees/index.doctree b/source/translated/it/.doctrees/index.doctree new file mode 100644 index 0000000..23859c6 Binary files /dev/null and b/source/translated/it/.doctrees/index.doctree differ diff --git a/source/translated/it/.doctrees/introduction.doctree b/source/translated/it/.doctrees/introduction.doctree new file mode 100644 index 0000000..9967a11 Binary files /dev/null and b/source/translated/it/.doctrees/introduction.doctree differ diff --git a/source/translated/it/LC_MESSAGES/getting_started.mo b/source/translated/it/LC_MESSAGES/getting_started.mo new file mode 100644 index 0000000..f7985c0 Binary files /dev/null and b/source/translated/it/LC_MESSAGES/getting_started.mo differ diff --git a/source/translated/it/LC_MESSAGES/index.mo b/source/translated/it/LC_MESSAGES/index.mo new file mode 100644 index 0000000..6300b5f Binary files /dev/null and b/source/translated/it/LC_MESSAGES/index.mo differ diff --git a/source/translated/it/LC_MESSAGES/introduction.mo b/source/translated/it/LC_MESSAGES/introduction.mo new file mode 100644 index 0000000..b6d551e Binary files /dev/null and b/source/translated/it/LC_MESSAGES/introduction.mo differ diff --git a/source/translated/it/getting_started.po b/source/translated/it/getting_started.po new file mode 100644 index 0000000..1136b2e --- /dev/null +++ b/source/translated/it/getting_started.po @@ -0,0 +1,345 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2012, aavv +# This file is distributed under the same license as the QGIS Documentation package. +# FIRST AUTHOR , YEAR. +# FULL NAME , 2012. +# +msgid "" +msgstr "" +"Project-Id-Version: QGIS Documentation 1.8\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2012-04-05 12:57\n" +"PO-Revision-Date: 2012-04-05 13:29+0200\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +# 94112c459bac4a2b8be66851984d311f +#: ../../getting_started.rst:11 +msgid "Getting Started" +msgstr "Come iniziare" + +# 0ccf3592a6144df6b2a431c65c0354e9 +#: ../../getting_started.rst:13 +msgid "" +"This chapter gives a quick overview of installing |qg|, some sample data " +"from the web page and running a first and simple session visualizing raster " +"and vector layers." +msgstr "" +"Questo capitolo fornisce una veloce panoramica sull’installazione di QGIS, " +"su alcuni dati campione scaricabili dal sito QGIS e su come avviare una " +"prima semplice sessione in cui visualizzare layer raster e vettoriali." + +# ebc41a7c943f4774a34da42191e10a33 +#: ../../getting_started.rst:18 +msgid "Installation" +msgstr "Installazione" + +# 8fbf74cd89234431890edcfc1545fe75 +#: ../../getting_started.rst:20 +msgid "" +"Installation of |qg| is very simple. Standard installer packages are " +"available for MS Windows and Mac OS X. For many flavors of GNU/Linux binary " +"packages (rpm and deb) or software repositories to add to your installation " +"manager are provided. Get the latest information on binary packages at the " +"website at http://download.qgis.org." +msgstr "" +"L’installazione di |qg| è molto semplice. Pacchetti standard per " +"l’installazione sono disponibili per MS Windows e Mac OS X. Per le " +"distribuzioni GNU/Linux sono disponibili pacchetti binari (rpm e deb) o " +"archivi software da aggiungere al gestore di installazione. Informazioni " +"aggiornate possono essere reperite sul sito web di |qg| http://download." +"qgis.org." + +# 06402342d65841f38225dc30e320c4c9 +#: ../../getting_started.rst:28 +msgid "Installation from source" +msgstr "Installazione da codice sorgente" + +# 8c9eed37501f4881a8d22eec5e63c51f +#: ../../getting_started.rst:30 +msgid "" +"If you need to build from source, please refer to the coding and compiling " +"guide available at http://www.qgis.org/en/documentation/manuals.html. The " +"installation instructions are also distributed with the source code." +msgstr "" +"Se si rende necessario compilare QGIS da codice sorgente si può fare " +"riferimento alla guida per la compilazione disponibile su http://www.qgis." +"org/en/documentation/manuals.html. Le istruzioni per l’installazione sono " +"anche distribuite con il codice sorgente di QGIS." + +# 496607f2645040b1a41a133fc9bb402e +#: ../../getting_started.rst:36 +msgid "Installation on external media" +msgstr "Installazione su supporti esterni" + +# fb0c52834b684fa991d00f4c4497f525 +#: ../../getting_started.rst:38 +msgid "" +"QGIS allows to define a -configpath option that overrides the default path " +"(e.g. :cmd-txt:`/.qgis` under Linux) for user configuration and forces " +"QSettings to use this directory, too. This allows users to e.g. carry a QGIS " +"installation on a flash drive together with all plugins and settings." +msgstr "" +"QGIS permette di specificare un’opzione di percorso (–configpath) che " +"sovrascrive il percorso predefinito (es. :cmd-txt:`/.qgis` in Linux) per le " +"configurazioni utente. In tal modo è possibile portare l’installazione di " +"QGIS, comprensiva dei plugin e delle impostazioni, su un supporto di memoria " +"esterno (es. penna USB)." + +# fa33c6f5eb4a4f52a5407ef0025e7f60 +#: ../../getting_started.rst:45 +msgid "Sample Data" +msgstr "Dati campione" + +# bfa1da4f76a5471281e9297d66dc6df4 +#: ../../getting_started.rst:47 +msgid "The user guide contains examples based on the |qg| sample dataset." +msgstr "" +"La guida utente contiene esempi basati sul set di dati campione di |qg|." + +# 550f766e78714728b63e740a6fe0495a +#: ../../getting_started.rst:49 +msgid "" +"|win| The Windows installer has an option to download the |qg| sample " +"dataset. If checked, the data will be downloaded to your :cmd-txt:`My " +"Documents` folder and placed in a folder called :cmd-txt:`GIS Database`. You " +"may use Windows Explorer to move this folder to any convenient location. If " +"you did not select the checkbox to install the sample dataset during the " +"initial installation, you can either" +msgstr "" +"|win| L’installer per Windows comprende un’opzione per scaricare il set di " +"dati campione di QGIS. Se selezionato, i dati verranno scaricati nella " +"vostra cartella :cmd-txt:`Documeni` e posizionati in una cartella " +"denominata :cmd-txt:`GIS Database`. Si può usare Windows Explorer per " +"spostare questa cartella in qualunque altra posizione. Qualora non fosse " +"stata selezionata l’opzione per installare il set di dati campione durante " +"l’installazione iniziale di QGIS è possibile:" + +# a938a8af97ce45bf9f0408a9aa593314 +#: ../../getting_started.rst:56 +msgid "use GIS data that you already have;" +msgstr "usare dati GIS già posseduti;" + +# 2590b63f443e46ea939916df5f3e9fa4 +#: ../../getting_started.rst:57 +msgid "" +"download the sample data from the qgis website at http://download.qgis.org; " +"or" +msgstr "" +"scaricare il set di dati dal sito di QGIS http://download.qgis.org; oppure" + +# 90e9970bc76a45d2bd13c666b81ac94b +#: ../../getting_started.rst:59 +msgid "" +"uninstall and reinstall with the data download option checked, only if the " +"above solutions are unsuccessful." +msgstr "" +"disinstallare QGIS e reinstallarlo selezionando l’opzione per lo " +"scaricamento dei dati, solo se la soluzione precedente non ha successo." + +# 73c6661b69364beeaed54190ea495498 +#: ../../getting_started.rst:63 +msgid "" +"|nix| |osx| For GNU/Linux and Mac OSX there are not yet dataset " +"installation packages available as rpm, deb or dmg. To use the sample " +"dataset download the file :cmd-txt:`qgis_sample_data` as ZIP or TAR archive " +"from http://download.osgeo.org/qgis/data/ and unzip or untar the archive on " +"your system. The Alaska dataset includes all GIS data that are used as " +"examples and screenshots in the user guide, and also includes a small GRASS " +"database. The projection for the qgis sample dataset is Alaska Albers Equal " +"Area with unit feet. The EPSG code is 2964." +msgstr "" +"|nix| |osx| Per GNU/Linux e Mac OSX non sono ancora disponibili pacchetti di " +"installazione del set di dati campione in formato rpm, deb or dmg. Per usare " +"il set di dati campione scaricare il file qgis_sample_data come archivio ZIP " +"o TAR da http://download.osgeo.org/qgis/data/ e decomprimerlo sul vostro " +"sistema. Il dataset Alaska include tutti i dati GIS usati come esempi e " +"schermate nella guida utente, includendo anche un piccolo database GRASS. La " +"proiezione usata per il set di dati di QGIS è Alaska Albers Equal Area con " +"unità in piedi. Il codice EPSG di questa proiezione è 2964." + +# 12590814766743659e427b6f5c814f66 +#: ../../getting_started.rst:96 +msgid "" +"If you intend to use as graphical frontend for GRASS, you can find a " +"selection of sample locations (e.g. Spearfish or South Dakota) at the " +"official GRASS GIS website http://grass.osgeo.org/download/data.php." +msgstr "" +"Se s’intende usare QGIS come interfaccia per GRASS, sono disponibili delle " +"LOCATION campione (ad es. Spearfish or South Dakota) sul sito ufficiale di " +"GRASS GIS http://grass.osgeo.org/download/data.php." + +# 9b5eac0e07974b3e97d7ace03699bf1c +#: ../../getting_started.rst:102 +msgid "Sample Session" +msgstr "Sessione di esempio" + +# d0ec8381d39d4ae18d054bbef75cc632 +#: ../../getting_started.rst:104 +msgid "" +"Now that you have installed and a sample dataset available, we would like to " +"demonstrate a short and simple sample session. We will visualize a raster " +"and a vector layer. We will use the landcover raster layer |qg| :cmd-txt:" +"`_sample_data/raster/landcover.img` and the lakes vector layer :cmd-txt:" +"`_sample_data/gml/lakes.gml`." +msgstr "" +"Ora che si è installato QGIS e si ha a disposizione un set di dati campione, " +"dimostreremo una breve e semplice sessione di QGIS. Visualizzeremo un layer " +"raster ed uno vettoriale. Useremo il layer raster dell’uso del suolo |qg| :" +"cmd-txt:`_sample_data/raster/landcover.img` e il layer vettoriale dei laghi :" +"cmd-txt:`_sample_data/gml/lakes.gml`." + +# eb6263022b024002809a9043b1a49f6e +#: ../../getting_started.rst:111 +msgid "Start |qg|" +msgstr "Avvio di |qg|" + +# f9f46b4d1ff44f85878ac348ede6486c +#: ../../getting_started.rst:113 +msgid "" +"|nix| Start |qg| by typing: |qg| at a command prompt, or if using " +"precompiled binary, using the Applications menu." +msgstr "" +"|nix| Avviare |qg| scrivendo: |qg| al prompt dei comandi, oppure se si " +"utilizzano pacchetti binari precompilati, utilizzando il menu delle " +"applicazioni." + +# 98910f884b5d4693a6e514bfc8578ca6 +#: ../../getting_started.rst:115 +msgid "" +"|win| Start |qg| using the Start menu or desktop shortcut, or double click " +"on a |qg| project file." +msgstr "" +"|win| Avviare |qg| usando il menu Start o l’icona sul desktop, oppure " +"facendo doppio click su un file di progetto QGIS." + +# eb7aa71ae59c447d88e055b50b767969 +#: ../../getting_started.rst:117 +msgid "|osx| Double click the icon in your Applications folder." +msgstr "|osx| Doppio click sull’icona nella cartella Applicazioni." + +# 9b20118f901c4f07845fd15fca194b7d +#: ../../getting_started.rst:125 +msgid "Load raster and vector layers from the sample dataset" +msgstr "Caricare dati raster e vettoriali dal set di dati campione" + +# 400973a07ec24a98980bd5a94f666efc +#: ../../getting_started.rst:127 +msgid "Click on the |mActionAddRasterLayer| :tool-name:`Load Raster` icon." +msgstr "" +"Cliccare sull’icona |mActionAddRasterLayer| :tool-name:`Aggiungi raster`." + +# 02bec8b7cccb440fa045b83624223039 +#: ../../getting_started.rst:128 +msgid "" +"Browse to the folder :cmd-txt:`qgis_sample_data/raster/`, select the ERDAS " +"Img file :cmd-txt:`landcover.img` and click :button-name:`Open`." +msgstr "" +"Individuare la cartella :cmd-txt:`qgis_sample_data/raster/`, selezionare il " +"file ERDAS Img :cmd-txt:`landcover.img` e cliccare :button-name:`Apri`." + +# e52cdba3224c4911aa1df6448e7f74a5 +#: ../../getting_started.rst:131 +msgid "" +"If the file is not listed, check if the Filetype combobox at the bottom of " +"the dialog is set on the right type, in this case \"Erdas Imagine Images " +"(\\*.img, \\*.IMG)\"" +msgstr "" +"Se il file non appare nella lista, controllare se il tipo di file " +"selezionato nel menu in basso della finestra di dialogo è corretto, in " +"questo caso Immagine ERDAS (*.img, *.IMG)" + +# 3213ef617aa54fbebf4417e73759fd71 +#: ../../getting_started.rst:134 +msgid "Now click on the |mActionAddOgrLayer| :tool-name:`Load Vector` icon." +msgstr "" +"Ora cliccare sull’icona |mActionAddOgrLayer| :tool-name:`Aggiungi vettore`." + +# 94e1f7c3e50e4e09b1a20f4c10b4e3fc +#: ../../getting_started.rst:135 +msgid "" +":radio-name:`File` should be selected as Source Type in the new :dialog-name:" +"`Add Vector Layer` dialog. Now click :button-name:`Browse` to select the " +"vector layer." +msgstr "" +":radio-name:`File` deve essere selezionato come tipo di sorgente nella " +"finestra di dialogo dialog-name:`Aggiungi vettore`. Ora cliccare :button-" +"name:`Sfoglia `per selezionare il layer vettoriale." + +# 25bee1cb748f432dbcc4bc328ba2ed58 +#: ../../getting_started.rst:139 +msgid "" +"Browse to the folder :cmd-txt:`qgis_sample_data/gml/`, select \"GML\" from " +"the filetype combobox, then select the GML file :cmd-txt:`lakes.gml` and " +"click :button-name:`Open`, then in Add Vector dialog click :button-name:`OK`." +msgstr "" +"Individuare la cartella :cmd-txt:`qgis_sample_data/gml/`, selezionare GML " +"dal menu tipo file, poi selezionare il file GML :cmd-txt:`lakes.gml` e " +"cliccare :button-name:`Apri`, poi nella finestra di dialogo Aggiungi vettore " +"cliccare :button-name:`OK` ." + +# c678a2cc03254ffba4308c6e04e7d835 +#: ../../getting_started.rst:143 +msgid "Zoom in a bit to your favorite area with some lakes." +msgstr "Ingrandire un la vista su un’area a vostra scelta con alcuni laghi." + +# 3decb9823fdc4a53909afd73817399a0 +#: ../../getting_started.rst:144 +msgid "" +"Double click the :cmd-txt:`lakes` layer in the map legend to open the :" +"dialog-name:`Properties` dialog." +msgstr "" +"Fare doppio click sul layer :cmd-txt:`lakes` nella legenda per aprire la " +"finestra :dialog-name:`Proprietà layer`." + +# d151e1b0331245e6a4cebeabb2808ad4 +#: ../../getting_started.rst:146 +msgid "Click on the :tab-name:`Style` tab and select a blue as fill color." +msgstr "" +"Cliccare sulla scheda :tab-name:`Style` e selezionare blu come colore di " +"riempimento." + +# ff945ad487254e47aa7b2701472be917 +#: ../../getting_started.rst:147 +msgid "" +"Click on the :tab-name:`Labels` tab and check the :check-name:`Display " +"labels` checkbox to enable labeling. Choose NAMES field as field containing " +"label." +msgstr "" +"Cliccare sulla scheda :tab-name:`Etichette` e spuntare l’opzione :check-name:" +"`Mostra etichette` per abilitare l’etichettatura. Scegliere il campo NOME " +"come campo per l’etichetta." + +# bed79854fb94467fb34c2c9205185879 +#: ../../getting_started.rst:150 +msgid "" +"To improve readability of labels, you can add a white buffer around them, by " +"clicking \"Buffer\" in the list on the left, checking :check-name:`Buffer " +"labels?` and choosing 3 as buffer size." +msgstr "" +"Per migliorare la leggibilità dell’etichetta, è possibile aggiungere un " +"contorno con sfondo colorato: spuntare :check-name:`Contorno etichette` e " +"scegliere dimensione e colore del contorno." + +# cd6c816f5ec7498fa450ab7f4b33eafd +#: ../../getting_started.rst:153 +msgid "" +"Click :button-name:`Apply`, check if the result looks good and finally " +"click :button-name:`OK`." +msgstr "" +"Cliccare :button-name:`Applica`, controllare se il risultato è buono ed " +"infine premete il tasto :button-name:`OK`." + +# 1bc806ea447042dca9d31d667ed93f17 +#: ../../getting_started.rst:156 +msgid "" +"You can see how easy it is to visualize raster and vector layers in . Let's " +"move on to the sections that follow to learn more about the available " +"functionality, features and settings and how to use them." +msgstr "" +"Visto come è facile visualizzare layer raster e vettoriali in QGIS? " +"Proseguiamo alla sezione seguente per imparare ulteriori funzioni, " +"caratteristiche ed impostazioni." diff --git a/source/translated/it/index.po b/source/translated/it/index.po new file mode 100644 index 0000000..de99b79 --- /dev/null +++ b/source/translated/it/index.po @@ -0,0 +1,47 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2012, aavv +# This file is distributed under the same license as the QGIS Documentation package. +# FIRST AUTHOR , YEAR. +# FULL NAME , 2012. +# +msgid "" +msgstr "" +"Project-Id-Version: QGIS Documentation 1.8\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2012-04-05 12:57\n" +"PO-Revision-Date: 2012-04-05 14:58+0200\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +# c82f84bd58b74ad39263ccf1249b39ec +#: ../../index.rst:7 +msgid "Welcome to QGIS Documentation's documentation!" +msgstr "Benvenuti alla documentazione di QGIS" + +# b52c732781ab42e7980cb37559e61dd0 +#: ../../index.rst:9 +msgid "Contents:" +msgstr "Contenuti:" + +# 5c943d10f0df4178b4794b9127aa56f3 +#: ../../index.rst:19 +msgid "Indices and tables" +msgstr "Indici e tabelle" + +# efd5d7db40b14b769cc5c6d42a0c4d27 +#: ../../index.rst:21 +msgid ":ref:`genindex`" +msgstr "" + +# d62a08c3af634837ab6351aba9f6cfe3 +#: ../../index.rst:22 +msgid ":ref:`modindex`" +msgstr "" + +# 9831c2b62fd94aa781e57b5e2c7708d5 +#: ../../index.rst:23 +msgid ":ref:`search`" +msgstr "" diff --git a/source/translated/it/introduction.po b/source/translated/it/introduction.po new file mode 100644 index 0000000..af9fc3c --- /dev/null +++ b/source/translated/it/introduction.po @@ -0,0 +1,360 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2012, aavv +# This file is distributed under the same license as the QGIS Documentation package. +# FIRST AUTHOR , YEAR. +# FULL NAME , 2012. +# +msgid "" +msgstr "" +"Project-Id-Version: QGIS Documentation 1.8\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2012-04-05 12:57\n" +"PO-Revision-Date: 2012-04-05 14:55+0200\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +# fb17a663a72a4d30b6bcf9851fdf6125 +#: ../../introduction.rst:3 +msgid "Introduction To GIS" +msgstr "Introduzione al GIS" + +# ee56d88478894dc09733dc072365ec4f +#: ../../introduction.rst:5 +msgid "" +"A Geographical Information System (GIS) [1]_ is a collection of software " +"that allows you to create, visualize, query and analyze geospatial data. " +"Geospatial data refers to information about the geographic location of an " +"entity. This often involves the use of a geographic coordinate, like a " +"latitude or longitude value. Spatial data is another commonly used term, as " +"are: geographic data, GIS data, map data, location data, coordinate data and " +"spatial geometry data." +msgstr "" +"Un Sistema Informativo Geografico (Geographical Information System, GIS) [1]" +"_ è un insieme di programmi che permettono di creare, visualizzare, " +"interrogare e analizzare dati geospaziali. I dati geospaziali riportano " +"informazioni inerenti la posizione geografica di un oggetto. Questo spesso " +"implica l’uso di coordinate geografiche, quali valori di latitudine e " +"longitudine. Dato spaziale è un altro termine comunemente usato, così come " +"lo sono: dato geografico, dato GIS, mappa, location, coordinate e geometrie " +"spaziali." + +# 087beb72859044e895d3a261311b5179 +#: ../../introduction.rst:14 +msgid "" +"Applications using geospatial data perform a variety of functions. Map " +"production is the most easily understood function of geospatial " +"applications. Mapping programs take geospatial data and render it in a form " +"that is viewable, usually on a computer screen or printed page. Applications " +"can present static maps (a simple image) or dynamic maps that are customised " +"by the person viewing the map through a desktop program or a web page." +msgstr "" +"Le applicazioni che usano dati geospaziali eseguono varie funzioni. Quella " +"più conosciuta e facilmente compresa è la produzione di mappe. I programmi " +"per la realizzazione di mappe impiegano i dati geospaziali e li " +"rappresentano in una forma che sia visibile, tipicamente su uno schermo o " +"stampati su carta. Si possono presentare mappe statiche (una semplice " +"immagine) o mappe dinamiche che sono personalizzate dall’utente che ne " +"usufruisce attraverso un’applicazione desktop o una pagina web." + +# 7a708b07b51b48f88dd5b3ca319253fe +#: ../../introduction.rst:22 +msgid "" +"Many people mistakenly assume that geospatial applications just produce " +"maps, but geospatial data analysis is another primary function of geospatial " +"applications. Some typical types of analysis include computing:" +msgstr "" +"Molte persone ritengono erroneamente che le applicazioni geospaziali si " +"riducano alla produzione di mappe, ma l’analisi geospaziale del dato è " +"un’altra primaria funzione di tali programmi. Alcune tipiche analisi che " +"possono essere condotte sono:" + +# c3aec391371344adb8f7e4a9987fb1fb +#: ../../introduction.rst:28 +msgid "distances between geographic locations" +msgstr "distanze tra posizioni geografiche" + +# 955a470f6abe431299ffbbca516d3ea6 +#: ../../introduction.rst:30 +msgid "" +"the amount of area (e.g., square meters) within a certain geographic region" +msgstr "" +"misurazione dell’area (ad. es. metri quadrati) di una certa regione " +"geografica" + +# fc6d59ee14344a0d8c46f891df79c364 +#: ../../introduction.rst:33 +msgid "what geographic features overlap other features" +msgstr "quali elementi geografici si sovrappongono ad altri" + +# 81b814359e844f1793ed74831dd271bf +#: ../../introduction.rst:35 +msgid "the amount of overlap between features" +msgstr "determinazione dell’entità della sovrapposizione tra elementi" + +# 2bf933018de0461398d1bc5a584a2ffe +#: ../../introduction.rst:37 +msgid "the number of locations within a certain distance of another" +msgstr "il numero di posizioni comprese entro una certa distanza da un’altra" + +# 21ee35a6c73241d59727657289a340d3 +#: ../../introduction.rst:39 +msgid "and so on..." +msgstr "e così via..." + +# 1bb1168c57384db794e2bf30e7a08e16 +#: ../../introduction.rst:42 +msgid "" +"These may seem simplistic, but can be applied in all sorts of ways across " +"many disciplines. The results of analysis may be shown on a map, but are " +"often tabulated into a report to support management decisions." +msgstr "" +"Tutto ciò può apparire riduttivo, eppure può essere applicato in " +"innumerevoli maniere nelle più disparate discipline. Il risultato " +"dell’analisi può essere mostrato su una mappa, ma è spesso tabulato in un " +"report a supporto di decisioni gestionali." + +# 58f2a33b0eca4a64a1b63a3313379a69 +#: ../../introduction.rst:47 +msgid "" +"The recent phenomena of location-based services promises to introduce all " +"sorts of other features, but many will be based on a combination of maps and " +"analysis. For example, you have a cell phone that tracks your geographic " +"location. If you have the right software, your phone can tell you what kind " +"of restaurants are within walking distance. While this is a novel " +"application of geospatial technology, it is essentially doing geospatial " +"data analysis and listing the results for you." +msgstr "" +"La recente diffusione di servizi basati sulla posizione lascia intravedere " +"l’introduzione di ogni sorta di ulteriori caratteristiche, ma molte di esse " +"saranno basate sulla combinazione di mappatura e analisi. Per esempio i " +"cellulari tracciano la loro posizione geografica. Con un programma adatto, " +"il telefono può dire che tipo di ristoranti possono essere raggiunti a piedi " +"dalla propria posizione entro una certa distanza. Per quanto questa sia un " +"applicazione recentissima della tecnologia geospaziale, è essenzialmente " +"basata su analisi geospaziale del dato e presentazione dei risultati." + +# b8071a4c43da46568b15df8ecbc520fb +#: ../../introduction.rst:57 +msgid "Why is all this so new?" +msgstr "Perché tutto questo è una novità?" + +# d54596c48c654016acdabd4f5d612607 +#: ../../introduction.rst:59 +msgid "" +"Well, it's not. There are many new hardware devices that are enabling mobile " +"geospatial services. Many open source geospatial applications are also " +"available, but the existence of geospatially focused hardware and software " +"is nothing new. Global positioning system (GPS) receivers are becoming " +"commonplace, but have been used in various industries for more than a " +"decade. Likewise, desktop mapping and analysis tools have also been a major " +"commercial market, primarily focused on industries such as natural resource " +"management." +msgstr "" +"Bene, in realtà non è così. Ci sono molti nuovi dispositivi hardware che " +"consentono servizi geospaziali in modalità mobile. Sono disponibili anche " +"molti programmi geospaziali open source, ma l’esistenza di hardware e " +"software finalizzati all’uso del dato geospaziale non sono per niente una " +"novità. I ricevitori GPS (Global Positioning System, GPS) sono diventati " +"molto comuni, ma sono usati in diverse industrie da più di un decennio. In " +"maniera analoga, programmi per la mappatura e l’analisi sono stati un " +"preminente mercato commerciale, focalizzato principalmente su industrie " +"nell’ambito della gestione delle risorse naturali." + +# 677e3fc0c57344b0bdc8f3f15042496e +#: ../../introduction.rst:69 +msgid "" +"What is new is how the latest hardware and software is being applied and who " +"is applying it. Traditional users of mapping and analysis tools were highly " +"trained GIS Analysts or digital mapping technicians trained to use CAD-like " +"tools. Now, the processing capabilities of home PCs and open source software " +"(OSS) packages have enabled an army of hobbyists, professionals, web " +"developers, etc. to interact with geospatial data. The learning curve has " +"come down. The costs have come down. The amount of geospatial technology " +"saturation has increased." +msgstr "" +"Quello che è nuovo è il modo in cui le recenti tecnologie hardware e " +"software sono usate e da chi sono usate. Gli utenti tradizionali di " +"applicazioni per la mappatura e l’analisi erano analisti GIS fortemente " +"specializzati o tecnici della mappatura digitale istruiti ad usare strumenti " +"tipo CAD. Attualmente le capacità di calcolo dei personal computer e il " +"software open source (Open Source Software, OSS) hanno consentito ad un " +"esercito di hobbysti, professionisti, sviluppatori web, ecc. d’interagire " +"con il dato geospaziale. La curva di apprendimento si è abbassata. I costi " +"sono diminuiti. La quantità di tecnologia geospaziale è cresciuta." + +# a9964c57f57d42c5bf007046dc94fce3 +#: ../../introduction.rst:79 +msgid "" +"How is geospatial data stored? In a nutshell, there are two types of " +"geospatial data in widespread use today. This is in addition to traditional " +"tabular data that is also widely used by geospatial applications." +msgstr "" +"Come sono archiviati i dati geospaziali? In estrema sintesi, attualmente ci " +"sono due tipi di dati geospaziali di uso comune. Ciò in aggiunta al " +"tradizionale dato in forma tabellare, che è comunque diffusamente impiegato " +"dalle applicazioni geospaziali." + +# 5e3740877d5c4c2787326fb348f27acb +#: ../../introduction.rst:85 +msgid "Raster Data" +msgstr "Dati raster" + +# d1e3c255daf2467bb9480efc8f560d28 +#: ../../introduction.rst:87 +msgid "" +"One type of geospatial data is called raster data or simply \"a raster\". " +"The most easily recognised form of raster data is digital satellite imagery " +"or air photos. Elevation shading or digital elevation models are also " +"typically represented as raster data. Any type of map feature can be " +"represented as raster data, but there are limitations." +msgstr "" +"Uno dei tipi di dato geospaziale è detto dato raster o semplicemente raster: " +"esempi di dati raster sono le immagini satellitari o le foto aeree. Le " +"ombreggiature altimetriche o i modelli digitali di terreno (Digital " +"Elevation Model, DEM) sono anch’essi rappresentati come dati raster. " +"Qualunque elemento di mappa può essere rappresentato come dato raster, ma ci " +"sono delle limitazioni." + +# 17dbe2f715224c4ea4780765708a772f +#: ../../introduction.rst:94 +msgid "" +"A raster is a regular grid made up of cells, or in the case of imagery, " +"pixels. They have a fixed number of rows and columns. Each cell has a " +"numeric value and has a certain geographic size (e.g. 30x30 meters in size)." +msgstr "" +"Un raster è una griglia regolare fatta di celle o, nel caso di semplici " +"immagini, di pixels. Ha un numero fisso di righe e colonne. Ogni cella ha un " +"valore numerico e una certa dimensione geografica (ad es. 30x30 metri)." + +# 9c7ab1c60c304816ac3eaf6ed2fd18bd +#: ../../introduction.rst:99 +msgid "" +"Multiple overlapping rasters are used to represent images using more than " +"one colour value (i.e. one raster for each set of red, green and blue values " +"is combined to create a colour image). Satellite imagery also represents " +"data in multiple \"bands\". Each band is essentially a separate, spatially " +"overlapping raster, where each band holds values of certain wavelengths of " +"light. As you can imagine, a large raster takes up more file space. A raster " +"with smaller cells can provide more detail, but takes up more file space. " +"The trick is finding the right balance between cell size for storage " +"purposes and cell size for analytical or mapping purposes." +msgstr "" +"Più raster sovrapposti sono utilizzati per rappresentare immagini che " +"utilizzano più di un colore. Anche le immagini satellitari sono un esempio " +"di dati in bande multiple. Ogni banda è essenzialmente un livello " +"sovrapposto al precedente dove vengono salvati i valori della lunghezza " +"della luce. Come è facile immaginare, un raster di grosse dimensioni occupa " +"maggiore spazio su disco. Un raster con celle piccole può fornire maggior " +"dettaglio ma richiede anche più spazio. L’abilità sta nel trovare il giusto " +"compromesso tra la dimensione della cella ai fini dell’archiviazione e la " +"dimensione della cella ai fini analitici o di mappatura. " + +# 69a16cff72d54dbf802a378ead08055a +#: ../../introduction.rst:111 +msgid "Vector Data" +msgstr "Dati vettoriali" + +# f40d5302d37244229067f50572ac1a20 +#: ../../introduction.rst:113 +msgid "" +"Vector data is also used in geospatial applications. If you stayed awake " +"during trigonometry and coordinate geometry classes, you will already be " +"familiar with some of the qualities of vector data. In its simplest sense, " +"vectors are a way of describing a location by using a set of coordinates. " +"Each coordinate refers to a geographic location using a system of x and y " +"values." +msgstr "" +"Anche i dati vettoriali vengono usati nelle applicazioni geospaziali. Chi ha " +"seguito corsi di trigonometria o di geometria dovrebbe già essere a " +"conoscenza dei vettori. In termini semplici, i vettori sono un metodo per " +"descrivere una posizione utilizzando un insieme di coordinate. Ogni " +"coordinata si riferisce ad una posizione geografica utilizzando un sistema " +"di valori y e x." + +# 78bfa7c52f5445d99038542ab18a4ef9 +#: ../../introduction.rst:120 +msgid "" +"This can be thought of in reference to a Cartesian plane - you know, the " +"diagrams from school that showed an x and y-axis. You might have used them " +"to chart declining retirement savings or increasing compound mortgage " +"interest, but the concepts are essential to geospatial data analysis and " +"mapping." +msgstr "" +"Si può pensare a tutto ciò in riferimento ad un piano cartesiano, i " +"diagrammi di scuola che mostravano un asse x e un asse y. Potreste averli " +"usati per diagrammare risparmi decrescenti per la pensione o interessi " +"crescenti per il mutuo, ma gli stessi concetti sono alla base dell’analisi e " +"della mappatura del dato geospaziale." + +# 39587f2fd0f449e192cc73633811985b +#: ../../introduction.rst:126 +msgid "" +"There are various ways of representing these geographic coordinates " +"depending on your purpose. This is a whole area of study for another day - " +"map projections." +msgstr "" +"Ci sono vari modi per rappresentare le coordinate: questa è l’area di studio " +"dei sistemi di proiezione cartografiche." + +# 7a613803ab20438f8f55e1a2c7daa1a8 +#: ../../introduction.rst:130 +msgid "" +"Vector data takes on three forms, each progressively more complex and " +"building on the former." +msgstr "" +"I dati vettoriali si presentano in tre forme, di complessità crescente e " +"basate sulla forma precedente." + +# f7a5dc7686c144bc8dacb8360a5f6283 +#: ../../introduction.rst:134 +msgid "" +"Points - A single coordinate (x y) represents a discrete geographic location" +msgstr "" +"Punti - Una coppia di coordinate (x y) rappresenta una precisa posizione " +"geografica" + +# 7668691ee8aa4f85b32772677d45a5d8 +#: ../../introduction.rst:137 +msgid "" +"Lines - Multiple coordinates (x1 y1, x2 y2, x3 y4, ... xn yn) strung " +"together in a certain order, like drawing a line from Point (x1 y1) to Point " +"(x2 y2) and so on. These parts between each point are considered line " +"segments. They have a length and the line can be said to have a direction " +"based on the order of the points. Technically, a line is a single pair of " +"coordinates connected together, whereas a line string is multiple lines " +"connected together." +msgstr "" +"Linee - Coordinate multiple (x1 y1, x2 y2, x3 y4, ... xn yn) collegate tra " +"loro in un certo ordine. Equivale a disegnare una linea dal punto (x1 y1) al " +"punto (x2 y2) e così via. Queste parti fra ogni punto sono considerate " +"segmenti. Hanno una lunghezza ed ad essi si può attribuire una direzione " +"basata sull’ordine dei punti. Tecnicamente, una linea è data da una singola " +"coppia di coordinate (x1,y1; x2,y2) collegate insieme; una polilinea è " +"costituita da linee multiple collegate insieme." + +# 11f98ae4347346f4a481e4cb64398370 +#: ../../introduction.rst:146 +msgid "" +"Polygons - When lines are strung together by more than two points, with the " +"last point being at the same location as the first, we call this a polygon. " +"A triangle, circle, rectangle, etc. are all polygons. The key feature of " +"polygons is that there is a fixed area within them." +msgstr "" +"Poligoni - Quando le linee sono collegate tra loro da più di due punti, con " +"l’ultimo punto coincidente con il primo, viene definito un poligono. " +"Triangoli, cerchi, rettangoli ecc. ecc. sono tutti poligoni. La " +"caratteristica principale dei poligoni è che essi racchiudono un’area." + +# 79c65fed481f4615b34c0851336e79d5 +#: ../../introduction.rst:154 +msgid "" +"This chapter is by Tyler Mitchell (http://www.oreillynet.com/pub/wlg/7053) " +"and used under the Creative Commons License. Tyler is the author of *Web " +"Mapping Illustrated*, published by O'Reilly, 2005." +msgstr "" +"Questo capitolo e' a cura di Tyler Mitchell (http://www.oreillynet.com/pub/" +"wlg/7053) e viene usato secondo i termini della Creative Commons License. " +"Tyler e' l'autore *Web Mapping Illustrated*, pubblicato da O'Reilly, 2005." diff --git a/source/translated/pot/.doctrees/environment.pickle b/source/translated/pot/.doctrees/environment.pickle new file mode 100644 index 0000000..6e1568e Binary files /dev/null and b/source/translated/pot/.doctrees/environment.pickle differ diff --git a/source/translated/pot/.doctrees/getting_started.doctree b/source/translated/pot/.doctrees/getting_started.doctree new file mode 100644 index 0000000..c3410ac Binary files /dev/null and b/source/translated/pot/.doctrees/getting_started.doctree differ diff --git a/source/translated/pot/.doctrees/index.doctree b/source/translated/pot/.doctrees/index.doctree new file mode 100644 index 0000000..23859c6 Binary files /dev/null and b/source/translated/pot/.doctrees/index.doctree differ diff --git a/source/translated/pot/.doctrees/introduction.doctree b/source/translated/pot/.doctrees/introduction.doctree new file mode 100644 index 0000000..e856776 Binary files /dev/null and b/source/translated/pot/.doctrees/introduction.doctree differ diff --git a/source/translated/pot/getting_started.pot b/source/translated/pot/getting_started.pot new file mode 100644 index 0000000..af7f582 --- /dev/null +++ b/source/translated/pot/getting_started.pot @@ -0,0 +1,198 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2012, aavv +# This file is distributed under the same license as the QGIS Documentation package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: QGIS Documentation 1.8\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2012-04-05 12:57\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#: ../../getting_started.rst:11 +# 94112c459bac4a2b8be66851984d311f +msgid "Getting Started" +msgstr "" + +#: ../../getting_started.rst:13 +# 0ccf3592a6144df6b2a431c65c0354e9 +msgid "This chapter gives a quick overview of installing |qg|, some sample data from the web page and running a first and simple session visualizing raster and vector layers." +msgstr "" + +#: ../../getting_started.rst:18 +# ebc41a7c943f4774a34da42191e10a33 +msgid "Installation" +msgstr "" + +#: ../../getting_started.rst:20 +# 8fbf74cd89234431890edcfc1545fe75 +msgid "Installation of |qg| is very simple. Standard installer packages are available for MS Windows and Mac OS X. For many flavors of GNU/Linux binary packages (rpm and deb) or software repositories to add to your installation manager are provided. Get the latest information on binary packages at the website at http://download.qgis.org." +msgstr "" + +#: ../../getting_started.rst:28 +# 06402342d65841f38225dc30e320c4c9 +msgid "Installation from source" +msgstr "" + +#: ../../getting_started.rst:30 +# 8c9eed37501f4881a8d22eec5e63c51f +msgid "If you need to build from source, please refer to the coding and compiling guide available at http://www.qgis.org/en/documentation/manuals.html. The installation instructions are also distributed with the source code." +msgstr "" + +#: ../../getting_started.rst:36 +# 496607f2645040b1a41a133fc9bb402e +msgid "Installation on external media" +msgstr "" + +#: ../../getting_started.rst:38 +# fb0c52834b684fa991d00f4c4497f525 +msgid "QGIS allows to define a -configpath option that overrides the default path (e.g. :cmd-txt:`/.qgis` under Linux) for user configuration and forces QSettings to use this directory, too. This allows users to e.g. carry a QGIS installation on a flash drive together with all plugins and settings." +msgstr "" + +#: ../../getting_started.rst:45 +# fa33c6f5eb4a4f52a5407ef0025e7f60 +msgid "Sample Data" +msgstr "" + +#: ../../getting_started.rst:47 +# bfa1da4f76a5471281e9297d66dc6df4 +msgid "The user guide contains examples based on the |qg| sample dataset." +msgstr "" + +#: ../../getting_started.rst:49 +# 550f766e78714728b63e740a6fe0495a +msgid "|win| The Windows installer has an option to download the |qg| sample dataset. If checked, the data will be downloaded to your :cmd-txt:`My Documents` folder and placed in a folder called :cmd-txt:`GIS Database`. You may use Windows Explorer to move this folder to any convenient location. If you did not select the checkbox to install the sample dataset during the initial installation, you can either" +msgstr "" + +#: ../../getting_started.rst:56 +# a938a8af97ce45bf9f0408a9aa593314 +msgid "use GIS data that you already have;" +msgstr "" + +#: ../../getting_started.rst:57 +# 2590b63f443e46ea939916df5f3e9fa4 +msgid "download the sample data from the qgis website at http://download.qgis.org; or" +msgstr "" + +#: ../../getting_started.rst:59 +# 90e9970bc76a45d2bd13c666b81ac94b +msgid "uninstall and reinstall with the data download option checked, only if the above solutions are unsuccessful." +msgstr "" + +#: ../../getting_started.rst:63 +# 73c6661b69364beeaed54190ea495498 +msgid "|nix| |osx| For GNU/Linux and Mac OSX there are not yet dataset installation packages available as rpm, deb or dmg. To use the sample dataset download the file :cmd-txt:`qgis_sample_data` as ZIP or TAR archive from http://download.osgeo.org/qgis/data/ and unzip or untar the archive on your system. The Alaska dataset includes all GIS data that are used as examples and screenshots in the user guide, and also includes a small GRASS database. The projection for the qgis sample dataset is Alaska Albers Equal Area with unit feet. The EPSG code is 2964." +msgstr "" + +#: ../../getting_started.rst:96 +# 12590814766743659e427b6f5c814f66 +msgid "If you intend to use as graphical frontend for GRASS, you can find a selection of sample locations (e.g. Spearfish or South Dakota) at the official GRASS GIS website http://grass.osgeo.org/download/data.php." +msgstr "" + +#: ../../getting_started.rst:102 +# 9b5eac0e07974b3e97d7ace03699bf1c +msgid "Sample Session" +msgstr "" + +#: ../../getting_started.rst:104 +# d0ec8381d39d4ae18d054bbef75cc632 +msgid "Now that you have installed and a sample dataset available, we would like to demonstrate a short and simple sample session. We will visualize a raster and a vector layer. We will use the landcover raster layer |qg| :cmd-txt:`_sample_data/raster/landcover.img` and the lakes vector layer :cmd-txt:`_sample_data/gml/lakes.gml`." +msgstr "" + +#: ../../getting_started.rst:111 +# eb6263022b024002809a9043b1a49f6e +msgid "Start |qg|" +msgstr "" + +#: ../../getting_started.rst:113 +# f9f46b4d1ff44f85878ac348ede6486c +msgid "|nix| Start |qg| by typing: |qg| at a command prompt, or if using precompiled binary, using the Applications menu." +msgstr "" + +#: ../../getting_started.rst:115 +# 98910f884b5d4693a6e514bfc8578ca6 +msgid "|win| Start |qg| using the Start menu or desktop shortcut, or double click on a |qg| project file." +msgstr "" + +#: ../../getting_started.rst:117 +# eb7aa71ae59c447d88e055b50b767969 +msgid "|osx| Double click the icon in your Applications folder." +msgstr "" + +#: ../../getting_started.rst:125 +# 9b20118f901c4f07845fd15fca194b7d +msgid "Load raster and vector layers from the sample dataset" +msgstr "" + +#: ../../getting_started.rst:127 +# 400973a07ec24a98980bd5a94f666efc +msgid "Click on the |mActionAddRasterLayer| :tool-name:`Load Raster` icon." +msgstr "" + +#: ../../getting_started.rst:128 +# 02bec8b7cccb440fa045b83624223039 +msgid "Browse to the folder :cmd-txt:`qgis_sample_data/raster/`, select the ERDAS Img file :cmd-txt:`landcover.img` and click :button-name:`Open`." +msgstr "" + +#: ../../getting_started.rst:131 +# e52cdba3224c4911aa1df6448e7f74a5 +msgid "If the file is not listed, check if the Filetype combobox at the bottom of the dialog is set on the right type, in this case \"Erdas Imagine Images (\\*.img, \\*.IMG)\"" +msgstr "" + +#: ../../getting_started.rst:134 +# 3213ef617aa54fbebf4417e73759fd71 +msgid "Now click on the |mActionAddOgrLayer| :tool-name:`Load Vector` icon." +msgstr "" + +#: ../../getting_started.rst:135 +# 94e1f7c3e50e4e09b1a20f4c10b4e3fc +msgid ":radio-name:`File` should be selected as Source Type in the new :dialog-name:`Add Vector Layer` dialog. Now click :button-name:`Browse` to select the vector layer." +msgstr "" + +#: ../../getting_started.rst:139 +# 25bee1cb748f432dbcc4bc328ba2ed58 +msgid "Browse to the folder :cmd-txt:`qgis_sample_data/gml/`, select \"GML\" from the filetype combobox, then select the GML file :cmd-txt:`lakes.gml` and click :button-name:`Open`, then in Add Vector dialog click :button-name:`OK`." +msgstr "" + +#: ../../getting_started.rst:143 +# c678a2cc03254ffba4308c6e04e7d835 +msgid "Zoom in a bit to your favorite area with some lakes." +msgstr "" + +#: ../../getting_started.rst:144 +# 3decb9823fdc4a53909afd73817399a0 +msgid "Double click the :cmd-txt:`lakes` layer in the map legend to open the :dialog-name:`Properties` dialog." +msgstr "" + +#: ../../getting_started.rst:146 +# d151e1b0331245e6a4cebeabb2808ad4 +msgid "Click on the :tab-name:`Style` tab and select a blue as fill color." +msgstr "" + +#: ../../getting_started.rst:147 +# ff945ad487254e47aa7b2701472be917 +msgid "Click on the :tab-name:`Labels` tab and check the :check-name:`Display labels` checkbox to enable labeling. Choose NAMES field as field containing label." +msgstr "" + +#: ../../getting_started.rst:150 +# bed79854fb94467fb34c2c9205185879 +msgid "To improve readability of labels, you can add a white buffer around them, by clicking \"Buffer\" in the list on the left, checking :check-name:`Buffer labels?` and choosing 3 as buffer size." +msgstr "" + +#: ../../getting_started.rst:153 +# cd6c816f5ec7498fa450ab7f4b33eafd +msgid "Click :button-name:`Apply`, check if the result looks good and finally click :button-name:`OK`." +msgstr "" + +#: ../../getting_started.rst:156 +# 1bc806ea447042dca9d31d667ed93f17 +msgid "You can see how easy it is to visualize raster and vector layers in . Let's move on to the sections that follow to learn more about the available functionality, features and settings and how to use them." +msgstr "" + diff --git a/source/translated/pot/index.pot b/source/translated/pot/index.pot new file mode 100644 index 0000000..82f786b --- /dev/null +++ b/source/translated/pot/index.pot @@ -0,0 +1,48 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2012, aavv +# This file is distributed under the same license as the QGIS Documentation package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: QGIS Documentation 1.8\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2012-04-05 12:57\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#: ../../index.rst:7 +# c82f84bd58b74ad39263ccf1249b39ec +msgid "Welcome to QGIS Documentation's documentation!" +msgstr "" + +#: ../../index.rst:9 +# b52c732781ab42e7980cb37559e61dd0 +msgid "Contents:" +msgstr "" + +#: ../../index.rst:19 +# 5c943d10f0df4178b4794b9127aa56f3 +msgid "Indices and tables" +msgstr "" + +#: ../../index.rst:21 +# efd5d7db40b14b769cc5c6d42a0c4d27 +msgid ":ref:`genindex`" +msgstr "" + +#: ../../index.rst:22 +# d62a08c3af634837ab6351aba9f6cfe3 +msgid ":ref:`modindex`" +msgstr "" + +#: ../../index.rst:23 +# 9831c2b62fd94aa781e57b5e2c7708d5 +msgid ":ref:`search`" +msgstr "" + diff --git a/source/translated/pot/introduction.pot b/source/translated/pot/introduction.pot new file mode 100644 index 0000000..d45344a --- /dev/null +++ b/source/translated/pot/introduction.pot @@ -0,0 +1,163 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2012, aavv +# This file is distributed under the same license as the QGIS Documentation package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: QGIS Documentation 1.8\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2012-04-05 12:57\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#: ../../introduction.rst:3 +# fb17a663a72a4d30b6bcf9851fdf6125 +msgid "Introduction To GIS" +msgstr "" + +#: ../../introduction.rst:5 +# ee56d88478894dc09733dc072365ec4f +msgid "A Geographical Information System (GIS) [1]_ is a collection of software that allows you to create, visualize, query and analyze geospatial data. Geospatial data refers to information about the geographic location of an entity. This often involves the use of a geographic coordinate, like a latitude or longitude value. Spatial data is another commonly used term, as are: geographic data, GIS data, map data, location data, coordinate data and spatial geometry data." +msgstr "" + +#: ../../introduction.rst:14 +# 087beb72859044e895d3a261311b5179 +msgid "Applications using geospatial data perform a variety of functions. Map production is the most easily understood function of geospatial applications. Mapping programs take geospatial data and render it in a form that is viewable, usually on a computer screen or printed page. Applications can present static maps (a simple image) or dynamic maps that are customised by the person viewing the map through a desktop program or a web page." +msgstr "" + +#: ../../introduction.rst:22 +# 7a708b07b51b48f88dd5b3ca319253fe +msgid "Many people mistakenly assume that geospatial applications just produce maps, but geospatial data analysis is another primary function of geospatial applications. Some typical types of analysis include computing:" +msgstr "" + +#: ../../introduction.rst:28 +# c3aec391371344adb8f7e4a9987fb1fb +msgid "distances between geographic locations" +msgstr "" + +#: ../../introduction.rst:30 +# 955a470f6abe431299ffbbca516d3ea6 +msgid "the amount of area (e.g., square meters) within a certain geographic region" +msgstr "" + +#: ../../introduction.rst:33 +# fc6d59ee14344a0d8c46f891df79c364 +msgid "what geographic features overlap other features" +msgstr "" + +#: ../../introduction.rst:35 +# 81b814359e844f1793ed74831dd271bf +msgid "the amount of overlap between features" +msgstr "" + +#: ../../introduction.rst:37 +# 2bf933018de0461398d1bc5a584a2ffe +msgid "the number of locations within a certain distance of another" +msgstr "" + +#: ../../introduction.rst:39 +# 21ee35a6c73241d59727657289a340d3 +msgid "and so on..." +msgstr "" + +#: ../../introduction.rst:42 +# 1bb1168c57384db794e2bf30e7a08e16 +msgid "These may seem simplistic, but can be applied in all sorts of ways across many disciplines. The results of analysis may be shown on a map, but are often tabulated into a report to support management decisions." +msgstr "" + +#: ../../introduction.rst:47 +# 58f2a33b0eca4a64a1b63a3313379a69 +msgid "The recent phenomena of location-based services promises to introduce all sorts of other features, but many will be based on a combination of maps and analysis. For example, you have a cell phone that tracks your geographic location. If you have the right software, your phone can tell you what kind of restaurants are within walking distance. While this is a novel application of geospatial technology, it is essentially doing geospatial data analysis and listing the results for you." +msgstr "" + +#: ../../introduction.rst:57 +# b8071a4c43da46568b15df8ecbc520fb +msgid "Why is all this so new?" +msgstr "" + +#: ../../introduction.rst:59 +# d54596c48c654016acdabd4f5d612607 +msgid "Well, it's not. There are many new hardware devices that are enabling mobile geospatial services. Many open source geospatial applications are also available, but the existence of geospatially focused hardware and software is nothing new. Global positioning system (GPS) receivers are becoming commonplace, but have been used in various industries for more than a decade. Likewise, desktop mapping and analysis tools have also been a major commercial market, primarily focused on industries such as natural resource management." +msgstr "" + +#: ../../introduction.rst:69 +# 677e3fc0c57344b0bdc8f3f15042496e +msgid "What is new is how the latest hardware and software is being applied and who is applying it. Traditional users of mapping and analysis tools were highly trained GIS Analysts or digital mapping technicians trained to use CAD-like tools. Now, the processing capabilities of home PCs and open source software (OSS) packages have enabled an army of hobbyists, professionals, web developers, etc. to interact with geospatial data. The learning curve has come down. The costs have come down. The amount of geospatial technology saturation has increased." +msgstr "" + +#: ../../introduction.rst:79 +# a9964c57f57d42c5bf007046dc94fce3 +msgid "How is geospatial data stored? In a nutshell, there are two types of geospatial data in widespread use today. This is in addition to traditional tabular data that is also widely used by geospatial applications." +msgstr "" + +#: ../../introduction.rst:85 +# 5e3740877d5c4c2787326fb348f27acb +msgid "Raster Data" +msgstr "" + +#: ../../introduction.rst:87 +# d1e3c255daf2467bb9480efc8f560d28 +msgid "One type of geospatial data is called raster data or simply \"a raster\". The most easily recognised form of raster data is digital satellite imagery or air photos. Elevation shading or digital elevation models are also typically represented as raster data. Any type of map feature can be represented as raster data, but there are limitations." +msgstr "" + +#: ../../introduction.rst:94 +# 17dbe2f715224c4ea4780765708a772f +msgid "A raster is a regular grid made up of cells, or in the case of imagery, pixels. They have a fixed number of rows and columns. Each cell has a numeric value and has a certain geographic size (e.g. 30x30 meters in size)." +msgstr "" + +#: ../../introduction.rst:99 +# 9c7ab1c60c304816ac3eaf6ed2fd18bd +msgid "Multiple overlapping rasters are used to represent images using more than one colour value (i.e. one raster for each set of red, green and blue values is combined to create a colour image). Satellite imagery also represents data in multiple \"bands\". Each band is essentially a separate, spatially overlapping raster, where each band holds values of certain wavelengths of light. As you can imagine, a large raster takes up more file space. A raster with smaller cells can provide more detail, but takes up more file space. The trick is finding the right balance between cell size for storage purposes and cell size for analytical or mapping purposes." +msgstr "" + +#: ../../introduction.rst:111 +# 69a16cff72d54dbf802a378ead08055a +msgid "Vector Data" +msgstr "" + +#: ../../introduction.rst:113 +# f40d5302d37244229067f50572ac1a20 +msgid "Vector data is also used in geospatial applications. If you stayed awake during trigonometry and coordinate geometry classes, you will already be familiar with some of the qualities of vector data. In its simplest sense, vectors are a way of describing a location by using a set of coordinates. Each coordinate refers to a geographic location using a system of x and y values." +msgstr "" + +#: ../../introduction.rst:120 +# 78bfa7c52f5445d99038542ab18a4ef9 +msgid "This can be thought of in reference to a Cartesian plane - you know, the diagrams from school that showed an x and y-axis. You might have used them to chart declining retirement savings or increasing compound mortgage interest, but the concepts are essential to geospatial data analysis and mapping." +msgstr "" + +#: ../../introduction.rst:126 +# 39587f2fd0f449e192cc73633811985b +msgid "There are various ways of representing these geographic coordinates depending on your purpose. This is a whole area of study for another day - map projections." +msgstr "" + +#: ../../introduction.rst:130 +# 7a613803ab20438f8f55e1a2c7daa1a8 +msgid "Vector data takes on three forms, each progressively more complex and building on the former." +msgstr "" + +#: ../../introduction.rst:134 +# f7a5dc7686c144bc8dacb8360a5f6283 +msgid "Points - A single coordinate (x y) represents a discrete geographic location" +msgstr "" + +#: ../../introduction.rst:137 +# 7668691ee8aa4f85b32772677d45a5d8 +msgid "Lines - Multiple coordinates (x1 y1, x2 y2, x3 y4, ... xn yn) strung together in a certain order, like drawing a line from Point (x1 y1) to Point (x2 y2) and so on. These parts between each point are considered line segments. They have a length and the line can be said to have a direction based on the order of the points. Technically, a line is a single pair of coordinates connected together, whereas a line string is multiple lines connected together." +msgstr "" + +#: ../../introduction.rst:146 +# 11f98ae4347346f4a481e4cb64398370 +msgid "Polygons - When lines are strung together by more than two points, with the last point being at the same location as the first, we call this a polygon. A triangle, circle, rectangle, etc. are all polygons. The key feature of polygons is that there is a fixed area within them." +msgstr "" + +#: ../../introduction.rst:154 +# 79c65fed481f4615b34c0851336e79d5 +msgid "This chapter is by Tyler Mitchell (http://www.oreillynet.com/pub/wlg/7053) and used under the Creative Commons License. Tyler is the author of *Web Mapping Illustrated*, published by O'Reilly, 2005." +msgstr "" +