Did you ever wondered to make a help system for your "Graphical User Interface" ? the ones
that when the user clicks on the "?" icon on any page of your GUI a nice help or tutorial will magically
be presented to them, if yes, then you can stop wondering :) HelpDown is here for you :)

All resources are available at alicommit-malp/HelpDown

Usage

Add it to your project from Nuget

dotnet add package HelpDown

In Startup.cs

public void ConfigureServices(IServiceCollection services){
    //...
    services.AddHelpDown();
    //...
}

public void Configure(IApplicationBuilder app, IHostingEnvironment env){
    //...
    app.UseHelpDown();
    //...
}

For instance, if you wish to make a help page for Home/Index

under the wwwroot folder create a new directory called "helpDown"

The folder structure will be look like this

+ Project Root
    wwwroot
        helpDown 
            Home
                Index
                    en.md
                    de.md
                    fr.md
                    cat.jpg

Write your help files in MarkDown > To Write your MarkDown help file, depending on your ide > - Visual Studio > - Visual Studio Code > - Rider > - Github

for example the content of the "en.md" will be something like this

# Title 
This is help document for **Index** action of **Home page**  
show the cat image which is located just beside the MD files 

![Local Image](cat.jpg) 

or show the cat image from an external link 

![External Image](https://github.com/alicommit-malp/HelpDown/raw/master/samples/wwwroot/helpDown/Home/Index/cat.jpg)

In your Index.cshtml

@using HelpDown
<div style="text-align: left">

    @{
        if (HelpDown.Exists(ViewContext, CultureInfo.CurrentCulture))
        {
            @Html.Raw(HelpDown.GenerateHtml(ViewContext, CultureInfo.CurrentCulture))
        }
    }
</div>

you can add a help button and set its visibility according to

if(HelpDown.Exists(ViewContext, CultureInfo.CurrentCulture)){
    //Help in the users current culture exists 
    //OR
    //If the the help in current culture does not exits, Help file in 
    //default culture exists
}
else{
    //Help in current culture or default current culture does not exists
}

Settings

To change the name of the "helpDown" directory

app.UseHelpDown(folderName:"customFolderName");

To change the default language (By default English is the default)

app.UseHelpDown(defaultLanguage:"de");

There you have it, a simple to use and manage Markdown-based help system for any ASP.Net Core
application.

All resources are available at alicommit-malp/HelpDown

Happy coding :)

MarkDown based GUI Help system

Usage

Settings