Wiki relative links
URLs within the
Wiki -- home.md
file currently point to .onion
TLD addresses. For clients browsing via
clear-net this may cause issues if they're not also routing network traffic
through Tor.
Proposal
I propose using relative links within the MarkDown files, wherever possible, when linking to repository files from Wiki pages.
Syntax
- [[<Text>|/../blob/<ref>/<path>]]
A live example may be reviewed via the Fork I use for testing; clear-net, and onion
In short clients viewing via the .onion
domain will be correctly routed, as
will those that browse over clear-net connections. Plus these changes have the
added benefit of making any private deployments and/or forks link to their
respective domains too.
For completeness here be a diff of proposed changes;
diff --git a/home.md b/home.md
index f3427cd..9f48d4d 100644
--- a/home.md
+++ b/home.md
@@ -8,7 +8,7 @@ As of this writing (17 March), Arti is a usable SOCKS proxy over the Tor network
More information will follow here, but for now, here are some links to more information:
-* [The README file. Read this first.](http://eweiibe6tdjsdprb4px6rqrzzcsi22m4koia44kc5pcjr7nec2rlxyad.onion/tpo/core/arti/-/blob/main/README.md)
-* [Instructions on contribution to arti development](http://eweiibe6tdjsdprb4px6rqrzzcsi22m4koia44kc5pcjr7nec2rlxyad.onion/tpo/core/arti/-/blob/main/CONTRIBUTING)
-* [The source repository where we're doing our development.](http://eweiibe6tdjsdprb4px6rqrzzcsi22m4koia44kc5pcjr7nec2rlxyad.onion/tpo/core/arti/)
-* [Timeline for adoption of Arti and deprecation of tor C](Adoption-of-Arti-and-Deprecation-of-Tor-C)
\ No newline at end of file
+* [[The README file. Read this first.|/../blob/main/README.md]]
+* [[Instructions on contribution to arti development|/../blob/main/CONTRIBUTING.md]]
+* [[The source repository where we're doing our development.|/../blob/main/]]
+* [Timeline for adoption of Arti and deprecation of tor C](Adoption-of-Arti-and-Deprecation-of-Tor-C)
Note, at the time of writing it seems there be no way to be any way to submit Merge Requests for Wiki the repository. As far as I can tell merging must be done manually, eg.
cd arti.wiki git remote add S0AndS0 git@gitlab.torproject.org:S0AndS0/arti.wiki.git git fetch S0AndS0 git merge S0AndS0/master git push origin master