Skip to content
/ BeDoc Public

A bespoke documentation engine for parsing and printing text-based information.

License

Notifications You must be signed in to change notification settings

gesslar/BeDoc

Repository files navigation

CodeQL Advanced Dependabot Updates Auto PR and Merge - dev 🤗 CodeFactor

BeDoc

BeDoc is a powerful, pluggable documentation generator designed to handle any programming language and output format. With its extensible framework, you can easily create custom parsers and printers to generate structured documentation for your projects.


Key Features

  • Pluggable Design: BeDoc works seamlessly with custom parsers and printers to fit your unique needs. BeDoc also supports async operations, allowing for efficient handling of large projects.
  • Customizable Input: Accommodate any text input, whether it’s a well-known language like LPC or Lua, or an underserved format needing attention.
  • Async Hooks: Take advantage of BeDoc's powerful ability to use async hooks to modify content in-flight, providing dynamic customization during the documentation generation process.
  • Versatile Output: Generate documentation in formats like Markdown, Wikitext, and more.
  • Configurable: Supports JSON-based configuration for seamless customization.
  • Integrated Workflow: Use the CLI for smooth integration into your development environment.

Installation

Install BeDoc globally using NPM:

npm i -g @gesslar/bedoc

Or add it to your project as a dev dependency:

npm i -D @gesslar/bedoc

Quick Start

Here’s how to use BeDoc programmatically:

import BeDoc from "@gesslar/bedoc"

// Initialize BeDoc with your configuration
const docGenerator = new BeDoc({
  input: './src',
  output: './docs',
  format: 'markdown',
});

// Generate documentation
(async () => {
  try {
    await docGenerator.generate();
    console.log('Documentation generated successfully!');
  } catch (error) {
    console.error('Error generating documentation:', error);
  }
})();

For detailed usage instructions and examples, visit the website: 👉 BeDoc Documentation


Contributing

Contributions are welcome! Feel free to open an issue or submit a pull request.


License

This project is licensed under the Unlicense.


Get started with BeDoc today and simplify your documentation workflow!

Do not taunt Happy Fun Ball.

About

A bespoke documentation engine for parsing and printing text-based information.

Resources

License

Stars

Watchers

Forks

Contributors 3

  •  
  •  
  •