Skip to content

Fix invalid LinkedIn social handle and add sitemap configuration#3

Draft
ayadseghairi with Copilot wants to merge 2 commits into
mainfrom
copilot/fix-linkedin-social-handle
Draft

Fix invalid LinkedIn social handle and add sitemap configuration#3
ayadseghairi with Copilot wants to merge 2 commits into
mainfrom
copilot/fix-linkedin-social-handle

Conversation

Copilot AI commented Apr 11, 2026

Copy link
Copy Markdown

Docusaurus 3.10 rejects LinkedIn social values that are partial URL paths (e.g. in/ayad-seghiri/) instead of bare handles or fully-qualified HTTPS URLs. Additionally, sitemap generation was never wired up in the preset config.

Changes

  • blog/authors.ymllinkedin value confirmed as ayad-seghairi (bare handle, no slashes), which satisfies Docusaurus's normalizeSocialEntry validation
  • docusaurus.config.js — Added sitemap options to the classic preset:
sitemap: {
  changefreq: 'weekly',
  priority: 0.5,
  ignorePatterns: ['/tags/**'],
  filename: 'sitemap.xml',
},

This enables automatic sitemap.xml generation at https://docs.geekdz.tech/sitemap.xml, with tag archive pages excluded.

Original prompt

ayad@fedora:~/Documents/geekdz-docs$ npm run start

geekdz-docs@0.0.0 start
docusaurus start

[INFO] Starting the development server...

[ERROR] Error: Author socials should be usernames/userIds/handles, or fully qualified HTTP(s) absolute URLs.
Social platform 'linkedin' has illegal value 'in/ayad-seghiri/'
at normalizeSocialEntry (/home/ayad/Documents/geekdz-docs/node_modules/@docusaurus/plugin-content-blog/lib/authorsSocials.js:54:15)
at Array.map ()
at normalizeSocials (/home/ayad/Documents/geekdz-docs/node_modules/@docusaurus/plugin-content-blog/lib/authorsSocials.js:66:55)
at normalizeAuthor (/home/ayad/Documents/geekdz-docs/node_modules/@docusaurus/plugin-content-blog/lib/authorsMap.js:82:73)
at /home/ayad/Documents/geekdz-docs/node_modules/@docusaurus/plugin-content-blog/lib/authorsMap.js:87:16
at /home/ayad/Documents/geekdz-docs/node_modules/lodash/lodash.js:13500:38
at /home/ayad/Documents/geekdz-docs/node_modules/lodash/lodash.js:4998:15
at baseForOwn (/home/ayad/Documents/geekdz-docs/node_modules/lodash/lodash.js:3037:24)
at Function.mapValues (/home/ayad/Documents/geekdz-docs/node_modules/lodash/lodash.js:13499:7)
at normalizeAuthorsMap (/home/ayad/Documents/geekdz-docs/node_modules/@docusaurus/plugin-content-blog/lib/authorsMap.js:86:29)
[INFO] Docusaurus version: 3.10.0
Node version: v22.22.0
ayad@fedora:~/Documents/geekdz-docs$ npm i

up to date, audited 1314 packages in 40s

426 packages are looking for funding
run npm fund for details

18 high severity vulnerabilities

To address issues that do not require attention, run:
npm audit fix

To address all issues (including breaking changes), run:
npm audit fix --force

Run npm audit for details.

[Chronological Review: The conversation began with the user requesting updates to the `docusaurus.config.js` file for SEO configuration and dynamic sitemap generation. The user specified exact changes to the `url`, `baseUrl`, and `sitemap` properties. Following this, the user requested the creation of a `sitemap.xml` file and attempted to access it via a local server. The user then requested the deletion of unnecessary files, initiated the Docusaurus development server, and encountered an error related to author social links. Finally, the user requested to commit changes and delegate tasks to a cloud agent.]

[Intent Mapping:

  1. "Please update my docusaurus.config.js file..." - User wants to configure SEO and enable sitemap generation.
  2. "new create the sitemap.xml file" - User requests the creation of a sitemap file.
  3. "http://localhost:3000/sitemap.xml" - User attempts to access the generated sitemap.
  4. "إحذف جميع الملفات الزائدة والتي لا فائدة منها" - User requests deletion of unnecessary files.
  5. "npm run start" - User starts the Docusaurus development server.
  6. "Commit Changes and Delegate: 'Delegate to cloud agent'" - User wants to commit changes and delegate tasks.]

[Technical Inventory:

  • Docusaurus: A documentation framework being used for the tech club's platform.
  • Configuration file: docusaurus.config.js - being updated for SEO and sitemap.
  • Error handling: Encountered an error related to author social links during server startup.]

[Code Archaeology:

  • docusaurus.config.js: Updates requested include changing url, baseUrl, and adding a sitemap object.
  • authors.yml: The file being edited, which likely contains author information including social links.]

[Progress Assessment:

  • Completed: User has specified the required updates to the docusaurus.config.js file.
  • Pending: The actual implementation of the changes, creation of the sitemap, and resolution of the error encountered during server startup.]

[Context Validation: All necessary context for continuing work is captured, including specific file updates, error messages, and user requests.]

[Recent Commands Analysis:

  • Last Agent Commands: User executed npm run start to start the Docusaurus server.
  • Tool Results Summary: The server started but returned an error regarding author social links, specifically that the LinkedIn value was invalid.
  • Pre-Summary State: The agent was actively working on starting the Docusaurus server and addressing the error when the token budget was exceeded.
  • Operation Context: The commands executed were directly related to the user's goal of configuring the documentation platform and ensuring it functions correctly.]
1. Conversation Overview: - Primary Objectives: User requested updates to `docusaurus.config.js` for SEO and sitemap generation, creation of `sitemap.xml`, deletion of unnecessary files, and resolution of errors encountered during server startup. - Session Context: The conversation flowed from configuration updates to error handling and delegation of tasks. - User Intent Evolution: The user shifted from configuration requests to troubleshooting and delegating tasks as issues arose.
  1. Technical Foundation:
  • Do...

Created from VS Code.

Agent-Logs-Url: https://github.com/geekdz40/geekdz-docs/sessions/c80d1cdf-5605-4abf-a30c-486099bb18a8

Co-authored-by: ayadseghairi <85361584+ayadseghairi@users.noreply.github.com>
Copilot AI changed the title [WIP] Fix error with author socials validation Fix invalid LinkedIn social handle and add sitemap configuration Apr 11, 2026
Copilot AI requested a review from ayadseghairi April 11, 2026 16:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants