Notorious Party Muppets

    @swimlane/docspa-stackblitz
    TypeScript icon, indicating that this package has built-in type declarations

    8.0.0 • Public • Published

    DocspaStackblitzModule

    (optional, external)

    This module allows embedding StackBlitz projects within markdown using a embed-stackblitz custom element and the [[stackblitz]] shortcode.

    import { BrowserModule } from '@angular/platform-browser';
    import { NgModule } from '@angular/core';
    import { DocspaCoreModule } from '@swimlane/docspa-core';
    import { DocspaStackblitzModule } from '@swimlane/docspa-stackblitz';
    
    import { AppComponent } from './app.component';
    import { config } from '../docspa.config';
    
    @NgModule({
      declarations: [
        AppComponent
      ],
      imports: [
        BrowserModule,
        DocspaCoreModule.forRoot(config),
        DocspaStackblitzModule
      ],
      providers: [],
      bootstrap: [AppComponent]
    })
    export class AppModule { }

    The embed-stackblitz custom element accepts a StackBlitz project payload as the project input.

    <embed-stackblitz
      title='Embeded StackBlitz Project<br />DocSPA'
      project='{"template": "javascript", "files": {"index.js": "console.log(123)", "index.html": "Hello World"} }'>
    </embed-stackblitz>

    or a path to a project payload (JSON file) in the documentation local files (relative to the document root folder):

    [[stackblitz title="Local StackBlitz Project<br />DocSPA" project-path="examples/folder/stackblitz" ]]

    i> When providing a payload path, if the files property of the payload contains an array, this is treated as an array of relative paths from which the file content will be loaded.

    You may also supply a project-id to to load an existing StackBlitz project:

    <embed-stackblitz
      title='Existing StackBlitz Project<br />DocSPA'
      project-id="sdk-create-project">
    </embed-stackblitz>

    If a both project-id and either a project-path or project input are provided, the files listed in the local project's files are treated as a a patch to the existing StackBlitz project.

    <embed-stackblitz
      title='Existing StackBlitz Project with local changes<br />DocSPA'
      project-id="sdk-create-project"
      project-path="examples/folder/stackblitz">
    </embed-stackblitz>

    Install

    npm i @swimlane/docspa-stackblitz

    DownloadsWeekly Downloads

    15

    Version

    8.0.0

    License

    MIT

    Unpacked Size

    70.5 kB

    Total Files

    15

    Last publish

    Collaborators

    • dabbott-sl
    • hernan-erasmo
    • rosvin
    • daniel.selig
    • thedude2004
    • jogaj_26
    • markcoleman1
    • gabriel.almeida.swimlane
    • cdhumes
    • johnapclaw
    • caleb.bass
    • hansstoetzer
    • drazafsky
    • sarath.pantula
    • jp.menezes
    • nikkuman
    • matias.vazquez
    • agustin.firpo
    • luis.duque
    • tmcclure
    • claudio.andrade
    • ischultz-swimlane
    • bensteele7
    • brantw
    • marjan-georgiev
    • danstory
    • hypercubed
    • seangrimes
    • michael.baswell
    • duredhel
    • dmikov
    • amiranda
    • jorgemontero
    • ngutierrez
    • adamfrank
    • parayacr
    • danguloa
    • dcookswim
    • tflintswim
    • jgrannan
    • bageldawg
    • malvarado25
    • it.admin.swim
    • smartinski
    • mattepp
    • vterziski
    • lisa-reynolds
    • josep.campos
    • royar95
    • tanner.lewis
    • mr_charlie
    • swimlane.dev