Skip to content

Commit b3e7f56

Browse files
bidi47bidi47
committed
updated index, packages pages, opengraph
Signed-off-by: bidi <bidi@apidemia.com>
1 parent 014ef47 commit b3e7f56

4 files changed

Lines changed: 71 additions & 32 deletions

File tree

‎css/docs.css‎

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@
3636
--dk-blue: #1d5db8;
3737
--dk-blue-dark: #16406f;
3838
--dk-blue-light: #7fb0f0;
39-
--dk-header: #12395E;
39+
--dk-header: #1d5db8;
4040
--dk-tint: #eaf1fb;
4141
--dk-tint-2: #f6f9fd;
4242
--dk-panel: #f7f9fc;
@@ -301,7 +301,7 @@ nav.nav_breadcrumb {
301301

302302
.nav_breadcrumb .breadcrumb {
303303
font-family: var(--dk-font-mono);
304-
font-size: 11px;
304+
font-size: 10px;
305305
letter-spacing: .04em;
306306
text-transform: uppercase;
307307
color: var(--dk-muted-2);
@@ -565,11 +565,12 @@ pre code {
565565
}
566566

567567
code {
568-
background-color: #F2EFEF;
569-
border-radius: 5px;
570-
color: #F60025;
571-
font-family: SpaceGrotesk, serif;
572-
font-size: 1em !important;
568+
background-color: #F1F4F8;
569+
border: 1px solid #DFE5EC;
570+
border-radius: 3px;
571+
color: #242B33;
572+
font-family: "JetBrains Mono", monospace;
573+
font-size: 13.5px;
573574
padding: 0 5px;
574575
}
575576

‎img/open-graph/twitter-card-docs.png‎

87.6 KB
Loading

‎index.html‎

Lines changed: 34 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,24 @@
44
<meta charset="utf-8">
55
<meta http-equiv="X-UA-Compatible" content="IE=edge">
66
<meta name="viewport" content="width=device-width, initial-scale=1.0">
7-
<meta name="description" content="Dotkernel documentation">
8-
<title>Dotkernel documentation</title>
7+
<title>Dotkernel Documentation</title>
8+
<meta name="description" content="Official Dotkernel documentation covering APIs, Admin, Queue, developer tools, packages, and modern PHP application development">
99
<link rel="canonical" href="https://docs.dotkernel.org/">
1010
<link rel="shortcut icon" href="https://docs.dotkernel.org/img/dk_docs_favicon_white.svg" />
1111

12+
<meta property="og:title" content="Dotkernel Documentation"/>
13+
<meta property="og:description" content="Official Dotkernel documentation covering APIs, Admin, Queue, developer tools, packages, and modern PHP application development"/>
14+
<meta property="og:image" content="https://docs.dotkernel.org/img/open-graph/twitter-card-docs.png"/>
15+
<meta property="og:type" content="website"/>
16+
<meta property="og:site_name" content="Dotkernel Documentation"/>
17+
<meta property="og:url" content="https://docs.dotkernel.org/"/>
18+
<meta property="og:locale" content="en_US"/>
19+
<meta name="twitter:card" content="summary_large_image"/>
20+
<meta name="twitter:site" content="@dotkernel"/>
21+
<meta name="twitter:title" content="Dotkernel Documentation"/>
22+
<meta name="twitter:description" content="Official Dotkernel documentation covering APIs, Admin, Queue, developer tools, packages, and modern PHP application development"/>
23+
<meta name="twitter:image" content="https://docs.dotkernel.org/img/open-graph/twitter-card-docs.png"/>
24+
1225
<link rel="preconnect" href="https://fonts.googleapis.com">
1326
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
1427
<link href="https://fonts.googleapis.com/css2?family=Archivo:wght@500;600;700&family=Source+Sans+3:ital,wght@0,400;0,600;1,400&family=JetBrains+Mono:wght@400;500;700&display=swap" rel="stylesheet">
@@ -24,8 +37,8 @@
2437
<nav class="navbar navbar-expand-lg dk-docs-nav py-2" data-bs-theme="dark">
2538
<div class="container-fluid dk-docs-nav__inner">
2639
<a class="navbar-brand dk-docs-nav__brand" href="https://docs.dotkernel.org/">
27-
<img alt="Dotkernel" class="d-inline-block align-text-top" height="24"
28-
src="https://docs.dotkernel.org/img/dk_logo_2024_white.svg" width="129"/>
40+
<img alt="Dotkernel Logo" class="d-inline-block align-text-top" height="28"
41+
src="https://docs.dotkernel.org/img/dk_logo_2024_white.svg" width="152"/>
2942
</a>
3043

3144
<ul class="dk-docs-nav__projects list-unstyled d-none d-lg-flex align-items-center mb-0">
@@ -95,14 +108,14 @@
95108

96109
<div class="dk-home-sidebar__group">Packages</div>
97110
<a href="https://docs.dotkernel.org/packages/">All packages</a>
98-
<a href="https://docs.dotkernel.org/packages/#lifecycle">Packages Lifecycle</a>
111+
<a href="https://www.dotkernel.com/dotkernel-packages-oss-lifecycle/">Packages Lifecycle</a>
99112
</nav>
100113
</div>
101114

102115
<div class="dk-home-main">
103116
<div class="dk-home-eyebrow">PSR-15 &middot; middleware-first architecture</div>
104117
<h1>A headless platform for building modern web applications</h1>
105-
<p class="dk-home-lede">Dotkernel is a set of open-source PHP applications &mdash; REST API, admin, and queue &mdash; that ship assembled on Mezzio and Laminas, over one shared Doctrine domain layer called Core. OAuth2, RBAC, HAL, and a generated OpenAPI spec are wired together on install, not left for you to choose.</p>
118+
<p class="dk-home-lede">Dotkernel is a set of open-source PHP applications - REST API, admin, and queue - that ship assembled on Mezzio and Laminas, over one shared Doctrine domain layer called Core. OAuth2, RBAC, HAL, and a generated OpenAPI spec are wired together on install, not left for you to choose.</p>
106119

107120
<div class="dk-home-stats">
108121
<div class="dk-home-stats__item">
@@ -120,30 +133,30 @@ <h1>A headless platform for building modern web applications</h1>
120133
</div>
121134

122135
<h2>Headless Platform</h2>
123-
<p>API, Admin, and Queue declare the same <code>Core</code> namespaces &mdash; the same entities, repositories, and services. Three deployables that scale independently and never disagree about the domain.</p>
136+
<p>API, Admin, and Queue declare the same <code>Core</code> namespaces - the same entities, repositories, and services. Three deployables that scale independently and never disagree about the domain.</p>
124137
<div class="dk-home-cards">
125138
<a href="https://docs.dotkernel.org/api-documentation/" class="dk-home-card dk-home-card--featured">
126139
<div class="dk-home-card__meta">Deployable &middot; Shares Core</div>
127140
<div class="dk-home-card__title">API</div>
128141
<div class="dk-home-card__tagline">The HTTP surface of your platform, ready for any client.</div>
129-
<div class="dk-home-card__desc">REST APIs on a readable PSR-15 middleware pipeline &mdash; no kernel, no facades, no runtime magic. OAuth2, RBAC, and OpenAPI included.</div>
142+
<div class="dk-home-card__desc">REST APIs on a readable PSR-15 middleware pipeline - no kernel, no facades, no runtime magic. OAuth2, RBAC, and OpenAPI included.</div>
130143
</a>
131144
<a href="https://docs.dotkernel.org/admin-documentation/" class="dk-home-card">
132145
<div class="dk-home-card__meta">Deployable &middot; Shares Core</div>
133146
<div class="dk-home-card__title">Admin</div>
134147
<div class="dk-home-card__tagline">A back office for complete control over the same data your API serves.</div>
135-
<div class="dk-home-card__desc">A ready-to-go admin skeleton &mdash; table-based CRUD screens for your records, plus the pieces for reports and dashboards.</div>
148+
<div class="dk-home-card__desc">A ready-to-go admin skeleton - table-based CRUD screens for your records, plus the pieces for reports and dashboards.</div>
136149
</a>
137150
<a href="https://docs.dotkernel.org/queue-documentation/" class="dk-home-card">
138151
<div class="dk-home-card__meta">Deployable &middot; Shares Core</div>
139152
<div class="dk-home-card__title">Queue</div>
140153
<div class="dk-home-card__tagline">Work your users should not wait for, moved off the request.</div>
141-
<div class="dk-home-card__desc">Background job processing for the platform &mdash; dispatch work from API or Admin and run it in a separate worker. Built on Symfony Messenger.</div>
154+
<div class="dk-home-card__desc">Background job processing for the platform - dispatch work from API or Admin and run it in a separate worker. Built on Symfony Messenger.</div>
142155
</a>
143156
</div>
144157

145158
<h2>Developer tooling</h2>
146-
<p>A production-like environment on your machine, and the context your AI tools need to write Dotkernel code &mdash; both ready before anything reaches your users.</p>
159+
<p>A production-like environment on your machine, and the context your AI tools need to write Dotkernel code - both ready before anything reaches your users.</p>
147160
<div class="dk-home-cards">
148161
<a href="https://docs.dotkernel.org/development/" class="dk-home-card">
149162
<div class="dk-home-card__meta">Tooling &middot; Local environment</div>
@@ -155,7 +168,7 @@ <h2>Developer tooling</h2>
155168
<div class="dk-home-card__meta">Tooling &middot; AI context</div>
156169
<div class="dk-home-card__title">Dotboost</div>
157170
<div class="dk-home-card__tagline">Faster AI-assisted development, grounded in Dotkernel's own standards.</div>
158-
<div class="dk-home-card__desc">Dotkernel context for AI coding tools &mdash; current standards, architectural patterns, and framework idioms, so generated code matches the ecosystem instead of guessing at it.</div>
171+
<div class="dk-home-card__desc">Dotkernel context for AI coding tools - current standards, architectural patterns, and framework idioms, so generated code matches the ecosystem instead of guessing at it.</div>
159172
</a>
160173
</div>
161174

@@ -166,18 +179,18 @@ <h2>Other skeletons</h2>
166179
<div class="dk-home-card__meta">Skeleton &middot; Minimal</div>
167180
<div class="dk-home-card__title">Light</div>
168181
<div class="dk-home-card__tagline">A small site or service without a platform around it.</div>
169-
<div class="dk-home-card__desc">The smallest complete Mezzio application &mdash; PSR-15 pipeline, routing, and templating, nothing to strip out. A real starting point for a simple site.</div>
182+
<div class="dk-home-card__desc">The smallest complete Mezzio application - PSR-15 pipeline, routing, and templating, nothing to strip out. A real starting point for a simple site.</div>
170183
</a>
171184
<a href="https://docs.dotkernel.org/frontend-documentation/" class="dk-home-card">
172185
<div class="dk-home-card__meta">Skeleton &middot; Standalone</div>
173186
<div class="dk-home-card__title">Frontend</div>
174187
<div class="dk-home-card__tagline">A server-rendered web application you can build on.</div>
175-
<div class="dk-home-card__desc">A web starter skeleton for full-stack applications on Mezzio and Laminas &mdash; server-rendered Twig views, forms, sessions, and RBAC-guarded routes.</div>
188+
<div class="dk-home-card__desc">A web starter skeleton for full-stack applications on Mezzio and Laminas - server-rendered Twig views, forms, sessions, and RBAC-guarded routes.</div>
176189
</a>
177190
</div>
178191

179192
<h2>Packages</h2>
180-
<p>Small, independent dot-* packages &mdash; pull in what you need. Lifecycle status for each lives on the <a href="https://docs.dotkernel.org/packages/#lifecycle">Packages Lifecycle</a> page.</p>
193+
<p>Small, independent dot-* packages - pull in what you need. Lifecycle status for each lives on the <a href="https://docs.dotkernel.org/packages/#lifecycle">Packages Lifecycle</a> page.</p>
181194
<div class="dk-home-pkg-groups">
182195
<div class="dk-home-pkg-group">
183196
<div class="dk-home-pkg-group__title">Authentication</div>
@@ -256,36 +269,34 @@ <h2>Contributing and Support</h2>
256269
<a href="https://docs.dotkernel.org/api-documentation/">API</a>
257270
<a href="https://docs.dotkernel.org/admin-documentation/">Admin</a>
258271
<a href="https://docs.dotkernel.org/queue-documentation/">Queue</a>
259-
<a href="https://docs.dotkernel.org/dotboost/">Dotboost</a>
260272
<a href="https://docs.dotkernel.org/light-documentation/">Light</a>
261-
<a href="https://docs.dotkernel.org/frontend-documentation/">Frontend</a>
262273
</div>
263274
<div class="dk-home-footer__col">
264275
<div class="dk-home-footer__label">Resources</div>
276+
<a href="https://docs.dotkernel.org/dotboost/">Dotboost</a>
265277
<a href="https://docs.dotkernel.org/headless-documentation/">Architecture</a>
266-
<a href="https://docs.dotkernel.org/">Documentation</a>
267-
<a href="https://docs.dotkernel.org/packages/#lifecycle">Packages Lifecycle</a>
278+
<a href="https://www.dotkernel.com/dotkernel-packages-oss-lifecycle/">Packages Lifecycle</a>
268279
<a href="https://docs.dotkernel.org/development/">WSL2 Dev Stack</a>
269280
</div>
270281
<div class="dk-home-footer__col">
271282
<div class="dk-home-footer__label">More</div>
272283
<a href="https://www.dotkernel.com/">Categories</a>
273284
<a href="https://www.dotkernel.com/blog/">Blog</a>
274285
<a href="https://github.com/orgs/dotkernel/discussions">Discussion</a>
275-
<a href="https://www.dotkernel.com/">About</a>
276-
<a href="https://www.dotkernel.com/">Contact us</a>
286+
<a href="https://www.dotkernel.com/about/">About</a>
287+
<a href="https://www.dotkernel.com/contact/">Contact us</a>
277288
</div>
278289
<div class="dk-home-footer__col">
279290
<div class="dk-home-footer__label">Follow</div>
280291
<a href="https://github.com/dotkernel" target="_blank">GitHub</a>
281-
<a href="https://www.dotkernel.com/feed/" target="_blank">RSS Feed</a>
292+
<a href="https://www.dotkernel.com/feed/" target="_blank">Dotkernel RSS Feed</a>
282293
<div class="dk-home-footer__note">Open-source tooling supported by JetBrains.</div>
283294
</div>
284295
</div>
285296

286297
<div class="dk-home-footer__bottom">
287298
<img src="https://docs.dotkernel.org/img/dk_logo_2024_white.svg" alt="Dotkernel" width="112" height="21" style="opacity:.75" />
288-
<div class="dk-home-footer__tagline">Built with Mezzio, Laminas &amp; Doctrine &mdash; for PHP developers, by PHP developers. The Laminas logo is copyright of the Laminas Foundation.</div>
299+
<div class="dk-home-footer__tagline">Built with Mezzio, Laminas &amp; Doctrine - for PHP developers, by PHP developers. The Laminas logo is copyright of the Laminas Foundation.</div>
289300
<div class="flex-grow-1"></div>
290301
<div class="dk-home-footer__copyright">&#169; Copyright Dotkernel <span id="current-year"></span>. All rights reserved.</div>
291302
</div>

‎packages/index.html‎

Lines changed: 29 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,22 @@
44
<meta charset="utf-8">
55
<meta http-equiv="X-UA-Compatible" content="IE=edge">
66
<meta name="viewport" content="width=device-width, initial-scale=1.0">
7-
<meta name="description" content="Overview of the Dotkernel packages.">
8-
<title>Dotkernel packages documentation</title>
7+
<title>Dotkernel Packages Documentation</title>
8+
<meta name="description" content="Track the lifecycle and maintenance status of Dotkernel’s open-source PHP packages, from actively developed components to maintained and archived projects">
9+
10+
<meta property="og:title" content="Dotkernel Packages Documentation"/>
11+
<meta property="og:description" content="Track the lifecycle and maintenance status of Dotkernel’s open-source PHP packages, from actively developed components to maintained and archived projects"/>
12+
<meta property="og:image" content="https://docs.dotkernel.org/img/open-graph/twitter-card-docs.png"/>
13+
<meta property="og:type" content="website"/>
14+
<meta property="og:site_name" content="Dotkernel Packages Documentation"/>
15+
<meta property="og:url" content="https://docs.dotkernel.org/"/>
16+
<meta property="og:locale" content="en_US"/>
17+
<meta name="twitter:card" content="summary_large_image"/>
18+
<meta name="twitter:site" content="@dotkernel"/>
19+
<meta name="twitter:title" content="Dotkernel Packages Documentation"/>
20+
<meta name="twitter:description" content="Track the lifecycle and maintenance status of Dotkernel’s open-source PHP packages, from actively developed components to maintained and archived projects"/>
21+
<meta name="twitter:image" content="https://docs.dotkernel.org/img/open-graph/twitter-card-docs.png"/>
22+
923
<link rel="canonical" href="https://docs.dotkernel.org/packages/">
1024
<link rel="shortcut icon" href="https://docs.dotkernel.org/img/dk_docs_favicon_white.svg">
1125
<link rel="stylesheet" href="https://docs.dotkernel.org/css/bootstrap.css" />
@@ -341,6 +355,19 @@ <h5 class="card-title">Session management</h5>
341355
</div>
342356
</div>
343357
</div>
358+
<div class="col-md-6 py-3">
359+
<div class="card h-100 pkg_card">
360+
<div class="card-header">
361+
<a href="https://docs.dotkernel.org/dot-totp" class="stretched-link">
362+
dot-totp
363+
</a>
364+
</div>
365+
<div class="card-body pkg_card_body">
366+
<h5 class="card-title">Time-Based One-Time Password (TOTP)</h5>
367+
<p class="card-text">DotKernel TOTP authorization component</p>
368+
</div>
369+
</div>
370+
</div>
344371
</div>
345372

346373
<div class="row">

0 commit comments

Comments
 (0)