CI: Render XHTML chunked manual

[cmb69]

The rendered XHTML chunked manual is provided as artifact.

---

I think this is useful for those who don't have a full doc build environment set up, but it slows down CI considerably, and it's still not possible to view the docs online. Maybe we could push to GH pages or something, and the full workflow should only be run when manually triggered?

Thoughts welcome!

[saundefined]

Deploing preview on GH-pages (or similar) sounds great (example) 🎉

But maybe enable it only for PRs,
and for commits add action just to trigger build-docs-lang-rsync (or keep it on cron)?

[saundefined]

I just tested the deployment from PR to Netlify (saundefined/doc-ru#1) and the preview build (https://1--php-doc-ru-test.netlify.app/) looks good, but the build workflow runs ~25 mins =(

[cmb69]

I assume the problem is that the large amount of files are uploaded one by one; would it be possible to upload an archive (tarball or zip) and to have it unpacked there?

[saundefined]

Done 🎉

I haven't found a way to deploy the archive and use branching at the same time.
I wrote a small script that bypasses this limitation.

Full workflow is now ~1.5 minutes + Netlify processes the archive for another 1-1.5 minutes

[afilina]

Suggestion from PR #1608 (comment)

Or provide a dockerized build command. Then you have 1 requirement that almost any developer will have installed or can easily install.

If this is a direction that we're willing to take, I'd be happy to do it. I was actually thinking about it this week when I saw how complicated the setup is for a first-time contributor.

[cmb69]

If this is a direction that we're willing to take, I'd be happy to do it.

Feel free to go ahead. :)