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

feat(core): support an offline mode build - SSG solution #9857

Closed
wants to merge 1 commit into from

Conversation

slorber
Copy link
Collaborator

@slorber slorber commented Feb 16, 2024

Motivation

WIP/POC attempt to solve #3825 and make a Docusaurus build usable without a server, distributed as a docs.zip file for example.

This attempt assumes we want to generate a static file for each page.
See possible solutions/alternatives here:
#3825 (comment)

Note, in practice it's going to be complicated to use that approach, because:

Test Plan

???

Test links

https://deploy-preview-9857--docusaurus-2.netlify.app/

@facebook-github-bot facebook-github-bot added the CLA Signed Signed Facebook CLA label Feb 16, 2024
Copy link

netlify bot commented Feb 16, 2024

[V2]

Name Link
🔨 Latest commit d0e61e8
🔍 Latest deploy log https://app.netlify.com/sites/docusaurus-2/deploys/65cf87179bfccd00088bb3e4
😎 Deploy Preview https://deploy-preview-9857--docusaurus-2.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

Copy link

⚡️ Lighthouse report for the deploy preview of this PR

URL Performance Accessibility Best Practices SEO PWA Report
/ 🟢 94 🟢 98 🟢 96 🟢 100 🟠 88 Report
/docs/installation 🟠 68 🟢 96 🟢 100 🟢 100 🟠 88 Report
/docs/category/getting-started 🟠 74 🟢 100 🟢 100 🟢 90 🟠 88 Report
/blog 🟠 69 🟢 100 🟢 100 🟢 90 🟠 88 Report
/blog/preparing-your-site-for-docusaurus-v3 🟠 63 🟢 96 🟢 100 🟢 100 🟠 88 Report
/blog/tags/release 🟠 70 🟢 100 🟢 100 🟠 80 🟠 88 Report
/blog/tags 🟠 74 🟢 100 🟢 100 🟢 90 🟠 88 Report

Copy link

Size Change: +70 B (0%)

Total Size: 992 kB

Filename Size Change
website/build/assets/js/main.********.js 765 kB +52 B (0%)
ℹ️ View Unchanged
Filename Size Change
website/.docusaurus/globalData.json 75.4 kB 0 B
website/build/assets/css/styles.********.css 114 kB 0 B
website/build/index.html 38 kB +18 B (0%)

compressed-size-action

@slorber
Copy link
Collaborator Author

slorber commented Feb 22, 2024

For now, let's close this in favor of the Hash Router solution: #9859

That doesn't mean an offline-first SSG approach will never land, but it's more complex to implement so let's focus first on an easier approach that the community likes that will likely solve most offline-first use cases.

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

Successfully merging this pull request may close these issues.

2 participants