Home

Awesome

<h1 align="center">vuese</h1> <p align="center"> <img src="https://github.com/HcySunYang/vuese/blob/master/imgs/vuese.png" /> </p> <p align="center">One-stop solution for vue component documentation</p> <p align="center">This project is supported by our <a href="./BACKERS.md">Backers</a></p> <p align="center"> <a href="http://commitizen.github.io/cz-cli/"><img src="https://img.shields.io/badge/commitizen-friendly-brightgreen.svg" alt="Commitizen friendly"/></a> <a href="https://github.com/vuese/vuese"><img src="https://img.shields.io/github/license/vuese/vuese.svg" alt="License"/></a> <a href="https://circleci.com/gh/HcySunYang/vuese/tree/master"><img src="https://img.shields.io/circleci/project/github/vuese/vuese.svg" alt="build status"/></a> <a href="https://www.patreon.com/HcySunYang"><img src="https://badgen.net/badge/support%20me/donate/ff00ff" alt="Support me"/></a> <a href="https://github.com/prettier/prettier"><img src="https://img.shields.io/badge/code_style-prettier-ff69b4.svg" alt="Code style"/></a> </p>

Document

For detailed documentation: vuese.org

Overview

Vuese Automatically generate documentation for your vue component, and provides a variety of solutions for generating component documentation to meet your different needs.

@vuese/cli

@vuese/cli is a command line tool that is very simple to use. If you want to quickly build a documentation site for your vue component or just want to generate markdown document for your vue component, then this tool might be a good choice. Please go to the details: @vuese/cli

@vuese/parser

The @vuese/parser module is the parser for the vue component, @vuese/cli internally parsing the vue component via the @vuese/parser module and extract the information we want. You can do any more advanced things with the interface provided by the @vuese/parser module. For the API documentation, please go to @vuese/parser

Online experience

Visit the following ๐Ÿ‘‡ link to intuitively feel @vuese/parser:

An online experience playground for vuese

@vuese/markdown-render

@vuese/markdown-render receives the result of the Vue file parsed by @vuese/parser as a parameter, generate a markdown string. @vuese/markdown-render is also used for @vuese/cli's document generation, in other words, you can use @vuese/markdown-render and @vuese/parser alone to write your own CLI tool to do something interesting.

@vuese/loader

@vuese/cli is a tool for quickly creating document prototypes that don't have a more flexible documentation solution. So this is why @vuese/loader and @vuese/webpack-plugin are needed.

Our goal is to focus only on the parts that can be automated, and does not limit how your document project is organized and what document framework is used. Of course, we can also provide fast solutions.

[WIP] [TODO]

@vuese/webpack-plugin

[WIP] [TODO]

Roadmap

Planning for vuese2.x: Read our roadmap

Contributing

  1. Fork it!
  2. Create your feature branch: git checkout -b my-new-feature
  3. Commit your changes: yarn commit
  4. Push to the branch: git push origin my-new-feature
  5. Submit a pull request :D

Contributors

Thanks goes to these wonderful people:

<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --> <!-- prettier-ignore -->
<img src="https://avatars2.githubusercontent.com/u/14146560?v=4" width="100px;"/><br /><sub><b>HcySunYang</b></sub><br />๐Ÿ’ป โš ๏ธ ๐Ÿ“– ๐Ÿ’ก<img src="https://avatars3.githubusercontent.com/u/15170275?v=4" width="100px;"/><br /><sub><b>wulunyi</b></sub><br />๐Ÿ’ป<img src="https://avatars2.githubusercontent.com/u/5432828?v=4" width="100px;"/><br /><sub><b>Estelle00</b></sub><br />๐Ÿ’ป
<!-- ALL-CONTRIBUTORS-LIST:END -->

Author

Vuese ยฉ HcySunYang, Released under the MIT License.<br> Authored and maintained by HcySunYang.

homepage ยท GitHub @HcySunYang ยท Twitter @HcySunYang