Merge PR#156 to draft-1.5 from ASPRSorg/issue-71-alt-1.5

Implements normalized wiki links and add introductory chapter to LAS 1.5

Also includes the following:

minor updates to patch github actions
normalize page break notation
update OGC links

Author: esilvia

.github/workflows/pdf.yml

@@ -28,14 +28,16 @@ jobs:
     - name: Spelling
       run: |
         make spelling
-    - uses: actions/upload-artifact@v3
+    - uses: actions/upload-artifact@v4
       with:
         name: PDF
         path: build/latex/LAS.pdf
-    - uses: actions/upload-artifact@v3
+        if-no-files-found: error
+    - uses: actions/upload-artifact@v4
       with:
         name: Misspelled
         path: build/spelling/output.txt
+        if-no-files-found: ignore
 
 
 

.gitignore

@@ -1 +1,2 @@
 build/
+.vscode

source/01_intro.txt

@@ -145,6 +145,8 @@ Summary of LAS 1.4 revisions (GitHub Issue numbers included when applicable):
     (`I-55 <https://github.com/ASPRSorg/LAS/issues/55>`_)
   * Clarified how and when certain header fields should be zero-filled.
     (`I-101 <https://github.com/ASPRSorg/LAS/issues/101>`_)
+  * Added Official LAS Wiki section.
+    (`I-71 <https://github.com/ASPRSorg/LAS/issues/71>`_)
   * More closely aligned data types with C99 definitions.
     (`I-115 <https://github.com/ASPRSorg/LAS/issues/115>`_)
 
@@ -178,7 +180,7 @@ The additions of LAS 1.4 include:
 
   * Added definitions for "LAS Domain Profile" and "LAS Domain Profile
     Description".
-  * Added links to official LAS wiki: https://github.com/ASPRSorg/LAS/wiki
+  * Added references to :ref:`Official LAS Wiki <laswiki_link>`.
 
 
 Conformance
@@ -207,17 +209,22 @@ this standard can be directed to ASPRS:
 OGC
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-LAS has been recognized by the Open Geospatial Consortium (`OGC`_) in 2018 as an
+LAS has been recognized by the Open Geospatial Consortium (`OGC`_) since 2018 as an
 OGC Community Standard. The OGC version of the document with forward material
 about standards that LAS references and its status within the standard body can
-be found at https://portal.opengeospatial.org/files/17-030r1.
+be found at https://www.ogc.org/publications/standard/las/.
 
 Future recognition and activity on OGC referencing activities of LAS can be
-followed at http://www.opengeospatial.org/standards/community.
+followed at https://www.ogc.org/publications/.
 
-.. _`OGC`: http://www.opengeospatial.org
+.. _`OGC`: https://www.ogc.org
 
-.. raw:: latex
 
-    \newpage
+.. _laswiki_link:
 
+Official LAS Wiki
+................................................................................
+
+The official LAS wiki hosts supplemental guidance pages, links to external
+resources, public registries, and more LAS-related resources.
+The wiki can be found at https://github.com/ASPRSorg/LAS/wiki.

source/02.00_definition.txt

@@ -1,3 +1,7 @@
+.. raw:: latex
+
+    \newpage
+
 LAS Format Definition
 --------------------------------------------------------------------------------
 

source/02.04_header.sub

@@ -227,7 +227,7 @@ file can be uniquely identified, globally.
 .. note::
 
     Example implementations of representing the Project ID fields as a GUID can
-    be found on the official LAS wiki: https://github.com/ASPRSorg/LAS/wiki
+    be found on the :ref:`Official LAS Wiki <laswiki_link>`.
 
 **Version Number**
 
@@ -445,8 +445,8 @@ The Time Offset field can be used to optimize :ref:`GPS Time <gpstime_link>` pre
 Offset GPS Time for a point record is equal to standard GPS Time, minus :math:`10^6` * Time Offset.
 
 For example, Adjusted Standard GPS Time uses a total offset of 1 billion (:math:`10^9`) seconds, which would be specified by a Time Offset of 1000.
-This achieves 100 nanosecond precision for the years 2007-2015. The LAS wiki provides
-`recommended values <https://github.com/ASPRSorg/LAS/wiki/Suggested-LAS-1.5-Time-Offset-Values>`_
+This achieves 100 nanosecond precision for the years 2007-2015. The
+:ref:`Official LAS Wiki <laswiki_link>` provides recommended values
 and year ranges that users are encouraged to use to maximize compatibility between datasets.
 
 This value must be set to zero if there are no point records in the file,

source/02.06_point.sub

@@ -668,7 +668,7 @@ and the vertical units are meters.
 .. note::
 
     Users seeking further clarity regarding LAS waveform encoding are encouraged
-    to learn more on the official LAS wiki: https://github.com/ASPRSorg/LAS/wiki
+    to learn more on the :ref:`Official LAS Wiki <laswiki_link>`.
 
 
 .. raw:: latex

source/04_optional_vlrs.txt

@@ -306,6 +306,6 @@ absolute digitizer voltage using the formula:
 .. note::
 
     Users seeking further clarity regarding LAS waveform encoding are encouraged
-    to learn more on the official LAS wiki: https://github.com/ASPRSorg/LAS/wiki
+    to learn more on the :ref:`Official LAS Wiki <laswiki_link>`.