From 9ee553cc5f4a8dd22935cac8d8511ac631768e44 Mon Sep 17 00:00:00 2001 From: acaptutorials Date: Wed, 3 Sep 2025 04:02:28 +0800 Subject: [PATCH 1/5] chore: display 404 page for invalid routes --- docs/pages/404.jsx | 70 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 70 insertions(+) create mode 100644 docs/pages/404.jsx diff --git a/docs/pages/404.jsx b/docs/pages/404.jsx new file mode 100644 index 00000000..c5115832 --- /dev/null +++ b/docs/pages/404.jsx @@ -0,0 +1,70 @@ +import Head from 'next/head' +import Image from 'next/image' + +const NotFoundPage = () => { + return ( + <> + + 404 Page Not Found | ACAP Tutorials + + + + +
+
+ {/* Logo */} +
+ ACAP Tutorials Logo + + ACAP Tutorials + +
+ + {/* 404 Error */} +
+

404

+

+ Page Not Found +

+

+ The page you're looking for doesn't exist or has been moved. +

+
+ + {/* Help Section */} +
+

+ Need help finding what you're looking for? +

+
+ + 📝 Report an Issue + + + 🤖 Ask DeepWiki + +
+
+
+
+ + ) +} + +export default NotFoundPage From 3a3aad9a65ff350206fb2620a405a5766aa5a379 Mon Sep 17 00:00:00 2001 From: acaptutorials Date: Wed, 3 Sep 2025 04:07:54 +0800 Subject: [PATCH 2/5] chore: put deepwiki chat icon in upper navbar menu --- docs/pages/_meta.json | 4 ---- docs/pages/showcase.mdx | 3 --- docs/styles/globals.css | 18 +++++++++++++++++- docs/theme.config.jsx | 23 ++++++++++++++++++++++- 4 files changed, 39 insertions(+), 9 deletions(-) delete mode 100644 docs/pages/showcase.mdx diff --git a/docs/pages/_meta.json b/docs/pages/_meta.json index 26b9a699..285ea387 100644 --- a/docs/pages/_meta.json +++ b/docs/pages/_meta.json @@ -29,10 +29,6 @@ "title": "Video Tutorials", "type": "page" }, - "showcase": { - "title": "Showcase", - "type": "page" - }, "about": { "title": "About", "type": "page" diff --git a/docs/pages/showcase.mdx b/docs/pages/showcase.mdx deleted file mode 100644 index 1bb85a23..00000000 --- a/docs/pages/showcase.mdx +++ /dev/null @@ -1,3 +0,0 @@ -# Showcase 🎨 - -_(content for this section is under construction)_ diff --git a/docs/styles/globals.css b/docs/styles/globals.css index bd6213e1..5881399a 100644 --- a/docs/styles/globals.css +++ b/docs/styles/globals.css @@ -1,3 +1,19 @@ @tailwind base; @tailwind components; -@tailwind utilities; \ No newline at end of file +@tailwind utilities; + +.logo-text { + line-height: 1; +} + +@media (max-width: 888px) { + .logo-text { + display: none; + } +} + +@media (max-width: 767px) { + .logo-text { + display: unset; + } +} diff --git a/docs/theme.config.jsx b/docs/theme.config.jsx index 91d7b27c..d4fd978d 100644 --- a/docs/theme.config.jsx +++ b/docs/theme.config.jsx @@ -9,7 +9,7 @@ export default { logo: ( <> logo  - ACAP Development Docs + ACAP Development Docs ), project: { @@ -21,6 +21,21 @@ export default { titleTemplate: 'ACAP Tutorials - %s' } }, + + // Displays the last-edited date on each page (from git) + gitTimestamp: ({ timestamp }) => { + const formatted = timestamp.toLocaleDateString('en-US', { + year: 'numeric', + month: 'long', + day: 'numeric' + }) + + return ( + + Last updated on {formatted} + + ) + }, head: function Head () { const { asPath, defaultLocale, locale } = useRouter() const { frontMatter } = useConfig() @@ -61,6 +76,12 @@ export default { key: process.env.RELEASE_VERSION ?? 'v10.1.0-alpha.6-release', text: }, + chat: { + link: 'https://deepwiki.com/acaptutorials/acaptutorials.github.io', + icon: ( + Ask DeepWiki + ) + }, sidebar: { defaultMenuCollapseLevel: 1 }, From d7c49861b3117fd02f715dd3efd6e34a2c6d31b5 Mon Sep 17 00:00:00 2001 From: acaptutorials Date: Wed, 3 Sep 2025 04:16:31 +0800 Subject: [PATCH 3/5] chore: add code comments --- docs/theme.config.jsx | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/docs/theme.config.jsx b/docs/theme.config.jsx index d4fd978d..4ee4f734 100644 --- a/docs/theme.config.jsx +++ b/docs/theme.config.jsx @@ -12,10 +12,16 @@ export default { ACAP Development Docs ), + + // Code repository URL project: { link: 'https://github.com/acaptutorials/acaptutorials.github.io' }, + + // Nextra docs base URL within the repository docsRepositoryBase: 'https://github.com/acaptutorials/acaptutorials.github.io/tree/dev/docs', + + // Use SEO settings (eg., page title) useNextSeoProps: () => { return { titleTemplate: 'ACAP Tutorials - %s' @@ -36,6 +42,8 @@ export default { ) }, + + // HTML head customizations head: function Head () { const { asPath, defaultLocale, locale } = useRouter() const { frontMatter } = useConfig() @@ -72,19 +80,27 @@ export default { ) }, + + // Top banner content banner: { key: process.env.RELEASE_VERSION ?? 'v10.1.0-alpha.6-release', text: }, + + // Right-most icon in the navbar chat: { link: 'https://deepwiki.com/acaptutorials/acaptutorials.github.io', icon: ( Ask DeepWiki ) }, + + // Side bar settings sidebar: { defaultMenuCollapseLevel: 1 }, + + // Custom footer contet footer: { text: (