article-cli 1.2.0__tar.gz → 1.3.0__tar.gz

{article_cli-1.2.0 → article_cli-1.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: article-cli
-Version: 1.2.0
+Version: 1.3.0
 Summary: CLI tool for managing LaTeX articles with git integration and Zotero bibliography
 Project-URL: Homepage, https://github.com/feelpp/article.cli
 Project-URL: Documentation, https://github.com/feelpp/article.cli#readme
@@ -59,13 +59,15 @@ Description-Content-Type: text/markdown
 [![PyPI version](https://badge.fury.io/py/article-cli.svg)](https://badge.fury.io/py/article-cli)
 [![Python Support](https://img.shields.io/pypi/pyversions/article-cli.svg)](https://pypi.org/project/article-cli/)
 
-A command-line tool for managing LaTeX articles with git integration and Zotero bibliography synchronization.
+A command-line tool for managing LaTeX articles and presentations with git integration and Zotero bibliography synchronization.
 
 ## Features
 
-- **Repository Initialization**: Complete setup for LaTeX article projects with one command
-- **LaTeX Compilation**: Compile documents with latexmk/pdflatex, watch mode, shell escape support
-- **GitHub Actions Workflows**: Automated PDF compilation, artifact upload, and GitHub releases
+- **Repository Initialization**: Complete setup for LaTeX article or presentation projects with one command
+- **Project Types**: Support for articles, Beamer presentations, and posters
+- **LaTeX Compilation**: Compile documents with latexmk/pdflatex/xelatex/lualatex, watch mode, shell escape support
+- **Font Installation**: Download and install fonts for XeLaTeX projects (Marianne, Roboto Mono, etc.)
+- **GitHub Actions Workflows**: Automated PDF compilation with XeLaTeX support, artifact upload, and GitHub releases
 - **Git Release Management**: Create, list, and delete releases with gitinfo2 support
 - **Zotero Integration**: Synchronize bibliography from Zotero with robust pagination and error handling
 - **LaTeX Build Management**: Clean build files and manage LaTeX compilation artifacts
@@ -168,6 +170,24 @@ default_branch = "main"
 
 [latex]
 clean_extensions = [".aux", ".bbl", ".blg", ".log", ".out", ".synctex.gz"]
+
+[fonts]
+directory = "fonts"
+
+[fonts.sources]
+marianne = "https://github.com/ArnaudBelcworking/Marianne/archive/refs/heads/master.zip"
+roboto-mono = "https://github.com/googlefonts/RobotoMono/releases/download/v3.000/RobotoMono-v3.000.zip"
+
+[themes]
+directory = "."
+
+# Custom theme sources (numpex is built-in)
+# [themes.sources.my-theme]
+# url = "https://example.com/theme.zip"
+# description = "My custom theme"
+# files = ["beamerthememytheme.sty"]
+# requires_fonts = false
+# engine = "pdflatex"
 ```
 
 ## Usage
@@ -178,6 +198,12 @@ clean_extensions = [".aux", ".bbl", ".blg", ".log", ".out", ".synctex.gz"]
 # Initialize a new article repository (auto-detects main .tex file)
 article-cli init --title "My Article Title" --authors "John Doe,Jane Smith"
 
+# Initialize a Beamer presentation project
+article-cli init --title "My Presentation" --authors "Author" --type presentation
+
+# Initialize with numpex theme (requires theme files from presentation.template.d)
+article-cli init --title "NumPEx Talk" --authors "Author" --type presentation --theme numpex
+
 # Specify custom Zotero group ID
 article-cli init --title "My Article" --authors "Author" --group-id 1234567
 
@@ -189,11 +215,12 @@ article-cli init --title "My Article" --authors "Author" --force
 ```
 
 The `init` command sets up:
-- **GitHub Actions workflow** for automated PDF compilation and releases
+- **GitHub Actions workflow** for automated PDF compilation and releases (with XeLaTeX support for presentations)
 - **pyproject.toml** with dependencies and article-cli configuration
 - **README.md** with comprehensive documentation
 - **.gitignore** with LaTeX-specific patterns
 - **VS Code configuration** for LaTeX Workshop with auto-build and SyncTeX
+- **Font configuration** (for presentation projects using custom themes)
 
 ### Git Release Management
 
@@ -233,6 +260,12 @@ article-cli compile main.tex
 # Compile with pdflatex engine
 article-cli compile --engine pdflatex
 
+# Compile with XeLaTeX (for custom fonts)
+article-cli compile --engine xelatex
+
+# Compile with LuaLaTeX
+article-cli compile --engine lualatex
+
 # Enable shell escape (for code highlighting, etc.)
 article-cli compile --shell-escape
 
@@ -246,6 +279,64 @@ article-cli compile --clean-first --clean-after
 article-cli compile --output-dir build/
 ```
 
+### Font Installation
+
+Install fonts for XeLaTeX projects (useful for custom Beamer themes):
+
+```bash
+# Install default fonts (Marianne, Roboto Mono) to fonts/ directory
+article-cli install-fonts
+
+# Install to a custom directory
+article-cli install-fonts --dir custom-fonts/
+
+# Force re-download even if fonts exist
+article-cli install-fonts --force
+
+# List installed fonts
+article-cli install-fonts --list
+```
+
+**Default fonts:**
+- **Marianne**: French government official font
+- **Roboto Mono**: Google's monospace font for code
+
+### Theme Installation
+
+Install Beamer themes for presentations:
+
+```bash
+# List available themes
+article-cli install-theme --list
+
+# Install numpex theme (NumPEx Beamer theme)
+article-cli install-theme numpex
+
+# Install to a custom directory
+article-cli install-theme numpex --dir themes/
+
+# Force re-download even if theme exists
+article-cli install-theme numpex --force
+
+# Install from a custom URL
+article-cli install-theme my-theme --url https://example.com/theme.zip
+```
+
+**Available themes:**
+- **numpex**: NumPEx Beamer theme following French government visual identity (requires XeLaTeX and custom fonts)
+
+**Complete presentation setup:**
+```bash
+# 1. Install the theme
+article-cli install-theme numpex
+
+# 2. Install required fonts
+article-cli install-fonts
+
+# 3. Compile with XeLaTeX
+article-cli compile presentation.tex --engine xelatex
+```
+
 ### Project Setup
 
 ```bash
@@ -292,6 +383,22 @@ MIT License - see LICENSE file for details.
 
 ## Changelog
 
+### v1.2.0
+- Add font installation command (`install-fonts`) for XeLaTeX projects
+- Support Marianne and Roboto Mono fonts by default
+- Add theme installation command (`install-theme`) for Beamer presentations
+- Built-in support for numpex theme with automatic download
+- Extended GitHub Actions workflow with XeLaTeX and multi-document support
+- Add presentation project type with Beamer template support
+- Add `--engine` option for xelatex and lualatex compilation
+- Improved CI/CD with font installation steps
+
+### v1.1.0
+- Add `init` command for repository initialization
+- Add `compile` command with watch mode and multiple engines
+- GitHub Actions workflow generation
+- VS Code configuration generation
+
 ### v1.0.0
 - Initial release
 - Git release management

{article_cli-1.2.0 → article_cli-1.3.0}/README.md

@@ -4,13 +4,15 @@
 [![PyPI version](https://badge.fury.io/py/article-cli.svg)](https://badge.fury.io/py/article-cli)
 [![Python Support](https://img.shields.io/pypi/pyversions/article-cli.svg)](https://pypi.org/project/article-cli/)
 
-A command-line tool for managing LaTeX articles with git integration and Zotero bibliography synchronization.
+A command-line tool for managing LaTeX articles and presentations with git integration and Zotero bibliography synchronization.
 
 ## Features
 
-- **Repository Initialization**: Complete setup for LaTeX article projects with one command
-- **LaTeX Compilation**: Compile documents with latexmk/pdflatex, watch mode, shell escape support
-- **GitHub Actions Workflows**: Automated PDF compilation, artifact upload, and GitHub releases
+- **Repository Initialization**: Complete setup for LaTeX article or presentation projects with one command
+- **Project Types**: Support for articles, Beamer presentations, and posters
+- **LaTeX Compilation**: Compile documents with latexmk/pdflatex/xelatex/lualatex, watch mode, shell escape support
+- **Font Installation**: Download and install fonts for XeLaTeX projects (Marianne, Roboto Mono, etc.)
+- **GitHub Actions Workflows**: Automated PDF compilation with XeLaTeX support, artifact upload, and GitHub releases
 - **Git Release Management**: Create, list, and delete releases with gitinfo2 support
 - **Zotero Integration**: Synchronize bibliography from Zotero with robust pagination and error handling
 - **LaTeX Build Management**: Clean build files and manage LaTeX compilation artifacts
@@ -113,6 +115,24 @@ default_branch = "main"
 
 [latex]
 clean_extensions = [".aux", ".bbl", ".blg", ".log", ".out", ".synctex.gz"]
+
+[fonts]
+directory = "fonts"
+
+[fonts.sources]
+marianne = "https://github.com/ArnaudBelcworking/Marianne/archive/refs/heads/master.zip"
+roboto-mono = "https://github.com/googlefonts/RobotoMono/releases/download/v3.000/RobotoMono-v3.000.zip"
+
+[themes]
+directory = "."
+
+# Custom theme sources (numpex is built-in)
+# [themes.sources.my-theme]
+# url = "https://example.com/theme.zip"
+# description = "My custom theme"
+# files = ["beamerthememytheme.sty"]
+# requires_fonts = false
+# engine = "pdflatex"
 ```
 
 ## Usage
@@ -123,6 +143,12 @@ clean_extensions = [".aux", ".bbl", ".blg", ".log", ".out", ".synctex.gz"]
 # Initialize a new article repository (auto-detects main .tex file)
 article-cli init --title "My Article Title" --authors "John Doe,Jane Smith"
 
+# Initialize a Beamer presentation project
+article-cli init --title "My Presentation" --authors "Author" --type presentation
+
+# Initialize with numpex theme (requires theme files from presentation.template.d)
+article-cli init --title "NumPEx Talk" --authors "Author" --type presentation --theme numpex
+
 # Specify custom Zotero group ID
 article-cli init --title "My Article" --authors "Author" --group-id 1234567
 
@@ -134,11 +160,12 @@ article-cli init --title "My Article" --authors "Author" --force
 ```
 
 The `init` command sets up:
-- **GitHub Actions workflow** for automated PDF compilation and releases
+- **GitHub Actions workflow** for automated PDF compilation and releases (with XeLaTeX support for presentations)
 - **pyproject.toml** with dependencies and article-cli configuration
 - **README.md** with comprehensive documentation
 - **.gitignore** with LaTeX-specific patterns
 - **VS Code configuration** for LaTeX Workshop with auto-build and SyncTeX
+- **Font configuration** (for presentation projects using custom themes)
 
 ### Git Release Management
 
@@ -178,6 +205,12 @@ article-cli compile main.tex
 # Compile with pdflatex engine
 article-cli compile --engine pdflatex
 
+# Compile with XeLaTeX (for custom fonts)
+article-cli compile --engine xelatex
+
+# Compile with LuaLaTeX
+article-cli compile --engine lualatex
+
 # Enable shell escape (for code highlighting, etc.)
 article-cli compile --shell-escape
 
@@ -191,6 +224,64 @@ article-cli compile --clean-first --clean-after
 article-cli compile --output-dir build/
 ```
 
+### Font Installation
+
+Install fonts for XeLaTeX projects (useful for custom Beamer themes):
+
+```bash
+# Install default fonts (Marianne, Roboto Mono) to fonts/ directory
+article-cli install-fonts
+
+# Install to a custom directory
+article-cli install-fonts --dir custom-fonts/
+
+# Force re-download even if fonts exist
+article-cli install-fonts --force
+
+# List installed fonts
+article-cli install-fonts --list
+```
+
+**Default fonts:**
+- **Marianne**: French government official font
+- **Roboto Mono**: Google's monospace font for code
+
+### Theme Installation
+
+Install Beamer themes for presentations:
+
+```bash
+# List available themes
+article-cli install-theme --list
+
+# Install numpex theme (NumPEx Beamer theme)
+article-cli install-theme numpex
+
+# Install to a custom directory
+article-cli install-theme numpex --dir themes/
+
+# Force re-download even if theme exists
+article-cli install-theme numpex --force
+
+# Install from a custom URL
+article-cli install-theme my-theme --url https://example.com/theme.zip
+```
+
+**Available themes:**
+- **numpex**: NumPEx Beamer theme following French government visual identity (requires XeLaTeX and custom fonts)
+
+**Complete presentation setup:**
+```bash
+# 1. Install the theme
+article-cli install-theme numpex
+
+# 2. Install required fonts
+article-cli install-fonts
+
+# 3. Compile with XeLaTeX
+article-cli compile presentation.tex --engine xelatex
+```
+
 ### Project Setup
 
 ```bash
@@ -237,6 +328,22 @@ MIT License - see LICENSE file for details.
 
 ## Changelog
 
+### v1.2.0
+- Add font installation command (`install-fonts`) for XeLaTeX projects
+- Support Marianne and Roboto Mono fonts by default
+- Add theme installation command (`install-theme`) for Beamer presentations
+- Built-in support for numpex theme with automatic download
+- Extended GitHub Actions workflow with XeLaTeX and multi-document support
+- Add presentation project type with Beamer template support
+- Add `--engine` option for xelatex and lualatex compilation
+- Improved CI/CD with font installation steps
+
+### v1.1.0
+- Add `init` command for repository initialization
+- Add `compile` command with watch mode and multiple engines
+- GitHub Actions workflow generation
+- VS Code configuration generation
+
 ### v1.0.0
 - Initial release
 - Git release management

{article_cli-1.2.0 → article_cli-1.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "article-cli"
-version = "1.2.0"
+version = "1.3.0"
 authors = [
     {name = "Christophe Prud'homme", email = "prudhomm@cemosis.fr"},
 ]

{article_cli-1.2.0 → article_cli-1.3.0}/src/article_cli/__init__.py

@@ -8,7 +8,7 @@ This package provides tools for:
     - Git hooks setup
 """
 
-__version__ = "1.2.0"
+__version__ = "1.3.0"
 __author__ = "Christophe Prud'homme"
 __email__ = "prudhomm@cemosis.fr"
 

{article_cli-1.2.0 → article_cli-1.3.0}/src/article_cli/cli.py

@@ -36,6 +36,10 @@ Examples:
   %(prog)s delete v1.0.0                  # Delete release
   %(prog)s update-bibtex                  # Update from Zotero
   %(prog)s config create                  # Create sample config file
+  %(prog)s install-fonts                  # Install fonts for XeLaTeX
+  %(prog)s install-fonts --list           # List installed fonts
+  %(prog)s install-theme numpex           # Install numpex Beamer theme
+  %(prog)s install-theme --list           # List available themes
 
 Environment variables:
   ZOTERO_API_KEY    : Your Zotero API key (required for update-bibtex)
@@ -76,6 +80,23 @@ Environment variables:
         action="store_true",
         help="Overwrite existing files",
     )
+    init_parser.add_argument(
+        "--type",
+        choices=["article", "presentation", "poster"],
+        default="article",
+        help="Project type (default: article). Use 'presentation' for Beamer slides.",
+    )
+    init_parser.add_argument(
+        "--theme",
+        default="",
+        help="Beamer theme for presentations (e.g., 'numpex', 'metropolis').",
+    )
+    init_parser.add_argument(
+        "--aspect-ratio",
+        choices=["169", "43", "1610"],
+        default="169",
+        help="Aspect ratio for presentations (default: 169 for 16:9).",
+    )
 
     # Setup command
     subparsers.add_parser("setup", help="Setup git hooks for gitinfo2")
@@ -94,9 +115,9 @@ Environment variables:
     )
     compile_parser.add_argument(
         "--engine",
-        choices=["latexmk", "pdflatex"],
+        choices=["latexmk", "pdflatex", "xelatex", "lualatex"],
         default="latexmk",
-        help="LaTeX engine to use (default: latexmk)",
+        help="LaTeX engine to use (default: latexmk). Use xelatex/lualatex for custom fonts.",
     )
     compile_parser.add_argument(
         "--shell-escape",
@@ -167,6 +188,57 @@ Environment variables:
 
     config_subparsers.add_parser("show", help="Show current configuration")
 
+    # Install-fonts command
+    fonts_parser = subparsers.add_parser(
+        "install-fonts", help="Download and install fonts for XeLaTeX projects"
+    )
+    fonts_parser.add_argument(
+        "--dir",
+        type=Path,
+        help="Directory to install fonts (default: fonts/)",
+    )
+    fonts_parser.add_argument(
+        "--force",
+        action="store_true",
+        help="Re-download fonts even if already installed",
+    )
+    fonts_parser.add_argument(
+        "--list",
+        action="store_true",
+        dest="list_fonts",
+        help="List installed fonts instead of installing",
+    )
+
+    # Install-theme command
+    theme_parser = subparsers.add_parser(
+        "install-theme", help="Download and install Beamer themes for presentations"
+    )
+    theme_parser.add_argument(
+        "theme_name",
+        nargs="?",
+        help="Name of theme to install (e.g., 'numpex')",
+    )
+    theme_parser.add_argument(
+        "--dir",
+        type=Path,
+        help="Directory to install theme (default: current directory)",
+    )
+    theme_parser.add_argument(
+        "--force",
+        action="store_true",
+        help="Re-download theme even if already installed",
+    )
+    theme_parser.add_argument(
+        "--list",
+        action="store_true",
+        dest="list_themes",
+        help="List available themes instead of installing",
+    )
+    theme_parser.add_argument(
+        "--url",
+        help="Custom URL to download theme from (use with theme_name)",
+    )
+
     return parser
 
 
@@ -185,6 +257,9 @@ def handle_init_command(args: argparse.Namespace, config: Config) -> int:
                 group_id=args.group_id,
                 force=args.force,
                 main_tex_file=args.tex_file,
+                project_type=args.type,
+                theme=args.theme,
+                aspect_ratio=args.aspect_ratio,
             )
             else 1
         )
@@ -413,6 +488,108 @@ def handle_config_command(args: argparse.Namespace, config: Config) -> int:
         return 1
 
 
+def handle_install_fonts_command(args: argparse.Namespace, config: Config) -> int:
+    """Handle the install-fonts command"""
+    try:
+        from .fonts import FontInstaller, install_fonts_from_config
+
+        fonts_config = config.get_fonts_config()
+
+        # Override directory if specified on command line
+        fonts_dir = (
+            args.dir if args.dir else Path(fonts_config.get("directory", "fonts"))
+        )
+
+        # List installed fonts if requested
+        if args.list_fonts:
+            installer = FontInstaller(fonts_dir=fonts_dir)
+            installed = installer.list_installed()
+
+            if not installed:
+                print_info(f"No fonts installed in {fonts_dir}")
+                return 0
+
+            print_info(f"Installed fonts in {fonts_dir}:")
+            for font_name in installed:
+                font_files = installer.get_font_files(font_name)
+                print(f"  - {font_name} ({len(font_files)} font files)")
+
+            return 0
+
+        # Install fonts
+        sources = fonts_config.get("sources", [])
+        installer = FontInstaller(fonts_dir=fonts_dir, sources=sources)
+
+        success = installer.install_all(force=args.force)
+        return 0 if success else 1
+
+    except Exception as e:
+        print_error(f"Font installation failed: {e}")
+        return 1
+
+
+def handle_install_theme_command(args: argparse.Namespace, config: Config) -> int:
+    """Handle the install-theme command"""
+    try:
+        from .themes import ThemeInstaller
+
+        themes_config = config.get_themes_config()
+
+        # Override directory if specified on command line
+        themes_dir = args.dir if args.dir else Path(themes_config.get("directory", "."))
+
+        # Get configured sources
+        sources = themes_config.get("sources", {})
+
+        installer = ThemeInstaller(themes_dir=themes_dir, sources=sources)
+
+        # List available themes if requested
+        if args.list_themes:
+            available = installer.list_available()
+            installed = installer.list_installed()
+
+            print_info("Available themes:")
+            for theme in available:
+                name = theme["name"]
+                desc = theme.get("description", "")
+                engine = theme.get("engine", "pdflatex")
+                fonts = (
+                    " (requires custom fonts)" if theme.get("requires_fonts") else ""
+                )
+                installed_marker = (
+                    " [installed]" if any(i["name"] == name for i in installed) else ""
+                )
+                print(f"  - {name}: {desc}")
+                print(f"      Engine: {engine}{fonts}{installed_marker}")
+
+            return 0
+
+        # Theme name is required for installation
+        if not args.theme_name:
+            print_error("Theme name is required. Use --list to see available themes.")
+            return 1
+
+        # Install from custom URL if provided
+        if args.url:
+            success = installer.install_from_url(
+                name=args.theme_name,
+                url=args.url,
+                force=args.force,
+            )
+        else:
+            # Install from known sources
+            success = installer.install_theme(
+                name=args.theme_name,
+                force=args.force,
+            )
+
+        return 0 if success else 1
+
+    except Exception as e:
+        print_error(f"Theme installation failed: {e}")
+        return 1
+
+
 def main(argv: Optional[list] = None) -> int:
     """
     Main entry point for article-cli
@@ -466,6 +643,12 @@ def main(argv: Optional[list] = None) -> int:
         elif args.command == "config":
             return handle_config_command(args, config)
 
+        elif args.command == "install-fonts":
+            return handle_install_fonts_command(args, config)
+
+        elif args.command == "install-theme":
+            return handle_install_theme_command(args, config)
+
         else:
             print_error(f"Unknown command: {args.command}")
             return 1