LiPD VSCode Extension
This extension provides support for reading and writing LiPD (Linked Paleo Data) files in Visual Studio Code.
Features
- Open and view LiPD (.lpd) files directly in VS Code
- Interactive editor with form-based editing of all LiPD properties
- Map visualization for location data using Mapbox
- Create new empty LiPD files
- Edit datasets with built-in undo/redo functionality
- Export CSV data from data tables
- NEW! LiPD Explorer view to browse remote datasets from a GraphDB SPARQL endpoint
Screenshots
Dataset Overview
Interactive Map for Location Data
Data Table Editing
Publications
GraphDB Remote Dataset Viewer
Requirements
- Visual Studio Code 1.85.0 or higher
- Internet connection for accessing remote datasets
Installation
You can install the extension directly from the VS Code Marketplace:
- Open VS Code
- Go to Extensions (Ctrl+Shift+X)
- Search for "LiPD File Support"
- Click Install
Usage
Opening LiPD Files:
- Double-click on any
.lpd file in your workspace to open it in the custom editor
- You can also right-click on a
.lpd file and select "Open With..." > "LiPD Editor"
- Browse and open remote datasets through the LiPD Explorer view in the activity bar
Using the LiPD GraphDB Explorer:
Click on the LiPD logo in the activity bar to open the LiPD GraphDB Explorer
Configure the GraphDB endpoint by clicking on the settings icon or through the status bar
Browse available datasets from the configured GraphDB endpoint
Use the search functionality to find specific datasets
Click on any dataset to open it directly from the remote database
Use the refresh button to update the dataset list
Save the LiPD file locally by clicking on "Save" or "Save As" icon
Sync a remote (or Local) dataset with GraphDB by clicking on the "Sync" icon
Creating New Files:
- Create a new file with a
.lpd extension
- An empty dataset will be created automatically
Editing:
- Navigate through the dataset using the tree view
- Edit fields directly in the form
- Map locations can be set by dragging the marker or entering coordinates
- All changes support Undo (Ctrl+Z) and Redo (Ctrl+Y)
Saving:
- Save changes with Ctrl+S (Cmd+S on macOS)
- Use File > Save As... to save to a new location
LiPD GraphDB Explorer
The LiPD GraphDB Explorer allows you to connect to a remote GraphDB SPARQL endpoint and browse, search, and open datasets stored in the database.
Features
- Connect to any compatible GraphDB SPARQL endpoint
- Browse all available datasets in a tree view
- Search for datasets by name, location, or time period
- Open remote datasets directly in the VS Code editor
- Save remote datasets to local files
Setting Up
Configure your GraphDB URL in the settings:
- Click on the settings icon in the LiPD Explorer view
- Or click on the GraphDB status bar item
- Enter the URL of your GraphDB SPARQL endpoint
Once connected, the explorer will display available datasets from the database
- The connection status is shown in the status bar
- Click the refresh button to update the dataset list
Searching Datasets
The search box at the top of the LiPD Explorer view allows you to filter datasets:
- Search by dataset name, location, or time period
- Results are filtered as you type
- Click any result to open it in the editor
Working with Remote Datasets
When you open a remote dataset, it is loaded into a special editor:
- You can view and edit the dataset just like local files
- Remote datasets are indicated with "(Remote)" in the title bar
- Use Save As to download a remote dataset to your local file system
Extension Settings
This extension contributes the following settings:
lipd.graphDbUrl: URL of the GraphDB SPARQL endpoint for remote LiPD datasets
- LiPD-JS : This is a javascript library to read/write LiPD files. This extension uses this library.
- PyLiPD : This is a python library to read/write LiPD files
Known Issues
- Some complex LiPD structures may not be fully supported yet
- Currently, the extension works best with relatively small to medium-sized LiPD files
Contributing
Contributions are welcome! Please feel free to submit a Pull Request to the GitHub repository.
License
This extension is licensed under the MIT License - see the LICENSE file for details.
| |
