Thread: Rsync access to https://www.postgresql.org/docs/ ?

Rsync access to https://www.postgresql.org/docs/ ?

From
hubert depesz lubaczewski
Date:
Hi,
would it be possible to get access to whole docs site, for all versions,
via rsync? I'd like have a copy of docs for my grepping purposes, and
would like to refresh it every so often, but preferably without need to
redownload the whole thing whenever new releases happen.

Best regards,

depesz




Re: Rsync access to https://www.postgresql.org/docs/ ?

From
Dave Page
Date:
Hi

On Thu, 22 Aug 2024 at 08:58, hubert depesz lubaczewski <depesz@depesz.com> wrote:
Hi,
would it be possible to get access to whole docs site, for all versions,
via rsync? I'd like have a copy of docs for my grepping purposes, and
would like to refresh it every so often, but preferably without need to
redownload the whole thing whenever new releases happen.

/docs/** is dynamically generated, so there are no doc files (except the PDFs) to share via rsync.

You can get the PDFs here if you want them (via git not rsync of course, but that shouldn't matter much): https://github.com/postgres/pgweb-static/tree/master/documentation/pdf

--
Dave Page
PostgreSQL: https://www.postgresql.org

PGDay UK 2024, 11th September, London: https://2024.pgday.uk/

Re: Rsync access to https://www.postgresql.org/docs/ ?

From
Alvaro Herrera
Date:
On 2024-Aug-22, Dave Page wrote:

> On Thu, 22 Aug 2024 at 08:58, hubert depesz lubaczewski <depesz@depesz.com>
> wrote:
> 
> > would it be possible to get access to whole docs site, for all versions,
> > via rsync? I'd like have a copy of docs for my grepping purposes, and
> > would like to refresh it every so often, but preferably without need to
> > redownload the whole thing whenever new releases happen.
> 
> /docs/** is dynamically generated, so there are no doc files (except the
> PDFs) to share via rsync.

It's probably easier to generate the HTML yourself.  These days, the
installation required is very simple on most standard Linux distros (not
talking about gentoo, arch, etc).

-- 
Álvaro Herrera               48°01'N 7°57'E  —  https://www.EnterpriseDB.com/



Re: Rsync access to https://www.postgresql.org/docs/ ?

From
Magnus Hagander
Date:
On Thu, Aug 22, 2024 at 6:11 PM Alvaro Herrera <alvherre@alvh.no-ip.org> wrote:
On 2024-Aug-22, Dave Page wrote:

> On Thu, 22 Aug 2024 at 08:58, hubert depesz lubaczewski <depesz@depesz.com>
> wrote:
>
> > would it be possible to get access to whole docs site, for all versions,
> > via rsync? I'd like have a copy of docs for my grepping purposes, and
> > would like to refresh it every so often, but preferably without need to
> > redownload the whole thing whenever new releases happen.
>
> /docs/** is dynamically generated, so there are no doc files (except the
> PDFs) to share via rsync.

It's probably easier to generate the HTML yourself.  These days, the
installation required is very simple on most standard Linux distros (not
talking about gentoo, arch, etc).


Even easier, if you're just looking for released versions, they are included in release tarballs...

--

Re: Rsync access to https://www.postgresql.org/docs/ ?

From
hubert depesz lubaczewski
Date:
On Thu, Aug 22, 2024 at 12:10:57PM -0400, Alvaro Herrera wrote:
> It's probably easier to generate the HTML yourself.  These days, the
> installation required is very simple on most standard Linux distros (not
> talking about gentoo, arch, etc).

Will get to this, but I was under impression that docs built, or
distributed in dist, are somehow different from the ones on
www.psotgresql.org, perhaps it's jus styling issue.

depesz



Re: Rsync access to https://www.postgresql.org/docs/ ?

From
Dave Page
Date:


On Sat, 24 Aug 2024 at 09:24, hubert depesz lubaczewski <depesz@depesz.com> wrote:
On Thu, Aug 22, 2024 at 12:10:57PM -0400, Alvaro Herrera wrote:
> It's probably easier to generate the HTML yourself.  These days, the
> installation required is very simple on most standard Linux distros (not
> talking about gentoo, arch, etc).

Will get to this, but I was under impression that docs built, or
distributed in dist, are somehow different from the ones on
www.psotgresql.org, perhaps it's jus styling issue.

depesz
It is just styling. 

Re: Rsync access to https://www.postgresql.org/docs/ ?

From
Alvaro Herrera
Date:
On 2024-Aug-24, hubert depesz lubaczewski wrote:

> On Thu, Aug 22, 2024 at 12:10:57PM -0400, Alvaro Herrera wrote:
> > It's probably easier to generate the HTML yourself.  These days, the
> > installation required is very simple on most standard Linux distros (not
> > talking about gentoo, arch, etc).
> 
> Will get to this, but I was under impression that docs built, or
> distributed in dist, are somehow different from the ones on
> www.psotgresql.org, perhaps it's jus styling issue.

You can build with the website styling too, if you want -- this command
does the trick:
  make html STYLE=website

Cheers

-- 
Álvaro Herrera               48°01'N 7°57'E  —  https://www.EnterpriseDB.com/