feat(pages): add LastUpdateAuthor & LastUpdateTime & editUrl

packages/docusaurus-plugin-content-pages/src/frontMatter.ts

@@ -11,6 +11,7 @@ import {
   FrontMatterTOCHeadingLevels,
   ContentVisibilitySchema,
   URISchema,
+  FrontMatterLastUpdateSchema,
 } from '@docusaurus/utils-validation';
 import type {PageFrontMatter} from '@docusaurus/plugin-content-pages';
 
@@ -24,6 +25,7 @@ const PageFrontMatterSchema = Joi.object<PageFrontMatter>({
   wrapperClassName: Joi.string(),
   hide_table_of_contents: Joi.boolean(),
   ...FrontMatterTOCHeadingLevels,
+  last_update: FrontMatterLastUpdateSchema,
 }).concat(ContentVisibilitySchema);
 
 export function validatePageFrontMatter(frontMatter: {

packages/docusaurus-plugin-content-pages/src/index.ts

@@ -23,6 +23,7 @@ import {
   parseMarkdownFile,
   isUnlisted,
   isDraft,
+  readLastUpdateData,
 } from '@docusaurus/utils';
 import {validatePageFrontMatter} from './frontMatter';
 import type {LoadContext, Plugin, RouteMetadata} from '@docusaurus/types';
@@ -120,6 +121,12 @@ export default function pluginContentPages(
         });
         const frontMatter = validatePageFrontMatter(unsafeFrontMatter);
 
+        const lastUpdatedData = await readLastUpdateData(
+          source,
+          options,
+          frontMatter.last_update,
+        );
+
         if (isDraft({frontMatter})) {
           return undefined;
         }
@@ -132,6 +139,8 @@ export default function pluginContentPages(
           title: frontMatter.title ?? contentTitle,
           description: frontMatter.description ?? excerpt,
           frontMatter,
+          lastUpdatedBy: lastUpdatedData.lastUpdatedBy,
+          lastUpdatedAt: lastUpdatedData.lastUpdatedAt,
           unlisted,
         };
       }
