pacnpal/Docs-Exporter-Astro
1
0
Fork 0
mirror of https://github.com/PacFactory/Docs-Exporter-Astro.git synced 2025-12-20 02:31:04 -05:00
Code Issues Packages Projects Releases Wiki Activity

Update CHANGELOG.md

Browse Source
This commit is contained in:
pacnpal
2024-12-09 21:02:49 -05:00
committed by GitHub
parent 20aa46cbf8
commit b9bb96aca5
1 changed files with 19 additions and 46 deletions
Download Patch File Download Diff File Expand all files Collapse all files

65
CHANGELOG.md
View File

@@ -1,51 +1,24 @@
# CHANGELOG.md # Changelog
--- All notable changes to this project will be documented in this file.
## General Changes ## [1.0.0] - 2024-12-09
1. **Code Refactoring** ### Added
- Significant restructuring of the functions to improve readability and maintainability. - Initial fork from Docs-Exporter
- Added Playwright to replace wkhtmltopdf. - Playwright support for PDF generation
- Introduction of meaningful function and variable names for better clarity. - Astro documentation format support
- Automatic CSS generation
- Enhanced error handling
- License compliance features
2. **Error Handling** ### Changed
- Enhanced error handling with `try-except` blocks, especially for frontmatter parsing and file operations. - Replaced wkhtmltopdf with Playwright
- Updated frontmatter parsing for Astro format
- Improved image and code block processing
--- ### Removed
- wkhtmltopdf dependency
- Original Next.js specific code
## New Features ## License
1. **HTML Preprocessing** This changelog is part of Astro Documentation PDF Generator, licensed under AGPL-3.0.
- Added functions `preprocess_code_blocks` and `process_image_paths` to handle custom Markdown syntax and image path updates for rendering consistency.
2. **Frontmatter Parsing**
- Introduced `parse_frontmatter`, `preprocess_frontmatter`, and `restore_html_tags` functions to manage YAML frontmatter in Markdown files, enhancing metadata handling.
3. **Repository Cloning**
- Added `clone_repo` to handle Git repository cloning with sparse checkout support, improving integration with remote documentation sources.
4. **PDF Generation**
- Integrated Playwright for rendering and generating PDFs from HTML content.
- Added support for custom headers, footers, and styles in the generated PDFs.
5. **Table of Contents (ToC)**
- Automatically generates a ToC from parsed metadata with proper hierarchy and numbering.
---
## Bug Fixes
1. **File Sorting**
- Fixed sorting issues in `get_files_sorted` to prioritize `index.md` and `index.mdx` files.
2. **Open File Check**
- Added `is_file_open` to ensure output files are not already open, preventing write conflicts.
3. **Version Detection**
- Improved `find_latest_version` logic to detect and sort unique versions from HTML content.
---
## Performance Improvements
- Optimized file processing loop to handle large repositories more efficiently.
- Improved Playwright's rendering performance by preloading images and resources.
---