Re: [gdal-dev] Building GDAL documentation with ReadTheDocs

> From what I see, robots.txt is automatically configured for the default > version: > https://docs.readthedocs.io/en/stable/reference/robots.html I read this as saying that the robots.txt published by the default branch will be served from the top level of the domain (https://proj.org/robots.txt

Re: [gdal-dev] Building GDAL documentation with ReadTheDocs

Interesting report from "google search console" I got today. This is just one example, there are many pages like this one: Page is not indexed: Duplicate without user-selected canonical URL: https://proj.org/en/stable/operations/projections/putp6.html (This page is not indexed. Pages that aren't i

Re: [gdal-dev] Building GDAL documentation with ReadTheDocs

On Wed, 24 Jul 2024 at 22:34, Javier Jimenez Shaw via gdal-dev wrote: > Maybe the solution is that proj.org default be "stable" and not "9.4". The reason why PROJ's RTD is configured this way is that "stable" is set at one commit (currently 875a485f) for the most recent release, as described by h

Re: [gdal-dev] Building GDAL documentation with ReadTheDocs

Thanks, Rob. I've added a robots.txt to the PR (using /en/latest/, since /en/stable/ is not yet published) Dan On Wed, Jul 24, 2024 at 7:44 AM Robert Coup via gdal-dev wrote: > > On Wed, 24 Jul 2024 at 12:27, Even Rouault wrote: > > > > > > Le 24/07/2024 à 12:33, Javier Jimenez Shaw via gdal-de

Re: [gdal-dev] Building GDAL documentation with ReadTheDocs

On Wed, 24 Jul 2024 at 12:27, Even Rouault wrote: > > > Le 24/07/2024 à 12:33, Javier Jimenez Shaw via gdal-dev a écrit : > >> I see the point, and I agree... but I don't know if it will work >> RTD redirects to whatever we configure. In proj.org it is going directly to 9.4 (current latest release

Re: [gdal-dev] Building GDAL documentation with ReadTheDocs

Le 24/07/2024 à 12:33, Javier Jimenez Shaw via gdal-dev a écrit : I see the point, and I agree... but I don't know if it will work RTD redirects to whatever we configure. In proj.org it is going directly to 9.4 (current latest release). Seems like a good idea and something t

Re: [gdal-dev] Building GDAL documentation with ReadTheDocs

I see the point, and I agree... but I don't know if it will work RTD redirects to whatever we configure. In proj.org it is going directly to 9.4 (current latest release). So every 6 months it points to something different. Telling in robots.txt that the full page has a different URL is not good for

Re: [gdal-dev] Building GDAL documentation with ReadTheDocs

Hi Dan, On Tue, 23 Jul 2024 at 17:16, Daniel Baston via gdal-dev < gdal-dev@lists.osgeo.org> wrote: > > If anyone has feedback about using ReadTheDocs for this project, or > the specifics of the proposed configuration, please share it here or > as a comment on the pull request. > My only suggest

Re: [gdal-dev] Building GDAL documentation with ReadTheDocs

> Could a random user easily check > out the docs repo and (with 100% open source tooling) generate the > docs? Yes, we are currently and would continue to use Sphinx for the documentation build. Dan On Tue, Jul 23, 2024 at 1:18 PM Greg Troxel via gdal-dev wrote: > > Daniel Baston via gdal-de

Re: [gdal-dev] Building GDAL documentation with ReadTheDocs

Le 23/07/2024 à 19:18, Greg Troxel via gdal-dev a écrit : Daniel Baston via gdal-dev writes: Hello, I've put together a configuration to build GDAL's documentation using ReadTheDocs. As far as I know, this is the simplest way of publishing version-specific documentation and rending documenta

Re: [gdal-dev] Building GDAL documentation with ReadTheDocs

This is wildly important for systems without internet access. On 7/23/24 10:18, Greg Troxel via gdal-dev wrote: In my view, docs should be part of a package build and installed so they are available on the computer with the software. ___ gdal-dev mail

Re: [gdal-dev] Building GDAL documentation with ReadTheDocs

Daniel Baston via gdal-dev writes: > Hello, > > I've put together a configuration to build GDAL's documentation using > ReadTheDocs. As far as I know, this is the simplest way of publishing > version-specific documentation and rending documentation for pull > requests. A current build of the docu

[gdal-dev] Building GDAL documentation with ReadTheDocs

Hello, I've put together a configuration to build GDAL's documentation using ReadTheDocs. As far as I know, this is the simplest way of publishing version-specific documentation and rending documentation for pull requests. A current build of the documentation can be viewed at https://gdal.readthed