feat(pages): add LastUpdateAuthor & LastUpdateTime & editUrl by OzakIOne · Pull Request #10032 · facebook/docusaurus

OzakIOne · 2024-04-09T15:59:04Z

Motivation

Provide two options in pages showLastUpdateAuthor, showLastUpdateTime and editUrl which like in docs, show the time the page was last updated and also who updated it

This only works for markdown pages

pages: {
  editUrl: ({locale, pagesPath}) => {
    if (locale !== defaultLocale) {
      return `https://crowdin.com/project/docusaurus-v2/${locale}`;
    }
    return `https://github.com/facebook/docusaurus/edit/main/website/src/pages/${pagesPath}`;
  },
  showLastUpdateAuthor: true,
  showLastUpdateTime: true,
}

Test Plan

Deploy, tests, dogfood

Test links

Deploy preview: https://deploy-preview-10032--docusaurus-2.netlify.app/tests

Related issues/PRs

#9954

netlify · 2024-04-09T16:01:57Z

✅ [V2]

Name	Link
🔨 Latest commit	`287bf0b`
🔍 Latest deploy log	https://app.netlify.com/sites/docusaurus-2/deploys/661d5e1e3addcc0008ea79da
😎 Deploy Preview	https://deploy-preview-10032--docusaurus-2.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

github-actions · 2024-04-09T16:05:25Z

⚡️ Lighthouse report for the deploy preview of this PR

URL	Performance	Accessibility	Best Practices	SEO	PWA	Report
/	🟠 56	🟢 98	🟢 96	🟢 100	🟠 88	Report
/docs/installation	🟠 68	🟢 96	🟢 100	🟢 100	🟠 88	Report
/docs/category/getting-started	🟠 75	🟢 100	🟢 100	🟢 90	🟠 88	Report
/blog	🟠 71	🟢 100	🟢 100	🟢 90	🟠 88	Report
/blog/preparing-your-site-for-docusaurus-v3	🟠 61	🟢 96	🟢 100	🟢 100	🟠 88	Report
/blog/tags/release	🟠 70	🟢 100	🟢 100	🟠 80	🟠 88	Report
/blog/tags	🟠 75	🟢 100	🟢 100	🟢 90	🟠 88	Report

github-actions · 2024-04-09T16:09:22Z

Size Change: +157 B (0%)

Total Size: 1.05 MB

Filename	Size	Change
`website/build/assets/js/main.********.js`	811 kB	+157 B (0%)

ℹ️ View Unchanged

Filename	Size
`website/.docusaurus/globalData.json`	91.2 kB
`website/build/assets/css/styles.********.css`	113 kB
`website/build/index.html`	38 kB

_{compressed-size-action}

argos-ci · 2024-04-11T16:33:20Z

The latest updates on your projects. Learn more about Argos notifications ↗︎

Build	Status	Details	Updated (UTC)
default (Inspect)	🧿 Changes detected (Review)	3 changed	Apr 15, 2024, 5:13 PM

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

slorber

Looks almost ready, but:

need to also support editUrl 🎁
need docs
need unit tests + fix existing snapshots
need to dogfood

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

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

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

slorber

Almost good!

Would like to test this on the dogfood plugins too, meta row UI should appear on these pages:

https://deploy-preview-10032--docusaurus-2.netlify.app/tests/pages/

slorber · 2024-04-12T10:23:56Z

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

+        function getPagesEditUrl() {
+          const pagesPathRelative = path.relative(
+            pagesDirPath,
+            path.resolve(pagesSourceAbsolute),
+          );
+
+          if (typeof editUrl === 'function') {
+            return editUrl({
+              pagesDirPath: posixPath(path.relative(siteDir, pagesDirPath)),
+              pagesPath: posixPath(pagesPathRelative),
+              permalink,
+              locale: i18n.currentLocale,
+            });
+          } else if (typeof editUrl === 'string') {
+            const isLocalized =
+              pagesDirPath === contentPaths.contentPathLocalized;
+            const fileContentPath =
+              isLocalized && options.editLocalizedFiles
+                ? contentPaths.contentPathLocalized
+                : contentPaths.contentPath;
+
+            const contentPathEditUrl = normalizeUrl([
+              editUrl,
+              posixPath(path.relative(siteDir, fileContentPath)),
+            ]);
+
+            return getEditUrl(pagesPathRelative, contentPathEditUrl);
+          }
+          return undefined;
+        }


Wonder if we could find a way to deduplicate/extract that complexity to utils? 🤔

website/docs/api/plugins/plugin-content-pages.mdx

website/docusaurus.config.ts

website/_dogfooding/dogfooding.config.ts

slorber · 2024-04-12T14:25:18Z

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

+          editUrl: getItemEditUrl({
+            editUrl,
+            itemDirPath: pagesDirPath,
+            itemSourceAbsolute: pagesSourceAbsolute,
+            permalink,
+            i18n,
+            options,
+            siteDir,
+            contentPaths,
+          }),


😄 maybe that was a bad idea, if we can only use it on the pages plugin and not all other plugins it's probably not worth it to extract to docusaurus utils 😅 (didn't see at first that the edit URL fn all have different param names)

feat(pages): add support for last update date & author

426b8fc

facebook-github-bot added the CLA Signed Signed Facebook CLA label Apr 9, 2024

OzakIOne added 3 commits April 10, 2024 14:05

wip git last update not working

af80172

wip

0c058f0

wip

cd5223e

slorber added the pr: new feature This PR adds a new API or behavior. label Apr 11, 2024

OzakIOne and others added 4 commits April 11, 2024 16:49

Merge branch 'main' into ozaki/pages-lastupdate

279479e

refactor: apply lint autofix

