mirror of
https://github.com/zitadel/zitadel.git
synced 2025-08-12 03:47:33 +00:00
docs: Make Examples and SDK Pages easier to understand (#7291)
* docs: first attempt to restructure the sdks and examples to make it better understandable * docs: first attempt to restructure the sdks and examples to make it better understandable * docs: first attempt to restructure the sdks and examples to make it better understandable * docs: first attempt to restructure the sdks and examples to make it better understandable * docs: first attempt to restructure the sdks and examples to make it better understandable * docs: first attempt to restructure the sdks and examples to make it better understandable * docs: adding more example pages * docs: adding more example pages * docs: add all sdk/examples * docs: add tile component * docs: introduction page * docs: introduction page * docs: add react * docs: remove old sdk and example pages * docs: fix broken links * docs: fix broken links * styles * Update docs/docs/sdk-examples/introduction.mdx Co-authored-by: Livio Spring <livio.a@gmail.com> * Update docs/docs/sdk-examples/java.mdx Co-authored-by: Livio Spring <livio.a@gmail.com> * Update docs/docs/sdk-examples/python.mdx Co-authored-by: Livio Spring <livio.a@gmail.com> * Update docs/docs/sdk-examples/python.mdx Co-authored-by: Livio Spring <livio.a@gmail.com> * docs: review changes * docs: smaller tiles * docs: changes from go and java review * docs: correct python description * Update docs/docs/sdk-examples/python.mdx Co-authored-by: Livio Spring <livio.a@gmail.com> * Update docs/docs/sdk-examples/introduction.mdx Co-authored-by: Tim Möhlmann <tim+github@zitadel.com> * Update docs/docs/sdk-examples/python.mdx Co-authored-by: Tim Möhlmann <tim+github@zitadel.com> * docs: flask logo * flask, rust imgs * docs: flask logo * Update go.mdx * Update java.mdx * Update docs/docs/sdk-examples/flutter.mdx Co-authored-by: Livio Spring <livio.a@gmail.com> * Update docs/src/css/tile.module.css Co-authored-by: Livio Spring <livio.a@gmail.com> * docs: sidebar alphabetic * docs: sidebar alphabetic * docs: django logo --------- Co-authored-by: peintnermax <max@caos.ch> Co-authored-by: Livio Spring <livio.a@gmail.com> Co-authored-by: Tim Möhlmann <tim+github@zitadel.com> Co-authored-by: Stefan Benz <stefan@caos.ch>
This commit is contained in:
Fabi
35
docs/src/components/tile.jsx
Normal file
35
docs/src/components/tile.jsx
Normal file
@@ -0,0 +1,35 @@
|
||||
import React from "react";
|
||||
import styles from "../css/tile.module.css";
|
||||
|
||||
export function Tile({ title, imageSource, imageSourceLight, link, external }) {
|
||||
return (
|
||||
<a
|
||||
href={link}
|
||||
className={styles.tile}
|
||||
target={external ? "_blank" : "_self"}
|
||||
>
|
||||
<h4>{title}</h4>
|
||||
<img
|
||||
className={imageSourceLight ? "hideonlight" : ""}
|
||||
src={imageSource}
|
||||
alt={title}
|
||||
width={70}
|
||||
height={70}
|
||||
/>
|
||||
{imageSourceLight && (
|
||||
<img
|
||||
className={imageSourceLight ? "hideondark" : ""}
|
||||
src={imageSourceLight}
|
||||
alt={title}
|
||||
width={70}
|
||||
height={70}
|
||||
/>
|
||||
)}
|
||||
{external && (
|
||||
<div className={styles.external}>
|
||||
<i className="las la-external-link-alt"></i>
|
||||
</div>
|
||||
)}
|
||||
</a>
|
||||
);
|
||||
}
|
||||
@@ -127,12 +127,20 @@
|
||||
--gigibannerforeground: black;
|
||||
--footer-border: rgba(0, 0, 0, 0.12);
|
||||
--card-border: rgba(135, 149, 161, 0.2);
|
||||
--card-border-hover: #6c8eef;
|
||||
--ifm-pagination-nav-color-hover: #000000;
|
||||
--input-border: #1a191954;
|
||||
--input-hover-border: #000000;
|
||||
--input-background: #00000004;
|
||||
}
|
||||
|
||||
.tile-wrapper {
|
||||
margin: 0 -8px;
|
||||
display: flex;
|
||||
flex-direction: row;
|
||||
flex-wrap: wrap;
|
||||
}
|
||||
|
||||
pre code {
|
||||
font-size: 14px !important;
|
||||
}
|
||||
@@ -232,11 +240,22 @@ pre code {
|
||||
}
|
||||
|
||||
h1 {
|
||||
font-size: 2.2rem;
|
||||
font-size: 3rem;
|
||||
}
|
||||
|
||||
h2 {
|
||||
font-size: 1.8rem;
|
||||
font-size: 2.5rem;
|
||||
margin-top: 2.5rem;
|
||||
}
|
||||
|
||||
h3 {
|
||||
font-size: 2rem;
|
||||
margin-top: 2.5rem;
|
||||
}
|
||||
|
||||
h4 {
|
||||
font-size: 1.5rem;
|
||||
margin-top: 2.5rem;
|
||||
}
|
||||
|
||||
.navbar__brand {
|
||||
@@ -305,6 +324,7 @@ h2 {
|
||||
--gigibannerforeground: white;
|
||||
--footer-border: rgba(255, 255, 255, 0.12);
|
||||
--card-border: rgba(135, 149, 161, 0.2);
|
||||
--card-border-hover: #ffffff;
|
||||
--ifm-pagination-nav-color-hover: #ffffff;
|
||||
--input-border: #f9f7f775;
|
||||
--input-hover-border: #ffffff;
|
||||
@@ -563,4 +583,20 @@ p strong {
|
||||
background-color: var(--ifm-color-secondary-contrast-background);
|
||||
color: var(--ifm-color-secondary-contrast-foreground);
|
||||
border-color: var(--ifm-color-secondary-dark);
|
||||
}
|
||||
}
|
||||
|
||||
.hideondark {
|
||||
display: block !important;
|
||||
}
|
||||
|
||||
:root[data-theme="dark"] .hideondark {
|
||||
display: none !important;
|
||||
}
|
||||
|
||||
.hideonlight {
|
||||
display: none !important;
|
||||
}
|
||||
|
||||
:root[data-theme="dark"] .hideonlight {
|
||||
display: block !important;
|
||||
}
|
||||
|
||||
69
docs/src/css/tile.module.css
Normal file
69
docs/src/css/tile.module.css
Normal file
@@ -0,0 +1,69 @@
|
||||
.tile {
|
||||
position: relative;
|
||||
margin: 0.5rem;
|
||||
border-radius: 0.5rem;
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
align-items: center;
|
||||
min-width: 230px;
|
||||
background: var(--card-background);
|
||||
padding: 0.1rem;
|
||||
text-align: center;
|
||||
text-decoration: none;
|
||||
transition: all 0.2s ease-in-out;
|
||||
border: 1px solid var(--card-border);
|
||||
overflow: hidden;
|
||||
text-decoration: none;
|
||||
}
|
||||
|
||||
.tile h4 {
|
||||
margin-top: 0.5rem;
|
||||
margin-bottom: 0;
|
||||
text-decoration: none;
|
||||
}
|
||||
|
||||
.tile:hover {
|
||||
box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1),
|
||||
0 2px 4px -1px rgba(0, 0, 0, 0.06);
|
||||
cursor: pointer;
|
||||
text-decoration: none !important;
|
||||
border-color: var(--card-border-hover);
|
||||
}
|
||||
|
||||
.tile p {
|
||||
font-size: 14px;
|
||||
margin: 0;
|
||||
color: var(--ifm-font-color-base);
|
||||
}
|
||||
|
||||
.tile img {
|
||||
display: block;
|
||||
width: auto;
|
||||
height: 60px;
|
||||
background-size: cover;
|
||||
object-fit: contain;
|
||||
background-position: center;
|
||||
pointer-events: none;
|
||||
box-shadow: none !important;
|
||||
margin: 0 auto;
|
||||
}
|
||||
|
||||
.external {
|
||||
position: absolute;
|
||||
top: -1rem;
|
||||
right: -1rem;
|
||||
border-radius: 50vw;
|
||||
padding: 1rem;
|
||||
height: 4rem;
|
||||
width: 4rem;
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
border: 1px solid var(--card-border);
|
||||
background: #ffffff20;
|
||||
}
|
||||
|
||||
.external i {
|
||||
margin-bottom: -0.5rem;
|
||||
margin-left: -0.5rem;
|
||||
}
|
||||
@@ -38,13 +38,13 @@ const features = [
|
||||
description=""
|
||||
/>
|
||||
<ListElement
|
||||
link="/docs/examples/sdks"
|
||||
link="/docs/sdk-examples/introduction"
|
||||
type={ICONTYPE.APIS}
|
||||
title="SDKs"
|
||||
description=""
|
||||
/>
|
||||
<ListElement
|
||||
link="/docs/examples/introduction"
|
||||
link="/docs/sdk-examples/introduction"
|
||||
type={ICONTYPE.APIS}
|
||||
title="Example Apps"
|
||||
description=""
|
||||
@@ -104,7 +104,7 @@ const features = [
|
||||
title: "Get Started",
|
||||
darkImageUrl: "/docs/img/index/Quickstarts-dark.svg",
|
||||
lightImageUrl: "img/index/Quickstarts-light.svg",
|
||||
link: "examples/introduction",
|
||||
link: "/docs/sdk-examples/introduction",
|
||||
description: (
|
||||
<>
|
||||
Learn how to integrate your applications and build secure workflows and
|
||||
@@ -133,7 +133,7 @@ const features = [
|
||||
description=""
|
||||
/>
|
||||
<ListElement
|
||||
link="/docs/examples/introduction"
|
||||
link="/docs/sdk-examples/introduction"
|
||||
type={ICONTYPE.APIS}
|
||||
title="Examples"
|
||||
description="Clone an existing example application."
|
||||
|
||||
Reference in New Issue
Block a user