You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
π [docs] Refactors the README for clarity and includes a GWAR tribute ANSI script
- β¨ [feat] Adds new ANSI art:
- Adds a tribute to GWAR, converted from an ANSI file, split into multiple PowerShell scripts for better handling
- Adds the original ANSI file for the GWAR tribute
- π [refactor] Improves documentation structure:
- Categorizes documentation links in the README into "User Documentation", "Developer Documentation", and "Project Information" for better organization
- Moves testing, linting, npm scripts, release process, and additional package feeds information into separate documentation files
- Removes the "ANSI Utility Scripts" section, as its content is now integrated into the "ANSI Conversion Guide"
- π [docs] Enhances contribution guidelines:
- Expands the contribution guidelines, providing more details on development setup, coding standards, pull request submission, and testing requirements
- Refers to the "Developer Documentation" section for development-specific tasks
- β‘ [perf] Optimizes ANSI conversion guide:
- Adds a section on advanced utilities, including instructions for splitting super-tall ANSI art and using other developer utilities like `Generate-ReleaseNotes.ps1` and `Validate-Changelog.ps1`
- π οΈ [fix] Fixes documentation links:
- Updates broken links and improves the overall clarity and accuracy of the documentation
- π§Ή [chore] Moves and renames files:
- Moves oversized colorscripts from the `docs` directory to the `assets` directory to better organize the project structure
- Moves the `ant80s_gwar_tribute.ans` file to the `assets` directory
Signed-off-by: Nick2bad4u <20943337+Nick2bad4u@users.noreply.github.com>
- Continuous integration: [`test.yml`](https://github.com/Nick2bad4u/ps-color-scripts-enhanced/blob/main/.github/workflows/test.yml) runs on Windows PowerShell 5.1, PowerShell 7.x across Windows/Linux/macOS, includes a PowerShell 7.5 preview container smoke test, and validates markdown links.
> **Note:** The following npm scripts are for development and repository maintenance only. End-users do not need Node.js or npm to use the PowerShell module.
- GitHub Packages (optional; instructions in [Publishing Guide](https://github.com/Nick2bad4u/ps-color-scripts-enhanced/blob/main/docs/Publishing.md))
455
-
- Azure Artifacts or other NuGet-compatible feeds for enterprise deployment
418
+
- Development setup and workflow
419
+
- Coding standards and best practices
420
+
- How to submit pull requests
421
+
- Testing requirements
456
422
457
-
## Contributing
458
-
459
-
Please review [CONTRIBUTING.md](https://github.com/Nick2bad4u/ps-color-scripts-enhanced/blob/main/CONTRIBUTING.md) for development guidelines, coding standards, and how to submit pull requests.
423
+
For development-specific tasks, see the [Developer Documentation](#developer-documentation) section above.
460
424
461
425
## Performance
462
426
@@ -572,38 +536,6 @@ The module includes <!-- COLOR_SCRIPT_COUNT_PLUS -->286+<!-- /COLOR_SCRIPT_COUNT
572
536
573
537
Use `Show-ColorScript -List` to see all available scripts.
574
538
575
-
## ANSI Utility Scripts
576
-
577
-
The repository ships several helpers for working with ANSI art, release notes, and documentation hygiene:
578
-
579
-
-`Convert-AnsiToColorScript.js` converts a `.ANS` file into a PowerShell script ready to drop into `ColorScripts-Enhanced/Scripts`.
580
-
-`scripts/Split-AnsiFile.js` slices extremely tall ANSI art into smaller chunks that can be converted individually.
581
-
-`scripts/Generate-ReleaseNotes.ps1` wraps `git-cliff` so you can build PowerShell Gallery release notes or tag summaries in one command.
582
-
-`scripts/Validate-Changelog.ps1` checks that `CHANGELOG.md` matches the manifest version and the latest `git-cliff` output.
583
-
-`scripts/Invoke-MarkdownLinkCheck.ps1` runs `markdown-link-check` across every markdown file using the bundled configuration.
584
-
-`docs/examples/ansi-conversion/` contains turnkey PowerShell scripts that demonstrate the Node and PowerShell conversion utilities end-to-end.
585
-
586
-
### Split Super-Tall ANSI Art
587
-
588
-
```powershell
589
-
# Preview suggested splits without writing files (looks for 4+ blank rows)
Options can be combined--`--auto` adds breaks where large blank gaps exist, `--heights` / `--breaks` enforce manual cut points, `--every=<n>` evenly divides the render, and `--strip-space-bg` (ANSI input only) mirrors the conversion behavior that clears background colors on plain spaces. Each output chunk is normalized with a trailing `ESC[0m` so the terminal resets cleanly after display.
606
-
607
539
## Troubleshooting
608
540
609
541
### Cache Not Working
@@ -760,4 +692,3 @@ For support options, response targets, and contact channels, review the [Support
0 commit comments