David Karlsson
ccb50a8467
hugo: add tags
...
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-04-23 10:47:54 +02:00
David Karlsson
5f6848ae8b
hugo: add support for code block titles
...
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-04-11 16:19:22 +02:00
David Karlsson
66b5b990de
hugo: add collapse attribute for code blocks
...
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-04-03 14:06:21 +02:00
David Karlsson
4267ce33e4
hugo: use "text" as a fallback lang for codeblocks
...
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-04-02 17:43:50 +02:00
David Karlsson
df0455d16f
hugo: improve build performance
...
use cached partials for repeat templates and icons
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-03-04 16:05:28 +01:00
David Karlsson
d29dbaf482
style: design updates march 2024
...
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-03-04 11:58:08 +01:00
David Karlsson
51c1bedfb1
cli: add subcommand links
...
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-02-29 16:08:10 +01:00
David Karlsson
c04c83ff58
cli: don't render options table if only hidden options
...
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-02-29 15:13:29 +01:00
David Karlsson
56679aec98
cli: alternative alias rendering
...
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-02-23 15:11:05 +01:00
David Karlsson
adcb1edfa7
chore: style and script refactor
...
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-02-23 15:03:27 +01:00
David Karlsson
846bf77f93
cli: hoist content in CLI stubs to top
...
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-02-15 12:36:56 +01:00
David Karlsson
75dc05388d
cli: add links for cli flags
...
... and remove the column for shorthands.
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-02-08 16:00:01 +01:00
David Karlsson
ee3c9c6448
site: add lazy loading for images
...
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-02-07 17:10:16 +01:00
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