How to fix dead links to (old) installation guide

Project Discussion
1

Due to the new pages about installation, existing links are dead now and have to get fixed.

An adequate target for the now dead link:

would be the new getting started page, which provides information about the installation guide of the Fedora variants.

Our first approach is to redirect from the old URL to the new one by placing a “:page-aliases:” directive in the new page header.

According to this information I modified the article:

= Getting Started
The Fedora docs team
:revnumber: F37
:revdate: 2022-11-15 
// :revremark: a new beginning

// Redirect the old (generic) installation guide to this page
:page-aliases: fedora:install-guide:index.adoc

But the result is a “page not found”.

1 Like
2

Try f36@fedora:install-guide:index.adoc?

3

Thanks for the info. I tried, but unfortunately didn’t work either.

4

Hm, I’m sorry. I’m sure darknao will know.

5

He does. He has fixed it. your proposal (replacing f36 by f37) works now. So we have a way to fix the dead links.

6

Sorry I was about to post here after fixing it and got distracted.

:page-aliases: f37@fedora:install-guide:index.adoc

Was indeed correct, but you can’t use :page-aliases: more than one time.
If you want to create multiple aliases, it needs to be on the same line:

:page-aliases: f37@fedora:install-guide:index.adoc, f37@fedora:install-guide:another.adoc, f37@fedora:install-guide:one-more.adoc

or, using multi lines with backslashes:

:page-aliases: f37@fedora:install-guide:index.adoc, \
f37@fedora:install-guide:another.adoc, \
f37@fedora:install-guide:one-more.adoc
1 Like