Files
articulate-parser/DOCKER.md
Kaj Kowalski a1a49a75b7 chore: Enhance developer tooling and documentation
Adds `actionlint` to the pre-commit configuration to validate GitHub Actions workflows.

Significantly expands the `AGENTS.md` file with a comprehensive summary of new features and changes in Go 1.24 and 1.25, along with actionable recommendations for the project.

Additionally, normalizes markdown list formatting across various documentation files for consistency.
2025-11-07 07:50:09 +01:00

2.1 KiB

Articulate Parser - Docker

A powerful command-line tool for parsing and processing articulate data files, now available as a lightweight Docker container.

Quick Start

Pull from GitHub Container Registry

docker pull ghcr.io/kjanat/articulate-parser:latest

Run with Articulate Rise URL

docker run --rm -v $(pwd):/data ghcr.io/kjanat/articulate-parser:latest https://rise.articulate.com/share/N_APNg40Vr2CSH2xNz-ZLATM5kNviDIO#/ markdown /data/output.md

Run with local files

docker run --rm -v $(pwd):/data ghcr.io/kjanat/articulate-parser:latest /data/input.json markdown /data/output.md

Usage

Basic File Processing

# Process from Articulate Rise URL
docker run --rm -v $(pwd):/data ghcr.io/kjanat/articulate-parser:latest https://rise.articulate.com/share/N_APNg40Vr2CSH2xNz-ZLATM5kNviDIO#/ markdown /data/output.md

# Process a local JSON file
docker run --rm -v $(pwd):/data ghcr.io/kjanat/articulate-parser:latest /data/document.json markdown /data/output.md

# Process with specific format and output
docker run --rm -v $(pwd):/data ghcr.io/kjanat/articulate-parser:latest /data/input.json docx /data/output.docx

Display Help and Version

# Show help information
docker run --rm ghcr.io/kjanat/articulate-parser:latest --help

# Show version
docker run --rm ghcr.io/kjanat/articulate-parser:latest --version

Available Tags

  • latest - Latest stable release
  • v1.x.x - Specific version tags
  • main - Latest development build

Image Details

  • Base Image: scratch (minimal attack surface)
  • Architecture: Multi-arch support (amd64, arm64)
  • Size: < 10MB (optimized binary)
  • Security: Runs as non-root user
  • Features: SBOM and provenance attestation included

Development

Local Build

docker build -t articulate-parser .

Docker Compose

docker-compose up --build

Repository