Skip to content

Commit 251173b

Browse files
authored
style: comprehensive UI refresh for landing page and docs
WIP: Major design update with modern styling. Landing page: - Added gradient backgrounds with RGBA color system - Updated header and navigation layout - Improved feature panels and mobile responsiveness - Udated logos and graphics Documentation UI: - Enhanced Antora theme with blurred, gradient, backgrounds - Restructured CSS architecture (vars.css, base.css, site.css) - Better typography and color system - Improved overall readability
1 parent d722b7d commit 251173b

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

42 files changed

+1735
-289
lines changed

README.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
= MrDocs
22

3-
image::docs/modules/ROOT/images/MrDocsBanner.jpg[Mr. Docs Documentation,link=https://www.mrdocs.com]
3+
image::docs/modules/ROOT/images/MrDocsBanner.png[Mr. Docs Documentation,link=https://www.mrdocs.com]
44

55
Visit the Mr. Docs Documentation website at https://www.mrdocs.com.
66

325 KB
Loading

docs/modules/ROOT/pages/index.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ Alan Freitas <[email protected]>
66
:page-tags: mrdocs
77
:navtitle: Home
88

9-
image::MrDocsBanner.jpg[link=https://www.mrdocs.com]
9+
image::MrDocsBanner.png[link=https://www.mrdocs.com]
1010

1111
- Automating {cpp} reference documentation significantly enhances usability by providing a navigable API and ensuring a single, up-to-date source of truth with minimal effort.
1212
- However, documenting {cpp} poses significant challenges due to discrepancies between the codebase and the public API. Doxygen remains a popular tool, yet it is suboptimal for {cpp} as it fails to fully comprehend {cpp} constructs and requires many transformation steps, including the incorporation of many macros within the {cpp} code. These macros maintain well-formed and ill-formed versions of the code, undermining the goal of unifying the source of truth.

docs/shared/logo.css

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
/* ===========================
2+
Shared Logo Styles
3+
=========================== */
4+
5+
/* Logo Styles */
6+
.nav .logo-link, .navbar-brand .navbar-item:first-child {
7+
display: flex;
8+
align-items: center;
9+
gap: 0.25rem;
10+
text-decoration: none;
11+
}
12+
13+
.nav .logo-link:hover {
14+
opacity: 0.8;
15+
text-decoration: none;
16+
}
17+
18+
.nav .logo-link svg, .navbar-brand .navbar-item:first-child svg {
19+
height: 48px;
20+
width: auto;
21+
flex-shrink: 0;
22+
}
23+
24+
.nav .logo-text, .navbar-brand .navbar-item:first-child .logo-text {
25+
font-weight: 700;
26+
color: #fff;
27+
white-space: nowrap;
28+
}
29+
30+
@media (max-width: 576px) {
31+
.nav .logo-link svg {
32+
height: 28px;
33+
}
34+
35+
.nav .logo-link {
36+
gap: 0.5rem;
37+
}
38+
}

docs/ui/preview-src/ui-model.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
antoraVersion: '1.0.0'
22
site:
33
url: http://localhost:5252
4-
title: Brand Docs
4+
title: MrDocs
55
homeUrl: &home_url /xyz/5.2/index.html
66
components:
77
- name: abc

docs/ui/src/css/base.css

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,16 @@ html {
99
font-size: var(--body-font-size);
1010
height: 100%;
1111
scroll-behavior: smooth;
12+
background:
13+
radial-gradient(ellipse 100% 100% at var(--x1) var(--y1), rgba(89, 36, 99, 0.8), transparent 50%),
14+
radial-gradient(ellipse 80% 120% at var(--x2) var(--y2), rgba(138, 214, 236, 0.5), transparent 55%),
15+
radial-gradient(ellipse 150% 90% at var(--x3) var(--y3), rgba(40, 98, 114, 0.6), transparent 65%),
16+
radial-gradient(ellipse 100% 100% at 80% 100%, rgba(89, 36, 99, 0.8), transparent 60%),
17+
linear-gradient(135deg, #124b83, #124b83, #124b83);
18+
background-attachment: fixed;
19+
background-blend-mode: screen;
20+
background-size: cover;
21+
background-repeat: no-repeat;
1222
}
1323

1424
@media screen and (min-width: 1024px) {
@@ -18,13 +28,14 @@ html {
1828
}
1929

2030
body {
21-
background: var(--body-background);
31+
/* Remove the solid background since we're using gradient on html */
32+
/* background: var(--body-background); */
2233
color: var(--body-font-color);
2334
font-family: var(--body-font-family);
2435
line-height: var(--body-line-height);
2536
margin: 0;
2637
tab-size: 4;
27-
word-wrap: anywhere; /* aka overflow-wrap; used when hyphens are disabled or aren't sufficient */
38+
word-wrap: anywhere;
2839
}
2940

3041
a {

docs/ui/src/css/custom.css

Lines changed: 85 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,85 @@
1+
/* Inherits styles from landing page */
2+
3+
.dotted {
4+
background-image: url("../../../../docs/website/assets/halftone.png");
5+
background-size: 158%;
6+
background-repeat: repeat-y;
7+
background-position: center center;
8+
width: 190px;
9+
height: 100vh;
10+
position: fixed;
11+
left: 0;
12+
opacity: 0.1;
13+
top: 0;
14+
z-index: -5;
15+
pointer-events: none;
16+
}
17+
18+
.dotted-right {
19+
background-image: url("../../../../docs/website/assets/halftone.png");
20+
background-size: 158%;
21+
transform: rotate(180deg);
22+
background-repeat: repeat-y;
23+
background-position: center center;
24+
width: 190px;
25+
height: 100vh;
26+
position: fixed;
27+
right: 0;
28+
opacity: 0.1;
29+
top: 0;
30+
z-index: -5;
31+
pointer-events: none;
32+
}
33+
34+
@media (max-width: 576px) {
35+
.dotted,
36+
.dotted-right {
37+
opacity: 0.05;
38+
}
39+
40+
.dotted {
41+
left: -80px;
42+
}
43+
44+
.dotted-right {
45+
right: -80px;
46+
}
47+
}
48+
49+
.doc {
50+
color: var(--navbar-font-color);
51+
}
52+
53+
.body .article {
54+
backdrop-filter: blur(10px);
55+
background-color: rgba(255, 255, 255, 0.1);
56+
}
57+
58+
.doc h1,
59+
.doc h2,
60+
.doc h3,
61+
.doc h4,
62+
.doc h5,
63+
.doc h6 {
64+
color: var(--navbar-font-color);
65+
}
66+
67+
.toc.sidebar .toc-menu {
68+
color: var(--navbar-font-color);
69+
}
70+
71+
.toc.sidebar .toc-menu h3 {
72+
color: var(--navbar-font-color);
73+
}
74+
75+
.breadcrumbs li {
76+
color: var(--color-white-50);
77+
}
78+
79+
.toc .toc-menu a.is-active {
80+
color: var(--color-white-50);
81+
}
82+
83+
.nav-text {
84+
color: var(--color-white-50);
85+
}

docs/ui/src/css/header.css

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,8 @@ body {
99
}
1010

1111
.navbar {
12-
background: var(--navbar-background);
12+
background-color: rgba(0, 0, 0, 0.2);
13+
backdrop-filter: blur(10px);
1314
color: var(--navbar-font-color);
1415
font-size: calc(16 / var(--rem-base) * 1rem);
1516
height: var(--navbar-height);

docs/ui/src/css/nav.css

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,8 @@
55
}
66

77
.nav-container {
8+
background-color: rgba(255, 255, 255, 0.1);
9+
backdrop-filter: blur(10px);
810
position: fixed;
911
top: var(--navbar-height);
1012
left: 0;
@@ -35,7 +37,7 @@
3537
}
3638

3739
.nav {
38-
background: var(--nav-background);
40+
/* background: var(--nav-background); */
3941
position: relative;
4042
top: var(--toolbar-height);
4143
height: var(--nav-height);
@@ -57,13 +59,14 @@
5759
}
5860

5961
.nav a {
60-
color: inherit;
62+
color: var(--color-white);
6163
}
6264

6365
.nav .panels {
6466
display: flex;
6567
flex-direction: column;
6668
height: inherit;
69+
background-color: rgba(255, 255, 255, 0.1);
6770
}
6871

6972
.nav-panel-menu {
@@ -183,7 +186,7 @@
183186
}
184187

185188
.nav-panel-explore {
186-
background: var(--nav-background);
189+
background: rgba(255, 255, 255, 0.3);
187190
display: flex;
188191
flex-direction: column;
189192
position: absolute;
@@ -201,7 +204,7 @@
201204
.nav-panel-explore .context {
202205
font-size: calc(15 / var(--rem-base) * 1rem);
203206
flex-shrink: 0;
204-
color: var(--nav-muted-color);
207+
color: var(--color-white);
205208
box-shadow: 0 -1px 0 var(--nav-panel-divider-color);
206209
padding: 0 0.5rem;
207210
display: flex;

docs/ui/src/css/page-versions.css

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@
1111
}
1212

1313
.page-versions .version-menu-toggle {
14-
color: inherit;
14+
color: var(--color-white);
1515
background: url(../img/chevron.svg) no-repeat;
1616
background-position: right 0.5rem top 50%;
1717
background-size: auto 0.75em;

0 commit comments

Comments
 (0)