Migrate to Microsoft.PowerShell.PlatyPS and psake v5#55
Open
HeyItsGilbert wants to merge 4 commits intomainfrom
Open
Migrate to Microsoft.PowerShell.PlatyPS and psake v5#55HeyItsGilbert wants to merge 4 commits intomainfrom
HeyItsGilbert wants to merge 4 commits intomainfrom
Conversation
- Replace Alt3.Docusaurus.Powershell + PlatyPS v0 with Microsoft.PowerShell.PlatyPS - Add scripts/New-PsakeDocusaurusHelp.ps1 to transform PlatyPS v2 markdown to Docusaurus MDX - Bump psake to 5.0.3; convert main tasks to v5 declarative hashtable syntax - Add -Quiet flag to build.ps1 for structured PsakeBuildResult output (reduces token usage) - Add 8 new command reference MDX files for psake v5 commands Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
❌ Deploy Preview for psake failed.
|
The sidebar was generated by the old Alt3 module and only listed 12 commands. The 8 new v5 command MDX files are now included. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Add PowerShellBuild module to requirements.psd1 - Add $psbOptions/$psbVersion/$psbOutputFolder to Properties block - Add GenerateCommandReferencePSB task set (Clean, Gen) - Wire GenerateCommandReferencePSB into Build task DependsOn - Add docs/psb-commands/ placeholder sidebar (empty until task runs) - Import psbCommands in sidebars.ts with conditional category in powershellBuildSidebar Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Rename New-PsakeDocusaurusHelp.ps1 -> New-DocusaurusModuleHelp.ps1 - Rename function to New-DocusaurusModuleHelp (works for any PS module) - Add CommandVersionMap parameter; injects :::note Since <module> X.Y::: admonition - Add CommandVersionMap to $docusaurusOptions for the 8 psake v5-only commands - Update both GenerateCommandReference-Gen and GenerateCommandReferencePSB-Gen to use new script/function - Remove Exec.mdx (command was renamed to Execute in psake v5; no longer exported) - Remove 'commands/Exec' from docusaurus.sidebar.js Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Alt3.Docusaurus.Powershell+PlatyPSv0 pipeline withMicrosoft.PowerShell.PlatyPS(v2 schema)scripts/New-PsakeDocusaurusHelp.ps1— a custom transformer that converts PlatyPS v2 markdown (tables, new frontmatter) into the same Docusaurus MDX format the site already uses5.0.3and adopts v5 features:Version 5declaration, declarative hashtable task syntax,Inputs/Outputscaching onInit,exec {}wrappers for external commands-Quietflag tobuild.ps1for structuredPsakeBuildResultoutput — reduces token usage when running from Claude CodeBuildSetup,BuildTearDown,Clear-PsakeCache,Execute,Get-PsakeBuildPlan,Test-BuildEnvironment,Test-PsakeTask,Version)Test plan
.\build.ps1 -Bootstrapto installMicrosoft.PowerShell.PlatyPS.\build.ps1 -Quiet -Task GenerateCommandReferenceand inspectdocs/commands/Assert.mdx— frontmatter, yaml param fences,.mdxcross-links, and escaped curly braces should all be present.\build.ps1 -Quiet -Task Test— all 44 Pester tests pass.\build.ps1 -Quiet -Task Build— Docusaurus build completes without broken-link errors🤖 Generated with Claude Code