#5429 closed defect (fixed)
Have chunked translations generated as part of debbie's runs
Reported by: | robe | Owned by: | strk |
---|---|---|---|
Priority: | medium | Milestone: | PostGIS 3.4.0 |
Component: | documentation | Version: | 3.3.x |
Keywords: | Cc: |
Description
Right now we create a chunked version of our english and (no single page for english)
We do the opposite for translations - we have a single for translations and no chunked version.
e.g this doesn't exist https://postgis.net/docs/manual-3.4/postgis-en.html this does https://postgis.net/docs/manual-3.4/postgis-ja.html
and our https://postgis.net/docs/manual-3.4 https://postgis.net/docs/
points at the english version.
The main issue I have wit this, is it's harder for people to reference pages in the non-chunked
e.g.
our workshop docs reference the manual a lot
https://postgis.net/workshops
so hard for translators to point at a non-english version when these are referenced.
the japanese have their own chunked I'm guessing for this reason that they point to in the docs https://postgis.net/workshops/ja/postgis-intro/
It's also been asked for in the past, which we've simply ignored these requests.
Change History (11)
comment:1 by , 16 months ago
Component: | postgis → documentation |
---|---|
Owner: | changed from | to
comment:2 by , 16 months ago
Summary: | Have chunked translations and non-chunked english → Have chunked translations generated as part of debbie's runs |
---|
comment:3 by , 16 months ago
comment:4 by , 16 months ago
See the html-reorg branch for further improvement (language suffix, shared images)
comment:5 by , 16 months ago
I suggest we change directory structure to something like:
- https://postgis.net/docs/manual-3.4/postgis-en.html # non-chunked
- https://postgis.net/docs/manual-3.4/postgis-en/ # chunked
- https://postgis.net/docs/manual-3.4/images/ # shared images
- https://postgis.net/docs/manual-3.4/style.css # shared asset
Is that acceptable to you Regina ?
comment:8 by , 16 months ago
Chunked localized are now generated:
- https://postgis.net/docs/manual-3.4/postgis-web-fr/
- https://postgis.net/docs/manual-3.4/postgis-web-en/
The -web- snippet is because among the available rules we're using the "web" one (chunked-web-html). The current install target keeps them separated (postgis-web-mobile is another prefix). I guess I could have the debbie script rename those directory to strip the "postgis-web-" out and just leave the language.
Then we will probably want a top-level redirect to have existing links still work by redirecting to the en/ subdir ?
comment:9 by , 16 months ago
I've pushed [802a18a7b4ffdd424d8d1376f6ca89e0d39b63d7/git] to do the renaming but after looking maybe we can just configure nginx to crawl into the appropriate subdir, as it seems to be done already for other things (versioned docs for example)
comment:10 by , 16 months ago
Resolution: | → fixed |
---|---|
Status: | new → closed |
comment:11 by , 16 months ago
Milestone: | PostGIS 3.5.0 → PostGIS 3.4.0 |
---|
In b3ccbe14/git: