* Add support for a dark color themes.
- The version dropdown is now replaced with a gear dropdown. This dropdown lets you
pick the version of the site to look at, and lets you pick the light or dark color
themes for the site.
- Fixed a rendering glitch on the community page where a stray right and bottom border
was rendered.
- Stop using the prism functionality for syntax highlighting since
it doesn't handle embedded links in <pre> blocks, which prevents
cross-linking to type names properly. We now roll our own PRE block
handling.
- Stop drawing a box around inline code elements which substantially improves
the visuals, especially in tables.
- Improve appearance of tables to be a bit cleaner.
Four major themes to this work:
* Performance. This new site is fast. It loads considerably faster, especially on mobile.
Every pixel is drawn exactly once. Clicking around doesn't result in things jiggling everywhere.
* Navigation. I wanted to make it easier to get around the site, especially on mobile. To that end, we now have:
- Sticky navigation elements. The top nav bar, the left sidebar and the right TOC are now sticky and remain
on screen even as page content is scrolled.
- Tabs in the Docs section have been removed and integrated as accordion items in the left sidebar.
* Layout. I moved a bit of content around to make it easier to find and give us some room to grow:
- The Help page is now replaced with a full Help section. This provides a home for the FAQ, glossary,
bug reporting, and troubleshooting pages.
- The About page is now replaced with a full About section. This provides a home for the release notes, roadmap, upcoming "in the news" section, etc.
* Design. I tried to improve consistency across the site and provide a slightly lighter feel by minimizing the impact of some design elements. Specifics:
- Font sizes are now consistent across the site.
- The site does a much better job at adjusting to different screen sizes which makes the mobile experience better.
- Accessibility is improved by adding many attributes for screen readers, and by ensuring the site scales properly based on user-selected fonts.
- Slightly update the section index files. This is to make some upcoming
future work easier. These changes have no practical effect on the current
site.
- Delete a few extraneous files I noticed.
figure.html now contains a bit of magic to substantially improve
the load time and visual appearance of pages that contain imagery.
The magic pre-allocates space on the page of the exact size needed
for the image, even though the image isn't loaded yet. The result
is that the page can be layed out once, layout doesn't need to
happen again for each image that gets loaded.
- The blog page now has a sidebar showing all blog posts.
- Blog entries now cleanly display the publication date, attribution, and subtitle
- Sidebar entries, both for blog posts and for docs now show tooltips when hovering the mouse over the entry.
- Remove unreferenced files
- Stop using sitemap_exclude in front matter since nothing is looking at this.
- Minify the javascript files for faster loading.
- Cleanup and add favicons
- Fill some of the app manifests for Android and Windows to integrate more nicely.
- Address a few Lighthouse auditing issues.
- istio.io/help now brings up a help page which groups together all the things users can do when
they need help.
- Replaced the FAQ link in the top right of each page with a Help link instead
- Did a bit of cleanup in the page footer content & naming
- Whenever there isn't much page content, the page footer is now glued to the bottom of the visible browser page instead
of floating like a fool in the middle of the page/screen.
- Fix clickable region in new FAQ page. Instead of just being able to click on the words, you can now click
on the whole heading area to expand it.
- Better aesthetics.
- Can now navigate by clicking on a letter selector.
- Each word can now be linked to directly (although discoverability
could be better)
- The glossary is now referenced from the header.
- You can now find the glossary at istio.io/glossary
- The welcome screen now uses the same layout as all the non-docs pages so it looks more
'normal'
- The TOC's right margin has been shrunk to be consistent with the left margin.
- The community page now uses the color Twitter and GitHub images.
- Move a few things around to maintain order in the web site support stuff.
- Use different rendering style for code blocks.
- Define a default language so stuff always looks right.
- Add a bit more info to the writing-a-topic guide.
* WIP on homepage and new top menu structure. Need to rebase to upstream
* WIP on homepage and new top menu structure. Need to rebase to upstream
* force max height on homepage images
The directory structure of the input web site now controls directory the layout of the
doc hierarchy. This simplifies authoring documents and enriches the UI we generate.
This also fixes the broken link problem with the GitHub staging sites. Most links work
now.
Our sitemap.xml now contains all that it should, and excludes stuff that it shouldn't contain.
Martin Taillefer
Martin Taillefer
Dave
Shriram Rajagopalan