Metadata-Version: 2.4
Name: docworker
Version: 0.0.2
Summary: A tool pack for converting and serving documentation(code, markdown and text)
Author-email: Ayeni Michael <ayenimichael92@gmail.com>
Project-URL: Homepage, https://github.com/Granzular/docworker
Project-URL: Issues, https://github.com/Granzular/docworker/issues
Keywords: markdown,documentation
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: pygments
Requires-Dist: flask
Requires-Dist: markdown
Dynamic: license-file

# DocWorker

docworker is a hobby project that grew out of a collection of personal scripts written to solve documentation-related problems. Over time, those scripts evolved into reusable utilities for working with documentation.

The project currently includes tools for serving Markdown content as HTML and generating documentation PDFs from source code. Additional functionality may be added as new needs arise.
>The Emperor protects...

## Features

### Markdown Server: mkserver

A lightweight server for rendering Markdown files as HTML.

**Capabilities:**

- Serve Markdown documents through a web interface
- Render Markdown as HTML
- Preview documentation locally
- Simple setup and usage

### Documentation PDF Generator: printerx

Generate documentation PDFs directly from source code projects.

**Capabilities:**

- Extract documentation from source code
- Generate PDF documentation
- Create portable documentation artifacts
- Support automated documentation workflows

## Installation

```bash
pip install docworker
```

Install the required dependencies for the utilities you intend to use.

## Usage

### Run the Markdown Server

```bash
docworker wkserver --dirs <source-directory>
```

### Generate Documentation PDF

```bash
docworker printerx --dirs <source-directory>
```

## Project Structure

```text
src/
|__docworker/
    ├── mkserver/
    ├── printerx/
    └── ...
```

## Future Plans

DocWorker is developed incrementally based on personal needs and experimentation. Future additions may include:

- Additional documentation utilities
- More export formats
- Improved customization options
- Better source code analysis
- Automation and workflow integrations

## Contributing

Contributions, bug reports, and suggestions are welcome. Feel free to open an issue or submit a pull request.

## Status

This is a personal hobby project under active development. Features, interfaces, and behavior may change over time.

## License

See the LICENSE file for details.
