HrefWizard 🪄✨

HrefWizard is a simple .NET library that automatically adds HTML anchor tags (<a>) to specific keywords within a given text. Define your keywords and URLs, and let the wizard do the rest!

Features ✨

• Automatic Linking: Finds defined keywords in text and wraps them with <a> tags.
• Case-Insensitive: Matches keywords regardless of their casing by default.
• Whole Word Matching: Prevents partial matches within words (e.g., won't link "cat" inside "caterpillar").
• Preserves Original Case: Keeps the original capitalization of the matched keyword in the link text.
• Configurable Links: Options to add target="_blank" and rel="nofollow" attributes.
• Simple API: Easy to add link definitions and process text.
• Framework Compatibility: Targets .NET Standard 2.0 for broad compatibility (.NET Framework, .NET Core, .NET 5+).

Installation 📦

Install the package via NuGet Package Manager:

Install-Package HrefWizard

Or via the .NET CLI:

dotnet add package HrefWizard

Basic Usage 🚀

using System; using HrefWizard; // Add this using statement public class Example { public static void Main(string[] args) { // 1. Create a wizard instance var wizard = new HrefWizard(); // 2. Add link definitions wizard.AddLink("google", "[https://www.google.com](https://www.google.com)"); wizard.AddLink("nuget", "[https://www.nuget.org](https://www.nuget.org)", targetBlank: true); wizard.AddLink("Microsoft", "[https://www.microsoft.com](https://www.microsoft.com)", relNoFollow: true); wizard.AddLink("OpenAI", "[https://openai.com](https://openai.com)", targetBlank: true, relNoFollow: true); // 3. Process your text string inputText = "Search on Google for the latest Microsoft products or find packages on NuGet. Check out OpenAI too."; string linkedText = wizard.ProcessText(inputText); // 4. Use the result Console.WriteLine(linkedText); // Output: // Search on <a href="[https://www.google.com](https://www.google.com)">Google</a> for the latest <a href="[https://www.microsoft.com](https://www.microsoft.com)" rel="nofollow">Microsoft</a> products or find packages on <a href="[https://www.nuget.org](https://www.nuget.org)" target="_blank">NuGet</a>. Check out <a href="[https://openai.com](https://openai.com)" target="_blank" rel="nofollow">OpenAI</a> too. } }

Configuration Options⚙️

When adding links using AddLink, you can specify:

• targetBlank (bool): If true, adds target="_blank" to the link, making it open in a new tab. Defaults to false.
• relNoFollow (bool): If true, adds rel="nofollow" to the link. Defaults to false.

(Note: Case sensitivity and whole word matching are currently handled by default logic but could become configurable options in future versions).

Future Improvements (Roadmap) 🗺️

• HTML Awareness: Implement smarter parsing to avoid adding links inside existing HTML tags (e.g., within <a>, <img>, <pre>, <code> tags).
• More Configuration: Add options for case sensitivity, whole word matching toggles, and custom CSS classes for links.
• Performance: Optimize the replacement logic for very large texts or large numbers of keywords.

Contributing🤝

Contributions, issues, and feature requests are welcome! Feel free to check issues page.

License 📄

This project is licensed under the Apache-2.0 license.