mirror of
https://github.com/amitwh/markdown-converter.git
synced 2026-08-02 18:10:18 +05:30
Compare commits
26
Commits
react-electron
...
v1.4.0
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
5376bddc59 | ||
|
|
d3b67b1388 | ||
|
|
aac496923e | ||
|
|
256f944b88 | ||
|
|
dbe57d2fad | ||
|
|
9a45849003 | ||
|
|
dfb603c2ea | ||
|
|
fda173d9a1 | ||
|
|
ddababf284 | ||
|
|
376fa00b08 | ||
|
|
5cbcfa466d | ||
|
|
328451f88d | ||
|
|
1b10a39b15 | ||
|
|
7fe53b4b9c | ||
|
|
edb163eab4 | ||
|
|
7131d1a38e | ||
|
|
6d3813e5e9 | ||
|
|
bfe362245d | ||
|
|
0d21ddbf15 | ||
|
|
7b5165bcb1 | ||
|
|
5c5cffed83 | ||
|
|
becfec5ae6 | ||
|
|
bd38c5342d | ||
|
|
f3e829ca63 | ||
|
|
b0a96f680a | ||
|
|
a6da95b057 |
@@ -1,189 +1,381 @@
|
|||||||
# Pan Converter
|
# PanConverter - Claude Development Guide
|
||||||
|
|
||||||
## Overview
|
## Project Overview
|
||||||
Pan Converter is a cross-platform desktop application for editing and converting Markdown files using Pandoc. It features a rich markdown editor with live preview, multiple themes, and support for exporting to various formats.
|
|
||||||
|
|
||||||
## Features
|
**PanConverter** is a cross-platform Markdown editor and converter powered by Pandoc, built with Electron. It provides professional-grade editing capabilities with comprehensive export options.
|
||||||
- **Markdown Editor**: Full-featured editor with syntax highlighting
|
|
||||||
- **Live Preview**: Real-time preview of your markdown content
|
|
||||||
- **Multiple Themes**: Light, Dark, Solarized, Monokai, and GitHub themes
|
|
||||||
- **Format Conversion**: Export to HTML, PDF, DOCX, LaTeX, RTF, ODT, and EPUB using Pandoc
|
|
||||||
- **Cross-Platform**: Runs on Windows, macOS, and Linux
|
|
||||||
- **Auto-Save**: Automatic saving every 30 seconds
|
|
||||||
|
|
||||||
## Requirements
|
**Current Version**: v1.4.0
|
||||||
- **Pandoc**: Must be installed on the system for export functionality
|
**Author**: Amit Haridas (amit.wh@gmail.com)
|
||||||
- Ubuntu/Debian: `sudo apt-get install pandoc`
|
**License**: MIT
|
||||||
- macOS: `brew install pandoc`
|
**Repository**: https://github.com/amitwh/pan-converter
|
||||||
- Windows: Download from https://pandoc.org/installing.html
|
|
||||||
|
|
||||||
## Development Setup
|
## Architecture & Technology Stack
|
||||||
|
|
||||||
|
### Core Technologies
|
||||||
|
- **Electron** - Cross-platform desktop application framework
|
||||||
|
- **Pandoc** - Universal document converter (required dependency)
|
||||||
|
- **marked** - Markdown parsing and rendering
|
||||||
|
- **highlight.js** - Syntax highlighting
|
||||||
|
- **XLSX** - Spreadsheet export functionality
|
||||||
|
- **DOMPurify** - HTML sanitization
|
||||||
|
|
||||||
|
### Application Structure
|
||||||
|
```
|
||||||
|
src/
|
||||||
|
├── main.js # Electron main process, menu system, IPC handlers
|
||||||
|
├── renderer.js # TabManager class, multi-file editing, event handling
|
||||||
|
├── index.html # Application layout with tabbed interface
|
||||||
|
└── styles.css # Comprehensive styling with multi-theme support
|
||||||
|
|
||||||
|
assets/
|
||||||
|
└── icon.png # Application icon
|
||||||
|
|
||||||
|
package.json # Dependencies and build configuration
|
||||||
|
CLAUDE.md # Development documentation for AI assistants
|
||||||
|
```
|
||||||
|
|
||||||
|
## Development Commands
|
||||||
|
|
||||||
### Prerequisites
|
### Prerequisites
|
||||||
- Node.js (v14 or higher)
|
|
||||||
- npm or yarn
|
|
||||||
- Pandoc (for export features)
|
|
||||||
|
|
||||||
### Installation
|
|
||||||
```bash
|
```bash
|
||||||
# Clone the repository
|
# Install Node.js dependencies
|
||||||
git clone <repository-url>
|
|
||||||
cd pan-converter
|
|
||||||
|
|
||||||
# Install dependencies
|
|
||||||
npm install
|
npm install
|
||||||
|
|
||||||
# Generate icons
|
# Install Pandoc (required for export functionality)
|
||||||
|
# Ubuntu/Debian:
|
||||||
|
sudo apt-get install pandoc
|
||||||
|
|
||||||
|
# macOS:
|
||||||
|
brew install pandoc
|
||||||
|
|
||||||
|
# Windows: Download from https://pandoc.org/installing.html
|
||||||
|
```
|
||||||
|
|
||||||
|
### Running the Application
|
||||||
|
```bash
|
||||||
|
# Start development server
|
||||||
|
npm start
|
||||||
|
|
||||||
|
# Start with debugging
|
||||||
|
npm start --enable-logging
|
||||||
|
```
|
||||||
|
|
||||||
|
### Building & Packaging
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Generate application icons
|
||||||
npm run generate-icons
|
npm run generate-icons
|
||||||
|
|
||||||
# Start the application
|
# Build for current platform
|
||||||
npm start
|
|
||||||
```
|
|
||||||
|
|
||||||
## Building
|
|
||||||
|
|
||||||
### Build for Current Platform
|
|
||||||
```bash
|
|
||||||
npm run build
|
npm run build
|
||||||
```
|
|
||||||
|
|
||||||
### Build for Specific Platforms
|
# Platform-specific builds
|
||||||
```bash
|
npm run build:win # Windows
|
||||||
# Windows
|
npm run build:mac # macOS
|
||||||
npm run build:win
|
npm run build:linux # Linux (AppImage, .deb, .snap)
|
||||||
|
|
||||||
# macOS
|
# Build for all platforms
|
||||||
npm run build:mac
|
|
||||||
|
|
||||||
# Linux (generates .deb, .AppImage, and .snap)
|
|
||||||
npm run build:linux
|
|
||||||
```
|
|
||||||
|
|
||||||
### Build for All Platforms
|
|
||||||
```bash
|
|
||||||
npm run dist:all
|
npm run dist:all
|
||||||
```
|
```
|
||||||
|
|
||||||
## Project Structure
|
### Git Branch Management
|
||||||
```
|
```bash
|
||||||
pan-converter/
|
# Switch to platform-specific branches
|
||||||
├── src/
|
git checkout linux # Linux development
|
||||||
│ ├── main.js # Main process
|
git checkout macos # macOS development
|
||||||
│ ├── renderer.js # Renderer process
|
git checkout windows # Windows development
|
||||||
│ ├── index.html # Main window HTML
|
git checkout master # Main development branch
|
||||||
│ └── styles.css # Application styles
|
|
||||||
├── assets/
|
# Update all branches with latest changes
|
||||||
│ ├── icon.svg # Source icon
|
git checkout master
|
||||||
│ └── icon.png # Generated icons
|
git push origin master
|
||||||
├── scripts/
|
git checkout linux && git merge master && git push origin linux
|
||||||
│ └── generate-icons.js # Icon generation script
|
git checkout macos && git merge master && git push origin macos
|
||||||
├── package.json # Project configuration
|
git checkout windows && git merge master && git push origin windows
|
||||||
└── CLAUDE.md # This file
|
|
||||||
```
|
```
|
||||||
|
|
||||||
## Architecture
|
### Release Management
|
||||||
|
```bash
|
||||||
|
# Create and push release tag
|
||||||
|
git tag v1.2.1 -m "Release message"
|
||||||
|
git push origin v1.2.1
|
||||||
|
|
||||||
|
# Create GitHub release with packages
|
||||||
|
gh release create v1.2.1 --title "Title" --notes "Release notes" \
|
||||||
|
"dist/PanConverter-1.2.1.AppImage" \
|
||||||
|
"dist/pan-converter_1.2.1_amd64.deb" \
|
||||||
|
"dist/pan-converter_1.2.1_amd64.snap"
|
||||||
|
```
|
||||||
|
|
||||||
|
## Feature Implementation Guide
|
||||||
|
|
||||||
|
### v1.4.0 Advanced Export & Batch Processing (Latest)
|
||||||
|
|
||||||
|
#### 🔧 Fixed File Association Support
|
||||||
|
**File Loading Fix** (`src/main.js:385-390`, `src/renderer.js:485-486`)
|
||||||
|
- Fixed timing issue with file association loading
|
||||||
|
- Added proper `renderer-ready` event to ensure TabManager is initialized
|
||||||
|
- Files now open correctly when double-clicked or opened via right-click menu
|
||||||
|
- Command-line file arguments are properly handled on startup
|
||||||
|
|
||||||
|
#### 🎛️ Advanced Export Options Dialog
|
||||||
|
**Template & Metadata Support** (`src/main.js:247-357`, `src/index.html:117-212`)
|
||||||
|
- Comprehensive export options dialog with professional UI
|
||||||
|
- Template selection (default or custom template files)
|
||||||
|
- Metadata fields (title, author, date, subject) with dynamic field addition
|
||||||
|
- Document options: Table of Contents, section numbering, citations
|
||||||
|
- PDF-specific options: Engine selection (XeLaTeX, PDFLaTeX, LuaLaTeX), custom margins
|
||||||
|
- Bibliography support: .bib, .yaml, .json files with CSL styling
|
||||||
|
- All export formats now use enhanced options dialog
|
||||||
|
|
||||||
|
#### 📁 Batch File Conversion System
|
||||||
|
**Multi-File Processing** (`src/main.js:179-186`, `src/main.js:559-690`)
|
||||||
|
- New "Batch" menu for converting entire folders
|
||||||
|
- Recursive folder processing with progress tracking
|
||||||
|
- Support for all export formats with advanced options
|
||||||
|
- Real-time progress bar and file-by-file status updates
|
||||||
|
- Maintains folder structure in output directory
|
||||||
|
- Error handling with completion statistics
|
||||||
|
|
||||||
|
#### 🎨 Enhanced UI Components
|
||||||
|
**Dialog System** (`src/styles.css:838-1361`)
|
||||||
|
- Professional modal dialogs with backdrop and animations
|
||||||
|
- Theme-aware styling for all new components
|
||||||
|
- Responsive layouts with proper accessibility
|
||||||
|
- Form validation and user feedback systems
|
||||||
|
- Progress indicators for long-running operations
|
||||||
|
|
||||||
|
### v1.3.x Tabbed Interface & Enhanced Features
|
||||||
|
|
||||||
|
#### 🗂️ Tabbed Multi-File Support (v1.3.0)
|
||||||
|
**TabManager Class** (`src/renderer.js`)
|
||||||
|
- Complete tab management system for multiple files
|
||||||
|
- Tab switching, creation, and closure
|
||||||
|
- State preservation per tab (content, cursor position, scroll)
|
||||||
|
- File path tracking for each tab
|
||||||
|
- Keyboard shortcuts: `Ctrl/Cmd+T` (new tab), `Ctrl/Cmd+W` (close tab)
|
||||||
|
|
||||||
|
#### 🎯 Enhanced PDF Export (v1.3.0)
|
||||||
|
**Multi-Engine Fallback System** (`src/main.js:239-280`)
|
||||||
|
- Primary: XeLaTeX with proper margins
|
||||||
|
- Fallback 1: PDFLaTeX
|
||||||
|
- Fallback 2: wkhtmltopdf
|
||||||
|
- Automatic engine detection and switching
|
||||||
|
|
||||||
|
#### 📁 File Association Support (v1.3.1)
|
||||||
|
**OS Integration** (`src/main.js:452-498`, `package.json:50-65`)
|
||||||
|
- Double-click .md files to open in PanConverter
|
||||||
|
- Command-line argument handling
|
||||||
|
- Pending file queue for startup loading
|
||||||
|
|
||||||
|
#### 🎨 Typography & Spacing (v1.3.2-1.3.3)
|
||||||
|
**Preview Enhancement** (`src/styles.css`)
|
||||||
|
- Restored ideal text spacing from v1.0
|
||||||
|
- Font sizes increased to 15px for better readability
|
||||||
|
- Comprehensive selector coverage for legacy and new containers
|
||||||
|
- Theme-aware typography for all content types
|
||||||
|
|
||||||
|
### v1.2.1 Comprehensive Editor Enhancements
|
||||||
|
|
||||||
|
#### ✨ Advanced Editor Features
|
||||||
|
|
||||||
|
**Find & Replace System** (`src/renderer.js:200-350`)
|
||||||
|
- Dialog-based interface with match highlighting
|
||||||
|
- Forward/backward navigation through matches
|
||||||
|
- Replace single or replace all functionality
|
||||||
|
- Real-time match counting and status display
|
||||||
|
- Escape key closes dialog
|
||||||
|
|
||||||
|
**Line Numbers** (`src/renderer.js:450-500`, `src/styles.css:517-598`)
|
||||||
|
- Toggle-able line numbers with toolbar button
|
||||||
|
- Synchronized scrolling with editor content
|
||||||
|
- Theme-aware styling for all supported themes
|
||||||
|
- Dynamic line number generation based on content
|
||||||
|
|
||||||
|
**Undo/Redo System** (`src/renderer.js:100-150`)
|
||||||
|
- Stack-based state management for editor history
|
||||||
|
- Keyboard shortcuts: `Ctrl/Cmd+Z` (undo), `Ctrl/Cmd+Shift+Z` (redo)
|
||||||
|
- Intelligent state saving on text changes
|
||||||
|
- Memory-efficient history management
|
||||||
|
|
||||||
|
**Smart Auto-Indentation** (`src/renderer.js:350-400`)
|
||||||
|
- Automatic list continuation on Enter key
|
||||||
|
- Proper indentation handling for nested lists
|
||||||
|
- Support for ordered and unordered lists
|
||||||
|
- Intelligent whitespace management
|
||||||
|
|
||||||
|
**Enhanced Keyboard Shortcuts** (`src/renderer.js:400-450`)
|
||||||
|
- `Tab`/`Shift+Tab` for line indentation/outdentation
|
||||||
|
- `Enter` for auto-continuing lists
|
||||||
|
- `Ctrl/Cmd+F` for find & replace dialog
|
||||||
|
- `Escape` for closing dialogs
|
||||||
|
|
||||||
|
**Word/Character Count** (`src/renderer.js:500-530`)
|
||||||
|
- Live counting displayed in status bar
|
||||||
|
- Updates automatically as content changes
|
||||||
|
- Word and character statistics
|
||||||
|
|
||||||
|
#### 📤 Export & Conversion Features
|
||||||
|
|
||||||
|
**PowerPoint Export** (`src/main.js:330-350`)
|
||||||
|
- Convert markdown to PPTX presentations
|
||||||
|
- Automatic slide-level formatting (`--slide-level=2`)
|
||||||
|
- Smart presentation structure handling
|
||||||
|
|
||||||
|
**Spreadsheet Export** (`src/main.js:370-457`)
|
||||||
|
- Export markdown tables to Excel (XLSX/XLS) and ODS formats
|
||||||
|
- Multi-table support with separate worksheets
|
||||||
|
- Automatic table detection and parsing
|
||||||
|
- Error handling for files without tables
|
||||||
|
|
||||||
|
**Document Import** (`src/main.js:280-315`)
|
||||||
|
- Import DOCX, ODT, RTF, HTML, PDF, PPTX, ODP files
|
||||||
|
- Automatic conversion to markdown format
|
||||||
|
- File dialog with appropriate filters
|
||||||
|
- Success notifications and error handling
|
||||||
|
|
||||||
|
**Table Creation Helper** (`src/renderer.js:600-650`)
|
||||||
|
- Built-in table generator with row/column specification
|
||||||
|
- Automatic markdown table formatting
|
||||||
|
- Proper header separation and alignment
|
||||||
|
|
||||||
|
#### 🎨 Interface & Theming
|
||||||
|
|
||||||
|
**Multi-Theme Support** (`src/styles.css:214-598`)
|
||||||
|
- Light, Dark, Solarized, Monokai, GitHub themes
|
||||||
|
- Complete theming for all UI components
|
||||||
|
- Theme-aware styling for new features (find dialog, line numbers)
|
||||||
|
- Persistent theme selection with local storage
|
||||||
|
|
||||||
|
**Enhanced UI Components** (`src/index.html:94-108`)
|
||||||
|
- Find & replace dialog with modern styling
|
||||||
|
- Toolbar buttons for all new features
|
||||||
|
- Status bar with live statistics
|
||||||
|
- Responsive layout with proper spacing
|
||||||
|
|
||||||
|
## File Structure & Key Components
|
||||||
|
|
||||||
### Main Process (`src/main.js`)
|
### Main Process (`src/main.js`)
|
||||||
- Manages application lifecycle
|
- **Menu System**: Comprehensive menu with file operations, editing, conversion, view options, batch processing
|
||||||
- Creates and manages windows
|
- **IPC Handlers**: Communication between main and renderer processes
|
||||||
- Handles file operations
|
- **File Operations**: Open, save, import/export functionality with file association support
|
||||||
- Manages menu bar
|
- **Export System**: Advanced export with templates, metadata, and Pandoc integration
|
||||||
- Communicates with renderer via IPC
|
- **Batch Processing**: Multi-file conversion with progress tracking and error handling
|
||||||
|
- **Theme Management**: Persistent theme storage and application
|
||||||
|
- **Spreadsheet Export**: Table extraction and XLSX generation
|
||||||
|
- **About Dialog**: Application information and feature list
|
||||||
|
|
||||||
### Renderer Process (`src/renderer.js`)
|
### Renderer Process (`src/renderer.js`)
|
||||||
- Handles UI interactions
|
- **Editor Initialization**: CodeMirror-like functionality with custom implementation
|
||||||
- Manages editor state
|
- **TabManager System**: Multi-file editing with state management
|
||||||
- Renders markdown preview
|
- **Find & Replace Engine**: Search algorithms with regex support
|
||||||
- Handles theme switching
|
- **Undo/Redo Manager**: History stack management
|
||||||
- Communicates with main process via IPC
|
- **Auto-indentation Logic**: Smart list continuation
|
||||||
|
- **Live Preview**: Real-time markdown rendering with DOMPurify
|
||||||
|
- **Export Dialog Management**: Advanced options collection and validation
|
||||||
|
- **Batch Conversion Interface**: Folder selection, progress tracking, and user feedback
|
||||||
|
- **Event Handling**: Keyboard shortcuts and UI interactions
|
||||||
|
- **Statistics Tracking**: Word/character counting
|
||||||
|
|
||||||
### Key Libraries
|
### Styling (`src/styles.css`)
|
||||||
- **Electron**: Desktop application framework
|
- **Base Styles**: Application layout and typography
|
||||||
- **marked**: Markdown parsing
|
- **Component Styles**: Toolbar, editor, preview, dialogs
|
||||||
- **highlight.js**: Syntax highlighting
|
- **Theme Implementations**: Complete styling for all themes
|
||||||
- **DOMPurify**: HTML sanitization
|
- **Responsive Design**: Flexible layouts and proper spacing
|
||||||
- **electron-store**: Persistent storage
|
- **Animation Support**: Smooth transitions and hover effects
|
||||||
- **electron-builder**: Application packaging
|
|
||||||
|
|
||||||
## Features Implementation
|
### HTML Structure (`src/index.html`)
|
||||||
|
- **Toolbar**: Feature buttons with SVG icons
|
||||||
|
- **Tab Bar**: Multi-file navigation with close buttons
|
||||||
|
- **Find Dialog**: Search and replace interface
|
||||||
|
- **Export Options Dialog**: Advanced export configuration with templates and metadata
|
||||||
|
- **Batch Conversion Dialog**: Folder selection and conversion progress
|
||||||
|
- **Editor Container**: Line numbers and text editor with tab content management
|
||||||
|
- **Preview Pane**: Rendered markdown display
|
||||||
|
- **Status Bar**: Statistics and application status
|
||||||
|
|
||||||
### Markdown Editor
|
## Testing & Quality Assurance
|
||||||
- Uses native textarea with custom styling
|
|
||||||
- Supports common markdown shortcuts via toolbar
|
|
||||||
- Tab key inserts 4 spaces for code indentation
|
|
||||||
- Auto-save every 30 seconds when content changes
|
|
||||||
|
|
||||||
### Live Preview
|
### Manual Testing Checklist
|
||||||
- Updates in real-time as you type
|
- [ ] All keyboard shortcuts work correctly
|
||||||
- Sanitized HTML output for security
|
- [ ] Find & replace functions properly with edge cases
|
||||||
- Syntax highlighting for code blocks
|
- [ ] Line numbers sync correctly with content
|
||||||
- GitHub-flavored markdown support
|
- [ ] Undo/redo preserves cursor position
|
||||||
|
- [ ] Auto-indentation works with various list types
|
||||||
|
- [ ] File association loading (double-click .md files)
|
||||||
|
- [ ] Export options dialog with templates and metadata
|
||||||
|
- [ ] Batch conversion with progress tracking
|
||||||
|
- [ ] All themes render correctly for new components
|
||||||
|
- [ ] Export functions work with various document formats
|
||||||
|
- [ ] Table creation and export functionality
|
||||||
|
- [ ] Cross-platform compatibility
|
||||||
|
|
||||||
### Theme System
|
### Known Issues & Limitations
|
||||||
- Themes stored in user preferences
|
- AppImage may require `--no-sandbox` flag on some Linux systems
|
||||||
- Applied via CSS classes on body element
|
- Large files (>1MB) may cause performance issues
|
||||||
- Persists across application restarts
|
- Windows/Mac builds require platform-specific environments
|
||||||
- Five built-in themes
|
- Pandoc must be installed separately for export functionality
|
||||||
|
|
||||||
### Export System
|
## Deployment & Distribution
|
||||||
- Uses Pandoc command-line tool
|
|
||||||
- Supports multiple output formats
|
|
||||||
- Maintains original file structure
|
|
||||||
- Shows error messages if Pandoc not installed
|
|
||||||
|
|
||||||
## Platform-Specific Branches
|
### Release Packages
|
||||||
|
- **Linux AppImage**: Universal Linux package (self-contained)
|
||||||
|
- **Debian Package**: `.deb` for Ubuntu/Debian systems
|
||||||
|
- **Snap Package**: Universal Linux package via Snap Store
|
||||||
|
- **Future**: Windows `.exe` and macOS `.dmg` packages
|
||||||
|
|
||||||
The repository maintains separate branches for platform-specific customizations:
|
### Release Process
|
||||||
- `master`: Main development branch
|
1. Update version in `package.json`, `src/main.js`, and `README.md`
|
||||||
- `linux`: Linux-specific configurations
|
2. Commit changes and push to all platform branches
|
||||||
- `macos`: macOS-specific configurations
|
3. Build platform-specific packages
|
||||||
- `windows`: Windows-specific configurations
|
4. Create Git tag and GitHub release
|
||||||
|
5. Upload packages to GitHub release
|
||||||
|
6. Update documentation and announce release
|
||||||
|
|
||||||
## Debian Package
|
## Contributing Guidelines
|
||||||
|
|
||||||
The application can be built as a `.deb` package for Debian-based systems:
|
### Code Style
|
||||||
```bash
|
- Use consistent indentation (2 spaces)
|
||||||
npm run build:linux
|
- Follow JavaScript ES6+ standards
|
||||||
```
|
- Comment complex functionality
|
||||||
|
- Maintain separation between main and renderer processes
|
||||||
|
- Use descriptive variable and function names
|
||||||
|
|
||||||
The generated `.deb` file will:
|
### Adding New Features
|
||||||
- Install to `/opt/pan-converter`
|
1. Plan feature implementation and UI integration
|
||||||
- Create desktop entry for application menu
|
2. Update relevant files (main.js, renderer.js, styles.css)
|
||||||
- Set up proper file associations
|
3. Test across all supported themes
|
||||||
- Declare Pandoc as dependency
|
4. Update documentation and README
|
||||||
|
5. Test on multiple platforms if possible
|
||||||
|
6. Submit pull request with detailed description
|
||||||
|
|
||||||
## Testing
|
### Bug Reporting
|
||||||
|
- Include steps to reproduce
|
||||||
|
- Specify platform and version information
|
||||||
|
- Attach relevant screenshots or error logs
|
||||||
|
- Check existing issues before creating new ones
|
||||||
|
|
||||||
### Manual Testing
|
## Future Roadmap
|
||||||
1. File Operations: New, Open, Save, Save As
|
|
||||||
2. Editor Features: Bold, Italic, Headings, Links, Code, Lists, Quotes
|
|
||||||
3. Preview Toggle: Show/hide preview pane
|
|
||||||
4. Theme Switching: Test all five themes
|
|
||||||
5. Export Functions: Test each export format
|
|
||||||
6. Auto-save: Verify 30-second auto-save works
|
|
||||||
|
|
||||||
### Platform Testing
|
### Planned Features
|
||||||
Test on:
|
- [ ] Collaborative editing capabilities
|
||||||
- Windows 10/11
|
- [ ] Plugin system for extensions
|
||||||
- macOS 11+ (Big Sur and later)
|
- [ ] Advanced markdown extensions (math, diagrams)
|
||||||
- Ubuntu 20.04+, Debian 11+
|
- [ ] Cloud synchronization options
|
||||||
|
- [ ] Mobile companion app
|
||||||
|
- [ ] Advanced export templates
|
||||||
|
- [ ] Spell check and grammar checking
|
||||||
|
- [ ] Version control integration
|
||||||
|
|
||||||
## Known Issues
|
### Technical Improvements
|
||||||
- ICO and ICNS icons need manual conversion from PNG
|
- [ ] Performance optimization for large files
|
||||||
- Pandoc must be installed separately
|
- [ ] Memory usage optimization
|
||||||
- Large files may cause performance issues
|
- [ ] Startup time improvements
|
||||||
|
- [ ] Better error handling and user feedback
|
||||||
|
- [ ] Automated testing suite
|
||||||
|
- [ ] Continuous integration/deployment
|
||||||
|
|
||||||
## Future Enhancements
|
---
|
||||||
- [ ] Add spell checking
|
|
||||||
- [ ] Implement find and replace
|
|
||||||
- [ ] Add custom CSS for preview
|
|
||||||
- [ ] Support for markdown extensions
|
|
||||||
- [ ] Plugin system for custom exporters
|
|
||||||
- [ ] Cloud sync capabilities
|
|
||||||
- [ ] Collaborative editing
|
|
||||||
|
|
||||||
## License
|
**Last Updated**: September 14, 2025
|
||||||
MIT License
|
**Claude Assistant**: Development completed for v1.4.0 with fixed file associations, advanced export options with templates and metadata, batch file conversion system, and enhanced UI components.
|
||||||
|
|
||||||
## Support
|
|
||||||
For issues or feature requests, please open an issue on the GitHub repository.
|
|
||||||
+378
@@ -0,0 +1,378 @@
|
|||||||
|
\hypertarget{panconverter}{%
|
||||||
|
\section{PanConverter}\label{panconverter}}
|
||||||
|
|
||||||
|
A cross-platform Markdown editor and converter powered by Pandoc.
|
||||||
|
|
||||||
|
\begin{figure}
|
||||||
|
\centering
|
||||||
|
\includegraphics{assets/icon.png}
|
||||||
|
\caption{PanConverter}
|
||||||
|
\end{figure}
|
||||||
|
|
||||||
|
\hypertarget{features}{%
|
||||||
|
\subsection{Features}\label{features}}
|
||||||
|
|
||||||
|
\hypertarget{advanced-markdown-editor}{%
|
||||||
|
\subsubsection{✨ Advanced Markdown
|
||||||
|
Editor}\label{advanced-markdown-editor}}
|
||||||
|
|
||||||
|
\begin{itemize}
|
||||||
|
\tightlist
|
||||||
|
\item
|
||||||
|
🗂️ \textbf{Tabbed Interface} - Work with multiple files simultaneously
|
||||||
|
in separate tabs
|
||||||
|
\item
|
||||||
|
📝 \textbf{Rich Text Editor} - Full-featured editor with syntax
|
||||||
|
highlighting and comprehensive toolbar
|
||||||
|
\item
|
||||||
|
🔍 \textbf{Find \& Replace} - Powerful search and replace with match
|
||||||
|
highlighting and navigation
|
||||||
|
\item
|
||||||
|
🔢 \textbf{Line Numbers} - Toggle line numbers for easier code editing
|
||||||
|
and navigation
|
||||||
|
\item
|
||||||
|
↩️ \textbf{Smart Auto-Indentation} - Automatic list continuation and
|
||||||
|
intelligent indentation
|
||||||
|
\item
|
||||||
|
⏪ \textbf{Undo/Redo} - Full undo/redo support with keyboard shortcuts
|
||||||
|
\item
|
||||||
|
⌨️ \textbf{Advanced Shortcuts} - Tab indentation, line selection, and
|
||||||
|
smart text formatting
|
||||||
|
\item
|
||||||
|
📂 \textbf{File Association Support} - Open markdown files directly
|
||||||
|
from file manager
|
||||||
|
\end{itemize}
|
||||||
|
|
||||||
|
\hypertarget{themes-interface}{%
|
||||||
|
\subsubsection{🎨 Themes \& Interface}\label{themes-interface}}
|
||||||
|
|
||||||
|
\begin{itemize}
|
||||||
|
\tightlist
|
||||||
|
\item
|
||||||
|
👁️ \textbf{Live Preview} - See your markdown rendered in real-time
|
||||||
|
with synchronized scrolling
|
||||||
|
\item
|
||||||
|
🎨 \textbf{Multiple Themes} - Choose from Light, Dark, Solarized,
|
||||||
|
Monokai, or GitHub themes
|
||||||
|
\item
|
||||||
|
💾 \textbf{Auto-Save} - Never lose your work with automatic saving
|
||||||
|
every 30 seconds
|
||||||
|
\end{itemize}
|
||||||
|
|
||||||
|
\hypertarget{export-conversion}{%
|
||||||
|
\subsubsection{📤 Export \& Conversion}\label{export-conversion}}
|
||||||
|
|
||||||
|
\begin{itemize}
|
||||||
|
\tightlist
|
||||||
|
\item
|
||||||
|
📄 \textbf{Enhanced PDF Export} - Robust PDF generation with multiple
|
||||||
|
LaTeX engine fallbacks (XeLaTeX, PDFLaTeX, wkhtmltopdf)
|
||||||
|
\item
|
||||||
|
📄 \textbf{Document Export} - Convert to HTML, DOCX, LaTeX, RTF, ODT,
|
||||||
|
EPUB, PowerPoint (PPTX), and OpenDocument Presentation (ODP)
|
||||||
|
\item
|
||||||
|
📊 \textbf{Spreadsheet Export} - Export markdown tables to Excel
|
||||||
|
(XLSX/XLS) and OpenDocument Spreadsheet (ODS) formats
|
||||||
|
\item
|
||||||
|
📥 \textbf{Document Import} - Import DOCX, ODT, RTF, HTML, PDF, and
|
||||||
|
presentation files to markdown
|
||||||
|
\item
|
||||||
|
📋 \textbf{Table Creation Helper} - Built-in table generator for easy
|
||||||
|
markdown table creation
|
||||||
|
\end{itemize}
|
||||||
|
|
||||||
|
\hypertarget{platform-support}{%
|
||||||
|
\subsubsection{🖥️ Platform Support}\label{platform-support}}
|
||||||
|
|
||||||
|
\begin{itemize}
|
||||||
|
\tightlist
|
||||||
|
\item
|
||||||
|
\textbf{Cross-Platform} - Works seamlessly on Windows, macOS, and
|
||||||
|
Linux
|
||||||
|
\end{itemize}
|
||||||
|
|
||||||
|
\hypertarget{installation}{%
|
||||||
|
\subsection{Installation}\label{installation}}
|
||||||
|
|
||||||
|
\hypertarget{prerequisites}{%
|
||||||
|
\subsubsection{Prerequisites}\label{prerequisites}}
|
||||||
|
|
||||||
|
\begin{itemize}
|
||||||
|
\tightlist
|
||||||
|
\item
|
||||||
|
\href{https://pandoc.org/installing.html}{Pandoc} must be installed
|
||||||
|
for export functionality
|
||||||
|
|
||||||
|
\begin{itemize}
|
||||||
|
\tightlist
|
||||||
|
\item
|
||||||
|
\textbf{Ubuntu/Debian}: \texttt{sudo\ apt-get\ install\ pandoc}
|
||||||
|
\item
|
||||||
|
\textbf{macOS}: \texttt{brew\ install\ pandoc}
|
||||||
|
\item
|
||||||
|
\textbf{Windows}: Download installer from Pandoc website
|
||||||
|
\end{itemize}
|
||||||
|
\end{itemize}
|
||||||
|
|
||||||
|
\hypertarget{pdf-export-requirements}{%
|
||||||
|
\subsubsection{PDF Export Requirements}\label{pdf-export-requirements}}
|
||||||
|
|
||||||
|
For optimal PDF export, install a LaTeX engine (recommended): -
|
||||||
|
\textbf{Ubuntu/Debian}:
|
||||||
|
\texttt{sudo\ apt-get\ install\ texlive-xetex\ texlive-latex-base} -
|
||||||
|
\textbf{macOS}: \texttt{brew\ install\ -\/-cask\ mactex} -
|
||||||
|
\textbf{Windows}: Install MiKTeX or TeX Live - \textbf{Alternative}:
|
||||||
|
\texttt{sudo\ apt-get\ install\ wkhtmltopdf} (fallback option)
|
||||||
|
|
||||||
|
\hypertarget{download}{%
|
||||||
|
\subsubsection{Download}\label{download}}
|
||||||
|
|
||||||
|
Download the latest release for your platform from the
|
||||||
|
\href{https://github.com/amitwh/pan-converter/releases}{Releases} page.
|
||||||
|
|
||||||
|
\hypertarget{linux}{%
|
||||||
|
\paragraph{Linux}\label{linux}}
|
||||||
|
|
||||||
|
\begin{itemize}
|
||||||
|
\tightlist
|
||||||
|
\item
|
||||||
|
\textbf{AppImage}: \texttt{PanConverter-1.3.1.AppImage} (universal,
|
||||||
|
may require \texttt{-\/-no-sandbox} flag)
|
||||||
|
\item
|
||||||
|
\textbf{Debian Package}: \texttt{pan-converter\_1.3.1\_amd64.deb}
|
||||||
|
\item
|
||||||
|
\textbf{Snap Package}: \texttt{pan-converter\_1.3.1\_amd64.snap}
|
||||||
|
\end{itemize}
|
||||||
|
|
||||||
|
\hypertarget{install-from-source}{%
|
||||||
|
\subsubsection{Install from Source}\label{install-from-source}}
|
||||||
|
|
||||||
|
\begin{Shaded}
|
||||||
|
\begin{Highlighting}[]
|
||||||
|
\FunctionTok{git}\NormalTok{ clone https://github.com/amitwh/pan{-}converter.git}
|
||||||
|
\BuiltInTok{cd}\NormalTok{ pan{-}converter}
|
||||||
|
\ExtensionTok{npm}\NormalTok{ install}
|
||||||
|
\ExtensionTok{npm}\NormalTok{ start}
|
||||||
|
\end{Highlighting}
|
||||||
|
\end{Shaded}
|
||||||
|
|
||||||
|
\hypertarget{usage}{%
|
||||||
|
\subsection{Usage}\label{usage}}
|
||||||
|
|
||||||
|
\hypertarget{basic-workflow}{%
|
||||||
|
\subsubsection{Basic Workflow}\label{basic-workflow}}
|
||||||
|
|
||||||
|
\begin{enumerate}
|
||||||
|
\def\labelenumi{\arabic{enumi}.}
|
||||||
|
\tightlist
|
||||||
|
\item
|
||||||
|
\textbf{Write} - Use the editor to write your Markdown content
|
||||||
|
\item
|
||||||
|
\textbf{Preview} - Toggle the preview pane to see rendered output
|
||||||
|
\item
|
||||||
|
\textbf{Theme} - Choose your preferred theme from the View menu
|
||||||
|
\item
|
||||||
|
\textbf{Export} - Export your document to various formats
|
||||||
|
\end{enumerate}
|
||||||
|
|
||||||
|
\hypertarget{export-options}{%
|
||||||
|
\subsubsection{Export Options}\label{export-options}}
|
||||||
|
|
||||||
|
\begin{itemize}
|
||||||
|
\tightlist
|
||||||
|
\item
|
||||||
|
\textbf{Documents}: HTML, PDF, DOCX, LaTeX, RTF, ODT, EPUB
|
||||||
|
\item
|
||||||
|
\textbf{Presentations}: PowerPoint (PPTX), OpenDocument Presentation
|
||||||
|
(ODP)
|
||||||
|
\item
|
||||||
|
\textbf{Spreadsheets}: Excel (XLSX/XLS), OpenDocument Spreadsheet
|
||||||
|
(ODS)
|
||||||
|
\end{itemize}
|
||||||
|
|
||||||
|
\hypertarget{import-conversion}{%
|
||||||
|
\subsubsection{Import \& Conversion}\label{import-conversion}}
|
||||||
|
|
||||||
|
\begin{itemize}
|
||||||
|
\tightlist
|
||||||
|
\item
|
||||||
|
\textbf{Import Documents}: Convert DOCX, ODT, RTF, HTML, PDF, and
|
||||||
|
presentation files to Markdown
|
||||||
|
\item
|
||||||
|
\textbf{Cross-Format Conversion}: Convert current file between
|
||||||
|
multiple formats
|
||||||
|
\item
|
||||||
|
\textbf{Smart Presentation Handling}: Automatic slide-level formatting
|
||||||
|
for PPTX/ODP exports
|
||||||
|
\end{itemize}
|
||||||
|
|
||||||
|
\hypertarget{table-creation}{%
|
||||||
|
\subsubsection{Table Creation}\label{table-creation}}
|
||||||
|
|
||||||
|
\begin{itemize}
|
||||||
|
\tightlist
|
||||||
|
\item
|
||||||
|
Click the table button in the toolbar
|
||||||
|
\item
|
||||||
|
Specify number of rows and columns
|
||||||
|
\item
|
||||||
|
Automatically generates properly formatted Markdown tables
|
||||||
|
\end{itemize}
|
||||||
|
|
||||||
|
\hypertarget{keyboard-shortcuts}{%
|
||||||
|
\subsection{Keyboard Shortcuts}\label{keyboard-shortcuts}}
|
||||||
|
|
||||||
|
\hypertarget{file-operations}{%
|
||||||
|
\subsubsection{File Operations}\label{file-operations}}
|
||||||
|
|
||||||
|
\begin{itemize}
|
||||||
|
\tightlist
|
||||||
|
\item
|
||||||
|
\texttt{Ctrl/Cmd\ +\ N} - New file/tab
|
||||||
|
\item
|
||||||
|
\texttt{Ctrl/Cmd\ +\ T} - New tab
|
||||||
|
\item
|
||||||
|
\texttt{Ctrl/Cmd\ +\ W} - Close current tab
|
||||||
|
\item
|
||||||
|
\texttt{Ctrl/Cmd\ +\ Tab} - Switch to next tab
|
||||||
|
\item
|
||||||
|
\texttt{Ctrl/Cmd\ +\ O} - Open file
|
||||||
|
\item
|
||||||
|
\texttt{Ctrl/Cmd\ +\ S} - Save file
|
||||||
|
\item
|
||||||
|
\texttt{Ctrl/Cmd\ +\ Shift\ +\ S} - Save as
|
||||||
|
\item
|
||||||
|
\texttt{Ctrl/Cmd\ +\ I} - Import document
|
||||||
|
\end{itemize}
|
||||||
|
|
||||||
|
\hypertarget{editor-features}{%
|
||||||
|
\subsubsection{Editor Features}\label{editor-features}}
|
||||||
|
|
||||||
|
\begin{itemize}
|
||||||
|
\tightlist
|
||||||
|
\item
|
||||||
|
\texttt{Ctrl/Cmd\ +\ F} - Find \& Replace
|
||||||
|
\item
|
||||||
|
\texttt{Ctrl/Cmd\ +\ Z} - Undo
|
||||||
|
\item
|
||||||
|
\texttt{Ctrl/Cmd\ +\ Shift\ +\ Z} - Redo
|
||||||
|
\item
|
||||||
|
\texttt{Tab} - Indent lines or insert 4 spaces
|
||||||
|
\item
|
||||||
|
\texttt{Shift\ +\ Tab} - Outdent selected lines
|
||||||
|
\item
|
||||||
|
\texttt{Enter} - Auto-continue lists with proper indentation
|
||||||
|
\end{itemize}
|
||||||
|
|
||||||
|
\hypertarget{view-navigation}{%
|
||||||
|
\subsubsection{View \& Navigation}\label{view-navigation}}
|
||||||
|
|
||||||
|
\begin{itemize}
|
||||||
|
\tightlist
|
||||||
|
\item
|
||||||
|
\texttt{Ctrl/Cmd\ +\ P} - Toggle preview
|
||||||
|
\item
|
||||||
|
\texttt{Ctrl/Cmd\ +\ Enter} - Toggle preview (alternative)
|
||||||
|
\item
|
||||||
|
\texttt{Escape} - Close find dialog
|
||||||
|
\end{itemize}
|
||||||
|
|
||||||
|
\hypertarget{building}{%
|
||||||
|
\subsection{Building}\label{building}}
|
||||||
|
|
||||||
|
\begin{Shaded}
|
||||||
|
\begin{Highlighting}[]
|
||||||
|
\CommentTok{\# Install dependencies}
|
||||||
|
\ExtensionTok{npm}\NormalTok{ install}
|
||||||
|
|
||||||
|
\CommentTok{\# Generate icons}
|
||||||
|
\ExtensionTok{npm}\NormalTok{ run generate{-}icons}
|
||||||
|
|
||||||
|
\CommentTok{\# Build for current platform}
|
||||||
|
\ExtensionTok{npm}\NormalTok{ run build}
|
||||||
|
|
||||||
|
\CommentTok{\# Build for specific platform}
|
||||||
|
\ExtensionTok{npm}\NormalTok{ run build:win }\CommentTok{\# Windows}
|
||||||
|
\ExtensionTok{npm}\NormalTok{ run build:mac }\CommentTok{\# macOS }
|
||||||
|
\ExtensionTok{npm}\NormalTok{ run build:linux }\CommentTok{\# Linux (generates .deb, .AppImage, and .snap)}
|
||||||
|
|
||||||
|
\CommentTok{\# Build for all platforms}
|
||||||
|
\ExtensionTok{npm}\NormalTok{ run dist:all}
|
||||||
|
\end{Highlighting}
|
||||||
|
\end{Shaded}
|
||||||
|
|
||||||
|
\hypertarget{version-history}{%
|
||||||
|
\subsection{Version History}\label{version-history}}
|
||||||
|
|
||||||
|
\begin{itemize}
|
||||||
|
\tightlist
|
||||||
|
\item
|
||||||
|
\textbf{v1.3.1} - Bug fixes: Fixed file associations for
|
||||||
|
double-clicking .md files, corrected 50/50 layout alignment for
|
||||||
|
editor/preview panes
|
||||||
|
\item
|
||||||
|
\textbf{v1.3.0} - Major update: Tabbed interface for multiple files,
|
||||||
|
enhanced PDF export with LaTeX engines, fixed file associations,
|
||||||
|
removed redundant converter menu, improved UI architecture
|
||||||
|
\item
|
||||||
|
\textbf{v1.2.1} - Comprehensive editor enhancements: Find \& Replace,
|
||||||
|
Line Numbers, Undo/Redo, Auto-indentation, PowerPoint export, document
|
||||||
|
conversion menu, table creation helper, spreadsheet export
|
||||||
|
\item
|
||||||
|
\textbf{v1.1.0} - Added Excel/ODS spreadsheet export, updated author
|
||||||
|
information, renamed to PanConverter
|
||||||
|
\item
|
||||||
|
\textbf{v1.0.0} - Initial release with basic markdown editing, themes,
|
||||||
|
and Pandoc export
|
||||||
|
\end{itemize}
|
||||||
|
|
||||||
|
\hypertarget{known-issues}{%
|
||||||
|
\subsection{Known Issues}\label{known-issues}}
|
||||||
|
|
||||||
|
\begin{itemize}
|
||||||
|
\tightlist
|
||||||
|
\item
|
||||||
|
AppImage may require \texttt{-\/-no-sandbox} flag on some Linux
|
||||||
|
systems
|
||||||
|
\item
|
||||||
|
Windows/Mac builds require platform-specific build environments
|
||||||
|
\item
|
||||||
|
Large files may cause performance issues
|
||||||
|
\end{itemize}
|
||||||
|
|
||||||
|
\hypertarget{contributing}{%
|
||||||
|
\subsection{Contributing}\label{contributing}}
|
||||||
|
|
||||||
|
Contributions are welcome! Please feel free to submit a Pull Request to
|
||||||
|
the \href{https://github.com/amitwh/pan-converter}{GitHub repository}.
|
||||||
|
|
||||||
|
\hypertarget{license}{%
|
||||||
|
\subsection{License}\label{license}}
|
||||||
|
|
||||||
|
MIT License - see LICENSE file for details.
|
||||||
|
|
||||||
|
\hypertarget{author}{%
|
||||||
|
\subsection{Author}\label{author}}
|
||||||
|
|
||||||
|
\textbf{Amit Haridas} -
|
||||||
|
\href{mailto:amit.wh@gmail.com}{\nolinkurl{amit.wh@gmail.com}}
|
||||||
|
|
||||||
|
\hypertarget{acknowledgments}{%
|
||||||
|
\subsection{Acknowledgments}\label{acknowledgments}}
|
||||||
|
|
||||||
|
\begin{itemize}
|
||||||
|
\tightlist
|
||||||
|
\item
|
||||||
|
Built with \href{https://www.electronjs.org/}{Electron}
|
||||||
|
\item
|
||||||
|
Markdown parsing by \href{https://marked.js.org/}{marked}
|
||||||
|
\item
|
||||||
|
Export functionality powered by \href{https://pandoc.org/}{Pandoc}
|
||||||
|
\item
|
||||||
|
Syntax highlighting by \href{https://highlightjs.org/}{highlight.js}
|
||||||
|
\item
|
||||||
|
Spreadsheet export by \href{https://www.npmjs.com/package/xlsx}{XLSX}
|
||||||
|
\item
|
||||||
|
HTML sanitization by
|
||||||
|
\href{https://www.npmjs.com/package/dompurify}{DOMPurify}
|
||||||
|
\end{itemize}
|
||||||
@@ -6,24 +6,57 @@ A cross-platform Markdown editor and converter powered by Pandoc.
|
|||||||
|
|
||||||
## Features
|
## Features
|
||||||
|
|
||||||
- 📝 **Rich Markdown Editor** - Full-featured editor with syntax highlighting
|
### ✨ Advanced Markdown Editor
|
||||||
- 👁️ **Live Preview** - See your markdown rendered in real-time
|
- 🗂️ **Tabbed Interface** - Work with multiple files simultaneously in separate tabs
|
||||||
|
- 📝 **Rich Text Editor** - Full-featured editor with syntax highlighting and comprehensive toolbar
|
||||||
|
- 🔍 **Find & Replace** - Powerful search and replace with match highlighting and navigation
|
||||||
|
- 🔢 **Line Numbers** - Toggle line numbers for easier code editing and navigation
|
||||||
|
- ↩️ **Smart Auto-Indentation** - Automatic list continuation and intelligent indentation
|
||||||
|
- ⏪ **Undo/Redo** - Full undo/redo support with keyboard shortcuts
|
||||||
|
- ⌨️ **Advanced Shortcuts** - Tab indentation, line selection, and smart text formatting
|
||||||
|
- 📂 **File Association Support** - Open markdown files directly from file manager
|
||||||
|
|
||||||
|
### 🎨 Themes & Interface
|
||||||
|
- 👁️ **Live Preview** - See your markdown rendered in real-time with synchronized scrolling
|
||||||
- 🎨 **Multiple Themes** - Choose from Light, Dark, Solarized, Monokai, or GitHub themes
|
- 🎨 **Multiple Themes** - Choose from Light, Dark, Solarized, Monokai, or GitHub themes
|
||||||
- 📤 **Export to Multiple Formats** - Convert to HTML, PDF, DOCX, LaTeX, RTF, ODT, and EPUB
|
- 💾 **Auto-Save** - Never lose your work with automatic saving every 30 seconds
|
||||||
- 💾 **Auto-Save** - Never lose your work with automatic saving
|
|
||||||
- 🖥️ **Cross-Platform** - Works on Windows, macOS, and Linux
|
### 📤 Export & Conversion
|
||||||
|
- 📄 **Enhanced PDF Export** - Robust PDF generation with multiple LaTeX engine fallbacks (XeLaTeX, PDFLaTeX, wkhtmltopdf)
|
||||||
|
- 📄 **Document Export** - Convert to HTML, DOCX, LaTeX, RTF, ODT, EPUB, PowerPoint (PPTX), and OpenDocument Presentation (ODP)
|
||||||
|
- 📊 **Spreadsheet Export** - Export markdown tables to Excel (XLSX/XLS) and OpenDocument Spreadsheet (ODS) formats
|
||||||
|
- 📥 **Document Import** - Import DOCX, ODT, RTF, HTML, PDF, and presentation files to markdown
|
||||||
|
- 📋 **Table Creation Helper** - Built-in table generator for easy markdown table creation
|
||||||
|
|
||||||
|
### 🖥️ Platform Support
|
||||||
|
- **Cross-Platform** - Works seamlessly on Windows, macOS, and Linux
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
### Prerequisites
|
### Prerequisites
|
||||||
- [Pandoc](https://pandoc.org/installing.html) must be installed for export functionality
|
- [Pandoc](https://pandoc.org/installing.html) must be installed for export functionality
|
||||||
|
- **Ubuntu/Debian**: `sudo apt-get install pandoc`
|
||||||
|
- **macOS**: `brew install pandoc`
|
||||||
|
- **Windows**: Download installer from Pandoc website
|
||||||
|
|
||||||
|
### PDF Export Requirements
|
||||||
|
For optimal PDF export, install a LaTeX engine (recommended):
|
||||||
|
- **Ubuntu/Debian**: `sudo apt-get install texlive-xetex texlive-latex-base`
|
||||||
|
- **macOS**: `brew install --cask mactex`
|
||||||
|
- **Windows**: Install MiKTeX or TeX Live
|
||||||
|
- **Alternative**: `sudo apt-get install wkhtmltopdf` (fallback option)
|
||||||
|
|
||||||
### Download
|
### Download
|
||||||
Download the latest release for your platform from the [Releases](https://github.com/yourusername/pan-converter/releases) page.
|
Download the latest release for your platform from the [Releases](https://github.com/amitwh/pan-converter/releases) page.
|
||||||
|
|
||||||
|
#### Linux
|
||||||
|
- **AppImage**: `PanConverter-1.3.1.AppImage` (universal, may require `--no-sandbox` flag)
|
||||||
|
- **Debian Package**: `pan-converter_1.3.1_amd64.deb`
|
||||||
|
- **Snap Package**: `pan-converter_1.3.1_amd64.snap`
|
||||||
|
|
||||||
### Install from Source
|
### Install from Source
|
||||||
```bash
|
```bash
|
||||||
git clone https://github.com/yourusername/pan-converter.git
|
git clone https://github.com/amitwh/pan-converter.git
|
||||||
cd pan-converter
|
cd pan-converter
|
||||||
npm install
|
npm install
|
||||||
npm start
|
npm start
|
||||||
@@ -31,45 +64,104 @@ npm start
|
|||||||
|
|
||||||
## Usage
|
## Usage
|
||||||
|
|
||||||
|
### Basic Workflow
|
||||||
1. **Write** - Use the editor to write your Markdown content
|
1. **Write** - Use the editor to write your Markdown content
|
||||||
2. **Preview** - Toggle the preview pane to see rendered output
|
2. **Preview** - Toggle the preview pane to see rendered output
|
||||||
3. **Theme** - Choose your preferred theme from the View menu
|
3. **Theme** - Choose your preferred theme from the View menu
|
||||||
4. **Export** - Export your document to various formats via File > Export
|
4. **Export** - Export your document to various formats
|
||||||
|
|
||||||
|
### Export Options
|
||||||
|
- **Documents**: HTML, PDF, DOCX, LaTeX, RTF, ODT, EPUB
|
||||||
|
- **Presentations**: PowerPoint (PPTX), OpenDocument Presentation (ODP)
|
||||||
|
- **Spreadsheets**: Excel (XLSX/XLS), OpenDocument Spreadsheet (ODS)
|
||||||
|
|
||||||
|
### Import & Conversion
|
||||||
|
- **Import Documents**: Convert DOCX, ODT, RTF, HTML, PDF, and presentation files to Markdown
|
||||||
|
- **Cross-Format Conversion**: Convert current file between multiple formats
|
||||||
|
- **Smart Presentation Handling**: Automatic slide-level formatting for PPTX/ODP exports
|
||||||
|
|
||||||
|
### Table Creation
|
||||||
|
- Click the table button in the toolbar
|
||||||
|
- Specify number of rows and columns
|
||||||
|
- Automatically generates properly formatted Markdown tables
|
||||||
|
|
||||||
## Keyboard Shortcuts
|
## Keyboard Shortcuts
|
||||||
|
|
||||||
- `Ctrl/Cmd + N` - New file
|
### File Operations
|
||||||
|
- `Ctrl/Cmd + N` - New file/tab
|
||||||
|
- `Ctrl/Cmd + T` - New tab
|
||||||
|
- `Ctrl/Cmd + W` - Close current tab
|
||||||
|
- `Ctrl/Cmd + Tab` - Switch to next tab
|
||||||
- `Ctrl/Cmd + O` - Open file
|
- `Ctrl/Cmd + O` - Open file
|
||||||
- `Ctrl/Cmd + S` - Save file
|
- `Ctrl/Cmd + S` - Save file
|
||||||
- `Ctrl/Cmd + Shift + S` - Save as
|
- `Ctrl/Cmd + Shift + S` - Save as
|
||||||
|
- `Ctrl/Cmd + I` - Import document
|
||||||
|
|
||||||
|
### Editor Features
|
||||||
|
- `Ctrl/Cmd + F` - Find & Replace
|
||||||
|
- `Ctrl/Cmd + Z` - Undo
|
||||||
|
- `Ctrl/Cmd + Shift + Z` - Redo
|
||||||
|
- `Tab` - Indent lines or insert 4 spaces
|
||||||
|
- `Shift + Tab` - Outdent selected lines
|
||||||
|
- `Enter` - Auto-continue lists with proper indentation
|
||||||
|
|
||||||
|
### View & Navigation
|
||||||
- `Ctrl/Cmd + P` - Toggle preview
|
- `Ctrl/Cmd + P` - Toggle preview
|
||||||
- `Ctrl/Cmd + Enter` - Toggle preview (alternative)
|
- `Ctrl/Cmd + Enter` - Toggle preview (alternative)
|
||||||
|
- `Escape` - Close find dialog
|
||||||
|
|
||||||
## Building
|
## Building
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
|
# Install dependencies
|
||||||
|
npm install
|
||||||
|
|
||||||
|
# Generate icons
|
||||||
|
npm run generate-icons
|
||||||
|
|
||||||
# Build for current platform
|
# Build for current platform
|
||||||
npm run build
|
npm run build
|
||||||
|
|
||||||
# Build for specific platform
|
# Build for specific platform
|
||||||
npm run build:win
|
npm run build:win # Windows
|
||||||
npm run build:mac
|
npm run build:mac # macOS
|
||||||
npm run build:linux
|
npm run build:linux # Linux (generates .deb, .AppImage, and .snap)
|
||||||
|
|
||||||
# Build for all platforms
|
# Build for all platforms
|
||||||
npm run dist:all
|
npm run dist:all
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## Version History
|
||||||
|
|
||||||
|
- **v1.3.1** - Bug fixes: Fixed file associations for double-clicking .md files, corrected 50/50 layout alignment for editor/preview panes
|
||||||
|
- **v1.3.0** - Major update: Tabbed interface for multiple files, enhanced PDF export with LaTeX engines, fixed file associations, removed redundant converter menu, improved UI architecture
|
||||||
|
- **v1.2.1** - Comprehensive editor enhancements: Find & Replace, Line Numbers, Undo/Redo, Auto-indentation, PowerPoint export, document conversion menu, table creation helper, spreadsheet export
|
||||||
|
- **v1.1.0** - Added Excel/ODS spreadsheet export, updated author information, renamed to PanConverter
|
||||||
|
- **v1.0.0** - Initial release with basic markdown editing, themes, and Pandoc export
|
||||||
|
|
||||||
|
## Known Issues
|
||||||
|
|
||||||
|
- AppImage may require `--no-sandbox` flag on some Linux systems
|
||||||
|
- Windows/Mac builds require platform-specific build environments
|
||||||
|
- Large files may cause performance issues
|
||||||
|
|
||||||
## Contributing
|
## Contributing
|
||||||
|
|
||||||
Contributions are welcome! Please feel free to submit a Pull Request.
|
Contributions are welcome! Please feel free to submit a Pull Request to the [GitHub repository](https://github.com/amitwh/pan-converter).
|
||||||
|
|
||||||
## License
|
## License
|
||||||
|
|
||||||
MIT License - see LICENSE file for details
|
MIT License - see LICENSE file for details.
|
||||||
|
|
||||||
|
## Author
|
||||||
|
|
||||||
|
**Amit Haridas** - [amit.wh@gmail.com](mailto:amit.wh@gmail.com)
|
||||||
|
|
||||||
## Acknowledgments
|
## Acknowledgments
|
||||||
|
|
||||||
- Built with [Electron](https://www.electronjs.org/)
|
- Built with [Electron](https://www.electronjs.org/)
|
||||||
- Markdown parsing by [marked](https://marked.js.org/)
|
- Markdown parsing by [marked](https://marked.js.org/)
|
||||||
- Export functionality powered by [Pandoc](https://pandoc.org/)
|
- Export functionality powered by [Pandoc](https://pandoc.org/)
|
||||||
|
- Syntax highlighting by [highlight.js](https://highlightjs.org/)
|
||||||
|
- Spreadsheet export by [XLSX](https://www.npmjs.com/package/xlsx)
|
||||||
|
- HTML sanitization by [DOMPurify](https://www.npmjs.com/package/dompurify)
|
||||||
BIN
Binary file not shown.
+27
-5
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "pan-converter",
|
"name": "pan-converter",
|
||||||
"version": "1.0.0",
|
"version": "1.4.0",
|
||||||
"description": "Cross-platform Markdown editor and converter using Pandoc",
|
"description": "Cross-platform Markdown editor and converter using Pandoc",
|
||||||
"main": "src/main.js",
|
"main": "src/main.js",
|
||||||
"scripts": {
|
"scripts": {
|
||||||
@@ -14,8 +14,13 @@
|
|||||||
"dist:all": "electron-builder -mwl",
|
"dist:all": "electron-builder -mwl",
|
||||||
"generate-icons": "node scripts/generate-icons.js"
|
"generate-icons": "node scripts/generate-icons.js"
|
||||||
},
|
},
|
||||||
"keywords": ["markdown", "pandoc", "converter", "editor"],
|
"keywords": [
|
||||||
"author": "Your Name",
|
"markdown",
|
||||||
|
"pandoc",
|
||||||
|
"converter",
|
||||||
|
"editor"
|
||||||
|
],
|
||||||
|
"author": "Amit Haridas <amit.wh@gmail.com>",
|
||||||
"license": "MIT",
|
"license": "MIT",
|
||||||
"devDependencies": {
|
"devDependencies": {
|
||||||
"electron": "^37.4.0",
|
"electron": "^37.4.0",
|
||||||
@@ -27,7 +32,8 @@
|
|||||||
"dompurify": "^3.2.6",
|
"dompurify": "^3.2.6",
|
||||||
"electron-store": "^10.1.0",
|
"electron-store": "^10.1.0",
|
||||||
"highlight.js": "^11.11.1",
|
"highlight.js": "^11.11.1",
|
||||||
"marked": "^16.2.1"
|
"marked": "^16.2.1",
|
||||||
|
"xlsx": "^0.18.5"
|
||||||
},
|
},
|
||||||
"build": {
|
"build": {
|
||||||
"appId": "com.panconverter.app",
|
"appId": "com.panconverter.app",
|
||||||
@@ -41,6 +47,22 @@
|
|||||||
"node_modules/**/*",
|
"node_modules/**/*",
|
||||||
"package.json"
|
"package.json"
|
||||||
],
|
],
|
||||||
|
"fileAssociations": [
|
||||||
|
{
|
||||||
|
"ext": "md",
|
||||||
|
"name": "Markdown Document",
|
||||||
|
"description": "Markdown Document",
|
||||||
|
"mimeType": "text/markdown",
|
||||||
|
"role": "Editor"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"ext": "markdown",
|
||||||
|
"name": "Markdown Document",
|
||||||
|
"description": "Markdown Document",
|
||||||
|
"mimeType": "text/markdown",
|
||||||
|
"role": "Editor"
|
||||||
|
}
|
||||||
|
],
|
||||||
"mac": {
|
"mac": {
|
||||||
"category": "public.app-category.productivity",
|
"category": "public.app-category.productivity",
|
||||||
"icon": "assets/icon.icns"
|
"icon": "assets/icon.icns"
|
||||||
@@ -63,7 +85,7 @@
|
|||||||
"pandoc"
|
"pandoc"
|
||||||
],
|
],
|
||||||
"description": "Markdown editor and converter using Pandoc",
|
"description": "Markdown editor and converter using Pandoc",
|
||||||
"maintainer": "Your Name <your.email@example.com>"
|
"maintainer": "Amit Haridas <amit.wh@gmail.com>"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
+219
-4
@@ -10,6 +10,13 @@
|
|||||||
</head>
|
</head>
|
||||||
<body>
|
<body>
|
||||||
<div class="container">
|
<div class="container">
|
||||||
|
<div class="tab-bar" id="tab-bar">
|
||||||
|
<div class="tab active" data-tab-id="1">
|
||||||
|
<span class="tab-title">Untitled</span>
|
||||||
|
<button class="tab-close" title="Close tab">×</button>
|
||||||
|
</div>
|
||||||
|
<button class="new-tab-button" id="new-tab-btn" title="New tab">+</button>
|
||||||
|
</div>
|
||||||
<div class="toolbar">
|
<div class="toolbar">
|
||||||
<button id="btn-bold" title="Bold">
|
<button id="btn-bold" title="Bold">
|
||||||
<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
|
<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
|
||||||
@@ -59,6 +66,29 @@
|
|||||||
<path d="M15 21c3 0 7-1 7-8V5c0-1.25-.757-2.017-2-2h-4c-1.25 0-2 .75-2 1.972V11c0 1.25.75 2 2 2h.75c0 2.25.25 4-2.75 4v3c0 1 0 1 1 1z"></path>
|
<path d="M15 21c3 0 7-1 7-8V5c0-1.25-.757-2.017-2-2h-4c-1.25 0-2 .75-2 1.972V11c0 1.25.75 2 2 2h.75c0 2.25.25 4-2.75 4v3c0 1 0 1 1 1z"></path>
|
||||||
</svg>
|
</svg>
|
||||||
</button>
|
</button>
|
||||||
|
<button id="btn-table" title="Insert Table">
|
||||||
|
<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
|
||||||
|
<rect x="3" y="3" width="18" height="18" rx="2" ry="2"></rect>
|
||||||
|
<line x1="3" y1="9" x2="21" y2="9"></line>
|
||||||
|
<line x1="3" y1="15" x2="21" y2="15"></line>
|
||||||
|
<line x1="9" y1="3" x2="9" y2="21"></line>
|
||||||
|
<line x1="15" y1="3" x2="15" y2="21"></line>
|
||||||
|
</svg>
|
||||||
|
</button>
|
||||||
|
<div class="toolbar-separator"></div>
|
||||||
|
<button id="btn-find" title="Find & Replace (Ctrl+F)">
|
||||||
|
<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
|
||||||
|
<circle cx="11" cy="11" r="8"></circle>
|
||||||
|
<path d="m21 21-4.35-4.35"></path>
|
||||||
|
</svg>
|
||||||
|
</button>
|
||||||
|
<button id="btn-line-numbers" title="Toggle Line Numbers">
|
||||||
|
<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
|
||||||
|
<path d="M3 6h18"></path>
|
||||||
|
<path d="M3 12h18"></path>
|
||||||
|
<path d="M3 18h18"></path>
|
||||||
|
</svg>
|
||||||
|
</button>
|
||||||
<div class="toolbar-separator"></div>
|
<div class="toolbar-separator"></div>
|
||||||
<button id="btn-preview-toggle" title="Toggle Preview">
|
<button id="btn-preview-toggle" title="Toggle Preview">
|
||||||
<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
|
<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
|
||||||
@@ -68,12 +98,197 @@
|
|||||||
</button>
|
</button>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
<!-- Find & Replace Dialog -->
|
||||||
|
<div id="find-dialog" class="find-dialog hidden">
|
||||||
|
<div class="find-controls">
|
||||||
|
<input type="text" id="find-input" placeholder="Find...">
|
||||||
|
<input type="text" id="replace-input" placeholder="Replace...">
|
||||||
|
<button id="btn-find-prev" title="Previous">↑</button>
|
||||||
|
<button id="btn-find-next" title="Next">↓</button>
|
||||||
|
<button id="btn-replace" title="Replace">Replace</button>
|
||||||
|
<button id="btn-replace-all" title="Replace All">All</button>
|
||||||
|
<button id="btn-find-close" title="Close">×</button>
|
||||||
|
</div>
|
||||||
|
<div class="find-info">
|
||||||
|
<span id="find-count">0 matches</span>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<!-- Export Options Dialog -->
|
||||||
|
<div id="export-dialog" class="export-dialog hidden">
|
||||||
|
<div class="export-dialog-content">
|
||||||
|
<div class="export-dialog-header">
|
||||||
|
<h3 id="export-dialog-title">Export Options</h3>
|
||||||
|
<button id="export-dialog-close" title="Close">×</button>
|
||||||
|
</div>
|
||||||
|
<div class="export-dialog-body">
|
||||||
|
<div class="export-section">
|
||||||
|
<label for="export-template">Template:</label>
|
||||||
|
<select id="export-template">
|
||||||
|
<option value="default">Default</option>
|
||||||
|
<option value="custom">Custom (Browse...)</option>
|
||||||
|
</select>
|
||||||
|
<input type="file" id="template-file-input" accept=".tex,.html,.docx,.odt" style="display: none;">
|
||||||
|
<input type="text" id="custom-template-path" placeholder="Template file path..." style="display: none;">
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="export-section">
|
||||||
|
<label>Metadata:</label>
|
||||||
|
<div class="metadata-container">
|
||||||
|
<div class="metadata-field">
|
||||||
|
<input type="text" placeholder="title" class="metadata-key">
|
||||||
|
<input type="text" placeholder="Document title" class="metadata-value">
|
||||||
|
</div>
|
||||||
|
<div class="metadata-field">
|
||||||
|
<input type="text" placeholder="author" class="metadata-key">
|
||||||
|
<input type="text" placeholder="Author name" class="metadata-value">
|
||||||
|
</div>
|
||||||
|
<div class="metadata-field">
|
||||||
|
<input type="text" placeholder="date" class="metadata-key">
|
||||||
|
<input type="text" placeholder="Date" class="metadata-value">
|
||||||
|
</div>
|
||||||
|
<div class="metadata-field">
|
||||||
|
<input type="text" placeholder="subject" class="metadata-key">
|
||||||
|
<input type="text" placeholder="Subject" class="metadata-value">
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<button id="add-metadata-field" type="button">+ Add Field</button>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="export-section">
|
||||||
|
<label>Document Options:</label>
|
||||||
|
<div class="checkbox-group">
|
||||||
|
<label><input type="checkbox" id="export-toc"> Table of Contents</label>
|
||||||
|
<label><input type="checkbox" id="export-number-sections"> Number Sections</label>
|
||||||
|
<label><input type="checkbox" id="export-citeproc"> Process Citations</label>
|
||||||
|
</div>
|
||||||
|
<div class="form-row">
|
||||||
|
<label for="export-toc-depth">TOC Depth:</label>
|
||||||
|
<input type="number" id="export-toc-depth" min="1" max="6" value="3">
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="export-section pdf-only">
|
||||||
|
<label>PDF Options:</label>
|
||||||
|
<div class="form-row">
|
||||||
|
<label for="pdf-engine">PDF Engine:</label>
|
||||||
|
<select id="pdf-engine">
|
||||||
|
<option value="xelatex">XeLaTeX (Recommended)</option>
|
||||||
|
<option value="pdflatex">PDFLaTeX</option>
|
||||||
|
<option value="lualatex">LuaLaTeX</option>
|
||||||
|
</select>
|
||||||
|
</div>
|
||||||
|
<div class="form-row">
|
||||||
|
<label for="pdf-geometry">Page Margins:</label>
|
||||||
|
<select id="pdf-geometry">
|
||||||
|
<option value="margin=1in">1 inch (Default)</option>
|
||||||
|
<option value="margin=0.75in">0.75 inch</option>
|
||||||
|
<option value="margin=1.25in">1.25 inch</option>
|
||||||
|
<option value="margin=2cm">2 cm</option>
|
||||||
|
<option value="margin=2.5cm">2.5 cm</option>
|
||||||
|
<option value="custom">Custom...</option>
|
||||||
|
</select>
|
||||||
|
<input type="text" id="custom-geometry" placeholder="e.g., margin=1.5in" style="display: none;">
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="export-section">
|
||||||
|
<label>Bibliography:</label>
|
||||||
|
<div class="form-row">
|
||||||
|
<input type="text" id="bibliography-file" placeholder="Bibliography file (.bib, .yaml, .json)">
|
||||||
|
<button id="browse-bibliography">Browse</button>
|
||||||
|
</div>
|
||||||
|
<div class="form-row">
|
||||||
|
<input type="text" id="csl-file" placeholder="Citation style file (.csl)">
|
||||||
|
<button id="browse-csl">Browse</button>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="export-dialog-footer">
|
||||||
|
<button id="export-cancel">Cancel</button>
|
||||||
|
<button id="export-confirm" class="primary">Export</button>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<!-- Batch Conversion Dialog -->
|
||||||
|
<div id="batch-dialog" class="batch-dialog hidden">
|
||||||
|
<div class="batch-dialog-content">
|
||||||
|
<div class="batch-dialog-header">
|
||||||
|
<h3>Batch File Conversion</h3>
|
||||||
|
<button id="batch-dialog-close" title="Close">×</button>
|
||||||
|
</div>
|
||||||
|
<div class="batch-dialog-body">
|
||||||
|
<div class="batch-section">
|
||||||
|
<label>Input Folder:</label>
|
||||||
|
<div class="folder-input-group">
|
||||||
|
<input type="text" id="batch-input-folder" placeholder="Select folder containing markdown files..." readonly>
|
||||||
|
<button id="browse-input-folder">Browse</button>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="batch-section">
|
||||||
|
<label>Output Folder:</label>
|
||||||
|
<div class="folder-input-group">
|
||||||
|
<input type="text" id="batch-output-folder" placeholder="Select output folder..." readonly>
|
||||||
|
<button id="browse-output-folder">Browse</button>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="batch-section">
|
||||||
|
<label for="batch-format">Output Format:</label>
|
||||||
|
<select id="batch-format">
|
||||||
|
<option value="html">HTML</option>
|
||||||
|
<option value="pdf">PDF</option>
|
||||||
|
<option value="docx">DOCX</option>
|
||||||
|
<option value="latex">LaTeX</option>
|
||||||
|
<option value="rtf">RTF</option>
|
||||||
|
<option value="odt">ODT</option>
|
||||||
|
<option value="epub">EPUB</option>
|
||||||
|
<option value="pptx">PowerPoint (PPTX)</option>
|
||||||
|
<option value="odp">OpenDocument Presentation (ODP)</option>
|
||||||
|
</select>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="batch-section">
|
||||||
|
<label>
|
||||||
|
<input type="checkbox" id="batch-include-subfolders" checked>
|
||||||
|
Include subfolders (recursive)
|
||||||
|
</label>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="batch-section">
|
||||||
|
<button id="batch-show-options" type="button">Advanced Export Options...</button>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div id="batch-progress" class="batch-progress hidden">
|
||||||
|
<div class="progress-bar">
|
||||||
|
<div class="progress-fill" id="batch-progress-fill"></div>
|
||||||
|
</div>
|
||||||
|
<div class="progress-text">
|
||||||
|
<span id="batch-progress-text">Processing...</span>
|
||||||
|
<span id="batch-progress-count">0 / 0</span>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="batch-dialog-footer">
|
||||||
|
<button id="batch-cancel">Cancel</button>
|
||||||
|
<button id="batch-start" class="primary" disabled>Start Conversion</button>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
<div class="editor-container">
|
<div class="editor-container">
|
||||||
<div id="editor-pane" class="pane">
|
<div class="tab-content active" id="tab-content-1" data-tab-id="1">
|
||||||
<textarea id="editor"></textarea>
|
<div id="editor-pane-1" class="pane">
|
||||||
|
<div class="editor-wrapper">
|
||||||
|
<div id="line-numbers-1" class="line-numbers hidden"></div>
|
||||||
|
<textarea id="editor-1" class="editor-textarea"></textarea>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div id="preview-pane-1" class="pane">
|
||||||
|
<div id="preview-1" class="preview-content"></div>
|
||||||
</div>
|
</div>
|
||||||
<div id="preview-pane" class="pane">
|
|
||||||
<div id="preview"></div>
|
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
|||||||
+496
-8
@@ -2,6 +2,7 @@ const { app, BrowserWindow, Menu, dialog, ipcMain, shell } = require('electron')
|
|||||||
const path = require('path');
|
const path = require('path');
|
||||||
const fs = require('fs');
|
const fs = require('fs');
|
||||||
const { exec } = require('child_process');
|
const { exec } = require('child_process');
|
||||||
|
const XLSX = require('xlsx');
|
||||||
|
|
||||||
// Simple storage implementation to replace electron-store
|
// Simple storage implementation to replace electron-store
|
||||||
const settingsPath = path.join(app.getPath('userData'), 'settings.json');
|
const settingsPath = path.join(app.getPath('userData'), 'settings.json');
|
||||||
@@ -27,7 +28,7 @@ const store = {
|
|||||||
};
|
};
|
||||||
|
|
||||||
let mainWindow;
|
let mainWindow;
|
||||||
let currentFile = null;
|
let currentFile = null; // This will now represent the active tab's file
|
||||||
|
|
||||||
function createWindow() {
|
function createWindow() {
|
||||||
mainWindow = new BrowserWindow({
|
mainWindow = new BrowserWindow({
|
||||||
@@ -47,6 +48,8 @@ function createWindow() {
|
|||||||
mainWindow.on('closed', () => {
|
mainWindow.on('closed', () => {
|
||||||
mainWindow = null;
|
mainWindow = null;
|
||||||
});
|
});
|
||||||
|
|
||||||
|
// Handle pending file from file association will be handled by renderer-ready event
|
||||||
}
|
}
|
||||||
|
|
||||||
function createMenu() {
|
function createMenu() {
|
||||||
@@ -75,6 +78,11 @@ function createMenu() {
|
|||||||
click: saveAsFile
|
click: saveAsFile
|
||||||
},
|
},
|
||||||
{ type: 'separator' },
|
{ type: 'separator' },
|
||||||
|
{
|
||||||
|
label: 'Import Document...',
|
||||||
|
accelerator: 'CmdOrCtrl+I',
|
||||||
|
click: importDocument
|
||||||
|
},
|
||||||
{
|
{
|
||||||
label: 'Export',
|
label: 'Export',
|
||||||
submenu: [
|
submenu: [
|
||||||
@@ -84,7 +92,14 @@ function createMenu() {
|
|||||||
{ label: 'LaTeX', click: () => exportFile('latex') },
|
{ label: 'LaTeX', click: () => exportFile('latex') },
|
||||||
{ label: 'RTF', click: () => exportFile('rtf') },
|
{ label: 'RTF', click: () => exportFile('rtf') },
|
||||||
{ label: 'ODT', click: () => exportFile('odt') },
|
{ label: 'ODT', click: () => exportFile('odt') },
|
||||||
{ label: 'EPUB', click: () => exportFile('epub') }
|
{ label: 'EPUB', click: () => exportFile('epub') },
|
||||||
|
{ type: 'separator' },
|
||||||
|
{ label: 'PowerPoint (PPTX)', click: () => exportFile('pptx') },
|
||||||
|
{ label: 'OpenDocument Presentation (ODP)', click: () => exportFile('odp') },
|
||||||
|
{ type: 'separator' },
|
||||||
|
{ label: 'Excel (XLSX)', click: () => exportSpreadsheet('xlsx') },
|
||||||
|
{ label: 'Excel Legacy (XLS)', click: () => exportSpreadsheet('xls') },
|
||||||
|
{ label: 'OpenDocument Spreadsheet (ODS)', click: () => exportSpreadsheet('ods') }
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
{ type: 'separator' },
|
{ type: 'separator' },
|
||||||
@@ -99,12 +114,18 @@ function createMenu() {
|
|||||||
label: 'Edit',
|
label: 'Edit',
|
||||||
submenu: [
|
submenu: [
|
||||||
{ label: 'Undo', accelerator: 'CmdOrCtrl+Z', role: 'undo' },
|
{ label: 'Undo', accelerator: 'CmdOrCtrl+Z', role: 'undo' },
|
||||||
{ label: 'Redo', accelerator: 'CmdOrCtrl+Y', role: 'redo' },
|
{ label: 'Redo', accelerator: 'CmdOrCtrl+Shift+Z', role: 'redo' },
|
||||||
{ type: 'separator' },
|
{ type: 'separator' },
|
||||||
{ label: 'Cut', accelerator: 'CmdOrCtrl+X', role: 'cut' },
|
{ label: 'Cut', accelerator: 'CmdOrCtrl+X', role: 'cut' },
|
||||||
{ label: 'Copy', accelerator: 'CmdOrCtrl+C', role: 'copy' },
|
{ label: 'Copy', accelerator: 'CmdOrCtrl+C', role: 'copy' },
|
||||||
{ label: 'Paste', accelerator: 'CmdOrCtrl+V', role: 'paste' },
|
{ label: 'Paste', accelerator: 'CmdOrCtrl+V', role: 'paste' },
|
||||||
{ label: 'Select All', accelerator: 'CmdOrCtrl+A', role: 'selectAll' }
|
{ label: 'Select All', accelerator: 'CmdOrCtrl+A', role: 'selectAll' },
|
||||||
|
{ type: 'separator' },
|
||||||
|
{
|
||||||
|
label: 'Find & Replace',
|
||||||
|
accelerator: 'CmdOrCtrl+F',
|
||||||
|
click: () => mainWindow.webContents.send('toggle-find')
|
||||||
|
}
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
@@ -126,6 +147,27 @@ function createMenu() {
|
|||||||
]
|
]
|
||||||
},
|
},
|
||||||
{ type: 'separator' },
|
{ type: 'separator' },
|
||||||
|
{
|
||||||
|
label: 'Font Size',
|
||||||
|
submenu: [
|
||||||
|
{
|
||||||
|
label: 'Increase Font Size',
|
||||||
|
accelerator: 'CmdOrCtrl+Shift+Plus',
|
||||||
|
click: () => mainWindow.webContents.send('adjust-font-size', 'increase')
|
||||||
|
},
|
||||||
|
{
|
||||||
|
label: 'Decrease Font Size',
|
||||||
|
accelerator: 'CmdOrCtrl+Shift+-',
|
||||||
|
click: () => mainWindow.webContents.send('adjust-font-size', 'decrease')
|
||||||
|
},
|
||||||
|
{
|
||||||
|
label: 'Reset Font Size',
|
||||||
|
accelerator: 'CmdOrCtrl+Shift+0',
|
||||||
|
click: () => mainWindow.webContents.send('adjust-font-size', 'reset')
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
{ type: 'separator' },
|
||||||
{ label: 'Reload', accelerator: 'CmdOrCtrl+R', role: 'reload' },
|
{ label: 'Reload', accelerator: 'CmdOrCtrl+R', role: 'reload' },
|
||||||
{ label: 'Toggle DevTools', accelerator: 'F12', role: 'toggleDevTools' },
|
{ label: 'Toggle DevTools', accelerator: 'F12', role: 'toggleDevTools' },
|
||||||
{ type: 'separator' },
|
{ type: 'separator' },
|
||||||
@@ -134,6 +176,15 @@ function createMenu() {
|
|||||||
{ label: 'Reset Zoom', accelerator: 'CmdOrCtrl+0', role: 'resetZoom' }
|
{ label: 'Reset Zoom', accelerator: 'CmdOrCtrl+0', role: 'resetZoom' }
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
|
{
|
||||||
|
label: 'Batch',
|
||||||
|
submenu: [
|
||||||
|
{
|
||||||
|
label: 'Convert Folder...',
|
||||||
|
click: () => showBatchConversionDialog()
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
{
|
{
|
||||||
label: 'Help',
|
label: 'Help',
|
||||||
submenu: [
|
submenu: [
|
||||||
@@ -144,14 +195,14 @@ function createMenu() {
|
|||||||
type: 'info',
|
type: 'info',
|
||||||
title: 'About PanConverter',
|
title: 'About PanConverter',
|
||||||
message: 'PanConverter',
|
message: 'PanConverter',
|
||||||
detail: 'A cross-platform Markdown editor and converter using Pandoc.\n\nVersion: 1.0.0\nLicense: MIT',
|
detail: 'A cross-platform Markdown editor and converter using Pandoc.\n\nVersion: 1.4.0\nAuthor: Amit Haridas\nEmail: amit.wh@gmail.com\nLicense: MIT\n\nFeatures:\n• Tabbed interface for multiple files\n• Advanced markdown editing with live preview\n• Enhanced PDF export with LaTeX engines\n• File association support for .md files (Fixed in v1.4.0)\n• Advanced export options with templates and metadata\n• Batch file conversion with progress tracking\n• Improved preview typography and spacing\n• Adjustable font sizes via menu (Ctrl+Shift+Plus/Minus)\n• Complete theme support including Monokai fixes\n• Find & replace with match highlighting\n• Line numbers and auto-indentation\n• Export to multiple formats via Pandoc\n• PowerPoint & presentation export\n• Export tables to Excel/ODS spreadsheets\n• Document import & conversion\n• Table creation helper\n• Multiple themes support\n• Undo/redo functionality',
|
||||||
buttons: ['OK']
|
buttons: ['OK']
|
||||||
});
|
});
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
label: 'Documentation',
|
label: 'Documentation',
|
||||||
click: () => shell.openExternal('https://github.com/yourusername/pan-converter')
|
click: () => shell.openExternal('https://github.com/amitwh/pan-converter')
|
||||||
}
|
}
|
||||||
]
|
]
|
||||||
}
|
}
|
||||||
@@ -198,6 +249,19 @@ function exportFile(format) {
|
|||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// Show export options dialog
|
||||||
|
showExportOptionsDialog(format);
|
||||||
|
}
|
||||||
|
|
||||||
|
function showExportOptionsDialog(format) {
|
||||||
|
mainWindow.webContents.send('show-export-dialog', format);
|
||||||
|
}
|
||||||
|
|
||||||
|
function showBatchConversionDialog() {
|
||||||
|
mainWindow.webContents.send('show-batch-dialog');
|
||||||
|
}
|
||||||
|
|
||||||
|
function performExportWithOptions(format, options) {
|
||||||
const outputFile = dialog.showSaveDialogSync(mainWindow, {
|
const outputFile = dialog.showSaveDialogSync(mainWindow, {
|
||||||
defaultPath: currentFile.replace(/\.[^/.]+$/, `.${format}`),
|
defaultPath: currentFile.replace(/\.[^/.]+$/, `.${format}`),
|
||||||
filters: [
|
filters: [
|
||||||
@@ -206,12 +270,106 @@ function exportFile(format) {
|
|||||||
});
|
});
|
||||||
|
|
||||||
if (outputFile) {
|
if (outputFile) {
|
||||||
const pandocCmd = `pandoc "${currentFile}" -o "${outputFile}"`;
|
let pandocCmd = `pandoc "${currentFile}" -o "${outputFile}"`;
|
||||||
|
|
||||||
|
// Add template if specified
|
||||||
|
if (options.template && options.template !== 'default') {
|
||||||
|
pandocCmd += ` --template="${options.template}"`;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Add metadata
|
||||||
|
if (options.metadata) {
|
||||||
|
for (const [key, value] of Object.entries(options.metadata)) {
|
||||||
|
if (value.trim()) {
|
||||||
|
pandocCmd += ` -M ${key}="${value.replace(/"/g, '\\"')}"`;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Add variables
|
||||||
|
if (options.variables) {
|
||||||
|
for (const [key, value] of Object.entries(options.variables)) {
|
||||||
|
if (value.trim()) {
|
||||||
|
pandocCmd += ` -V ${key}="${value.replace(/"/g, '\\"')}"`;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Add other options
|
||||||
|
if (options.toc) pandocCmd += ' --toc';
|
||||||
|
if (options.tocDepth) pandocCmd += ` --toc-depth=${options.tocDepth}`;
|
||||||
|
if (options.numberSections) pandocCmd += ' --number-sections';
|
||||||
|
if (options.citeproc) pandocCmd += ' --citeproc';
|
||||||
|
if (options.bibliography) pandocCmd += ` --bibliography="${options.bibliography}"`;
|
||||||
|
if (options.csl) pandocCmd += ` --csl="${options.csl}"`;
|
||||||
|
|
||||||
|
// Add specific options for PDF export to ensure proper generation
|
||||||
|
if (format === 'pdf') {
|
||||||
|
const pdfEngine = options.pdfEngine || 'xelatex';
|
||||||
|
const geometry = options.geometry || 'margin=1in';
|
||||||
|
pandocCmd += ` --pdf-engine=${pdfEngine} -V geometry:${geometry}`;
|
||||||
|
|
||||||
|
// Try with specified PDF engine
|
||||||
|
exec(pandocCmd, (error, stdout, stderr) => {
|
||||||
|
if (error) {
|
||||||
|
// Try fallback engines if the specified one fails
|
||||||
|
const fallbackEngines = ['pdflatex', 'lualatex'];
|
||||||
|
tryPdfFallback(currentFile, outputFile, fallbackEngines, 0, options, error);
|
||||||
|
} else {
|
||||||
|
showExportSuccess(outputFile);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
} else {
|
||||||
exec(pandocCmd, (error, stdout, stderr) => {
|
exec(pandocCmd, (error, stdout, stderr) => {
|
||||||
if (error) {
|
if (error) {
|
||||||
dialog.showErrorBox('Export Error', `Failed to export: ${error.message}\n\nMake sure Pandoc is installed.`);
|
dialog.showErrorBox('Export Error', `Failed to export: ${error.message}\n\nMake sure Pandoc is installed.`);
|
||||||
} else {
|
} else {
|
||||||
|
showExportSuccess(outputFile);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function tryPdfFallback(inputFile, outputFile, engines, index, options, lastError) {
|
||||||
|
if (index >= engines.length) {
|
||||||
|
dialog.showErrorBox('PDF Export Error',
|
||||||
|
`Failed to export PDF with all available engines. Please ensure you have one of the following installed:\n` +
|
||||||
|
`• XeLaTeX (recommended): sudo apt-get install texlive-xetex\n` +
|
||||||
|
`• PDFLaTeX: sudo apt-get install texlive-latex-base\n` +
|
||||||
|
`• LuaLaTeX: sudo apt-get install texlive-luatex\n\n` +
|
||||||
|
`Last error: ${lastError.message}`
|
||||||
|
);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
const engine = engines[index];
|
||||||
|
const geometry = options.geometry || 'margin=1in';
|
||||||
|
let pandocCmd = `pandoc "${inputFile}" --pdf-engine=${engine} -V geometry:${geometry} -o "${outputFile}"`;
|
||||||
|
|
||||||
|
// Add all other options
|
||||||
|
if (options.template && options.template !== 'default') {
|
||||||
|
pandocCmd += ` --template="${options.template}"`;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (options.metadata) {
|
||||||
|
for (const [key, value] of Object.entries(options.metadata)) {
|
||||||
|
if (value.trim()) {
|
||||||
|
pandocCmd += ` -M ${key}="${value.replace(/"/g, '\\"')}"`;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
exec(pandocCmd, (error, stdout, stderr) => {
|
||||||
|
if (error) {
|
||||||
|
tryPdfFallback(inputFile, outputFile, engines, index + 1, options, error);
|
||||||
|
} else {
|
||||||
|
showExportSuccess(outputFile);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
function showExportSuccess(outputFile) {
|
||||||
dialog.showMessageBox(mainWindow, {
|
dialog.showMessageBox(mainWindow, {
|
||||||
type: 'info',
|
type: 'info',
|
||||||
title: 'Export Complete',
|
title: 'Export Complete',
|
||||||
@@ -219,10 +377,55 @@ function exportFile(format) {
|
|||||||
buttons: ['OK']
|
buttons: ['OK']
|
||||||
});
|
});
|
||||||
}
|
}
|
||||||
|
|
||||||
|
function exportSpreadsheet(format) {
|
||||||
|
if (!currentFile) {
|
||||||
|
dialog.showErrorBox('Error', 'Please save the file first');
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Request content from renderer
|
||||||
|
mainWindow.webContents.send('get-content-for-spreadsheet', format);
|
||||||
|
}
|
||||||
|
|
||||||
|
function importDocument() {
|
||||||
|
const files = dialog.showOpenDialogSync(mainWindow, {
|
||||||
|
properties: ['openFile'],
|
||||||
|
filters: [
|
||||||
|
{ name: 'Documents', extensions: ['docx', 'odt', 'rtf', 'html', 'tex', 'epub', 'pdf'] },
|
||||||
|
{ name: 'Presentations', extensions: ['pptx', 'odp'] },
|
||||||
|
{ name: 'All Files', extensions: ['*'] }
|
||||||
|
]
|
||||||
|
});
|
||||||
|
|
||||||
|
if (files && files[0]) {
|
||||||
|
const inputFile = files[0];
|
||||||
|
const outputFile = inputFile.replace(/\.[^/.]+$/, '.md');
|
||||||
|
|
||||||
|
// Convert to markdown using pandoc
|
||||||
|
const pandocCmd = `pandoc "${inputFile}" -t markdown -o "${outputFile}"`;
|
||||||
|
|
||||||
|
exec(pandocCmd, (error, stdout, stderr) => {
|
||||||
|
if (error) {
|
||||||
|
dialog.showErrorBox('Import Error', `Failed to import: ${error.message}\n\nMake sure Pandoc is installed.`);
|
||||||
|
} else {
|
||||||
|
// Open the converted markdown file
|
||||||
|
currentFile = outputFile;
|
||||||
|
const content = fs.readFileSync(outputFile, 'utf-8');
|
||||||
|
mainWindow.webContents.send('file-opened', { path: outputFile, content });
|
||||||
|
|
||||||
|
dialog.showMessageBox(mainWindow, {
|
||||||
|
type: 'info',
|
||||||
|
title: 'Import Complete',
|
||||||
|
message: `Document imported successfully as ${outputFile}`,
|
||||||
|
buttons: ['OK']
|
||||||
|
});
|
||||||
|
}
|
||||||
});
|
});
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
function setTheme(theme) {
|
function setTheme(theme) {
|
||||||
store.set('theme', theme);
|
store.set('theme', theme);
|
||||||
mainWindow.webContents.send('theme-changed', theme);
|
mainWindow.webContents.send('theme-changed', theme);
|
||||||
@@ -247,7 +450,270 @@ ipcMain.on('get-theme', (event) => {
|
|||||||
event.reply('theme-changed', theme);
|
event.reply('theme-changed', theme);
|
||||||
});
|
});
|
||||||
|
|
||||||
app.whenReady().then(createWindow);
|
// Handle tab file tracking for exports
|
||||||
|
ipcMain.on('set-current-file', (event, filePath) => {
|
||||||
|
currentFile = filePath;
|
||||||
|
});
|
||||||
|
|
||||||
|
// Handle renderer ready for file association
|
||||||
|
ipcMain.on('renderer-ready', (event) => {
|
||||||
|
if (app.pendingFile) {
|
||||||
|
openFileFromPath(app.pendingFile);
|
||||||
|
app.pendingFile = null;
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
// Handle export with options
|
||||||
|
ipcMain.on('export-with-options', (event, { format, options }) => {
|
||||||
|
performExportWithOptions(format, options);
|
||||||
|
});
|
||||||
|
|
||||||
|
// Handle batch conversion
|
||||||
|
ipcMain.on('batch-convert', (event, { inputFolder, outputFolder, format, options }) => {
|
||||||
|
performBatchConversion(inputFolder, outputFolder, format, options);
|
||||||
|
});
|
||||||
|
|
||||||
|
// Handle folder selection for batch conversion
|
||||||
|
ipcMain.on('select-folder', (event, type) => {
|
||||||
|
const folder = dialog.showOpenDialogSync(mainWindow, {
|
||||||
|
properties: ['openDirectory']
|
||||||
|
});
|
||||||
|
|
||||||
|
if (folder && folder[0]) {
|
||||||
|
event.reply('folder-selected', { type, path: folder[0] });
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
ipcMain.on('export-spreadsheet', (event, { content, format }) => {
|
||||||
|
const outputFile = dialog.showSaveDialogSync(mainWindow, {
|
||||||
|
defaultPath: currentFile.replace(/\.[^/.]+$/, `.${format}`),
|
||||||
|
filters: [
|
||||||
|
{ name: format.toUpperCase(), extensions: [format] }
|
||||||
|
]
|
||||||
|
});
|
||||||
|
|
||||||
|
if (outputFile) {
|
||||||
|
try {
|
||||||
|
// Parse markdown content to extract tables
|
||||||
|
const tables = extractTablesFromMarkdown(content);
|
||||||
|
|
||||||
|
if (tables.length === 0) {
|
||||||
|
dialog.showErrorBox('Export Error', 'No tables found in the markdown content');
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Create workbook
|
||||||
|
const wb = XLSX.utils.book_new();
|
||||||
|
|
||||||
|
tables.forEach((table, index) => {
|
||||||
|
const ws = XLSX.utils.aoa_to_sheet(table);
|
||||||
|
XLSX.utils.book_append_sheet(wb, ws, `Table ${index + 1}`);
|
||||||
|
});
|
||||||
|
|
||||||
|
// Write file
|
||||||
|
XLSX.writeFile(wb, outputFile);
|
||||||
|
|
||||||
|
dialog.showMessageBox(mainWindow, {
|
||||||
|
type: 'info',
|
||||||
|
title: 'Export Complete',
|
||||||
|
message: `Spreadsheet exported successfully to ${outputFile}`,
|
||||||
|
buttons: ['OK']
|
||||||
|
});
|
||||||
|
} catch (error) {
|
||||||
|
dialog.showErrorBox('Export Error', `Failed to export: ${error.message}`);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
// Helper function to extract tables from markdown
|
||||||
|
function extractTablesFromMarkdown(markdown) {
|
||||||
|
const tables = [];
|
||||||
|
const lines = markdown.split('\n');
|
||||||
|
let currentTable = [];
|
||||||
|
let inTable = false;
|
||||||
|
|
||||||
|
for (const line of lines) {
|
||||||
|
if (line.includes('|')) {
|
||||||
|
if (!inTable) {
|
||||||
|
inTable = true;
|
||||||
|
currentTable = [];
|
||||||
|
}
|
||||||
|
|
||||||
|
// Skip separator lines (|---|---|)
|
||||||
|
if (!line.match(/^\s*\|?\s*:?-+:?\s*\|/)) {
|
||||||
|
const cells = line.split('|')
|
||||||
|
.map(cell => cell.trim())
|
||||||
|
.filter(cell => cell !== '');
|
||||||
|
|
||||||
|
if (cells.length > 0) {
|
||||||
|
currentTable.push(cells);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} else if (inTable && line.trim() === '') {
|
||||||
|
// End of table
|
||||||
|
if (currentTable.length > 0) {
|
||||||
|
tables.push(currentTable);
|
||||||
|
}
|
||||||
|
currentTable = [];
|
||||||
|
inTable = false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Add last table if exists
|
||||||
|
if (currentTable.length > 0) {
|
||||||
|
tables.push(currentTable);
|
||||||
|
}
|
||||||
|
|
||||||
|
return tables;
|
||||||
|
}
|
||||||
|
|
||||||
|
function performBatchConversion(inputFolder, outputFolder, format, options) {
|
||||||
|
if (!fs.existsSync(inputFolder)) {
|
||||||
|
dialog.showErrorBox('Error', 'Input folder does not exist');
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Create output folder if it doesn't exist
|
||||||
|
if (!fs.existsSync(outputFolder)) {
|
||||||
|
try {
|
||||||
|
fs.mkdirSync(outputFolder, { recursive: true });
|
||||||
|
} catch (error) {
|
||||||
|
dialog.showErrorBox('Error', `Failed to create output folder: ${error.message}`);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Find all markdown files in input folder
|
||||||
|
const markdownFiles = [];
|
||||||
|
|
||||||
|
function findMarkdownFiles(dir) {
|
||||||
|
const files = fs.readdirSync(dir);
|
||||||
|
|
||||||
|
for (const file of files) {
|
||||||
|
const fullPath = path.join(dir, file);
|
||||||
|
const stat = fs.statSync(fullPath);
|
||||||
|
|
||||||
|
if (stat.isDirectory()) {
|
||||||
|
findMarkdownFiles(fullPath); // Recursive search
|
||||||
|
} else if (file.match(/\.(md|markdown)$/i)) {
|
||||||
|
markdownFiles.push(fullPath);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
findMarkdownFiles(inputFolder);
|
||||||
|
|
||||||
|
if (markdownFiles.length === 0) {
|
||||||
|
dialog.showErrorBox('No Files Found', 'No markdown files found in the selected folder');
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Show progress dialog
|
||||||
|
let completedCount = 0;
|
||||||
|
const totalCount = markdownFiles.length;
|
||||||
|
|
||||||
|
// Process each file
|
||||||
|
const processNextFile = (index) => {
|
||||||
|
if (index >= markdownFiles.length) {
|
||||||
|
// All files processed
|
||||||
|
dialog.showMessageBox(mainWindow, {
|
||||||
|
type: 'info',
|
||||||
|
title: 'Batch Conversion Complete',
|
||||||
|
message: `Successfully converted ${completedCount} out of ${totalCount} files to ${format.toUpperCase()}.`,
|
||||||
|
buttons: ['OK']
|
||||||
|
});
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
const inputFile = markdownFiles[index];
|
||||||
|
const relativePath = path.relative(inputFolder, inputFile);
|
||||||
|
const baseName = path.basename(relativePath, path.extname(relativePath));
|
||||||
|
const outputFile = path.join(outputFolder, relativePath.replace(/\.(md|markdown)$/i, `.${format}`));
|
||||||
|
|
||||||
|
// Create subdirectories in output folder if needed
|
||||||
|
const outputDir = path.dirname(outputFile);
|
||||||
|
if (!fs.existsSync(outputDir)) {
|
||||||
|
fs.mkdirSync(outputDir, { recursive: true });
|
||||||
|
}
|
||||||
|
|
||||||
|
// Build pandoc command
|
||||||
|
let pandocCmd = `pandoc "${inputFile}" -o "${outputFile}"`;
|
||||||
|
|
||||||
|
// Add template if specified
|
||||||
|
if (options.template && options.template !== 'default') {
|
||||||
|
pandocCmd += ` --template="${options.template}"`;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Add metadata
|
||||||
|
if (options.metadata) {
|
||||||
|
for (const [key, value] of Object.entries(options.metadata)) {
|
||||||
|
if (value.trim()) {
|
||||||
|
pandocCmd += ` -M ${key}="${value.replace(/"/g, '\\"')}"`;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Add variables
|
||||||
|
if (options.variables) {
|
||||||
|
for (const [key, value] of Object.entries(options.variables)) {
|
||||||
|
if (value.trim()) {
|
||||||
|
pandocCmd += ` -V ${key}="${value.replace(/"/g, '\\"')}"`;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Add other options
|
||||||
|
if (options.toc) pandocCmd += ' --toc';
|
||||||
|
if (options.tocDepth) pandocCmd += ` --toc-depth=${options.tocDepth}`;
|
||||||
|
if (options.numberSections) pandocCmd += ' --number-sections';
|
||||||
|
if (options.citeproc) pandocCmd += ' --citeproc';
|
||||||
|
if (options.bibliography) pandocCmd += ` --bibliography="${options.bibliography}"`;
|
||||||
|
if (options.csl) pandocCmd += ` --csl="${options.csl}"`;
|
||||||
|
|
||||||
|
// Add PDF-specific options
|
||||||
|
if (format === 'pdf') {
|
||||||
|
const pdfEngine = options.pdfEngine || 'xelatex';
|
||||||
|
const geometry = options.geometry || 'margin=1in';
|
||||||
|
pandocCmd += ` --pdf-engine=${pdfEngine} -V geometry:${geometry}`;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Execute conversion
|
||||||
|
exec(pandocCmd, (error, stdout, stderr) => {
|
||||||
|
if (!error) {
|
||||||
|
completedCount++;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Update progress (you could send this to renderer for a progress bar)
|
||||||
|
mainWindow.webContents.send('batch-progress', {
|
||||||
|
completed: index + 1,
|
||||||
|
total: totalCount,
|
||||||
|
currentFile: path.basename(inputFile),
|
||||||
|
success: !error
|
||||||
|
});
|
||||||
|
|
||||||
|
// Process next file
|
||||||
|
processNextFile(index + 1);
|
||||||
|
});
|
||||||
|
};
|
||||||
|
|
||||||
|
// Start processing
|
||||||
|
processNextFile(0);
|
||||||
|
}
|
||||||
|
|
||||||
|
app.whenReady().then(() => {
|
||||||
|
createWindow();
|
||||||
|
|
||||||
|
// Handle file association on app startup
|
||||||
|
// Process all command line arguments except the first two (node and script path)
|
||||||
|
const fileArgs = process.argv.slice(2);
|
||||||
|
for (const arg of fileArgs) {
|
||||||
|
if ((arg.endsWith('.md') || arg.endsWith('.markdown')) && fs.existsSync(arg)) {
|
||||||
|
// Store the file to open after window is ready
|
||||||
|
app.pendingFile = arg;
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
app.on('window-all-closed', () => {
|
app.on('window-all-closed', () => {
|
||||||
if (process.platform !== 'darwin') {
|
if (process.platform !== 'darwin') {
|
||||||
@@ -260,3 +726,25 @@ app.on('activate', () => {
|
|||||||
createWindow();
|
createWindow();
|
||||||
}
|
}
|
||||||
});
|
});
|
||||||
|
|
||||||
|
// Handle file opening on macOS
|
||||||
|
app.on('open-file', (event, filePath) => {
|
||||||
|
event.preventDefault();
|
||||||
|
if (mainWindow) {
|
||||||
|
openFileFromPath(filePath);
|
||||||
|
} else {
|
||||||
|
// Store the file path to open after window is created
|
||||||
|
app.pendingFile = filePath;
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
// Handle file opening from command line or file association
|
||||||
|
function openFileFromPath(filePath) {
|
||||||
|
if (fs.existsSync(filePath)) {
|
||||||
|
currentFile = filePath;
|
||||||
|
const content = fs.readFileSync(filePath, 'utf-8');
|
||||||
|
if (mainWindow && mainWindow.webContents) {
|
||||||
|
mainWindow.webContents.send('file-opened', { path: filePath, content });
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
+877
-151
File diff suppressed because it is too large
Load Diff
+995
-48
File diff suppressed because it is too large
Load Diff
Reference in New Issue
Block a user