Wookashi.ExtraText 2.1.0

Wookashi.ExtraText

A lightweight, cross-platform .NET library for removing diacritical marks (accents) from text in a language-specific manner. Perfect for search functionality, sorting, URL slugs, or data standardization.

Features

• Supports 25 languages with 300+ character mappings
• Simple extension methods on string
• Cross-platform (.NET Framework 4.6.1+, .NET Core 2.0+, .NET 5+)
• High performance using StringBuilder
• No external dependencies

Installation

Package Manager

Install-Package Wookashi.ExtraText

.NET CLI

dotnet add package Wookashi.ExtraText

PackageReference

<PackageReference Include="Wookashi.ExtraText" Version="2.0.0" />

Usage

Add the namespace:

using Wookashi.ExtraText;

Replace All Diacritical Marks

Replaces diacritical marks from all supported languages:

"żółć".ReplaceDiacriticalMarks();     // Returns "zolc"
"café".ReplaceDiacriticalMarks();     // Returns "cafe"
"Müller".ReplaceDiacriticalMarks();   // Returns "Mueller"

Replace Language-Specific Marks

Replaces only marks from the specified language:

using Wookashi.ExtraText.Normalize.Enums;

"über".ReplaceDiacriticalMarks(Language.German);    // Returns "ueber"
"żółć".ReplaceDiacriticalMarks(Language.Polish);    // Returns "zolc"
"señor".ReplaceDiacriticalMarks(Language.Spanish);  // Returns "senor"

Complete Example

using System;
using Wookashi.ExtraText;
using Wookashi.ExtraText.Normalize.Enums;

class Program
{
    static void Main()
    {
        var polishText = "Zażółć gęślą jaźń";
        var germanText = "Größe über alles";

        // Replace all diacritics
        Console.WriteLine(polishText.ReplaceDiacriticalMarks());
        // Output: "Zazolc gesla jazn"

        // Replace only German-specific diacritics
        Console.WriteLine(germanText.ReplaceDiacriticalMarks(Language.German));
        // Output: "Groesse ueber alles"
    }
}

Supported Languages

All languages include both lowercase and uppercase variants.

Use Cases

• Search engines - Normalize user input and indexed content for accent-insensitive search
• URL slugs - Generate clean URLs from titles containing special characters
• Data deduplication - Compare records that may have inconsistent diacritic usage
• File naming - Create safe filenames from user-provided text
• Sorting - Normalize text for consistent alphabetical ordering

Contributing

Contributions are welcome! If you have suggestions, bug reports, or want to add support for more languages:

1. Fork the repository
2. Create a feature branch
3. Submit a pull request

Or contact me at l.hryciuk@outlook.com

Authors

• Lukas Hryciuk - Wookashi

License

This project is licensed under the MIT License - see the LICENSE file for details.