Initial Customizations

.prettierignore

@@ -1,2 +1,5 @@
 # Ignore artifacts:
-build
+/build
+
+# Package files
+package-lock.json

.vscode/extensions.json

@@ -0,0 +1,3 @@
+{
+  "recommendations": ["esbenp.prettier-vscode"]
+}

.vscode/settings.json

@@ -0,0 +1,10 @@
+{
+  "editor.defaultFormatter": "esbenp.prettier-vscode",
+  "editor.formatOnSave": true,
+  "editor.formatOnPaste": true,
+  "editor.tabSize": 2,
+  "files.eol": "\n",
+  "files.associations": {
+    "*.svg": "html"
+  }
+}

docs/get-started.md

@@ -0,0 +1,5 @@
+---
+sidebar_position: 2
+---
+
+# Get Started

docs/introduction.md

@@ -0,0 +1,5 @@
+---
+sidebar_position: 1
+---
+
+# Introduction

docs/tutorial-basics/_category_.json

@@ -1,4 +1,4 @@
 {
   "label": "Tutorial - Basics",
-  "position": 2
+  "position": 3
 }

docs/tutorial-basics/congratulations.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 6
+sidebar_position: 7
 ---
 
 # Congratulations!

docs/tutorial-basics/create-a-blog-post.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 3
+sidebar_position: 4
 ---
 
 # Create a Blog Post

docs/tutorial-basics/create-a-document.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 2
+sidebar_position: 3
 ---
 
 # Create a Document

docs/tutorial-basics/create-a-page.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 1
+sidebar_position: 2
 ---
 
 # Create a Page

docs/tutorial-basics/deploy-your-site.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 5
+sidebar_position: 6
 ---
 
 # Deploy your site

docs/tutorial-basics/markdown-features.mdx

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 4
+sidebar_position: 5
 ---
 
 # Markdown Features
@@ -39,6 +39,28 @@ Let's see how to [Create a page](./create-a-page.md).
 
 **Result:** Let's see how to [Create a page](./create-a-page.md).
 
+## Lists
+
+Markdown lists can be rendered as ordered or unordered, and can be nested.
+
+```md
+- Unordered list item 1.
+- Unordered list item 2.
+- Unordered list item 3.
+
+1. Ordered list item 1.
+1. Ordered list item 2.
+1. Ordered list item 3.
+```
+
+- Unordered list item 1.
+- Unordered list item 2.
+- Unordered list item 3.
+
+1. Ordered list item 1.
+2. Ordered list item 2.
+3. Ordered list item 3.
+
 ## Images
 
 Regular Markdown images are supported.
@@ -85,15 +107,33 @@ Docusaurus has a special syntax to create admonitions and callouts:
 
     :::
 
