README

A Kirby plugin that provides a searchable interface for special characters, built on top of Typo & Paste.

Features

Searchable database of special characters
Multi-language support
SQLite-based search engine
Seamless integration with Typo & Paste (v2.4.0+)
Standalone functionality for Kirby 5

Installation

Installation via Composer

composer require philippoehrlein/typo-search-and-paste

Manual Installation

Download and extract the plugin
Copy the typo-search-and-paste folder into /site/plugins/

Configuration

With Typo & Paste (v2.4.0+)

If you have Typo & Paste v2.4.0 or higher installed, no additional configuration is needed. The search functionality will be automatically integrated.

Panel Toolbar Button

In Kirby 5, you can add the Typo Search & Paste button to your panel toolbar in two ways:

1. In your blueprint:

buttons:
  - typo-search-and-paste
  - preview
  - settings
  - languages
  - status

2. Globally in your config:

// site/config/config.php
return [
  'panel' => [
    'viewButtons' => [
      // Page view
      'page' => ['typo-search-and-paste', 'preview', 'settings', 'languages', 'status'],
      // Site view
      'site' => ['typo-search-and-paste', 'preview', 'languages']
    ]
  ]
];

Contributing to the Character Database

The plugin uses SQLite databases for efficient character searching. You can contribute to the character database by following these steps:

Navigate to the data/src directory
Create or modify JSON files for your language (e.g., en.json, de.json)
Each JSON file should follow this structure:

{
  "characters": [
    {
      "value": "©",
      "name": "Copyright Sign",
      "aliases": ["copyright", "c"]
    }
  ]
}

Run the build script to update the database:

php data/src/build.php [options]

Build Script Options

--lang: Specify languages to build (comma-separated)
```
php data/src/build.php --lang=en,de
```

--include: Include specific categories

php data/src/build.php --include=math,symbols

--exclude: Exclude specific categories

php data/src/build.php --exclude=math,symbols

Note: --include and --exclude cannot be used simultaneously. If both are provided, --exclude will be ignored.

License

MIT License

philippoehrlein / typo-search-and-paste

Maintainers

Details