BUG #14921: searchable docs

Started by Pieter van den Homberghover 8 years ago6 messagesbugs
Jump to latest
#1Pieter van den Hombergh
pieter.van.den.hombergh@gmail.com

The following bug has been logged on the website:

Bug reference: 14921
Logged by: Pieter van den Hombergh
Email address: pieter.van.den.hombergh@gmail.com
PostgreSQL version: 10.1
Operating system: linux
Description:

In our university, postgres is the db of choice. Our data base exams have a
postgres instance plus doc on a live usb stick. It would be a nice service
to the students if we could add searchable docs instead of just the static
html docs during the exams.

Is it possible to get an installable and searcheable doc version, such as
you provide on your website?

#2John R Pierce
pierce@hogranch.com
In reply to: Pieter van den Hombergh (#1)
Re: BUG #14921: searchable docs

On 11/23/2017 7:05 AM, pieter.van.den.hombergh@gmail.com wrote:

In our university, postgres is the db of choice. Our data base exams have a
postgres instance plus doc on a live usb stick. It would be a nice service
to the students if we could add searchable docs instead of just the static
html docs during the exams.

Is it possible to get an installable and searcheable doc version, such as
you provide on your website?

A) this isn't a big

B) that would require a web server and search engine be distributed too,
and if the host is already running a webserver, somehow integrating it,
very OS distribution specific.

--
john r pierce, recycling bits in santa cruz

#3John McKown
john.archie.mckown@gmail.com
In reply to: John R Pierce (#2)
Re: BUG #14921: searchable docs

On Thu, Nov 23, 2017 at 9:13 AM, John R Pierce <pierce@hogranch.com> wrote:

On 11/23/2017 7:05 AM, pieter.van.den.hombergh@gmail.com wrote:

In our university, postgres is the db of choice. Our data base exams have
a
postgres instance plus doc on a live usb stick. It would be a nice service
to the students if we could add searchable docs instead of just the static
html docs during the exams.

Is it possible to get an installable and searcheable doc version, such as
you provide on your website?

A) this isn't a big

B) that would require a web server and search engine be distributed too,
and if the host is already running a webserver, somehow integrating it,
very OS distribution specific.

--
john r pierce, recycling bits in santa cruz

​Probably a stupid thought on my part, but would it be possible to load the
documentation into a PostgreSQL data base and use "full text search" on it?
I've only read a very little on this feature, so I'm very ignorant on what
it can do.​

--
I have a theory that it's impossible to prove anything, but I can't prove
it.

Maranatha! <><
John McKown

#4Alvaro Herrera
alvherre@2ndquadrant.com
In reply to: John McKown (#3)
Re: BUG #14921: searchable docs

John McKown wrote:

Probably a stupid thought on my part, but would it be possible to load the
documentation into a PostgreSQL data base and use "full text search" on it?

That's what our website does, AFAIK.

--
�lvaro Herrera https://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services

#5Erik Rijkers
er@xs4all.nl
In reply to: Pieter van den Hombergh (#1)
Re: BUG #14921: searchable docs

On 2017-11-23 16:05, pieter.van.den.hombergh@gmail.com wrote:

In our university, postgres is the db of choice. Our data base exams
have a
postgres instance plus doc on a live usb stick. It would be a nice
service
to the students if we could add searchable docs instead of just the
static
html docs during the exams.

Is it possible to get an installable and searcheable doc version, such
as
you provide on your website?

You could either use the one of pdfs, provided on the website at:
https://www.postgresql.org/docs/manuals/

Or, if you have the wherewithal to compile docs yourself
there is the option to compile into a single file
by doing, inside doc/src/sgml:

make postgres.html

This yields a single 14 MB file: postgres.html

Perhaps the project can make this file available?
( perhaps it is available already? )

Erik Rijkers

#6Pieter van den Hombergh
pieter.van.den.hombergh@gmail.com
In reply to: Erik Rijkers (#5)
Re: BUG #14921: searchable docs

Thanks! This is a good pointer to the doc source.

Op do 23 nov. 2017 17:28 schreef Erik Rijkers <er@xs4all.nl>:

Show quoted text

On 2017-11-23 16:05, pieter.van.den.hombergh@gmail.com wrote:

In our university, postgres is the db of choice. Our data base exams
have a
postgres instance plus doc on a live usb stick. It would be a nice
service
to the students if we could add searchable docs instead of just the
static
html docs during the exams.

Is it possible to get an installable and searcheable doc version, such
as
you provide on your website?

You could either use the one of pdfs, provided on the website at:
https://www.postgresql.org/docs/manuals/

Or, if you have the wherewithal to compile docs yourself
there is the option to compile into a single file
by doing, inside doc/src/sgml:

make postgres.html

This yields a single 14 MB file: postgres.html

Perhaps the project can make this file available?
( perhaps it is available already? )

Erik Rijkers