Opened 16 months ago

Closed 16 months ago

Last modified 16 months ago

#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 robe, 16 months ago

Component: postgisdocumentation
Owner: changed from pramsey to strk

comment:2 by robe, 16 months ago

Summary: Have chunked translations and non-chunked englishHave chunked translations generated as part of debbie's runs

comment:3 by Sandro Santilli <strk@…>, 16 months ago

In b3ccbe14/git:

Add chunked-html-localized rule

References #5429

comment:4 by strk, 16 months ago

See the html-reorg branch for further improvement (language suffix, shared images)

comment:5 by strk, 16 months ago

I suggest we change directory structure to something like:

Is that acceptable to you Regina ?

comment:6 by Sandro Santilli <strk@…>, 16 months ago

In 578f3f9/git:

Reorganize html targets

  • Non-chunked will be html/postgis-<lang>.html
  • Chunked will be under html/postgis-<lang>/
  • Chunked web will be under html/postgis-web-<lang>/
  • Chunked web mobile will be under html/postgis-web-mobile-<lang>/
  • Images (all shared) will be under html/images
  • HTML install will honour --htmldir configure switch
  • Add html-assets-install and html-assets-uninstall targets

References #5429
References #5430

comment:7 by Sandro Santilli <strk@…>, 16 months ago

In 9c50cb9/git:

Fix assumping in debbie's release_docs script, and add some questions

References #5429

comment:8 by strk, 16 months ago

Chunked localized are now generated:

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 strk, 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 strk, 16 months ago

Resolution: fixed
Status: newclosed

comment:11 by robe, 16 months ago

Milestone: PostGIS 3.5.0PostGIS 3.4.0
Note: See TracTickets for help on using tickets.