Skip to content
This repository has been archived by the owner on Apr 2, 2024. It is now read-only.
/ docsify-demo Public archive

Plugin for Docsify that adds a preview of your component

License

Notifications You must be signed in to change notification settings

JacobWeinbren/docsify-demo

Repository files navigation

Docsify Demo 💻

Plugin for Docsify 📘 that adds a preview of your component

Latest version on NPM NPM bundle size GitHub top language MIT License

This plugin is focused on testing local code within Docsify, based on the @shoelace code-block implementation. Unlike other docsify plugins that exist, this plugin supports LitElement, more recently known as Lit.Dev. Similar to Storybook, this allows for testing common use cases, but in a simpler way.

Key Features

  • A live preview of your component/s, which can be resized to simulate smaller devices
  • Each demo comes with a toggleable code view, which reveals the underlying code
  • For all the code previews, this plugin integrates a copy button feature

This is my first plugin - please feel welcome to suggest features or raise bugs by creating an issue.

Installation

  1. Add the jsdelivr script
<script src="//cdn.jsdelivr.net/npm/docsify-demo@latest/dist/index.min.js"></script>
  1. Add the jsdelivr styles
<link
    rel="stylesheet"
    href="//cdn.jsdelivr.net/npm/docsify-demo@latest/dist/index.min.css"
/>
  1. Use the following markdown to add a component to your documentation
```html preview
<p>Hello, World.</p>
```
  1. This is what it should look like

Demo Screenshot, showing a toggle bar, reveal button and preview box

Example

To see the small example in this repo, run the following.

git clone https://github.com/JacobWeinbren/docsify-demo
cd docsify-demo
yarn install
yarn build
yarn serve

License

This plugin uses the MIT License, summarised here.

About

Plugin for Docsify that adds a preview of your component

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published