[Liblas-commits] hg: more styling, html building, additional files
liblas-commits at liblas.org
liblas-commits at liblas.org
Mon May 17 14:19:05 EDT 2010
changeset 0b86d9451d34 in /Volumes/Data/www/liblas.org/hg
details: http://hg.liblas.orghg?cmd=changeset;node=0b86d9451d34
summary: more styling, html building, additional files
diffstat:
doc/_templates/indexsidebar.html | 17 ++++++-
doc/_templates/layout.html | 21 ++++++++
doc/community.txt | 27 ++++++++++
doc/conf.py | 14 +++--
doc/copyright.txt | 7 ++
doc/development/index.txt | 25 +++++++++
doc/docs.txt | 4 +-
doc/download.txt | 2 +
doc/features.txt | 47 ++++++++++++++++++
doc/index.txt | 101 +++-----------------------------------
include/liblas/capi/liblas.h | 7 ++-
11 files changed, 170 insertions(+), 102 deletions(-)
diffs (truncated from 456 to 300 lines):
diff -r 80e46c5687da -r 0b86d9451d34 doc/_templates/indexsidebar.html
--- a/doc/_templates/indexsidebar.html Mon May 17 10:31:00 2010 -0500
+++ b/doc/_templates/indexsidebar.html Mon May 17 13:18:59 2010 -0500
@@ -1,4 +1,19 @@
+
+<p>
+<a href="{{ pathto('docs') }}" title="Home">Documentation</a><br />
+<a href="{{ pathto('download') }}" title="Home">Download</a><br />
+<a href="http://trac.osgeo.org" title="Bugs">Bugs</a><br />
+
+<a href="{{ pathto('features') }}" title="Features">Features</a><br />
+<a href="{{ pathto('community') }}" title="Mailing Lists">Mailing Lists</a><br />
+
+</p>
+
+<p>
+<a href="http://2010.foss4g.org"><img src="http://2010.foss4g.org/images/logo_125x125.jpg" /></a>
+</p>
<p>
<script type="text/javascript" src="http://www.ohloh.net/p/10742/widgets/project_partner_badge.js"></script>
-</p>
\ No newline at end of file
+</p>
+
diff -r 80e46c5687da -r 0b86d9451d34 doc/_templates/layout.html
--- a/doc/_templates/layout.html Mon May 17 10:31:00 2010 -0500
+++ b/doc/_templates/layout.html Mon May 17 13:18:59 2010 -0500
@@ -30,3 +30,24 @@
{# put the sidebar before the body #}
{% block sidebar1 %}{% endblock %}
{% block sidebar2 %}{{ sidebar() }}{% endblock %}
+
+{% block footer %}
+<div class="footer">
+ {%- if show_copyright %}
+ {%- if hasdoc('copyright') %}
+ {% trans path=pathto('copyright'), copyright=copyright|e %}© <a href="{{ path }}">Copyright</a> {{ copyright }}.{% endtrans %}
+ {%- else %}
+ {% trans copyright=copyright|e %}© Copyright {{ copyright }}.{% endtrans %}
+ {%- endif %}
+
+ {%- endif %}
+ {%- if last_updated %}
+ {% trans last_updated=last_updated|e %}Website was last updated on {{ last_updated }} {% endtrans %}
+ {%- endif %}
+ {%- if show_sphinx %}
+ {% trans sphinx_version=sphinx_version|e %}and created with <a href="http://sphinx.pocoo.org/">Sphinx</a>.{% endtrans %}
+ {%- endif %}
+
+
+</div>
+{% endblock %}
diff -r 80e46c5687da -r 0b86d9451d34 doc/community.txt
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/community.txt Mon May 17 13:18:59 2010 -0500
@@ -0,0 +1,27 @@
+.. _community:
+
+******************************************************************************
+Community
+******************************************************************************
+
+Mailing Lists
+..............................................................................
+
+* liblas-devel - http://lists.osgeo.org/mailman/listinfo/liblas-devel
+* liblas-commits - http://lists.osgeo.org/mailman/listinfo/liblas-commits
+
+
+Bugs
+..............................................................................
+
+Visit http://trac.osgeo.org to file bugs or edit wiki pages with your own
+information about libLAS.
+
+IRC
+..............................................................................
+
+Find the libLAS developers on IRC on #liblas at `Freenode`_.
+
+
+
+.. _`Freenode`: http://freenode.net
diff -r 80e46c5687da -r 0b86d9451d34 doc/conf.py
--- a/doc/conf.py Mon May 17 10:31:00 2010 -0500
+++ b/doc/conf.py Mon May 17 13:18:59 2010 -0500
@@ -38,7 +38,7 @@
# General information about the project.
project = u'libLAS'
-copyright = u'2010, Howard Butler'
+copyright = u'2010, Howard Butler, Mateusz Loskot and others'
# The version info for the project you're documenting, acts as replacement for
# |version| and |release|, also used in various other places throughout the
@@ -97,17 +97,17 @@
# 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 = {}
+#html_theme_options = {'rightsidebar':True}
# Add any paths that contain custom themes here, relative to this directory.
#html_theme_path = []
# The name for this set of Sphinx documents. If None, it defaults to
# "<project> v<release> documentation".
-#html_title = None
+html_title = 'liblas.org'
# A shorter title for the navigation bar. Default is the same as html_title.
-#html_short_title = None
+html_short_title = 'Documentation'
# The name of an image file (relative to this directory) to place at the top
# of the sidebar.
@@ -132,7 +132,9 @@
#html_use_smartypants = True
# Custom sidebar templates, maps document names to template names.
-html_sidebars = {"index":"indexsidebar.html"}
+html_sidebars = {
+ '**': ['globaltoc.html', 'sourcelink.html', 'searchbox.html'],
+"index":["indexsidebar.html",'searchbox.html']}
# Additional templates that should be rendered to pages, maps page names to
# template names.
@@ -177,6 +179,6 @@
pdf_stylesheets = ['liblas']
pdf_language = "en_US"
pdf_fit_mode = "overflow"
-
+pdf_appendices = ''
# Example configuration for intersphinx: refer to the Python standard library.
intersphinx_mapping = {'http://docs.python.org/': None}
diff -r 80e46c5687da -r 0b86d9451d34 doc/copyright.txt
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/copyright.txt Mon May 17 13:18:59 2010 -0500
@@ -0,0 +1,7 @@
+.. _license:
+
+******************************************************************************
+License
+******************************************************************************
+
+.. include:: ../LICENSE.txt
\ No newline at end of file
diff -r 80e46c5687da -r 0b86d9451d34 doc/development/index.txt
--- a/doc/development/index.txt Mon May 17 10:31:00 2010 -0500
+++ b/doc/development/index.txt Mon May 17 13:18:59 2010 -0500
@@ -5,6 +5,9 @@
******************************************************************************
+Topics
+..............................................................................
+
.. toctree::
:maxdepth: 0
@@ -14,3 +17,25 @@
format_elements
+Authors
+..............................................................................
+
+The libLAS development team are:
+
+ * `Howard Butler`_
+ * `Mateusz Loskot`_
+ * `Phil Vachon`_
+ * Martin Vales
+ * `Frank Warmerdam`_
+
+Special thanks to `Martin Isenburg and Jonathan Shewchuk`_ for their
+:ref:`lastools_liblas` pioneering implementation of the ASPRS LAS standard that made
+development of the libLAS library possible.
+
+
+.. _`Howard Butler`: http://hobu.biz
+.. _`Mateusz Loskot`: http://mateusz.loskot.net
+.. _`Phil Vachon`: http://www.geoscan.info
+.. _`Frank Warmerdam`: http://home.gdal.org/warmerda/
+.. _`Martin Isenburg and Jonathan Shewchuk`: http://www.cs.unc.edu/~isenburg/lastools/
+
diff -r 80e46c5687da -r 0b86d9451d34 doc/docs.txt
--- a/doc/docs.txt Mon May 17 10:31:00 2010 -0500
+++ b/doc/docs.txt Mon May 17 13:18:59 2010 -0500
@@ -7,9 +7,9 @@
.. toctree::
:maxdepth: 1
+ compilation
+ tutorial/index
faq
- tutorial/index
- compilation
development/index
utilities/index
python/index
diff -r 80e46c5687da -r 0b86d9451d34 doc/download.txt
--- a/doc/download.txt Mon May 17 10:31:00 2010 -0500
+++ b/doc/download.txt Mon May 17 13:18:59 2010 -0500
@@ -1,3 +1,5 @@
+.. _download:
+
.. _download:
******************************************************************************
diff -r 80e46c5687da -r 0b86d9451d34 doc/features.txt
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/features.txt Mon May 17 13:18:59 2010 -0500
@@ -0,0 +1,47 @@
+.. _features:
+
+******************************************************************************
+Features
+******************************************************************************
+
+Open Source
+..............................................................................
+
+libLAS is open source software. You can embed it in your own applications
+(and even resell it) as long as you follow the crediting restriction of the BSD
+license. See :ref:`license` for more detail.
+
+Multiple APIs
+..............................................................................
+
+libLAS has C, C++, .NET, Ruby, and Python APIs.
+
+Spatial Reference System Support
+..............................................................................
+
+Linked against a 1.2.5+ version of `libgeotiff`_, you can set and get the spatial reference
+systems of LAS files using simple `proj.4`_ coordinate system definitions.
+Alternatively, with libLAS 1.2, you can link against `GDAL`_ to be able to
+manipulate spatial references using WKT. The current development version of
+libLAS can be used in combination with `GDAL`_ 1.7 to support `vertical coordinate systems`_
+as well.
+
+Simple Variable Length Record Abstraction
+..............................................................................
+
+libLAS provides a sensible abstraction for working with variable length records (VLR)
+in LAS files, and it transparently manages the VLRs related to spatial referencing
+systems for you.
+
+Command-line Utilities
+..............................................................................
+
+libLAS provides ports of the `LAStools`_ utilities by Martin Isenburg for doing
+things like translating from one version of the LAS format to another, inspecting
+header information, and translating LAS data to and from text.
+
+Cross-platform operation
+..............................................................................
+
+libLAS is known to work on all editions of Microsoft Visual C++ 7.1+ (Windows) and
+GCC 4.1+ (Mac OS X and Linux) platforms on both big- and little-endian architectures.
diff -r 80e46c5687da -r 0b86d9451d34 doc/index.txt
--- a/doc/index.txt Mon May 17 10:31:00 2010 -0500
+++ b/doc/index.txt Mon May 17 13:18:59 2010 -0500
@@ -11,32 +11,29 @@
libLAS is a C/C++ library for reading and writing the very common `LAS`
`LiDAR`_ format. The `ASPRS LAS format`_ is a sequential binary format used to
store data from LiDAR sensors and by LiDAR processing software for data
-interchange and archival.
+interchange and archival. See :ref:`features` for more details on what
+libLAS can provide a LiDAR software developer.
-.. image:: http://2010.foss4g.org/images/logo_125x125.jpg
- :height: 125px
- :width: 125px
- :alt: FOSS4G 2010 in Barcelona, Spain
- :align: right
- :target: http://2010.foss4g.org/
libLAS builds upon by `Martin Isenburg and Jonathan Shewchuk`_ of LLNL/UC
Berkeley in their `LAStools`_ project to do a number of things. First, the
libLAS focuses almost completely on providing an easy-to-program-with library
for software developers wishing to implement the LAS specification in their
-own software. Second, libLAS exists to provide a truly open source library --
+own software. Second, libLAS exists to provide a truly open source library (see :ref:`license` for terms )--
`LAStools`_ has no explicit licensing terms. Third, libLAS exists to provide
advanced functionality and concentrate almost solely on the specification --
not LiDAR data processing in general. libLAS a building block for developers to
use to implement their own LiDAR data processing when working with ASPRS LAS
data.
+.. seealso::
+ :ref:`lastools_liblas` provides a comparison and description of the
+ relationship of libLAS to LAStools.
+
libLAS' initial development was supported in 2007-2008 by the `IGSB`_ of the
Iowa DNR for use in its state-wide `LIDAR`_ project.
-.. seealso::
More information about the Liblas-commits
mailing list