Gemini-Glow

A syntax highlighter extension for Visual Studio Code that enhances Gemtext (.gmi, .gemini) files used in the Gemini protocol.

Installation

You can install this extension from the Visual Studio Code Marketplace.

From VS Code

1. Open VS Code
2. Press Ctrl+P to open the Quick Open dialog
3. Type ext install imigueldiaz.gemini-glow to find the extension
4. Click the Install button

Manual Installation

If you prefer to install manually:

1. Download the latest .vsix file from the VS Code Marketplace
2. Open VS Code
3. Go to Extensions (Ctrl+Shift+X)
4. Click "..." at the top of the Extensions panel
5. Select "Install from VSIX..." and choose the downloaded file

Features

• Syntax highlighting for Gemtext files
• Support for all Gemtext elements:
  • Headings (3 levels)
  • Unordered lists
  • Links with optional labels
  • Blockquotes
  • Preformatted text blocks

Gemtext Format

Gemtext is the native markup format used in the Gemini protocol. It's designed to be lightweight and easy to read, with a limited set of formatting options:

Headers

# Level 1 Header
## Level 2 Header
### Level 3 Header

Lists

* List item
* Another list item
* Yet another list item

Links

=> gemini://example.com/ Link to example.com
=> gemini://example.com/file.gmi Another link

Blockquotes

> This is a blockquote

Preformatted Text (Code Blocks)

```
This is preformatted text
Lines will be displayed exactly as typed
```

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Building from Source

If you want to build the extension yourself:

1. Clone the repository:

   git clone https://codeberg.org/imigueldiaz/gemini-glow.git
   cd gemini-glow
   

2. Install the VSCE tool globally (if you haven't already):

   npm install -g @vscode/vsce
   

3. Package the extension:

   vsce package
   

This will generate a .vsix file that you can install in VS Code using the "Install from VSIX..." option in the Extensions view.

Verifying Releases

All releases on Codeberg are signed with my GPG key, which can be found at: https://keys.openpgp.org/pks/lookup?op=get&options=mr&search=0x4C8BBC0202929D02358520A487ECA80B31221D3A

Each release includes a corresponding .asc signature file that can be used to verify the integrity of the downloaded files.

To verify a release:

1. Import my GPG key (if you haven't already):

   curl -sSL https://keys.openpgp.org/pks/lookup?op=get&options=mr&search=0x4C8BBC0202929D02358520A487ECA80B31221D3A | gpg --import -
   

2. Download both the VSIX file and its corresponding .asc signature file.

3. Verify the signature:

   gpg --verify gemini-glow-[version].vsix.asc gemini-glow-[version].vsix
   

License

MIT