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