improve style and documentation on db.torproject.org
after the latest update of userdir-ldap-cgi (in #40182 (closed)) we lost quite a few feathers on https://db.torproject.org/, which somehow need to be restored.
as a reminder, that page is based on https://db.debian.org/, which looks okay.
in particular, you will notice the following problems:
- the navigation bar on top is way too "airy"... it's based off of the one on the homepage but it seems like it lacks a bunch of stuff
- the sidebar is not working: it's not to the side and it's generally ugly
- we're also missing a link back to the home page
- the machines list overflows
i think the following fixes should be performed:
-
the top navbar needs to be styled properly, probably with a purple background, i haven't figured out the right CSS knobs to do this. this is in html/template/navbar.wml
-
sidebar needs to fixed, possibly with vertical nav floated to the right? -
add a link to the search form -
fix the machines list table
We previously were just dumping a bunch of links at the end of the main index page (which is searchform.html
, bizarrely). this was patched out because it was ugly anyways and not present on all pages, which made navigation confusing:
@@ -48,11 +48,4 @@ to update their settings, or <a href="logout.cgi?id=~id~;authtoken=~authtoken~">
logged in.</p>
</form>
</center>
-<hr>
-<center>
-<p><a href="machines.cgi">Tor development machines</a>
-<br><a href="doc-general.html">Documentation</a>
-<br><a href="password.html">Lost or forgotten password instructions</a>
-<br><a href="forward.html">torproject.org Email Forwarding</a>
-
</p>
I would, however, seriously consider completely dropping links to internal documentation from our fork.
One of the major deltas we carry across releases are all sorts of changes and tweaks to those YML files, which is extremely annoying and labour-intensive. It might be easier to extract the documentation we have now and put it into the ldap wiki page and maintain our fork there.
this would seriously reduce our diff with upstream and simplify maintenance. we would just need to keep the sidebar up to date (html/template/vbar.wml
).
Update: i have changed the sidebar to point to our wiki which should make the builtin documentation mostly unreachable. So only style issues remain here.
@kez, are you up for this?