Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Experimental] Try out Astro docs deployment #41279

Draft
wants to merge 2 commits into
base: gh-pages
Choose a base branch
from

Conversation

julien-deramond
Copy link
Member

@julien-deramond julien-deramond commented Mar 8, 2025

Description

This experimental PR gathers the gh-pages possible deployment of Astro docs migration PR.

First of all, the generated website is created by running npm run astro-build from #41251 (done on the 8th of March). It created a _site directory like it's already the case in our main branch.

Then, likely how we're already doing the gh-pages update:

npm run astro-build
mv \_site /tmp/
git checkout gh-pages
git checkout -b gh-pages-jd-docs-astro

mv /tmp/_site/404.html .
mv /tmp/_site/CNAME .
mv /tmp/_site/apple-touch-icon.png .
mv /tmp/_site/favicon.ico .
mv /tmp/_site/index.html .
mv /tmp/_site/robots.txt .
mv /tmp/_site/sitemap-0.xml .
mv /tmp/_site/sitemap-index.xml .
mv /tmp/_site/sw.js .
mv /tmp/_site/_astro .
rm -rf about ; mv /tmp/_site/about .
rm -rf components ; mv /tmp/_site/components .
rm -rf docsref ; mv /tmp/_site/docsref .
rm -rf examples ; mv /tmp/_site/examples .
rm -rf getting-started ; mv /tmp/_site/getting-started .
rm -rf migration ; mv /tmp/_site/migration .
rm -rf docs/getting-started ; mv /tmp/_site/docs/getting-started docs/
rm -rf docs/versions ; mv /tmp/_site/docs/versions docs/
mv /tmp/_site/docs/index.html docs/index.html
rm -rf docs/5.3 ; mv /tmp/_site/docs/5.3 docs/

Then, you can checkout this branch locally and run http-serve for instance.

Impacts analysis

  • mv /tmp/_site/docs/5.3 docs/ copy a useless site directory that shouldn't be there (see 3cb7611)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant