Skip to main content

generate MD documentation from tekton pipelines and tasks

Project description

mkdocs-mkdocs-pipeline-visualizer

Usage

$ pip install mkdocs-pipeline-visualizer

Example of mkdocs.yaml

site_name: Tekton

nav:
  - Home: index.md
  - Deployment Pipeline: ./path/to/pipeline/deploy-pipeline.md

plugins:
  - pipeline-visualizer

./path/to/pipeline/deploy-pipeline.md is the path to the actual pipeline definition but replace the extension from .yaml to .md

(Optional) configuration these are the default values

plugins:
  - pipeline-visualizer:
      plantuml_graphs: True
      plantuml_graph_direction: TB
      plantuml_theme: _none_
  • plantuml_graphs [bool] controls if pipeline graph should be visible
  • plantuml_graph_direction [string] TB(top to bottom) or LR(left to right)
  • plantuml_theme [string] any theme from https://plantuml.com/theme to style plantuml_theme e.g hacker, spacelab

Changelog

0.1.7

  • fix issue with \ in usage
  • correct example in readme

0.1.6

  • hide workspaces for tasks when none are used
  • show version of pipeline/task when available

0.1.5

  • remove extra --- after tasks
  • sample of how to use task in pipeline
  • make plantuml graphs optional using boolean plantuml_graphs default true
  • only process pipeline or tasks

0.1.4

  • show all tasks in finally block

0.1.3

  • enable configuration of graph direction plantuml_graph_direction either TB or LR
  • configuration for plantuml theme plantuml_theme string (https://plantuml.com/theme)
  • display references to configMaps

0.1.2

  • remove unused code
  • change how default and empty values are presented

0.1.1

  • fix issue with multicods

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mkdocs_pipeline_visualizer-0.1.7.tar.gz (6.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mkdocs_pipeline_visualizer-0.1.7-py3-none-any.whl (6.9 kB view details)

Uploaded Python 3

File details

Details for the file mkdocs_pipeline_visualizer-0.1.7.tar.gz.

File metadata

File hashes

Hashes for mkdocs_pipeline_visualizer-0.1.7.tar.gz
Algorithm Hash digest
SHA256 1dcabc47938d05ed2417ac50f686815581a50f8ad59ceaf4e0911170d7fb9f5c
MD5 70e8d6b1c80c68b0618f328ee56ea33b
BLAKE2b-256 2f138fcd7c31f97ab003fb3d1090b393e3777ea4c3c4386fc2b9b93516498fc5

See more details on using hashes here.

File details

Details for the file mkdocs_pipeline_visualizer-0.1.7-py3-none-any.whl.

File metadata

File hashes

Hashes for mkdocs_pipeline_visualizer-0.1.7-py3-none-any.whl
Algorithm Hash digest
SHA256 ad683d8e425af15f76d578e3e7de4b28b02258b66aaad9e250721fd45a7cc71e
MD5 55ff0409ede4f87fbcdb2bca01b1529f
BLAKE2b-256 47b6658734c3a1a8832e21de0783da24f2a210e91e8248546cdc0fa32788851d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page