Commit Graph

31 Commits

Author SHA1 Message Date
David Karlsson
f6191387b6 chore: remove mermaid.js
We're not using mermaid for diagrams anymore so we can prune the
dependency.

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-02-01 09:46:24 +01:00
David Karlsson
d6627bcbce fix: use flexbox to simplify templates and fix overflow on mobile
The grid col templates weren't working correctly, switched to flexbox to
make it easier to understand and work better on smaller screens.

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-01-28 23:22:17 +01:00
David Karlsson
ce9e6317fc css: prevent horizontal overflow on md/sm/xs screens
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-01-25 21:12:07 +01:00
David Karlsson
047a48d0ab fix: sidebar background in light mode
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-01-25 14:22:09 +01:00
David Karlsson
0ff3eb3aab hugo: migrate font icons to svg
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-01-25 12:28:38 +01:00
David Karlsson
ff459f0dcd css: improve styles to reduce layout shifts
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-01-25 08:35:33 +01:00
David Karlsson
15485594b4 hugo: do not render hidden cli options
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-01-24 15:51:18 +01:00
David Karlsson
f0260dbf20 hugo: display command aliases
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-01-19 16:13:36 +01:00
David Karlsson
04a5ee0915 hugo: use icon utility class for external links
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-01-08 13:25:03 +01:00
David Karlsson
834db3da41 css: refactor and improve styles
- Refactoring styles to prevent unwanted specificity issues by using
  tailwind directives
- Improve color consistency for code blocks and other components by
  replacing adhoc hex values with theme colors

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-01-03 14:54:57 +01:00
David Karlsson
77b0a087c5 fix: remove heading IDs for h1 elements
Closes #18983

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-12-28 20:55:13 +01:00
David Karlsson
72725b7708 hugo: handle multiline flag descriptions
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-12-13 21:14:31 +01:00
David Karlsson
c710541f28 a11y: add aria-hidden to external link icons
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-12-11 09:43:11 +01:00
David Karlsson
210ac7bb11 fix: add scroll margin for h1s
h1 elements with IDs need a scroll margin to account for the header and
margin height. These anchors are linked automatically by Algolia.

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-11-23 12:27:31 +01:00
David Karlsson
fd264a9df3 search: add docsearch container class and h1 ids
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-11-22 20:42:52 +01:00
David Karlsson
a0dca716e9 Revert "search: add a stronger main content identifier" 2023-11-10 15:37:39 +01:00
David Karlsson
72a1be8ec1 search: add a stronger main content identifier
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-11-10 13:34:25 +01:00
David Karlsson
f64276790d feat: numbered lines for code blocks
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-10-30 20:48:59 +01:00
David Karlsson
f7bbe06d27 feat: special rendering for codeblock variables
This change adds special rendering for variables in codeblocks.
Variables (placeholder values in examples subject to change)
can be denoted using the following syntax:

    <VARIABLE_NAME>

Using this format will render the variable in a special color, and
without the angle brackets, akin to:

    \033[95mVARIABLE_NAME\033[39m

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-10-13 20:17:16 +02:00
David Karlsson
26ee37b52a feat: add image border as query param
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-10-02 13:08:40 +02:00
David Karlsson
2eb97d7fe7 fix: use links with leading slash as-is
Links that started with a slash were being prepended the URL hostname
and rendered as absolute links before. This caused our link checker to
miss broken links that contained a leading slash.

This change fixes this issue by rendering links with a leading slash as-is,
without modification.

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-09-29 21:06:55 +02:00
David Karlsson
d5420c616e Merge pull request #18310 from dvdksn/style-dds-updates
styling updates
2023-09-28 11:11:01 +02:00
David Karlsson
0905e312e3 chore: remove unused templates
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-09-28 10:56:12 +02:00
David Karlsson
0eca2035e7 fix: add no-select to external link icon
Prevents users from having the icon ligature text included in
clipboard text when copying text from the docs site.

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-09-28 10:36:49 +02:00
David Karlsson
d8c4f4f353 fix: ignore empty default values for cli flags
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-09-15 16:19:10 +02:00
David Karlsson
b5f365e0ec style: center images and adjust border radius 💅
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-08-31 16:44:15 +02:00
David Karlsson
57c9b961fe js: fix copy function for multiline code blocks
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-08-23 11:19:53 +02:00
David Karlsson
1f2062db67 fix: add logo background for api docs
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-08-22 15:03:22 +02:00
David Karlsson
1c6f0ee337 hugo: fix edge case causing duplicate h1 (#17959)
Some documents are missing a `title` front matter,
and instead use an H1 from the document body.
This change introduces a fix to render an external
h1 only if the front matter field is set.

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-08-22 10:48:51 +01:00
David Karlsson
2284afe898 hugo: fix html escape for headings
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-08-22 11:27:27 +02:00
David Karlsson
a0d21ade2f migrate to hugo
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-08-22 09:41:02 +02:00