# qoder-wiki-export

**Repository Path**: zen_y/qoder-wiki-export

## Basic Information

- **Project Name**: qoder-wiki-export
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-09
- **Last Updated**: 2025-09-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Qoder Wiki Export

A VSCode extension that provides export functionality for documentation generated by the Qoder VSCode extension.

## Features

- Export Qoder-generated repository documentation to Markdown files
- Select individual documents or export entire wiki catalogs
- Preserve hierarchical folder structure from wiki catalogs
- Progress tracking for large documentation sets
- Graceful error handling and user feedback

## Requirements

- VSCode 1.74.0 or higher
- Qoder extension (`aicoding.aicoding-agent`) must be installed and active
- User must be logged in to Qoder

## Installation

1. Clone this repository
2. Install the official [VSCode packing tool](https://code.visualstudio.com/api/working-with-extensions/publishing-extension): `npm install -g @vscode/vsce`
3. Run `npm install` and then `npm run package`
4. In Qoder `Ctrl+Shift+P` or `Cmd+Shift+P` and run `Extensions: Install from VSIX` to install the extension. Choose the .vsix file generated in this repo folder.

## Usage

1. Ensure you have the Qoder extension installed and are logged in
2. Generate wiki documentation using Qoder
3. Open the Command Palette (`Ctrl+Shift+P` or `Cmd+Shift+P`)
4. Run the following command:  `Qoder Wiki Export: Export Qoder Wiki Documentation`
5. Select the documents you want to export
6. Choose the way you want the hierarchy of the documents to be represented: Flat Structure or Tree Structure
7. Choose a destination folder for the exported files

## Export Process

1. The extension will check if Qoder is available and you are logged in
2. Select documents to export from the available wiki catalogs
3. Choose a destination folder for the exported files
4. Monitor progress as documents are exported
5. Review the export summary upon completion

## Output Structure

Exported files maintain the hierarchical structure from your wiki catalogs:

```
exported-wiki/
├── index.md                    # Navigation index
├── Architecture/
│   ├── system-overview.md
│   └── component-design.md
├── API/
│   ├── endpoints.md
│   └── authentication.md
└── ...
```

## Error Handling

The extension provides graceful error handling for common scenarios:

- Qoder extension not available
- User not logged in to Qoder
- Network connectivity issues
- File system permissions
- Individual document export failures

## Development

### Building

```bash
npm install
npm run compile
```

### Linting

```bash
npm run lint
```

### Testing

```bash
npm test
```

## License

This extension is provided as-is for use with the Qoder VSCode extension.