Plywood Gallery For VSCode

A Visual Studio code extension with rich support for integrating the use of Plywood Gallery: allowing the insertion of code snippets into the editor through images galleries.

Index

1. Key Features
2. Introduction
3. Importing Gallaries
4. Release Notes

Key Features

• Visualizing Code Snippets
• Text/dropdown support for Code Snippets
• Gain access to many community and official code snippet repositories

Introduction

A Gallery is a list of code and image mappings using the template specifed by the core gallery Plywood Gallery. Individual developers can make a gallery of their own by following the template and publish them to Github where users can download and import them.

Once a gallery is imported, a webview will be installed revealing a set of images that the gallery provides. After placing the cursor down to the desired location, you can press on the images to insert the code snippet tied to it.

After the extension is fully installed, you will be introduced to this treeview on the activity bar.



Here you can control and modify imported galleries.

Certain things you can do inside the treeview

• Import Local and Remote galleries
• Remove Local and Remote galleries
• Check for Remote gallery updates
• Opening a gallery (clicking on the gallery item)
• Unpacking code items of a gallery

Importing Galleries

You can load galleries from two distinct locations:

• Remote GitHub Repositories
• Local Repositories/Directories

Remote Galleries

Recommended

By default the extension provides a curated list of recommended Galleries.



You click these Galleries to download them instantenously.

For Gallery Developers: if you would like to feature your own Gallery for recommendations, make sure that your gallery meets the given security criteria and create an issue for it!

Repositories

In order to load a remote github gallery, you can use the command plywood-gallery.ImportRemote or via the button for cloud-download in the treeview navigation bar.

This will prompt an input box where you'll have to provide the URL of the repository to be imported. Keep note though that the extension by default looks for a gallery under the main branch of any specified repositories, in cases where this may not be intended, you can specify an optional branch parameter before the URL with a semi-colon.

E.g.

master;https://github.com/kolibril13/plywood-gallery-minimal-example

Local Galleries

In order to load a local gallery, you can use the command:

• plywood-gallery.ImportLocal
• via the button for desktop-download

This will launch a file explorer for any .yaml files. Select the gallery_config.yaml file for the local gallery that you want to import (it doesn't have to be named gallery_config) and simply press open.

Importing a gallery inside a batch simply changes the protocol from picking a central gallery_config.yaml file to picking the specific config file for the gallery.

Release Notes

Pre-release!

0.0.1-0.0.2

Initial release of the Plywood Gallery Extension

Credits

• kolibril13 for building the plywood gallery core library and the minimal example.
• Picture icons created by Pixel perfect - Flaticon
• Photo icons created by Andrean Prabowo - Flaticon
• Wood icons created by Freepik - Flaticon