Comments (8)
Hi @steveklabnik. Yes, like allowing the actual link that is navigated to be different than our default.
e.g.,
permalink: /my/custom/link.html
from docusaurus.
How can one map multiple URLs to the same page? I've tried multiple variations of the permalink syntax trying to get an endpoint like example.com/productA/latest to also map to example.com/productA/1.0.2 but I can't seem to make it work. Looking for this approach as we have multiple products we need to version and each should be discoverable via a /latest page.
Docusaurus is only responsible for building static html files.
It is possible to use our client-side redirect plugin to emit extra files at build/productA/latest/xyz.html
that would redirect with JS to /productA/1.0.2/xyz
, but it is not ideal and you should use your hosting provider features to setup a server redirect (much better for SEO than a client-side redirect).
--
If you do not want a redirect: you can also serve the same content from 2 separate locations.
For example, if you run as a post-build step cp -R build/productA/1.0.2 build/productA/latest
Your pages will then become available at 2 distinct locations: /productA/1.0.2/xyz
+ /productA/latest/xyz
For both pages, the canonical SEO URL of your page will remain /productA/1.0.2/xyz
from docusaurus.
Seems there's a war between Docusaurus and Render.com to complete the redirection so the browser errors, saying:
The only responsibility of Docusaurus is to build static files.
Is Docusaurus producing static files that you do not expect it to produce?
If the static files are ok, then the bug is either in Render or your usage of Render (I can't help much on that, I don't use that host myself)
If you want my help, you will need to provide a built folder with the html files, a live deployment of those html files on render, what you expect, and the problem you see.
If I can't inspect the static files, and see the problem myself, it's very hard to give any help.
from docusaurus.
I got my solution here :) Thanks again for all your help!!
from docusaurus.
What does "permalink" mean in this context? If it's setting the URL that a page is configured at, like I described over here, then a huge 👍 from me.
from docusaurus.
Implemented in v2
Example
---
id: permalink
title: Permalink
permalink: :baseUrl/:docsUrl/:langPart/:versionPart/my/custom/link
---
Lorem ipsum
from docusaurus.
How can one map multiple URLs to the same page? I've tried multiple variations of the permalink syntax trying to get an endpoint like example.com/productA/latest to also map to example.com/productA/1.0.2 but I can't seem to make it work. Looking for this approach as we have multiple products we need to version and each should be discoverable via a /latest page.
from docusaurus.
Thank you Sébastien! Being partial to the redirect approach, I've tried it to half success. Seems there's a war between Docusaurus and Render.com to complete the redirection so the browser errors, saying:
This page isn’t working
site.com redirected you too many times.
ERR_TOO_MANY_REDIRECTS
Should I open a new issue for this or is there a known solution for [partially] disabling Docusaurus's internal redirect to 404, which I think is the main culprit? Thanks in advance
from docusaurus.
Related Issues (20)
- Blog author social platforms shorthands are not normalized for inline authors
- Blog authors page bugs for authors with 0 posts HOT 4
- npm2yarn converts command incorrectly for PNPM HOT 1
- Blog authors page is not using baseUrl when rendering a relative author.image_url HOT 5
- Footer links are too wide in mobile view which leads to misclicks HOT 1
- [@docusaurus/plugin-client-redirects] Not working with external links HOT 6
- plugin-pwa: Usage of placeholders in manifest.json allowing implementation of manifest.json for different deployment environments HOT 1
- Inconsistent File Handling Between Development and Build Processes HOT 3
- Do not transform static JS assets HOT 6
- Unicode in Navlinks broken on NodeJS 22 HOT 3
- `float`ing images overlap background of boxes (code boxes, admonitions, etc.) HOT 8
- Regarding plugin @docusaurus/plugin-client-redirects can't set redirection settings for other languages HOT 2
- How can docusaurus' 404 page be adapted to other language pages? HOT 6
- DocCardList element renders the wrong items HOT 1
- Adding `@babel/preset-react` to docusaurus does not enable "Support for the experimental syntax 'jsx'" HOT 3
- `@docusaurus/eslint-plugin` is not compatible with ESLint 9 HOT 4
- Update dependencies to non-vulnerable versions HOT 5
- Firefox: Triple click + Ctrl+c in code block copies two lines instead of one HOT 2
- Setting `id` frontmatter unexpectedly affects the published path of a document HOT 2
- Make auto-generated multiple sidebars exclusive by default HOT 1
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from docusaurus.