[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 %}&copy; <a href="{{ path }}">Copyright</a> {{ copyright }}.{% endtrans %}
+      {%- else %}
+        {% trans copyright=copyright|e %}&copy; 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