diff --git a/.github/workflows/deploy-dev.yml b/.github/workflows/deploy-dev.yml index f99b1b6f..04ff7791 100644 --- a/.github/workflows/deploy-dev.yml +++ b/.github/workflows/deploy-dev.yml @@ -19,9 +19,10 @@ jobs: OPENGRAPH_IMAGE_URL: ${{ secrets.OPENGRAPH_IMAGE_URL }} steps: - name: Checkout the repository - uses: actions/checkout@v3 + uses: actions/checkout@v5 with: ref: 'dev' + fetch-depth: 0 - name: Use NodeJS v20.15.0 uses: actions/setup-node@v3 with: diff --git a/.github/workflows/deploy-prod.yml b/.github/workflows/deploy-prod.yml index 25125c6f..d71c7f64 100644 --- a/.github/workflows/deploy-prod.yml +++ b/.github/workflows/deploy-prod.yml @@ -19,9 +19,10 @@ jobs: OPENGRAPH_IMAGE_URL: ${{ secrets.OPENGRAPH_IMAGE_URL }} steps: - name: Checkout the repository - uses: actions/checkout@v3 + uses: actions/checkout@v5 with: ref: ${{ github.event.release.tag_name }} + fetch-depth: 0 - name: Use NodeJS v20.15.0 uses: actions/setup-node@v3 with: @@ -82,7 +83,7 @@ jobs: password: ${{ secrets.DOCKERHUB_TOKEN }} - name: Checkout the repository - uses: actions/checkout@v3 + uses: actions/checkout@v5 with: ref: ${{ github.event.release.tag_name }} diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml index 291c1a4b..343a7d64 100644 --- a/.github/workflows/lint.yml +++ b/.github/workflows/lint.yml @@ -12,7 +12,7 @@ jobs: runs-on: ubuntu-latest steps: - name: Checkout the repository - uses: actions/checkout@v3 + uses: actions/checkout@v5 - name: Use NodeJS v20.15.0 uses: actions/setup-node@v3 with: diff --git a/.github/workflows/pull-images.yml b/.github/workflows/pull-images.yml index 52d13d31..42cf9741 100644 --- a/.github/workflows/pull-images.yml +++ b/.github/workflows/pull-images.yml @@ -12,7 +12,7 @@ jobs: runs-on: ubuntu-latest steps: - name: Checkout the repository - uses: actions/checkout@v3 + uses: actions/checkout@v5 - name: Fetch and check out latest tag run: | diff --git a/README.md b/README.md index 1c1c7ad7..1a694abf 100644 --- a/README.md +++ b/README.md @@ -94,7 +94,7 @@ The app depends these libraries and frameworks. #### To display a new image: -1. Upload the image to the `/assets` branch, ([Issue #102](https://github.com/acaptutorials/acaptutorials.github.io/issues/102)) +1. Upload the image to the [`/assets`](https://github.com/acaptutorials/acaptutorials.github.io/tree/assets) branch, ([Issue #102](https://github.com/acaptutorials/acaptutorials.github.io/issues/102)) - Commit the file under the appropriate directory (e.g., `/images/`, `/docs/`, etc.). - Use **unique, versioned file names** (e.g., `feature-v2.png`) to prevent caching issues. 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 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..4ee4f734 100644 --- a/docs/theme.config.jsx +++ b/docs/theme.config.jsx @@ -9,18 +9,41 @@ export default { logo: ( <> logo  - ACAP Development Docs + 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' } }, + + // 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} + + ) + }, + + // HTML head customizations head: function Head () { const { asPath, defaultLocale, locale } = useRouter() const { frontMatter } = useConfig() @@ -57,13 +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: (