[gdal-dev] Doc: driver + config options summary pages [was Re: How to know which formats allow editing with ogrinfo?]

Even Rouault even.rouault at spatialys.com
Sat Nov 16 09:50:47 PST 2019


> The summary table will need some styling.
> At the moment I only see the short and and long name columns.
> *If* I scroll down to the bottom, then I get a horizontal scroll bar
> and can scroll to see that there are more columns.
> 
> I get this with Firefox and Opera on Linux and Firefox and IE11 on Win7
> (yes I need to get a newer windows virtual machine).

Hum, displays correctly for me on
- Linux, Firefox 70.0.1
- Linux, Chromium 78.0.3904.97
- W10, Edge 44.18362.449.0
with browser in full width.

If I reduce the width, I also have the scroll bar.

The table is created there:
https://github.com/OSGeo/gdal/blob/master/gdal/doc/source/build_driver_summary.py#L67

and that generates the following HTML:
<colgroup>
<col style="width: 10%" />
<col style="width: 35%" />
<col style="width: 10%" />
<col style="width: 10%" />
<col style="width: 10%" />
<col style="width: 25%" />
</colgroup>

We'd probably need help from a Sphinx and/or CSS expert to improve that...
But if the width is too small, reducing the column width could make things unreadable,
so having at least the short and long name in reduced page width seems a
reasonable fallback behaviour.

-- 
Spatialys - Geospatial professional services
http://www.spatialys.com


More information about the gdal-dev mailing list