diff options
| author | Andres Freund <andres@anarazel.de> | 2023-04-04 21:31:27 -0700 |
|---|---|---|
| committer | Andres Freund <andres@anarazel.de> | 2023-04-04 21:31:27 -0700 |
| commit | 9d2a464a04846961ffa6b5f2c25b68bc2bf0af67 (patch) | |
| tree | 737a9d7eae4ed65ed5981e924be9c32504bc9170 | |
| parent | b8059bdf1ef8f7e215ec5010fcf6c3bd9c491eef (diff) | |
| download | postgresql-9d2a464a04846961ffa6b5f2c25b68bc2bf0af67.tar.gz postgresql-9d2a464a04846961ffa6b5f2c25b68bc2bf0af67.zip | |
meson: docs: Allow configuring simple/website style
The meson docs generation hardcoded using the website style so far. Make it
configurable via a meson option.
Reviewed-by: Justin Pryzby <pryzby@telsasoft.com>
Reported-by: Peter Eisentraut <peter.eisentraut@enterprisedb.com>
Discussion: https://postgr.es/m/3fc3bb9b-f7f8-d442-35c1-ec82280c564a@enterprisedb.com
| -rw-r--r-- | doc/src/sgml/installation.sgml | 12 | ||||
| -rw-r--r-- | doc/src/sgml/meson.build | 7 | ||||
| -rw-r--r-- | meson_options.txt | 3 |
3 files changed, 19 insertions, 3 deletions
diff --git a/doc/src/sgml/installation.sgml b/doc/src/sgml/installation.sgml index 0191add0301..f451204854c 100644 --- a/doc/src/sgml/installation.sgml +++ b/doc/src/sgml/installation.sgml @@ -2923,6 +2923,18 @@ ninja install </listitem> </varlistentry> + <varlistentry id="configure-docs-html-style"> + <term><option>-Ddocs_html_style={ simple | website }</option></term> + <listitem> + <para> + Controls which <acronym>CSS</acronym> stylesheet is used. The default + is <literal>simple</literal>. If set to <literal>website</literal>, + the HTML documentation will reference the stylesheet for <ulink + url="https://www.postgresql.org/docs/current/">postgresql.org</ulink>. + </para> + </listitem> + </varlistentry> + </variablelist> </sect3> diff --git a/doc/src/sgml/meson.build b/doc/src/sgml/meson.build index 539865da8d9..c6d77b5a150 100644 --- a/doc/src/sgml/meson.build +++ b/doc/src/sgml/meson.build @@ -103,9 +103,10 @@ if xsltproc_bin.found() '--tool', xsltproc_bin, '--', ] - xsltproc_html_flags = xsltproc_flags + [ - '--param', 'website.stylesheet', '1' - ] + xsltproc_html_flags = xsltproc_flags + if get_option('docs_html_style') == 'website' + xsltproc_html_flags += ['--param', 'website.stylesheet', '1'] + endif endif diff --git a/meson_options.txt b/meson_options.txt index c203dcce6fe..5b44a8829d3 100644 --- a/meson_options.txt +++ b/meson_options.txt @@ -85,6 +85,9 @@ option('docs', type : 'feature', value: 'auto', option('docs_pdf', type : 'feature', value: 'auto', description: 'documentation in PDF format') +option('docs_html_style', type : 'combo', choices: ['simple', 'website'], + description: 'CSS stylesheet for HTML documentation') + option('dtrace', type : 'feature', value: 'disabled', description: 'DTrace support') |