Step 1. Load/Create a project and add a page.

Step 2. Create a new folder to store the index files;

1. Right click on wwwroot under the project and choose Add -> New Folder
2. Create a new folder called 'Keyoti_Search_Index'

Step 3. Open the Index Manager Tool from the Start Menu and enter the path to your index directory.

The Index Manager Tool can be found under the Start Menu;

Step 4. Select 'Import New Source', enter the start URL & click 'Import'.

If an error reports the page cannot be read, please check the URL or consult the user guide for help.

Once the import is complete close the Import window, select 'Optimize' and click 'Start Optimize'.

Step 5. Copy the SearchUnit scripts folder to your project;

1. Open the SearchUnit install folder (via Start Menu or File Explorer).
2. Copy the 'Keyoti_SearchEngine_Web_Common' folder.
3. Paste to your application's Solution Explorer, in wwwroot.




Next

Step 6. Add the SearchUnit JS and CSS tags to the head of your page.

To automatically add the tags, drag SearchUnit.js and SearchUnit.css from the Solution Explorer on to the page source. Alternatively copy and paste the tags as below to the head of your page.

Add this Javascript to your page

Step 7. Add the SearchUnit divs to your page.

sew_searchBoxControl is the search text box and button.

sew_searchResultControl is the search result control.

Step 8. Register the SearchUnit WebAPI controller.

.NET 6+

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddControllers().AddApplicationPart(System.Reflection.Assembly.Load(new System.Reflection.AssemblyName("Keyoti5.SearchEngine.Web"))).AddControllersAsServices();

// Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbuckle
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

var app = builder.Build();
...
                                              
app.MapControllers();
                                              
app.Run();

.NET 5

Add the bold code to your Startup.ConfigureServices

public void ConfigureServices(IServiceCollection services)
{
    services.AddRazorPages();
    services.AddControllers().AddApplicationPart(System.Reflection.Assembly.Load(new System.Reflection.AssemblyName("Keyoti5.SearchEngine.Web")));
}

Ensure the controllers are mapped (otherwise AJAX calls from the client will fail, with a 404), eg. add the bold line in Configure

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
    }
    else
    {
        app.UseExceptionHandler("/Error");
        app.UseHsts();
    }

    app.UseHttpsRedirection();
    app.UseStaticFiles();

    app.UseRouting();

    app.UseAuthorization();

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapRazorPages();
        endpoints.MapControllers();
    });
}

Step 9. Add needed references and nuget packages

• Keyoti5.SearchEngine.Core.DLL
• Keyoti5.SearchEngine.License.DLL
• Keyoti5.SearchEngine.Suggestions.dll
• Keyoti5.SearchEngine.Web.DLL
• Keyoti5.Text.LemmaGenerator.dll
• Keyoti5.Text.MSOffice.dll
• Keyoti.SearchEngine.SuggestionsDictionary.dll

• System.Runtime.Caching
• Newtonsoft.Json

Step 10. Run the web application (hit F5) and try a search!

Here a search was done for 'chicken' in the SearchUnit demo recipes project.

Go further!

Now you're ready to explore more features in SearchUnit, please take a look at the 'Features' page in the help for more information on all that SearchUnit can do.