5441315

feat: working

432efc4

cleanup

b18e6b4

OzakIOne marked this pull request as ready for review April 11, 2024 16:24

OzakIOne requested review from Josh-Cena and slorber as code owners April 11, 2024 16:24

OzakIOne added the Argos Add this label to run UI visual regression tests. See argos.yml GH action. label Apr 11, 2024

fix layout shift

b81ccfb

OzakIOne commented Apr 11, 2024

View reviewed changes

packages/docusaurus-theme-classic/src/theme/MDXPage/index.tsx Outdated Show resolved Hide resolved

slorber requested changes Apr 11, 2024

View reviewed changes

OzakIOne added 5 commits April 11, 2024 19:34

wip

252d0f3

update link

ac155df

docs: add options

47c50e6

tests: update & add new test

4811749

wip fix css layout

e735aa1

slorber requested changes Apr 12, 2024

View reviewed changes

OzakIOne added 2 commits April 12, 2024 12:44

review

c39a898

wip extract getItemEditURL to utils

ebb35f6

slorber requested changes Apr 12, 2024

View reviewed changes

danielsinai mentioned this pull request Aug 15, 2024

[Snyk] Upgrade @docusaurus/plugin-ideal-image from 3.0.1 to 3.4.0 port-labs/ocean#907

Closed

Ramyromel mentioned this pull request Aug 28, 2024

[Snyk] Upgrade @docusaurus/core from 2.4.3 to 3.4.0 Ramyromel/polkadot-wiki#11

Merged

Herychukwu mentioned this pull request Aug 31, 2024

[Snyk] Upgrade @docusaurus/core from 3.0.0 to 3.5.1 Herychukwu/solana-program-library#8

Open

This was referenced Sep 3, 2024

[Snyk] Upgrade @docusaurus/module-type-aliases from 2.4.3 to 3.5.1 Ramyromel/polkadot-wiki#12

Merged

[Snyk] Upgrade @docusaurus/plugin-client-redirects from 2.4.3 to 3.5.1 Ramyromel/polkadot-wiki#13

Open

Exkaleburx mentioned this pull request Sep 5, 2024

[Snyk] Upgrade @docusaurus/utils from 3.1.1 to 3.5.2 Exkaleburx/chakra-ui#182

Open

This was referenced Sep 8, 2024

[Snyk] Upgrade @docusaurus/module-type-aliases from 3.0.0 to 3.5.2 qdraw/starsky#1698

Closed

[Snyk] Upgrade @docusaurus/types from 3.0.0 to 3.5.2 qdraw/starsky#1699

Closed

qdraw mentioned this pull request Sep 14, 2024

[Snyk] Upgrade: , qdraw/starsky#1719

Closed

Exkaleburx mentioned this pull request Sep 19, 2024

[Snyk] Upgrade: , focus-visible, framer-motion, react-spinners Exkaleburx/chakra-ui#202

Open

qdraw mentioned this pull request Sep 21, 2024

[Snyk] Upgrade: , , prism-react-renderer qdraw/starsky#1728

Closed

galopeian1 mentioned this pull request Sep 26, 2024

[Snyk] Upgrade @docusaurus/core from 3.0.1 to 3.5.2 galopeian1/bitsy#9

Open

This was referenced Sep 28, 2024

[Snyk] Upgrade @docusaurus/module-type-aliases from 3.0.0 to 3.5.2 qdraw/starsky#1738

Closed

[Snyk] Upgrade @docusaurus/types from 3.0.0 to 3.5.2 qdraw/starsky#1739

Closed

Abuchtela mentioned this pull request Nov 10, 2024

[Snyk] Upgrade @docusaurus/core from 3.0.0 to 3.5.2 Abuchtela/aptos-core#64

Closed

diegoazh mentioned this pull request Nov 11, 2024

[Snyk] Upgrade @docusaurus/core from 3.2.1 to 3.5.2 diegoazh/gmap-vue#337

Closed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat(pages): add LastUpdateAuthor & LastUpdateTime & editUrl#10032

feat(pages): add LastUpdateAuthor & LastUpdateTime & editUrl#10032
slorber merged 20 commits intomainfrom
ozaki/pages-lastupdate

OzakIOne commented Apr 9, 2024 •

edited

Loading

Uh oh!

netlify bot commented Apr 9, 2024 •

edited

Loading

Uh oh!

github-actions bot commented Apr 9, 2024 •

edited

Loading

Uh oh!

github-actions bot commented Apr 9, 2024 •

edited

Loading

Uh oh!

argos-ci bot commented Apr 11, 2024 •

edited

Loading

Uh oh!

Uh oh!

slorber left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

slorber left a comment

Uh oh!

slorber Apr 12, 2024

Uh oh!

Uh oh!

Uh oh!

Uh oh!

slorber Apr 12, 2024

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

OzakIOne commented Apr 9, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Motivation

Test Plan

Test links

Related issues/PRs

Uh oh!

netlify bot commented Apr 9, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ [V2]

Uh oh!

github-actions bot commented Apr 9, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

⚡️ Lighthouse report for the deploy preview of this PR

Uh oh!

github-actions bot commented Apr 9, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

argos-ci bot commented Apr 11, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

slorber left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

slorber left a comment

Choose a reason for hiding this comment

Uh oh!

slorber Apr 12, 2024

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

slorber Apr 12, 2024

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

OzakIOne commented Apr 9, 2024 •

edited

Loading

netlify bot commented Apr 9, 2024 •

edited

Loading

github-actions bot commented Apr 9, 2024 •

edited

Loading

github-actions bot commented Apr 9, 2024 •

edited

Loading

argos-ci bot commented Apr 11, 2024 •

edited

Loading