[BUG] (docs) relative link doesn't work correctly #1804

Closed
opened 2026-02-05 03:56:24 +03:00 by OVERLORD · 2 comments
Owner

Originally created by @jonhnet on GitHub (Dec 17, 2023).

The bug

The first link on this page:
https://immich.app/docs/guides/external-library/
doesn't work when you click it.

It looks right when you hover, and the underlying HTML looks right too (/docs/guides/external-library/), but when you click it, it goes to https://immich.app/docs/guides/features/libraries#external-libraries (note the extra guides in the path), and of course gives Page Not Found.

This behavior doesn't reproduce locally (under yarn).

It's just one link, but I wonder if some common underlying mechanism is breaking some other links, too.

The OS that Immich Server is running on

github doc generator

Version of Immich Server

n/a

Version of Immich Mobile App

n/a

Platform with the issue

  • Server
  • Web
  • Mobile

Your docker-compose.yml content

(not relevant)

Your .env content

(not relevant)

Reproduction steps

1. visit https://immich.app/docs/guides/external-library/
2. click on the first link "External Library"
3. observe Page Not Found

Additional information

No response

Originally created by @jonhnet on GitHub (Dec 17, 2023). ### The bug The first link on this page: https://immich.app/docs/guides/external-library/ doesn't work when you click it. It _looks_ right when you hover, and the underlying HTML looks right too (/docs/guides/external-library/), but when you click it, it goes to https://immich.app/docs/guides/features/libraries#external-libraries (note the extra **guides** in the path), and of course gives Page Not Found. This behavior doesn't reproduce locally (under yarn). It's just one link, but I wonder if some common underlying mechanism is breaking some other links, too. ### The OS that Immich Server is running on github doc generator ### Version of Immich Server n/a ### Version of Immich Mobile App n/a ### Platform with the issue - [ ] Server - [ ] Web - [ ] Mobile ### Your docker-compose.yml content ```YAML (not relevant) ``` ### Your .env content ```Shell (not relevant) ``` ### Reproduction steps ```bash 1. visit https://immich.app/docs/guides/external-library/ 2. click on the first link "External Library" 3. observe Page Not Found ``` ### Additional information _No response_
Author
Owner

@jonhnet commented on GitHub (Dec 17, 2023):

The bug does not manifest when viewed locally through yarn start or npm run build; npm run serve.
The file produced in build/docs/guides/external-library/index.html has the correct link in its a href.

@jonhnet commented on GitHub (Dec 17, 2023): The bug does not manifest when viewed locally through `yarn start` or `npm run build; npm run serve`. The file produced in `build/docs/guides/external-library/index.html` has the correct link in its `a href`.
Author
Owner

@jonhnet commented on GitHub (Dec 19, 2023):

...and now the bug is no longer appearing in the production site. I dunno, but no point in continuing worrying about it.

@jonhnet commented on GitHub (Dec 19, 2023): ...and now the bug is no longer appearing in the production site. I dunno, but no point in continuing worrying about it.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: immich-app/immich#1804