Commit Graph

131 Commits

Author SHA1 Message Date
Craig Osterhout b6456b6df3
layouts: add toc_max and toc_min (#22159)
<!--Delete sections as needed -->

## Description

Fix toc_min and toc_max for right nav as defined in
https://docs.docker.com/contribute/file-conventions/#front-matter

Comparison with existing `toc_max: 2`:
https://docs.docker.com/desktop/release-notes/

https://deploy-preview-22159--docsdocker.netlify.app/desktop/release-notes/

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Editorial review

Signed-off-by: Craig <craig.osterhout@docker.com>
2025-03-04 13:30:16 -08:00
Allie Sadler c8fafb9f54
ENGDOCS-2413b (#22048)
<!--Delete sections as needed -->

## Description

Moves tags placement on pages

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2025-02-18 15:41:28 +00:00
David Karlsson afabe0bbf0 site: dont hide close button in kapa widget
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2025-01-30 13:25:07 +01:00
David Karlsson 1a9dc69bd0 chore: tidy templates, add comments
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2025-01-20 10:30:58 +01:00
David Karlsson b9b18957e1 chore: update contribute link to website section
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2025-01-14 15:07:49 +01:00
David Karlsson e7246a2fdf hugo: fix 'reverse' option for re-ordering sidebar entries
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-12-18 13:06:50 +01:00
David Karlsson 1989620ae1 feat: add support for sidebar grouping
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-11-26 13:49:50 +01:00
David Karlsson ac73249bf9 site: remove target=_blank
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-10-31 15:46:19 +01:00
David Karlsson 4fdce97ab4
Merge pull request #21244 from dvdksn/guides-filters-tags
guides: rework filter logic, presentation
2024-10-30 13:27:00 +01:00
David Karlsson 56e58ae5bf site: rework guides filters and tags taxonomy
- Rework the filtering system for guides to drop the use of the
  "products", "subjects", and "levels" taxonomies in favor of "tags" and
  "languages"
- This change means that the existing taxonomy functionality integrates
  better with the guides filtering, and there are fewer parameters to
  keep in mind when adding metadata to a guide
  - Only two taxonomies instead of three
  - Only one of those taxonomies are guides-specific (languages)
  - The other taxonomy (tags) works for all content
- Updates how tags and tag pages are rendered in general

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-10-28 16:10:20 +01:00
David Karlsson 93f816efbb site: use condensed header logo on small screens
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-10-28 16:04:40 +01:00
David Karlsson a0bb017467 site: move theme switch to footer
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-10-28 15:55:48 +01:00
David Karlsson 0f80eeae07 site: automatically scroll down the sidebar to reveal the current page
Some pages are nested quite deep in the sidebar, which means they aren't
automatically visible on pageload unless the sidebar is scrolled. This
commit adds a scrolldown function to the sidebar to check if the element
representing the current page is in view. If it isn't, the sidebar is
scrolled down to a position where the current page comes into view.

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-10-10 12:28:21 +02:00
David Karlsson 2e59bd4eb7 site: use filter-based nav for guides
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-10-03 16:50:15 +02:00
David Karlsson d3b966e9f6 deps: update material-symbols icons to v0.23.0
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-09-27 12:09:29 +02:00
David Karlsson 3c83e5399d site: add cookies settings button (onetrust)
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-09-23 16:00:44 +02:00
David Karlsson 57bd20f334 Revert "site: add cookie settings button"
This reverts commit e845f4250a.
2024-09-23 14:59:32 +02:00
David Karlsson e845f4250a site: add cookie settings button
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-09-23 14:15:33 +02:00
David Karlsson 77858d9066 site: add Ask AI button to header
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-09-20 18:28:05 +02:00
David Karlsson 3f37a4c682
Merge pull request #20919 from dvdksn/fix-engine-sidebar-title
site: fix "latest" engine api sidebar link
2024-09-17 16:24:40 +02:00
David Karlsson 87af4e586a search: don't hide search drop-down on focus change
Focus/blur events are handled diffrently in Safari compared to other
browsers. For a better experience, let's not attempt to close the search
results drop-down if focus exits the search bar area. We still have a
click.outside and a keyup listener for "escape" on window to handle the
close, and a "close" button in the input bar (which is now also
focusable).

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-09-17 14:07:06 +02:00
David Karlsson ba32f0719b site: fix "latest" engine api sidebar link
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-09-17 12:03:18 +02:00
David Karlsson 5eb0381ef1 hugo: refactor sidebar templates
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-09-17 10:11:09 +02:00
David Karlsson 7f321a9197 hugo: move sidebar main navigation to partial
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-09-16 18:02:21 +02:00
David Karlsson dd294db10b hugo: add main nav icons and fix mobile rendering
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-09-16 17:50:29 +02:00
David Karlsson d970c475e0 hugo: use comon base template in taxonomy layouts
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-09-16 15:55:57 +02:00
David Karlsson 4443d3640a hugo: update layout architecture
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-09-16 14:43:05 +02:00
David Karlsson d078a3b291 site: update top navigation styles
- use the full viewport width
- goodbye sad gray, hello fun blue
- nicer logo

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-09-16 11:03:22 +02:00
David Karlsson 6205776d1f
Merge pull request #20881 from dvdksn/rm-badge-thumnail-title
fix: badge markup showing up in preview titles
2024-09-13 10:13:08 +02:00
David Karlsson 2260278786 hugo: define sidebar badge using front matter
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-09-13 09:45:42 +02:00
David Karlsson 1f17aa9c32 site: fix search page redirects
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-09-13 09:19:19 +02:00
David Karlsson 55a45c1278 fix: prefill query param on search
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-09-12 17:58:37 +02:00
David Karlsson 58aa02924d site: improve search ux, add /search page
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-09-12 17:14:01 +02:00
David Karlsson edc85bef6e hugo: inline top-nav partial
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-09-11 14:27:55 +02:00
David Karlsson f530a68e24 hugo: inline toc-cli partial
This partial was only used once.

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-09-11 14:25:52 +02:00
David Karlsson e79d7a84bd hugo: add support for pageless links in sidebar
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-09-11 14:15:15 +02:00
David Karlsson 3fd58b6a3e hugo: add support for reversed sidebar order
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-09-09 14:12:40 +02:00
David Karlsson fd7ecdc1c8
Merge pull request #20761 from dvdksn/manuals-section
hugo: move content files, use filesystem-based navigation
2024-09-09 11:36:37 +02:00
David Karlsson c36309ed8a hugo: render site navigation using sections
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-09-09 10:51:38 +02:00
David Karlsson 4302539dac site: add kapa widget branding text
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-09-09 10:23:24 +02:00
David Karlsson 70833553ba site: add learning paths
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-08-22 10:24:00 +02:00
David Karlsson 908af3998a
Merge pull request #20652 from dvdksn/update-postcss-method
hugo: replace deprecated resources.PostCSS method
2024-08-19 23:12:54 +02:00
David Karlsson 27290ad524 hugo: replace deprecated resources.PostCSS method
hugo --logLevel info
...
INFO  deprecated: resources.PostCSS was deprecated in Hugo v0.128.0 and will be removed in a future release. Use css.PostCSS.

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-08-19 16:50:57 +02:00
David Karlsson 297f867bd1 hugo: remove unused templates
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-08-19 16:39:55 +02:00
David Karlsson ea6246b059 hugo: use render hook for callouts
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-08-16 10:28:48 +02:00
David Karlsson 886a27ae8d hugo: cache more partials
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-08-13 08:27:54 +02:00
David Karlsson 8b82562776 site: add vwo async smartcode to staging env
Enables A/B testing with VWO on docs-stage.docker.com
2024-07-16 13:32:09 +02:00
David Karlsson 9f8eca2276 feat: add stepper graphic for article series
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-07-03 18:26:57 +02:00
David Karlsson 819744d334 Revert "site: add vwo async smartcode"
This reverts commit 922f788824.
2024-07-02 10:52:56 +02:00
David Karlsson 922f788824 site: add vwo async smartcode
Enables A/B testing with VWO

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-06-28 10:49:23 +02:00