@@ -159,20 +168,26 @@ export default function pluginContentPages(
 
       const {addRoute, createData} = actions;
 
-      function createPageRouteMetadata(metadata: Metadata): RouteMetadata {
+      async function createPageRouteMetadata(
+        metadata: Metadata,
+      ): Promise<RouteMetadata> {
+        if (metadata.type === 'mdx') {
+          return {
+            sourceFilePath: aliasedSitePathToRelativePath(metadata.source),
+            lastUpdatedAt: metadata.lastUpdatedAt,
+          };
+        }
+
         return {
           sourceFilePath: aliasedSitePathToRelativePath(metadata.source),
-          // TODO add support for last updated date in the page plugin
-          //  at least for Markdown files
-          // lastUpdatedAt: metadata.lastUpdatedAt,
           lastUpdatedAt: undefined,
         };
       }
 
       await Promise.all(
         content.map(async (metadata) => {
           const {permalink, source} = metadata;
-          const routeMetadata = createPageRouteMetadata(metadata);
+          const routeMetadata = await createPageRouteMetadata(metadata);
           if (metadata.type === 'mdx') {
             await createData(
               // Note that this created data path must be in sync with

packages/docusaurus-plugin-content-pages/src/options.ts

@@ -27,6 +27,8 @@ export const DEFAULT_OPTIONS: PluginOptions = {
   beforeDefaultRehypePlugins: [],
   beforeDefaultRemarkPlugins: [],
   admonitions: true,
+  showLastUpdateTime: false,
+  showLastUpdateAuthor: false,
 };
 
 const PluginOptionSchema = Joi.object<PluginOptions>({
@@ -44,6 +46,10 @@ const PluginOptionSchema = Joi.object<PluginOptions>({
     DEFAULT_OPTIONS.beforeDefaultRemarkPlugins,
   ),
   admonitions: AdmonitionsSchema.default(DEFAULT_OPTIONS.admonitions),
+  showLastUpdateTime: Joi.bool().default(DEFAULT_OPTIONS.showLastUpdateTime),
+  showLastUpdateAuthor: Joi.bool().default(
+    DEFAULT_OPTIONS.showLastUpdateAuthor,
+  ),
 });
 
 export function validateOptions({

packages/docusaurus-plugin-content-pages/src/plugin-content-pages.d.ts

@@ -8,6 +8,7 @@
 declare module '@docusaurus/plugin-content-pages' {
   import type {MDXOptions} from '@docusaurus/mdx-loader';
   import type {LoadContext, Plugin} from '@docusaurus/types';
+  import type {FrontMatterLastUpdate, LastUpdateData} from '@docusaurus/utils';
 
   export type Assets = {
     image?: string;
@@ -20,6 +21,8 @@ declare module '@docusaurus/plugin-content-pages' {
     include: string[];
     exclude: string[];
     mdxPageComponent: string;
+    showLastUpdateTime: boolean;
+    showLastUpdateAuthor: boolean;
   };
 
   export type Options = Partial<PluginOptions>;
@@ -35,6 +38,7 @@ declare module '@docusaurus/plugin-content-pages' {
     readonly toc_max_heading_level?: number;
     readonly draft?: boolean;
     readonly unlisted?: boolean;
+    readonly last_update?: FrontMatterLastUpdate;
   };
 
   export type JSXPageMetadata = {
@@ -43,7 +47,7 @@ declare module '@docusaurus/plugin-content-pages' {
     source: string;
   };
 
-  export type MDXPageMetadata = {
+  export type MDXPageMetadata = LastUpdateData & {
     type: 'mdx';
     permalink: string;
     source: string;

packages/docusaurus-theme-classic/src/theme/MDXPage/index.tsx

@@ -18,12 +18,20 @@ import TOC from '@theme/TOC';
 import Unlisted from '@theme/Unlisted';
 import type {Props} from '@theme/MDXPage';
 
+import EditMetaRow from '@theme/EditMetaRow';
 import styles from './styles.module.css';
 
 export default function MDXPage(props: Props): JSX.Element {
   const {content: MDXPageContent} = props;
   const {
-    metadata: {title, description, frontMatter, unlisted},
+    metadata: {
+      title,
+      description,
+      frontMatter,
+      unlisted,
+      lastUpdatedBy,
+      lastUpdatedAt,
+    },
     assets,
   } = MDXPageContent;
   const {
@@ -33,6 +41,8 @@ export default function MDXPage(props: Props): JSX.Element {
   } = frontMatter;
   const image = assets.image ?? frontMatter.image;
 
+  const canDisplayEditMetaRow = !!(lastUpdatedAt || lastUpdatedBy);
+
   return (
     <HtmlClassNameProvider
       className={clsx(
@@ -66,6 +76,17 @@ export default function MDXPage(props: Props): JSX.Element {
               </div>
             )}
           </div>
+          {canDisplayEditMetaRow && (
+            <EditMetaRow
+              className={clsx(
+                'margin-top--sm',
+                ThemeClassNames.blog.blogFooterEditMetaRow,
+              )}
+              editUrl=""
+              lastUpdatedAt={lastUpdatedAt}
+              lastUpdatedBy={lastUpdatedBy}
+            />
+          )}
         </main>
       </Layout>
     </HtmlClassNameProvider>

project-words.txt

@@ -224,6 +224,7 @@ opensearch
 opensearchdescription
 opensource
 optimizt
+Orama
 orama
 Orta
 orta

website/docusaurus.config.ts

@@ -464,6 +464,8 @@ export default async function createConfigAsync() {
           } satisfies BlogOptions,
           pages: {
             remarkPlugins: [npm2yarn],
+            showLastUpdateAuthor: true,
+            showLastUpdateTime: true,
           } satisfies PageOptions,
           theme: {
             customCss: [