CSVW-RDF Convertor - VS Code Extension

A VS Code extension for converting between CSV on the Web (CSVW) and RDF formats. This extension provides an intuitive interface for bidirectional conversion between tabular data and RDF, following W3C CSVW specifications.

🚀 Features

• Bidirectional Conversion: Convert between CSVW and RDF formats seamlessly
• Visual Tree Interface: Manage multiple conversions through an organized tree view
• Auto-conversion: Automatic conversion on file saves for rapid development
• CSVW Specification Compliance: Full support for W3C CSVW metadata specifications
• Multiple Input Support: Handle multiple CSV files within a single conversion
• Template IRI Support: Toggle template IRI generation for RDF output
• Minimal Mode: Streamlined output options for cleaner results
• Workspace Integration: Seamless integration with VS Code workspace folders

📦 Installation

1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X)
3. Search for "CSVW-RDF Convertor"
4. Click Install
5. Reload VS Code if prompted

🎯 Getting Started

Opening the Extension

After installation, you'll see a new activity bar icon on the left side of VS Code. Click it to open the CSVW-RDF Convertor panel.

Creating Your First Conversion

Method 1: From Current File

1. Open a CSV or RDF file in VS Code
2. Click the Convert Current Window button in the editor toolbar or on the gear button at the top right
3. Enter a name for your conversion
4. The extension will automatically set up the conversion structure

Method 2: Manual Creation

1. Click the Add Conversion button (➕) in the extension panel
2. Enter a name for your conversion
3. Default rdf and csv inputs files are created

🏗️ Understanding the Conversion Structure

Each conversion creates a folder structure in your workspace:

csvw-rdf-conversions/
└── YourConversionName/
    ├── descriptor.json      # CSVW metadata descriptor
    ├── inputs/
    │   ├── csvInput.csv     # Primary CSV data
    │   ├── rdfInput.ttl     # RDF input for reverse conversion
    │   └── [additional].csv # Additional CSV files
    └── outputs/
        ├── output.ttl       # Generated RDF output
        └── error.txt        # Error details (if any)
Copy

🔄 Conversion Workflows

CSV to RDF Conversion

1. Open Conversion Fields: Click the folder icon next to your conversion
2. Edit Input Files: Modify your CSV data and descriptor metadata
3. Save Files: The extension automatically converts on saving the input files
4. View Results: RDF output appears in the outputs folder

RDF to CSVW Conversion

1. Open Conversion Fields: Access your conversion workspace
2. Edit RDF Input: Modify the rdfInput.ttl file
3. Configure Descriptor: Set up CSVW metadata for desired CSV structure
4. Save and Convert: Automatic conversion generates CSV files

Advanced Features

Multiple CSV Files

• Use Add Another Input to include multiple CSV files in one conversion
• Each file is processed according to the descriptor configuration

Template IRIs

• Toggle Template IRIs to control IRI generation patterns
• Useful for creating consistent URI schemes across datasets

Minimal Mode

• Enable Minimal Mode for cleaner, more compact RDF output
• Reduces verbosity while maintaining semantic accuracy

🎛️ Extension Commands

Tree View Commands

Conversion Commands

Utility Commands

Due to the nature of vscode extensions, sometimes not all windows are closed correctly. For example when you rename your csv table in the descriptor, new file with this name is created, but sometimes the old one doesn't close.

📖 Working with CSVW Descriptors

The descriptor.json file is the heart of CSVW conversion. Read about it here: https://www.w3.org/ns/csvw

🔧 Configuration Options

Template IRIs

When enabled, non-ASCII characters will not be escaped:

# Template IRI enabled
https://slovník.cz/čeština/přístroj

# Template IRI disabled
https://xn--slovnk-7va.cz/%C4%8De%C5%A1tina/p%C5%99%C3%ADstroj
Copy

Minimal Mode

Reduces RDF verbosity by:

• Omitting optional metadata
• Using more compact representations
• Focusing on core data relationships

🚨 Error Handling

Error Display

• Errors appear in error.txt files within the outputs folder
• Red underline on the first line indicates validation issues in your files

🔄 Auto-conversion Behavior

The extension automatically converts when you save:

📁 Workspace Integration

File Organization

• All conversions stored in csvw-rdf-conversions/ folder
• Each conversion has its own subdirectory
• Files automatically created and managed

Multi-root Workspaces

• Extension works with the first workspace folder
• Ensure your main project is the first folder in multi-root setups

🆘 Support and Resources

Documentation

Full API documentation is available online: https://s0ft1.github.io/CSVW-RDF-convertor/

W3C CSVW Specification

• CSVW Primer
• Metadata Vocabulary
• CSV2RDF Mapping

Happy converting! 🎉