From c58c8dad43cd7be222614e4ff421d09dc439a17c Mon Sep 17 00:00:00 2001 From: Christian Ledermann Date: Sat, 30 Nov 2024 17:10:41 +0000 Subject: [PATCH] enhance documentation --- docs/index.rst | 1 + docs/kml.rst | 10 +++++++--- docs/working_with_kml.rst | 10 +++++++--- 3 files changed, 15 insertions(+), 6 deletions(-) diff --git a/docs/index.rst b/docs/index.rst index 657e117b..d438380c 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -29,5 +29,6 @@ requirements, namely: upgrading fastkml contributing + kml alternatives HISTORY diff --git a/docs/kml.rst b/docs/kml.rst index 71985554..29f8133b 100644 --- a/docs/kml.rst +++ b/docs/kml.rst @@ -1,9 +1,13 @@ KML Resources and Tutorials =========================== +Learning KML can be straightforward with the right resources. +Here are some of the best sources: -https://developers.google.com/kml -https://en.wikipedia.org/wiki/Keyhole_Markup_Language +`Google Developers - KML `_ provides a comprehensive +guide to KML, including tutorials, reference, and examples. -https://support.safe.com/hc/en-us/sections/25407358419469-OGC-Google-KML + +The `FME Support Center's section on OGC and Google KML `_ +provides detailed guidance for creating, styling, and optimizing KML files. diff --git a/docs/working_with_kml.rst b/docs/working_with_kml.rst index 3da5942e..9a0eba4e 100644 --- a/docs/working_with_kml.rst +++ b/docs/working_with_kml.rst @@ -50,8 +50,12 @@ We could also search for all Points, which will also return the Points inside th ``find_all`` can also search for arbitrary elements by their attributes, by passing the attribute name and value as keyword arguments. -``find`` is a shortcut for ``find_all`` that returns the first element found, which is -useful when we know there is only one element that matches the search criteria. + +.. note:: + + ``find`` is a shortcut for ``find_all`` that returns the first element found, + which is useful when we know there is only one element that matches the search + criteria. .. code-block:: pycon @@ -232,7 +236,7 @@ Now we can remove the CascadingStyle from the document and have a look at the re hide - + Ort1 10.06256752902339