@gesslar/bedoc
v1.11.0
Published
Pluggable documentation engine for any language and format
Maintainers
Readme
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/bedocOr add it to your project as a dev dependency:
npm i -D @gesslar/bedocQuick 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.
