DocOps Logo

DocOps.io Extension Server

Flexible Visualizations to supplement AsciiDoctor documents.

Beautiful Data Visualizations Made For AsciiDoctorJ

Create stunning charts, buttons, planners, timelines, roadmap, and other visualizations with just a few lines of code. Lightweight, flexible, and powerful.

Get Started

Add the DocOps Extension Server to a project to create beautiful visualizations in an AsciiDoctor document. Follow these steps to get started:

Maven

<dependency>
  <groupId>io.docops</groupId>
  <artifactId>docops-extension-server</artifactId>
  <version>2024.00</version>
</dependency>

Gradle

implementation 'io.docops:docops-extension-server:2024.00'

Using with AsciiDoctorJ

After adding the dependency to a project, the project can use the DocOps extensions to add the dependencies to the AsciiDoctor documents:

// In your Java code
import org.asciidoctor.Asciidoctor;
import org.asciidoctor.jruby.extension.spi.ExtensionRegistry;

// Initialize AsciiDoctorJ with DocOps extensions
Asciidoctor asciidoctor = Asciidoctor.Factory.create();
ExtensionRegistry.registerExtension(asciidoctor);

// Process your AsciiDoc content
String html = asciidoctor.convert(asciiDocContent, options);

Check out the examples below to see the various visualizations one can create with DocOps extensions.

Core Capabilities

Discover the powerful visualization tools available in DocOps

📝

Architecture Decision Records

Document and track architecture decisions with visual context

  • Decision Documentation
  • Status Tracking
  • Context & Rationale
  • Visual Representation
📊

Bar Charts

Responsive bar charts with custom styling and animations

100%
Responsive
SVG
Vector Graphics
  • Vertical & Horizontal
  • Custom Colors
📈

Line Charts

Multi-series line charts with smooth animations

  • Multi-series Support
  • Smooth Curves
  • Interactive Legends

Perfect For

Performance tracking, trends, time-series data

View Example →
🛡️

Badges & Shields

Customizable status badges and shields for documentation

  • Status Indicators
  • Version Shields
  • Custom Colors
  • Icon Support
🔘

Hexagonal Buttons

Interactive hexagonal buttons with connecting lines

  • Interactive Links
  • Custom Icons
  • Connecting Lines

Great For

Navigation menus, service showcases, interactive links

View Example →
🔄

Flow Connectors

Create flow diagrams and process visualizations

  • Process Flows
  • Workflow Diagrams
  • Relationship Mapping
  • Auto-generated Legends
📋

Placemat & Planner

Organize content with visual placemats and project planners

Layout Options 5+
  • Content Organization
  • Project Planning
  • Visual Layouts
🚀

Release Strategy

Visualize release plans, roadmaps, and deployment strategies

  • Release Planning
  • Roadmap Visualization
  • Deployment Strategies
  • Timeline Management

Use Cases

Sprint Planning Product Roadmaps Feature Rollout
View Example →
📊

Scorecard

Visual scorecards and metrics dashboards for tracking

KPI
Tracking
95%
Accuracy
  • Metrics Visualization
  • Status Reporting
⏱️

Timeline

Interactive timelines for project history and planning

  • Project Timelines
  • Historical Views
  • Milestone Tracking
  • Interactive Navigation
🔍

More Capabilities

Explore additional visualizations and components

Additional Components 10+
  • Callouts & Annotations
  • Metrics Cards
  • Color Gradients
  • Tree Charts

Usage Examples

Architecture Decision Records (ADR)

Document and visualize architecture decisions with context, rationale, and status. (See adr.html for more examples)

AsciiDoctor
[docops,adr,useDark=false,role=center]
----
title: Use Elasticsearch for Search Functionality
status: Accepted
date: 2024-05-15
context:
- Our application needs robust search capabilities across multiple data types
- We need to support full-text search with relevance ranking
- The search functionality must scale with growing data volumes
- We need to support faceted search and filtering
decision:
- We will use Elasticsearch as our search engine
- We will integrate it with our existing PostgreSQL database
- We will implement a synchronization mechanism to keep data in sync
consequences:
- Improved search performance and capabilities
- Additional infrastructure to maintain
- Need for expertise in Elasticsearch configuration and optimization
- Potential complexity in keeping data synchronized
participants:
Jane Smith (Architect), John Doe (Developer),Alice Johnson (Product Manager)
----
Output
Architecture Decision Record

Ready to Get Started?

Enhance your AsciiDoctor documents with powerful visualizations