-:::tip My tip
+:::note
+
+Some **content** with _markdown_ `syntax`. Check [this `api`](#).
+
+:::
+
+:::info
 
-Use this awesome feature option
+Some **content** with _markdown_ `syntax`. Check [this `api`](#).
 
 :::
 
-:::danger Take care
+:::tip
 
-This action is dangerous
+Some **content** with _markdown_ `syntax`. Check [this `api`](#).
+
+:::
+
+:::caution
+
+Some **content** with _markdown_ `syntax`. Check [this `api`](#).
+
+:::
+
+:::danger
+
+Some **content** with _markdown_ `syntax`. Check [this `api`](#).
 
 :::
 
@@ -108,7 +148,7 @@ export const Highlight = ({children, color}) => (
       backgroundColor: color,
       borderRadius: '20px',
       color: '#fff',
-      padding: '10px',
+      padding: '10px 20px',
       cursor: 'pointer',
     }}
     onClick={() => {
@@ -123,18 +163,19 @@ This is <Highlight color="#25c2a0">Docusaurus green</Highlight> !
 This is <Highlight color="#1877F2">Facebook blue</Highlight> !
 ```
 
-export const Highlight = ({children, color}) => (
+export const Highlight = ({ children, color }) => (
   <span
     style={{
       backgroundColor: color,
       borderRadius: '20px',
       color: '#fff',
-      padding: '10px',
+      padding: '10px 20px',
       cursor: 'pointer',
     }}
     onClick={() => {
       alert(`You clicked the color ${color} with label ${children}`);
-    }}>
+    }}
+  >
     {children}
   </span>
 );

docs/tutorial-extras/_category_.json

@@ -1,4 +1,4 @@
 {
   "label": "Tutorial - Extras",
-  "position": 3
+  "position": 4
 }

docusaurus.config.js

@@ -7,21 +7,21 @@ const darkCodeTheme = require('prism-react-renderer/themes/dracula');
 /** @type {import('@docusaurus/types').Config} */
 const config = {
   title: 'CAI Open Source',
-  tagline: 'Open source tools for tracing media provenance',
+  tagline: 'Open-source tools for content authenticity and provenance',
   url: 'https://contentauth.netlify.com',
   baseUrl: '/',
   onBrokenLinks: 'throw',
   onBrokenMarkdownLinks: 'warn',
-  favicon: 'img/favicon.png',
+  favicon: '/favicon.png',
   organizationName: 'contentauth',
   projectName: 'opensource.contentauth.org',
+  clientModules: [require.resolve('./static/scripts/ui.js')],
   stylesheets: [
     // Acumin Pro (temporary)
     'https://use.typekit.net/wgs7uns.css',
     // Adobe Clean
     'https://use.typekit.net/dnb4eqs.css',
   ],
-
   presets: [
     [
       'classic',
@@ -36,90 +36,54 @@ const config = {
       }),
     ],
   ],
-
   // See here for configuration options:
   // https://docusaurus.io/docs/api/themes/configuration
   themeConfig:
     /** @type {import('@docusaurus/preset-classic').ThemeConfig} */
     ({
-      // announcementBar: {
-      //   id: 'sample',
-      //   content:
-      //     '<strong>Note:</strong> Our SDK is still pre-1.0. Features and API may change.',
-      //   backgroundColor: '#ffca32',
-      //   textColor: '#2b2b2b',
-      //   isCloseable: true,
-      // },
       colorMode: {
         disableSwitch: true,
       },
       navbar: {
         logo: {
           alt: 'Content Authenticity Initiative',
-          src: 'img/logo-text.svg',
+          src: 'img/logo-cai.svg',
           width: 180,
           height: 54,
         },
         items: [
           {
-            type: 'doc',
-            docId: 'intro',
+            to: '/docs/get-started',
             position: 'right',
             label: 'Get started',
           },
           {
-            href: 'https://github.com/contentauth',
-            label: 'GitHub',
+            to: '/docs/introduction',
             position: 'right',
+            label: 'Docs',
+            activeBaseRegex: '/docs/(?!get-started)',
           },
           {
-            href: 'https://www.contentauthenticity.org',
+            to: 'https://www.contentauthenticity.org',
             label: 'Learn more',
             position: 'right',
           },
           {
-            href: 'https://verify.contentauthenticity.org',
+            to: 'https://verify.contentauthenticity.org',
             label: 'Verify',
             position: 'right',
+            className: 'navbar__button',
           },
         ],
       },
       footer: {
-        style: 'dark',
-        links: [
-          {
-            title: 'Docs',
-            items: [
-              {
-                label: 'Tutorial',
-                to: '/docs/intro',
-              },
-            ],
-          },
-          {
-            title: 'Community',
-            items: [
-              {
-                label: 'Stack Overflow',
-                href: 'https://stackoverflow.com/questions/tagged/contentauth',
-              },
-              {
-                label: 'Twitter',
-                href: 'https://twitter.com/contentauth',
-              },
-            ],
-          },
-          {
-            title: 'More',
-            items: [
-              {
-                label: 'GitHub',
-                href: 'https://github.com/contentauth',
-              },
-            ],
-          },
-        ],
-        copyright: `Copyright © ${new Date().getFullYear()} Adobe`,
+        style: 'light',
+        logo: {
+          src: '#', // stop warning.
+          alt: 'Content Authenticity Initiative',
+          href: 'https://contentauthenticity.org',
+        },
+        copyright: `Copyright © ${new Date().getFullYear()} Adobe. All rights reserved. <a href="https://www.adobe.com/privacy.html" target="_blank" rel="noopener noreferrer">Privacy</a> | <a href="https://www.adobe.com/legal/terms.html" target="_blank" rel="noopener noreferrer">Terms of Use</a> | <a href="/">Cookie Preferences</a>`,
       },
       prism: {
         theme: lightCodeTheme,

package.json

@@ -12,7 +12,8 @@
     "serve": "docusaurus serve",
     "write-translations": "docusaurus write-translations",
     "write-heading-ids": "docusaurus write-heading-ids",
-    "prepare": "husky install"
+    "prepare": "husky install",
+    "prettier": "prettier --ignore-unknown --write ."
   },
   "dependencies": {
     "@docusaurus/core": "2.0.0-beta.18",
@@ -41,6 +42,6 @@
     "prettier": "2.6.2"
   },
   "lint-staged": {
-    "**/*": "prettier --write --ignore-unknown"
+    "**/*": "prettier --ignore-unknown --write"
   }
 }

sidebars.js

@@ -14,7 +14,8 @@
 /** @type {import('@docusaurus/plugin-content-docs').SidebarsConfig} */
 const sidebars = {
   // By default, Docusaurus generates a sidebar from the docs folder structure
-  tutorialSidebar: [{type: 'autogenerated', dirName: '.'}],
+  tutorialSidebar: [{ type: 'autogenerated', dirName: '.' }],
+  apiSidebar: [],
 
   // But you can create a sidebar manually
   /*