Commit 2cdb1a2a authored by Jean Jordaan's avatar Jean Jordaan

Tidying ..

parent f98d75c3
Introduction
============
Fastkml is a library to read, write and manipulate kml files. It aims to keep
Fastkml is a library to read, write and manipulate KML files. It aims to keep
it simple and fast (using lxml_ if available). Fast refers to the time you
spend to write and read KML files as well as the time you spend to get
aquainted to the library or to create KML objects. It provides a subset of KML
spend to write and read KML files, as well as the time you spend to get
acquainted with the library or to create KML objects.
It provides a subset of KML
and is aimed at documents that can be read from multiple clients such as
openlayers and google maps rather than to give you all functionality that KML
openlayers and google maps, rather than to give you all functionality that KML
on google earth provides.
Geometries are handled as pygeoif_ or shapely_ (if installed) objects.
Geometries are handled as pygeoif_ or, if installed, shapely_ objects.
.. _pygeoif: http://pypi.python.org/pypi/pygeoif/
.. _shapely: http://pypi.python.org/pypi/Shapely
......@@ -79,7 +80,7 @@ Limitations
===========
*Tesselate*, *Extrude* and *Altitude Mode* are assigned to a Geometry or
Geometry collection (MultiGeometry). You cannot assign diffrent values of
Geometry collection (MultiGeometry). You cannot assign different values of
*Tesselate*, *Extrude* or *Altitude Mode* on parts of a MultiGeometry.
You can find the complete list of current issues on `GitHub
......
......@@ -14,10 +14,10 @@ Welcome to FastKML's documentation!
:target: https://www.ohloh.net/p/fastkml
Fastkml is a library to read, write and manipulate kml files. It aims to keep
fastkml is a library to read, write and manipulate KML files. It aims to keep
it simple and fast (using lxml_ if available). "Fast" refers to the time you
spend to write and read KML files as well as the time you spend to get
aquainted to the library or to create KML objects. It provides a subset of KML
spend to write and read KML files, as well as the time you spend to get
acquainted with the library or to create KML objects. It provides a subset of KML
and is aimed at documents that can be read from multiple clients such as
openlayers and google maps rather than to give you all functionality that KML
on google earth provides.
......@@ -29,18 +29,18 @@ developers site.
Rationale
---------
Why yet another KML library? None of the existing ones quite fitted my
Why yet another KML library? None of the existing ones quite fit my
requirements, namely:
* Fastkml can *read and write* KML files, feeding fastkmls output back into
fastkml and serializing it again will result in the same output.
* You can parse any kml snipppet, it does not need to be a complete KML
* fastkml can *read and write* KML files, feeding fastkml's output back into
fastkml and serializing it again will result in the same output.
* You can parse any KML snippet, it does not need to be a complete KML
document.
* It runs on python 2 and 3.
* It runs on Python 2 and 3.
* It is fully tested and actively maintained.
* Geometries are handled in the `__geo_interface__` standard.
* Minimal dependencies, pure python.
* If available lxml_ will be used to increase its speed.
* Minimal dependencies, pure Python.
* If available, lxml_ will be used to increase its speed.
.. toctree::
:maxdepth: 2
......
......@@ -13,7 +13,7 @@ fastkml works on Unix/Linux, OS X, and Windows.
Install it with ``pip install fastkml`` or ``easy_install fastkml``.
If you use fastkml extensively or need to process big kml files consider
If you use fastkml extensively or need to process big KML files, consider
installing lxml_ as it speeds up processing.
You can install all requirements for working with fastkml by using pip_ from
......
Usage Guide
===========
You can find more examples in the included ``test_main.py`` file or in
collective.geo.fastkml_, here is a quick overview:
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment