Update from code changes: document static export URLs - #6875
Open
mintlify[bot] wants to merge 4 commits into
Open
Update from code changes: document static export URLs#6875mintlify[bot] wants to merge 4 commits into
mintlify[bot] wants to merge 4 commits into
Conversation
Contributor
Author
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
Contributor
Author
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
Contributor
Author
|
Update from code changes updated this PR. Updated wording, translation phrasing, heading consistency, and Chinese SEO metadata Source PRs
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Document the
.htmlURLs emitted by static export bundles so they work on hosts without extensionless rewrites.Changes
.htmldestinations for built-in internal navigation, including version and language switchers, search results, cards, assistant citations, and API playground links.Context
This documents the static export URL changes in mintlify/mint#9840 and the follow-up imperative navigation fix in mintlify/mint#9842.
Note
Low Risk
Documentation-only changes to static export overview pages; no application or API code.
Overview
Documents how static export bundles expose pages as explicit
.htmlURLs (e.g./guides/getting-started.html,/index.html) so self-hosters know what to expect when uploading to S3 or plain static hosting without extensionless rewrites.Adds a Page URLs in static bundles section (with anchor
page-urls-in-static-bundlesin localized pages) to the English, Spanish, French, and Chineseapi/static-export/overviewpages. The new copy explains that the Static Export API turns this on automatically, contrasts CloudFront (client nav/prefetch preserved) with file-only hosts (full-page.htmllinks), and notes that canonical/sitemap and optional client nav URLs can stay extensionless—with a caveat that file-only hosts may need rewrites.The Chinese overview also extends the frontmatter description with S3/CDN/static hosting context.
The localized overviews now also explain that built-in internal navigation uses
.htmldestinations and preserves query strings.Reviewed by Cursor Bugbot for commit ac1abc1. Bugbot is set up for automated code reviews on this repo. Configure here.
Update history
Note
Low Risk
Documentation-only updates to static export overview pages; no application or API code changes.
Overview
Adds a Page URLs in static bundles section to the English, Spanish, French, and Chinese
api/static-export/overviewpages, documenting behavior from recent static-export URL work in the main product.The new copy explains that bundles expose explicit
.htmlpaths (e.g./guides/getting-started.html,/index.html), that the Static Export API enables this without doc config changes, and how CloudFront (client nav/prefetch) differs from plain file hosts (full-page.htmllinks). It also notes that built-in navigation—switchers, search, cards, assistant citations, API playground—targets.htmlURLs while preserving query strings, and that canonical/sitemap URLs can stay extensionless (with a file-host rewrite caveat).Localized pages use anchor
page-urls-in-static-bundles. The Chinese overview extends frontmatterdescriptionwith S3/CDN/static hosting context.Reviewed by Cursor Bugbot for commit 50751fe. Bugbot is set up for automated code reviews on this repo. Configure here.