Adding Github Action to build artifacts using LiaScript Exporter.

Author: grugnog

README.md

@@ -88,6 +88,45 @@ Learn more: https://scorm.com/scorm-explained/
 Known SCORM configurations per LMS:
   https://www.npmjs.com/package/@liascript/exporter#scorm-examples
 
+## GitHub Action
+
+Export your LiaScript courses directly in GitHub workflows with this GitHub Action.
+
+### Quick Start
+
+Add to your `.github/workflows/export.yml`:
+
+```yaml
+name: Export Course
+on: [push]
+
+jobs:
+  export:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Export to SCORM
+      uses: ./
+      with:
+        input-file: 'README.md'
+        format: 'scorm1.2'
+        output-name: 'my-course'
+        scorm-organization: 'My Organization'
+    
+    - name: Upload SCORM package
+      uses: actions/upload-artifact@v4
+      with:
+        name: scorm-package
+        path: '*.zip'
+```
+
+### Documentation
+
+For complete GitHub Action documentation, inputs, outputs, and more examples, see: [`action/README.md`](action/README.md)
+
+## CLI Usage
+
 --scorm-organization        set the organization title
 --scorm-masteryScore        set the scorm masteryScore (a value between 0
                             -- 100), default is 0
@@ -204,7 +243,7 @@ overview page, based on a provided yaml description.
 Learn more: https://www.npmjs.com/package/@liascript/exporter#project 
 
 Example:
-- Input:  https://github.com/LiaBooks/liabooks.github.com/blob/main/project.yaml
+- Input:  https://github.com/LiaBooks/liabooks.github.com/blob/main/project.yml
 - Output: https://liabooks.github.io
 
 --project-no-meta           Disable the generation of meta information

action.yml

@@ -0,0 +1,153 @@
+name: 'LiaScript-Exporter'
+description: 'Export LiaScript courses to SCORM, PDF, Web, and other formats for LMS deployment and distribution'
+author: 'grugnog'
+branding:
+  icon: 'book'
+  color: 'blue'
+
+inputs:
+  # Core inputs
+  input-file:
+    description: 'Path to README.md or project.yml file'
+    required: true
+  format:
+    description: 'Export format (scorm1.2, scorm2004, pdf, web, ims, xapi, rdf, json, project)'
+    required: true
+  output-name:
+    description: 'Base name for output files'
+    required: false
+  course-path:
+    description: 'Directory containing the course'
+    required: false
+
+  # SCORM settings
+  scorm-organization:
+    description: 'Organization title'
+    required: false
+  scorm-mastery-score:
+    description: 'Mastery score (0-100)'
+    required: false
+    default: '0'
+  scorm-typical-duration:
+    description: 'Duration (PT0H5M0S format)'
+    required: false
+    default: 'PT0H5M0S'
+  scorm-iframe:
+    description: 'Use iframe for SCORM'
+    required: false
+    default: 'false'
+  scorm-embed:
+    description: 'Embed Markdown in JS'
+    required: false
+    default: 'false'
+
+  # PDF settings
+  pdf-theme:
+    description: 'LiaScript theme'
+    required: false
+    default: 'default'
+  pdf-format:
+    description: 'Paper format'
+    required: false
+    default: 'A4'
+  pdf-scale:
+    description: 'Webpage rendering scale'
+    required: false
+    default: '1'
+  pdf-landscape:
+    description: 'Landscape orientation'
+    required: false
+    default: 'false'
+  pdf-print-background:
+    description: 'Print background graphics'
+    required: false
+    default: 'false'
+  pdf-stylesheet:
+    description: 'Custom CSS file path'
+    required: false
+
+  # Web settings
+  web-zip:
+    description: 'Create zip archive'
+    required: false
+    default: 'true'
+  web-indexeddb:
+    description: 'Enable IndexedDB storage'
+    required: false
+    default: 'false'
+  web-iframe:
+    description: 'Use iframe version'
+    required: false
+    default: 'false'
+
+  # IMS settings
+  ims-indexeddb:
+    description: 'Use IndexedDB for persistence'
+    required: false
+    default: 'false'
+
+  # xAPI settings
+  xapi-endpoint:
+    description: 'LRS endpoint URL'
+    required: false
+  xapi-auth:
+    description: 'Authentication string'
+    required: false
+  xapi-actor:
+    description: 'xAPI actor JSON'
+    required: false
+  xapi-course-id:
+    description: 'Course identifier'
+    required: false
+  xapi-course-title:
+    description: 'Course title'
+    required: false
+  xapi-debug:
+    description: 'Enable debug logging'
+    required: false
+    default: 'false'
+  xapi-zip:
+    description: 'Package as zip'
+    required: false
+    default: 'false'
+
+  # RDF settings
+  rdf-format:
+    description: 'Output format (json-ld, n-quads)'
+    required: false
+    default: 'json-ld'
+  rdf-url:
+    description: 'External URL reference'
+    required: false
+  rdf-type:
+    description: 'Schema.org type'
+    required: false
+    default: 'Course'
+  rdf-license:
+    description: 'License URL'
+    required: false
+  rdf-educational-level:
+    description: 'Educational level'
+    required: false
+
+  # General settings
+  style:
+    description: 'Additional CSS styling'
+    required: false
+  responsive-voice-key:
+    description: 'Text-to-speech API key'
+    required: false
+
+outputs:
+  output-file:
+    description: 'Path to the generated file'
+  file-size:
+    description: 'Size of generated file in bytes'
+  format:
+    description: 'Format that was generated'
+  success:
+    description: 'Whether export succeeded (true/false)'
+
+runs:
+  using: 'node20'
+  main: 'action/dist/index.js'

action/.gitignore

@@ -0,0 +1,32 @@
+# Dependencies
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Build outputs
+dist/*.d.ts
+dist/*.d.ts.map
+dist/*.js.map
+dist/sourcemap-register.js
+dist/licenses.txt
+
+# Keep the main bundled file for GitHub Actions
+!dist/index.js
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Test artifacts
+coverage/
+test-action.js
+
+# Logs
+*.log