Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1j1bP0-0000d4-N6 for pgsql-docs@arkaria.postgresql.org; Tue, 11 Feb 2020 19:40:59 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.89) (envelope-from ) id 1j1bOy-0005Ku-Lw for pgsql-docs@arkaria.postgresql.org; Tue, 11 Feb 2020 19:40:56 +0000 Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29]) by malur.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1j1bOy-0005Kn-7B for pgsql-docs@lists.postgresql.org; Tue, 11 Feb 2020 19:40:56 +0000 Received: from meldrar.postgresql.org ([2a02:c0:301:0:ffff::31]) by magus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.92) (envelope-from ) id 1j1bOu-000199-HX for pgsql-docs@lists.postgresql.org; Tue, 11 Feb 2020 19:40:55 +0000 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=postgresql.org; s=20171124; h=Content-Type:In-Reply-To:MIME-Version:Date: Message-ID:From:References:Cc:To:Subject:Sender:Reply-To: Content-Transfer-Encoding:Content-ID:Content-Description; bh=AKvtWbx0yQtpD6gO33+ft1VdeUQsrZARAtcSTn/cBkc=; b=Y4SrMRib6CgzwfkvoOOlziwZa2 DVtr4P9m9ci5KVBSpE4+htkzZ+G/VCIEK+MTlrBPHBCxO0VL7ev0kxMtkbEbGirh4jrmEcw0sKZXf jPxeGRCPHlk+xzC5iWMEP7bHWQm2I98walI+j1J+GMFbG+9ZL54abKMj7jM5A7Uj2XvjPi3knklRh BA6akBbfg0CPnffQef868p78nXnkVQKAXdaoeP2Z8J/Sg/FEliZq704L65oOP9NeM7dXb+NdP1HSw PmvF2Xd5v7UwWq9yRKVkiPEVXcEoOG/GD01KUBEY10TpB2MRoq1gmmxE2w4+epfYSNMyjHWL4cZTk 6sczNavg==; Received: from [63.118.15.50] (helo=Ph33rHippo.local) by meldrar.postgresql.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1j1bOp-00089I-Rr; Tue, 11 Feb 2020 19:40:51 +0000 Subject: Re: Duplicating website's formatting in local doc builds To: Tom Lane Cc: pgsql-docs@lists.postgresql.org References: <1375.1581446233@sss.pgh.pa.us> <3873.1581449531@sss.pgh.pa.us> From: "Jonathan S. Katz" Autocrypt: addr=jkatz@postgresql.org; keydata= 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 FmEC Message-ID: <4b44c4ec-a678-6586-fbb0-efc3299af203@postgresql.org> Date: Tue, 11 Feb 2020 14:40:44 -0500 User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:68.0) Gecko/20100101 Thunderbird/68.4.2 MIME-Version: 1.0 In-Reply-To: <3873.1581449531@sss.pgh.pa.us> Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="cLJGbSMbaZYQzuzq19Fer1270KwjZnHo8" X-Host-Lookup-Failed: Reverse DNS lookup failed for 63.118.15.50 (failed) List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Precedence: bulk This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --cLJGbSMbaZYQzuzq19Fer1270KwjZnHo8 Content-Type: multipart/mixed; boundary="bNAe8tSgRGBEC0FYbXqn8hQPZKm96noa3" --bNAe8tSgRGBEC0FYbXqn8hQPZKm96noa3 Content-Type: multipart/mixed; boundary="------------D490F6DD7A25339669C8F8C6" Content-Language: en-US This is a multi-part message in MIME format. --------------D490F6DD7A25339669C8F8C6 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable On 2/11/20 2:32 PM, Tom Lane wrote: > "Jonathan S. Katz" writes: >> On 2/11/20 1:37 PM, Tom Lane wrote: >>> I also wonder why duplicating the website's style isn't the default. >>> Doesn't seem like having authors optimize for some other style is >>> what we really want. >=20 >> Oh, and specifically for this, my guess is because it requires one to >> make a call over a network to load the stylesheet. :) >=20 > Surely we could provide directions about how to store that locally. I have a little doubt about that, but per mention in the original email, it means storing a lot more stylesheets and ones that may change with more frequency than the project. It may not be too much of an issue, but I do want to note that. I'm somewhat ambivalent myself, but my preference is to have the single source of truth. Anyway, attached is a first attempt at a patch. I tried a few different variations but in my quick review of it, I could not figure out how to make a XSLT respect having multiple stylesheets (likely due to my lack of familiarity with XSLT). This just swaps out the link. A better approach would be to find a way to include multiple CSS stylesheets. After searching over a bunch of different terms, I could not figure out how to get to this result, but as mentioned, I'm close to clueless on writing XSLT at this point. Another way we could get to the desired result add something to pgweb similar to the old "docs.css" that is being referenced that combines the multiple stylesheets into one. It's a bit of an anti-pattern in modern web, so I'm not thrilled to go down that route. Jonathan --------------D490F6DD7A25339669C8F8C6 Content-Type: text/plain; charset=UTF-8; x-mac-type="0"; x-mac-creator="0"; name="website-formatted-docs.patch" Content-Transfer-Encoding: base64 Content-Disposition: attachment; filename="website-formatted-docs.patch" ZGlmZiAtLWdpdCBhL2RvYy9zcmMvc2dtbC9zdHlsZXNoZWV0LnhzbCBiL2RvYy9zcmMvc2dt bC9zdHlsZXNoZWV0LnhzbAppbmRleCA0ZmY2ZThlZDI0Li4zODQzNDM2N2YxIDEwMDY0NAot LS0gYS9kb2Mvc3JjL3NnbWwvc3R5bGVzaGVldC54c2wKKysrIGIvZG9jL3NyYy9zZ21sL3N0 eWxlc2hlZXQueHNsCkBAIC0yMyw3ICsyMyw3IEBACiA8eHNsOnBhcmFtIG5hbWU9Imh0bWwu c3R5bGVzaGVldCI+CiAgIDx4c2w6Y2hvb3NlPgogICAgIDx4c2w6d2hlbiB0ZXN0PSIkd2Vi c2l0ZS5zdHlsZXNoZWV0ID0gMCI+c3R5bGVzaGVldC5jc3M8L3hzbDp3aGVuPgotICAgIDx4 c2w6b3RoZXJ3aXNlPmh0dHBzOi8vd3d3LnBvc3RncmVzcWwub3JnL21lZGlhL2Nzcy9kb2Nz LmNzczwveHNsOm90aGVyd2lzZT4KKyAgICA8eHNsOm90aGVyd2lzZT5odHRwczovL3d3dy5w b3N0Z3Jlc3FsLm9yZy9tZWRpYS9jc3MvYmFzZS5jc3M8L3hzbDpvdGhlcndpc2U+CiAgIDwv eHNsOmNob29zZT4KIDwveHNsOnBhcmFtPgogCg== --------------D490F6DD7A25339669C8F8C6-- --bNAe8tSgRGBEC0FYbXqn8hQPZKm96noa3-- --cLJGbSMbaZYQzuzq19Fer1270KwjZnHo8 Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAEBCAAdFiEE+oS2la8r95ogZD/x8QSccp8cZScFAl5DAzwACgkQ8QSccp8c ZSdnRhAAq8o9iATfCgIgJzI5mxkJBe8NA0ybMuytTruhlN6HT/RwA09uM3m+wVNl +8LZtDEzJl4CoTd3+WIL9ehgMN40HxZClEWvefubsMbM9qpV35EPfexuT3NO351J kYbAV8hzA8Qsj0foAVj1ifPDg/Yez9cvqvjgb9HVT5nN6yVqhcdMxhiwVj/LfddK p0iGT8QvbuORztpuLJu6WwknA3+D+OC0r/3jsTtP45q0jHVaLUjEZxnW+2uHovYC cJXl9MUmI4AftNDOYWdyojqgAsX6soNTYx0xMiDpyln279llCSaXV9Rn6sLlx5lq J+XWI/wnjJqiAYn5SmXK/SVrQoKOtXBHVBIVfkfUiBx7vm3Vm0owDxxbJMoVQ9kN mubMdppMgIq0Zu5nlu6zOkfCO7V6ZQgs3s9g96urkYWtm8CT3YsrL6IJMrAUmesS Zfq8Pc36qvCXAMkxrB3OXBfD0OrM3tFNw12U5lmG6FlRUedA/rjC2LuC9yRjbdqL LzoAc5wbdYbUyLCDoTE9hbdw9WpTlzWlvMNSKne/MqGe7bz5F6O0RYwQch9seu7Y LeCta9Prodvc9LToc+hqRMFSU9Gao8GAL0OlCDGmd2l3nBb87pq4NeXOUdanjdUy 8441rGZQoZR7iQbyPmId7psfUqqIAszi7hF0qKmFg91vzrIx4T4= =fwut -----END PGP SIGNATURE----- --cLJGbSMbaZYQzuzq19Fer1270KwjZnHo8--