Non-onion absolute links on onion pages

[qubist]

Hi,

Looking at the website/docs, I notice there are quite a few absolute
links to the non-onion domain. If the user is on the onion site and
clicks such link, one leaves the onion which contradicts the essential
idea of it.

I hope someone can have a look at this and replace absolute links with
relative ones.

[unman]

> --
> You received this message because you are subscribed to the Google Groups "qubes-devel" group.
> To unsubscribe from this group and stop receiving emails from it, send an email to qubes-devel...@googlegroups.com.
> To view this discussion visit https://groups.google.com/d/msgid/qubes-devel/20260206124109.0bb34120%40localhost.

Thanks for this.
Links to sites outwith the onion should be marked as external. There
should not be any hard links to the RTD docs.
I'll take a look.
--
I never presume to speak for the Qubes team.
When I comment in the mailing lists I speak for myself.

[unman]

On Fri, Feb 06, 2026 at 02:36:58PM +0000, 'unman' via qubes-devel wrote:
> On Fri, Feb 06, 2026 at 12:41:09PM -0000, qubist wrote:
> > Hi,
> >
> > Looking at the website/docs, I notice there are quite a few absolute
> > links to the non-onion domain. If the user is on the onion site and
> > clicks such link, one leaves the onion which contradicts the essential
> > idea of it.
> >
> > I hope someone can have a look at this and replace absolute links with
> > relative ones.
> >
> > --
> > You received this message because you are subscribed to the Google Groups "qubes-devel" group.
> > To unsubscribe from this group and stop receiving emails from it, send an email to qubes-devel...@googlegroups.com.
> > To view this discussion visit https://groups.google.com/d/msgid/qubes-devel/20260206124109.0bb34120%40localhost.
>
> Thanks for this.
> Links to sites outwith the onion should be marked as external. There
> should not be any hard links to the RTD docs.
> I'll take a look.

Unless I'm mistaken after a quick look I only see one link on the style guide page.

Can you point me to others?

[qubist]

On Fri, 6 Feb 2026 15:12:15 +0000 'unman' via qubes-devel wrote:

> Can you point me to others?

Some examples I found looking at the HTML source code:

- The onion home page contains absolute link to the non-onion docs:

```
<a href="https://doc.qubes-os.org/en/latest/introduction/support.html#discussion-guidelines">discussion guidelines</a>
```

- Another one:

http://doc.qubesosfasa4zl44o4tws22di6kepyzfeqv3tg4e3ztknltfxqrymdad.onion/project-security/verifying-signatures.html


contains links to www.qubes-os.org and not to its onion counterpart. That
seems to apply to other doc pages as well due to the way the menu is structured.

If that is done using some static HTML generator, it may be challenging
to have different links for onion/non-onion but I just thought it might
be good to mention it in case a fix is possible.

[parulin]

Hi,

On 2/6/26 09:36, 'unman' via qubes-devel wrote:
> Links to sites outwith the onion should be marked as external. There
> should not be any hard links to the RTD docs.

Searching to a local build, I found the following pages with hardcoded
links to doc.qubes-os.org:

/developer/general/rst-documentation-style-guide.html
/developer/general/how-to-edit-the-rst-documentation.html
/introduction/issue-tracking.html
/introduction/faq.html

I'm not sure if it is appropriate to change those links:

* the first one, also spotted by unman is about the "rST documentation
hosted on [...]", the onion is not the rST documentation, so, not having
a .onion is a good thing.
* another is an example of what a contributor shouldn't use is converted
to the onion counterpart (I don't think it matters here)
* another refers to the Read the docs build to download alternative
formats (this one is pointing to the onion domain, which is wrong
because it is not possible with this build)
* the last one refers to the official documentation (okay)

On 2/6/26 13:30, qubist wrote:
> If that is done using some static HTML generator, it may be challenging
> to have different links for onion/non-onion but I just thought it might
> be good to mention it in case a fix is possible.

So, we are talking about the links to www.qubes-os.org. We can use the
extlinks extension for domains that also exist as .onion: the regular
build will use the .org domain while a build might be triggered with
something like `--tag onion` and display the .onion URL instead.

[unman]

On Sat, Feb 07, 2026 at 03:30:06AM -0500, 'parulin' via qubes-devel wrote:
> Searching to a local build, I found the following pages with hardcoded links
to doc.qubes-os.org:

The only one of these that exists on the onion is the one I identified.
The others are, for better or worse, rewritten.

I have not yet looked at links from the onion docs to the clearnet site, or
hard coded links in the onion web site. These should be trivial to fix.