markup-plus 0.6.0__tar.gz

markup_plus-0.6.0/.gitignore

@@ -0,0 +1,121 @@
+# ============================================================
+# Python
+# ============================================================
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# ============================================================
+# Virtual Environments
+# ============================================================
+venv/
+env/
+ENV/
+env.bak/
+venv.bak/
+.venv/
+build_env/
+
+# ============================================================
+# PyInstaller
+# ============================================================
+*.manifest
+*.spec
+pyinstaller-hooks/
+
+# ============================================================
+# IDE and Editors
+# ============================================================
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.project
+.pydevproject
+.settings/
+
+# ============================================================
+# Operating System
+# ============================================================
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+desktop.ini
+
+# ============================================================
+# Testing
+# ============================================================
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.nox/
+.hypothesis/
+
+# ============================================================
+# Generated HTML (from examples)
+# ============================================================
+examples/*.html
+
+# ============================================================
+# Installer (local only, not in Git)
+# ============================================================
+installer/
+installer-output/
+*.exe
+
+# ============================================================
+# Local development
+# ============================================================
+*.log
+*.bak
+*.tmp
+*.temp
+.cache/
+tmp/
+
+# ============================================================
+# Distribution
+# ============================================================
+*.tar.gz
+*.zip
+*.whl
+*.egg
+
+# ============================================================
+# Environment
+# ============================================================
+.env
+.env.local
+.env.*.local
+
+# ============================================================
+# Jupyter
+# ============================================================
+.ipynb_checkpoints/

markup_plus-0.6.0/CHANGELOG.md

@@ -0,0 +1,249 @@
+Changelog
+=========
+
+All notable changes to Markup+ will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [Unreleased]
+
+### Planned
+- `@run` directive for executing HTML/JS/CSS in-place
+- Nested lists support
+- Table cell spanning
+- PDF export
+- Live preview server
+- Plugin system
+
+---
+
+## [0.6.0] - 2026-09-16
+
+Release v0.6.0: Custom CSS, themes, standalone exe.
+
+### Added
+- Custom CSS support via `--css` flag
+- Ready-made themes (Ocean Blue, Midnight Dark, Forest Green, Rose Pink, Solarized Light, Nord, Paper)
+- Standalone executable for Windows
+- Theme switching at conversion time
+- Complete CSS variables system for customization
+
+### Changed
+- Improved rendering pipeline
+- Enhanced theme system
+
+### Fixed
+- Various rendering issues from previous versions
+
+---
+
+## [0.5.0] - 2026-09-16
+
+Phase 4: Variables, if/elif/else, each loops, filters, and comments.
+
+### Added
+- Variable system (`@let`) with strings, numbers, booleans, and arrays
+- Conditional blocks (`@if`, `@elif`, `@else`, `@endif`)
+- Loop blocks (`@each` with optional index)
+- Filter system with `upper`, `lower`, `capitalize`, `title`, `reverse`, `length`
+- Comment directive (`@#`)
+- Variable substitution with `{name}` syntax
+- Filter chaining with `|`
+
+### Changed
+- Parser now tracks variable definitions
+- Renderer evaluates conditions and loops
+
+---
+
+## [0.4.0] - 2026-09-16
+
+Phase 3.4-3.5: Task lists, front matter, TOC, and footnotes.
+
+### Added
+- Task lists with checkboxes (`- [x]` and `- [ ]`)
+- Front matter support for metadata (between `---` lines)
+- Table of contents directive (`@toc`) with custom title
+- Footnotes support with `[^1]` syntax
+- Front matter fields become variables
+
+### Changed
+- Parser handles front matter as metadata
+- TOC automatically generated from headings
+
+---
+
+## [0.3.3] - 2026-09-16
+
+Phase 3.3: Auto RTL detection for Persian, Arabic, Hebrew.
+
+### Added
+- Automatic RTL detection for Persian, Arabic, Hebrew, and Urdu
+- 30% RTL character threshold for auto-detection
+- `--rtl` and `--ltr` flags for manual control
+- Persian-friendly fonts and layout
+
+### Changed
+- Direction detection algorithm uses Unicode bidirectional properties
+
+### Fixed
+- RTL rendering for mixed Persian and English text
+
+---
+
+## [0.3.2] - 2026-09-15
+
+Phase 3.2: Tables with alignment support.
+
+### Added
+- Markdown-style tables with `|` syntax
+- Column alignment: left (`:---`), center (`:---:`), right (`---:`)
+- Table header styling
+- Alternating row colors
+
+### Fixed
+- Table rendering with special characters
+
+---
+
+## [0.3.1] - 2026-09-15
+
+Phase 3.1: Links, autolinks, strikethrough + test updates.
+
+### Added
+- Link syntax with `[text](url)` and `[text](url "title")`
+- Autolinks with `<https://example.com>`
+- Strikethrough with `~~text~~`
+- Links open in new tab automatically
+
+### Changed
+- Test suite updates for new features
+
+---
+
+## [0.3.0] - 2026-09-15
+
+Phase 2.5: Complete feature set - lightbox, themes, scroll reveal.
+
+### Added
+- Image lightbox with keyboard navigation
+- Light and dark themes
+- Scroll reveal animations
+- Theme switcher
+
+### Changed
+- Complete redesign of image rendering
+- Enhanced visual presentation
+
+---
+
+## [0.2.0] - 2026-09-15
+
+Phase 2.4: Images with alignment, captions, links, and options.
+
+### Added
+- Image syntax with `![alt](url)`
+- Image options: width, height, align, caption, description, link, zoomable
+- Image alignment (left, center, right)
+- Image captions below images
+- Clickable images with links
+
+### Changed
+- Image rendering with wrapper elements
+
+---
+
+## [0.1.0] - 2026-09-15
+
+Phase 1: Core - headings, paragraphs, inline formatting.
+
+### Added
+- Heading support (H1 to H6)
+- Paragraph support
+- Bold (`**text**`) and italic (`*text*`) formatting
+- Inline code with backticks
+- Basic HTML output
+- CLI entry point (`mup` command)
+
+### Added (within v0.1.0 development)
+- Phase 2.2: Blockquotes and horizontal rules
+- Phase 2.3.5: Enhanced code blocks with live preview
+- Fenced code blocks with syntax highlighting
+- Code block copy and download buttons
+- Live preview for HTML/CSS/JS code
+
+---
+
+## Version History Summary
+
+| Version | Date | Phase | Focus |
+|---------|------|-------|-------|
+| 0.1.0 | 2026-09-15 | Phase 1-2.3 | Core + Blockquotes + Code blocks |
+| 0.2.0 | 2026-09-15 | Phase 2.4 | Images with options |
+| 0.3.0 | 2026-09-15 | Phase 2.5 | Lightbox + Themes + Scroll reveal |
+| 0.3.1 | 2026-09-15 | Phase 3.1 | Links + Autolinks + Strikethrough |
+| 0.3.2 | 2026-09-15 | Phase 3.2 | Tables with alignment |
+| 0.3.3 | 2026-09-16 | Phase 3.3 | Auto RTL detection |
+| 0.4.0 | 2026-09-16 | Phase 3.4-3.5 | Task lists + Front matter + TOC + Footnotes |
+| 0.5.0 | 2026-09-16 | Phase 4 | Variables + Conditionals + Loops + Filters |
+| 0.6.0 | 2026-09-16 | Release | Custom CSS + Themes + Standalone exe |
+
+---
+
+## Upcoming Versions
+
+### [0.7.0] - Planned
+- `@run` directive for executing HTML/JS/CSS in-place
+- Nested lists
+- Table cell spanning
+- Better error messages with line context
+- Auto-fix suggestions
+- Watch mode (`mup watch`)
+
+### [0.8.0] - Planned
+- PDF export
+- Markdown export
+- EPUB export
+- JSON export
+- Static site generation
+- Custom HTML templates
+
+### [0.9.0] - Planned
+- Incremental compilation
+- Streaming parser
+- Parallel rendering
+- Plugin system
+- Built-in plugins
+
+### [1.0.0] - Planned
+- Stable API
+- 100% test coverage on core modules
+- Desktop IDE (Markup+ Studio)
+- Windows installer
+- Documentation website
+- Video course
+
+---
+
+## Links
+
+- [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
+- [Semantic Versioning](https://semver.org/spec/v2.0.0.html)
+- [Markup+ Repository](https://github.com/ataee-dev/markup-plus)
+- [Markup+ Issues](https://github.com/ataee-dev/markup-plus/issues)
+- [Markup+ Discussions](https://github.com/ataee-dev/markup-plus/discussions)
+
+---
+
+## Contact
+
+- Email: hosseinataee2009@gmail.com
+- Repository: https://github.com/ataee-dev/markup-plus
+
+---
+
+Markup+ Non-Commercial License
+Copyright 2026 Hossein Ataee

markup_plus-0.6.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,187 @@
+Contributor Code of Conduct
+============================
+
+Version: 0.6.0
+Last Updated: January 2026
+
+---
+
+Our Pledge
+----------
+
+We as members, contributors, and leaders pledge to make participation
+in our community a harassment-free experience for everyone, regardless
+of age, body size, visible or invisible disability, ethnicity, sex
+characteristics, gender identity and expression, level of experience,
+education, socio-economic status, nationality, personal appearance,
+race, caste, color, religion, or sexual identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open,
+welcoming, diverse, inclusive, and healthy community.
+
+---
+
+Our Standards
+-------------
+
+Examples of behavior that contributes to a positive environment for
+our community include:
+
+- Demonstrating empathy and kindness toward other people
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive feedback
+- Accepting responsibility and apologizing to those affected by our
+  mistakes, and learning from the experience
+- Focusing on what is best not just for us as individuals, but for the
+  overall community
+
+Examples of unacceptable behavior include:
+
+- The use of sexualized language or imagery, and sexual attention or
+  advances of any kind
+- Trolling, insulting or derogatory comments, and personal or political
+  attacks
+- Public or private harassment
+- Publishing others' private information, such as a physical or email
+  address, without their explicit permission
+- Other conduct which could reasonably be considered inappropriate in
+  a professional setting
+
+---
+
+Enforcement Responsibilities
+----------------------------
+
+Community leaders are responsible for clarifying and enforcing our
+standards of acceptable behavior and will take appropriate and fair
+corrective action in response to any behavior that they deem
+inappropriate, threatening, offensive, or harmful.
+
+Community leaders have the right and responsibility to remove, edit,
+or reject comments, commits, code, wiki edits, issues, and other
+contributions that are not aligned to this Code of Conduct, and will
+communicate reasons for moderation decisions when appropriate.
+
+---
+
+Scope
+-----
+
+This Code of Conduct applies within all community spaces, and also
+applies when an individual is officially representing the community
+in public spaces. Examples of representing our community include
+using an official email address, posting via an official social media
+account, or acting as an appointed representative at an online or
+offline event.
+
+---
+
+Enforcement
+-----------
+
+Instances of abusive, harassing, or otherwise unacceptable behavior
+may be reported to the community leaders responsible for enforcement
+at:
+
+    hosseinataee2009@gmail.com
+
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and
+security of the reporter of any incident.
+
+---
+
+Enforcement Guidelines
+----------------------
+
+Community leaders will follow these Community Impact Guidelines in
+determining the consequences for any action they deem in violation
+of this Code of Conduct:
+
+### 1. Correction
+
+Community Impact: Use of inappropriate language or other behavior
+deemed unprofessional or unwelcome in the community.
+
+Consequence: A private, written warning from community leaders,
+providing clarity around the nature of the violation and an
+explanation of why the behavior was inappropriate. A public apology
+may be requested.
+
+### 2. Warning
+
+Community Impact: A violation through a single incident or series of
+actions.
+
+Consequence: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited
+interaction with those enforcing the Code of Conduct, for a specified
+period of time. This includes avoiding interactions in community
+spaces as well as external channels like social media. Violating
+these terms may lead to a temporary or permanent ban.
+
+### 3. Temporary Ban
+
+Community Impact: A serious violation of community standards,
+including sustained inappropriate behavior.
+
+Consequence: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No
+public or private interaction with the people involved, including
+unsolicited interaction with those enforcing the Code of Conduct, is
+allowed during this period. Violating these terms may lead to a
+permanent ban.
+
+### 4. Permanent Ban
+
+Community Impact: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of
+an individual, or aggression toward or disparagement of classes of
+individuals.
+
+Consequence: A permanent ban from any sort of public interaction
+within the community.
+
+---
+
+Attribution
+-----------
+
+This Code of Conduct is adapted from the Contributor Covenant,
+version 2.1, available at:
+
+    https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+
+Community Impact Guidelines were inspired by Mozilla's code of
+conduct enforcement ladder:
+
+    https://github.com/mozilla/diversity
+
+For answers to common questions about this code of conduct, see the
+FAQ at:
+
+    https://www.contributor-covenant.org/faq
+
+Translations are available at:
+
+    https://www.contributor-covenant.org/translations
+
+---
+
+Contact
+-------
+
+For questions or concerns about this Code of Conduct, contact:
+
+    Hossein Ataee
+    Email: hosseinataee2009@gmail.com
+    Repository: https://github.com/ataee-dev/markup-plus
+
+---
+
+Last updated: January 2026
+Version: 0.6.0
+
+Markup+ Non-Commercial License
+Copyright 2026 Hossein Ataee