repository·main·Indexed 41 days ago
https://github.com/mynihongo/mudblazor.markdownA specialized Markdown rendering component for the MudBlazor ecosystem, version 1.0.0. It provides the <MudMarkdown /> component to render Markdown content using standard MudBlazor styling and providers. Features include support for headings, text styling, lists, tables, and fenced code blocks, with options to configure a custom clipboard service via AddMudMarkdownClipboardService<T>.
To run the provided sample projects, you must set up the Node.js environment to handle dependencies and builds. Follow these steps:
src\MudBlazor.Markdown directory in your terminal.npm ci.npm run build.npm ci
npm run buildFollow these steps to install the modlist using Wabbajack:
Wabbajack.exe and place it in a dedicated working folder (e.g., C:/Wabbajack).Browse Modlists, and find Enderal - My Way.Go/Begin button and wait for completion.Troubleshooting Wabbajack Errors:
Could not download x: The mod may have updated and old files are unavailable. Wait for a modlist update.x is not a whitelisted download: A new update is likely available; check for modlist updates.Wabbajack could not find my game folder: Ensure you are using a legitimate Steam version of the game.Follow these steps to integrate MudBlazor.Markdown into your project:
Add the following to your _Imports.razor file:
@using MudBlazorAdd these components to App.razor or MainLayout.razor:
<MudThemeProvider />
<MudPopoverProvider />
<MudDialogProvider />
<MudSnackbarProvider />In the <head> node of Pages/_Host.cshtml (Server) or wwwroot/index.html (WebAssembly), add these stylesheets:
<link href="https://fonts.googleapis.com/css?family=Roboto:300,400,500,700&display=swap" rel="stylesheet" />
<link href="_content/MudBlazor/MudBlazor.min.css" rel="stylesheet" />
<link href="_content/MudBlazor.Markdown/MudBlazor.Markdown.min.css" rel="stylesheet" />At the bottom of the <body> node, add these scripts:
<script src="_content/MudBlazor/MudBlazor.min.js"></script>
<script src="_content/MudBlazor.Markdown/MudBlazor.Markdown.min.js"></script>Register the required services in your DI container.
Blazor Server (Startup.cs):
public void ConfigureServices(IServiceCollection services)
{
services.AddMudServices();
services.AddMudMarkdownServices();
// Optionally add a custom clipboard service if the default fails
services.AddMudMarkdownClipboardService<MauiClipboardService>();
}Blazor WebAssembly (Program.cs):
var builder = WebAssemblyHostBuilder.CreateDefault(args);
builder.Services.AddMudServices();
builder.Services.AddMudMarkdownServices();
// Optionally add a custom clipboard service if the default fails
builder.Services.AddMudMarkdownClipboardService<MauiClipboardService>();Before installing the Enderal - My Way modlist, ensure the following prerequisites are met:
Skyrim Special Edition folder in Documents/My Games/.High.Aspect Ratio and Resolution to your monitor's native values.Antialiasing to Off.Windowed Mode and Borderless.To use the MudBlazor.Markdown component, install the NuGet package using the .NET CLI.
dotnet add package MudBlazor.MarkdownTo render markdown, use the <MudMarkdown /> component and provide the markdown string via the Value parameter.
Important for Static SSR:
Because MudBlazor relies on code executed in OnAfterRender or OnAfterRenderAsync, it may not work correctly with static SSR. To ensure interactivity, specify @rendermode="InteractiveServer" (or the appropriate interactive mode for your setup) on the component.
Example:
<MudMarkdown @rendermode="InteractiveServer" Value="some markdown here" /><MudText Typo="Typo.h3">My markdown</MudText>
<MudMarkdown Value="@Value" />
@code
{
private string Value { get; } = "text *italics* and **bold*";
}While light and dark themes are supported out-of-the-box for most Markdown elements (Headers, Regular text, Quotation, Lists, Tables, and Details), code block theme-switching is not supported out-of-the-box.
To implement theme-switching for code blocks, refer to the implementation examples in the following sample projects:
After Wabbajack finishes the installation, complete these steps to launch the game:
Game Folder Files directory inside your Enderal installation folder. Copy its contents into your Skyrim installation directory (where Skyrim.exe is located).ModOrganizer.exe.Enderal: Forgotten Stories (Special Edition), activate the Enderal SE - Steam Time Tracking and Achievements mod in the left pane.EMW - Push Run To Play is selected.Run button.When an update is released:
overwrite existing Modlist button.WARNING: Wabbajack will delete all files that are not part of the Modlist during an update. Any additional mods you installed manually will be lost. Your downloads folder will remain untouched.
To improve FPS, you can tweak the ENB settings or the game's internal settings.
Open the ENB GUI using Right Shift + Enter. High-impact settings to consider disabling:
Ambient Occlusion: Can save up to 20 FPS.DepthOfField: Can save up to 10 FPS.Bloom: Can save up to 3 FPS.Distant/DetailedShadow: Significant impact depending on shader settings.ComplexFire/ParticleLights: Impact is most noticeable during magic use or near light sources.Use the included BethINI tool (found in MO2/tools/BethINI) to adjust the Detail section:
Shadow Resolution: A balance of 2048 is recommended.Ambient Occlusion: Set to None (the modlist uses ENB SAO instead).Detailed Draw Distance: Try 2000 instead of 2800.Remove Shadows: Use only if struggling significantly (not recommended).The following edge cases have been identified as potential rendering issues in MudBlazor.Markdown based on reported issues:
if statements).@page, @model) within code blocks. if
{
return;
}