# найяскравіший.MinimalBlog - Як просто може бути ASPM SK2NET блог

<!--category-- ASP.NET, Markdown, Blogging -->
<datetime class="hidden">2025-12-01T12:00</datetime>

## Введение

Якщо ви ' читали цей блог , ви могли помітити, що моя основна блогова платформа - це МSK2 дозвольте \ ' називати її \ МSK4\ захопливо розроблена \."\ PostgreSQL та векторні бази даних \МSK6\ семантичні та повні \ мSK7\ пошук тексту з індексами GIN \ ,\ автоматичний переклад на \ एमСК9\ мови | МСК10 \ численні хостеві послуги | , \ Планування роботи Hangfire \ msк12 \ Prometheus метрики \ มСК13 \ Serilog відслідковування \мСК14 \ HTMX інтерактиви \ ми підпорядковуємо власні пакети нугета \мск16 \ і достатньо контейнерів Docker для того, щоб зробити корабель завидливим \

**Це повністю навмисно.** Це моя лабораторія, де я експериментую з технологіями. *нібито* щоб бути над "-", тому що МSK1 - це те, як я вчуся МСК2 , розв 'язуючи проблеми, яких більшість блогів не мають СМСК3 . Взагалі-то MSК4 , а тоді пакувати ці рішення як відкриті .

Але ось в чому справа. **ви, мабуть, не потребуєте нічого з цього, щоб вести блог**

Ось чому я створив **найяскравіший.MinimalBlog** -, щоб показати, що відбувається, коли ви відкидаєте всі експерименти і зосереджуєтесь на абсолютних невід 'ємних речах . Немає бази даних МSK2 Немають конвеєрів для будування M SK3 Немаєте складності . Просто помічаєте файли у папці MSC5 з' являються в інтернеті MST6 Ось як виглядає блог, якщо ви не використовуєте його як лабораторію

> NOTA: Подивіться на кінець статті, щоб побачити зв 'язок з джерелом [пакет нугета](https://www.nuget.org/packages?q=mostlylucid&includeComputedFrameworks=true&prerel=true&sortby=relevance) як тільки я отримую час, щоб переконатися в тому, що МСК0 МСК1 надійний і що МSK2 не жахливий '

[TOC]

## Філософія: Менше - це більше .

Весь проект розроблений за принципом МСК0 . **тримай це просто**. Немає бази даних , немає конвеєра збудування МSK2 немає фреймворка JavaScript M SK3 лише ASP MSC4 NET 9.0, Маркідж для відмітки для розшифровування
NOTE: Ви можете навіть зробити це з боку клієнта, використовуючи [знизити](https://github.com/markdown-it/markdown-it) а потім просто мати статичну карту сервера `.md` файлів і зробити його навіть SIMPLER, але ... добре це ASP . NET блог

## Структура проекту

Давайте поглянемо на те, як проект організований.

```
Mostlylucid.MinimalBlog/
├── Pages/
│   ├── Index.cshtml              # Homepage with post list
│   ├── Post.cshtml                # Individual post page
│   ├── Categories.cshtml          # List of all categories
│   ├── Category.cshtml            # Posts in a category
│   ├── _Layout.cshtml             # Shared layout
│   ├── _ViewImports.cshtml        # Shared imports
│   └── _ViewStart.cshtml          # Layout selection
├── wwwroot/
│   └── css/
│       └── site.css               # All the CSS you need
├── MarkdownBlogService.cs         # Core blog logic
├── MetaWeblogService.cs           # XML-RPC for external editors
├── Program.cs                     # Application setup
├── appsettings.json               # Configuration
└── Mostlylucid.MinimalBlog.csproj # Project file
```

## Серце: MarkdownBlogService

Ядро блогу - це `MarkdownBlogService` клас. ЦеM SK1 надзвичайно простий- тільки MSC3 рядки коду, які обробляютьМSK4

1. Читання файлів відмітки з каталогу
2. Розшифровування метадань (головокМSK1 категоріїM SK2 дата публікації)
3. Перетворення позначки в HTML за допомогою Markdig
4. Caching everything in memory

Ось як це працює.

### Завантаження постів

Служба сканує задану папку для `.md` і завантажує їх в пам 'ять:

```csharp
private List<BlogPost> LoadAllPosts()
{
    if (!Directory.Exists(_markdownPath)) return [];

    return Directory.GetFiles(_markdownPath, "*.md", SearchOption.TopDirectoryOnly)
        .Where(f => Path.GetFileName(f).Count(c => c == '.') == 1) // Only base .md files
        .Select(ParseFile)
        .Where(p => p is { IsHidden: false })
        .OrderByDescending(p => p!.PublishedDate)
        .ToList()!;
}
```

Зверніть увагу на розумне фільтрування: `Count(c => c == '.') == 1` гарантує, що ми отримаємо тільки базу `.md` файли, не перекладені так, як `post.ar.md` або `post.de.md` ( якщо ви хочете додати переклади пізнішеM SK1

### Розшифровування метадань

Кожен файл відмітки має просту концепцію:

```markdown
# Post Title

<!-- category -- Category1, Category2 -->
<datetime class="hidden">2024-11-30T12:00</datetime>

Your content here...
```

Розшифровувач виділяє ці метадані за допомогою звичайного вираження та Маркдіга AST:

```csharp
private BlogPost? ParseFile(string filePath)
{
    var markdown = File.ReadAllText(filePath);
    var slug = Path.GetFileNameWithoutExtension(filePath);
    var document = Markdown.Parse(markdown, _pipeline);

    // Extract title from first H1
    var title = document.Descendants<HeadingBlock>()
        .FirstOrDefault(h => h.Level == 1)?
        .Inline?.FirstChild?.ToString() ?? slug;

    // Extract categories: <!-- category -- Cat1, Cat2 -->
    var categoryMatch = CategoryRegex().Match(markdown);
    var categories = categoryMatch.Success
        ? categoryMatch.Groups[1].Value.Split(',', StringSplitOptions.TrimEntries)
        : [];

    // Extract date: <datetime class="hidden">2024-01-01T00:00</datetime>
    var dateMatch = DateTimeRegex().Match(markdown);
    var publishedDate = dateMatch.Success && DateTime.TryParse(dateMatch.Groups[1].Value, out var dt)
        ? dt : File.GetCreationTimeUtc(filePath);

    return new BlogPost
    {
        Slug = slug,
        Title = title,
        Categories = categories,
        PublishedDate = publishedDate,
        HtmlContent = Markdown.ToHtml(markdown, _pipeline),
        IsHidden = markdown.Contains("<hidden")
    };
}
```

### Стратегія Caching

Кожна методика в службі використовує `IMemoryCache` щоб уникнути перечитування та аналізу файлів на кожному запиті

```csharp
public IReadOnlyList<BlogPost> GetAllPosts()
{
    return cache.GetOrCreate("all_posts", entry =>
    {
        entry.SetOptions(CacheOptions);
        return LoadAllPosts();
    }) ?? [];
}
```

Вхіди в кэш мають тривалість 30- Minuтного вичерпування і МSK1 Абсолютне вичерпання на годину МSK2 Прості , ефективні

## Установлення додатку: ПрограмуM SK1cs

Це всього лиш 43 рядки : Розібрані сторінки МSK2 пам 'ять, кэш, , вихідний кэш

## UI: Прості розібрані сторінки

У інтерфейсі є чистий сервер-рендерований HTML. Без JavaskripM SK2 без HTMX , без альпіанськогоMスク4jsMSC5 Домашня сторінка впорядковує постиМSK6 пост-сторінка рендерує `@Html.Raw(post.HtmlContent)` з `[OutputCache]` атрибут на годину- довгий HTML CachingM SK1 Чотири сторінки вкупі , кожен з них під 30 рядки МSK4

## Сタイリング: M SK1 Ліни CSS

Весь візуальний дизайн оброблений одним CSS-файлом з лише 55 рядками . Він використовує налаштування CSS для малювання і створює чистийMSC2 темний GitHub- надихнутий виглядM SK4

```css
:root {
  --bg: #0d1117;
  --bg-card: #161b22;
  --text: #c9d1d9;
  --text-muted: #8b949e;
  --accent: #58a6ff;
  --border: #30363d;
}

body {
  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
  background: var(--bg);
  color: var(--text);
  line-height: 1.6;
  max-width: 48rem;
  margin: 0 auto;
  padding: 2rem 1rem;
}

/* ... more styles ... */
```

Жодного пристроювача. Жодної збудови кроку . Жодних тисяч класів корисних речей

## Бонусна функція: MetaWeblog API

Для письменників, які віддають перевагу [Монстр Маркдау](https://markdownmonster.west-wind.com/), проект включає в себе повну implementaцію API MetaWeblog

- Список постів
- Створити нові записи
- редагувати наявні місця
- Постери
- завантажити зображення
- Згадайте категорії

Втілення `MetaWeblogService.cs` і обробляє повний XML-RPC протокол, аналіз запитів та генерує відповідіM SK2 Це означає, що ви можете написати ваші блогові статті в улюбленому редакторі і опублікувати їх безпосередньо на вашому блогуMSC3

## Konfiguracja

Весь файл конфігурації - просто 14 рядкиM SK1

```json
{
  "MarkdownPath": "../Mostlylucid/Markdown",
  "ImagesPath": "wwwroot/images",
  "MetaWeblog": {
    "Username": "admin",
    "Password": "changeme",
    "BlogUrl": "http://localhost:5000"
  },
  "Logging": {
    "LogLevel": {
      "Default": "Information"
    }
  }
}
```

- `MarkdownPath` - де знаходяться ваші файли відмітки
- `ImagesPath` - де зберігаються зображення
- `MetaWeblog` - права на доступ до зовнішнього редактора

## Використовування як пакет NuGet

> Як вже згадано, він незабаром стане доступним, але ще не :)

Тепер блог доступний як NuGet пакет, що робить його банальним додавати до будь-якої ASP.NET Core aplikacjiM SK2

```bash
dotnet add package mostlylucid.MinimalBlog
```

Тоді у вашому `Program.cs`:

```csharp
builder.Services.AddRazorPages();
builder.Services.AddMinimalBlog(options =>
{
    options.MarkdownPath = "Markdown";
    options.ImagesPath = "wwwroot/images";
    options.EnableMetaWeblog = false; // Optional, defaults to true
});

var app = builder.Build();

app.UseStaticFiles();
app.UseMinimalBlog();
app.MapRazorPages();
app.Run();
```

Це МСК0 , це "-", лише два методи:`AddMinimalBlog` і `UseMinimalBlog`) і у вас є робочий блог

## Працюючи з проектом зразка

Для запуску включного зразка проекту:

```bash
cd Mostlylucid.MinimalBlog
dotnet run
```

Виход `http://localhost:5000` і ви побачите блог з файлами відмітки з настроїного маршруту.

## Створюємо контент

Для створення нового блогу:

1. Створити новий `.md` файл у вашому настроенні `MarkdownPath`
2. Додайте стандартні метадані:
   ```markdown
   # Your Post Title
   
   <!-- category -- YourCategory, AnotherCategory -->
   <datetime class="hidden">2024-11-30T12:00</datetime>
   
   Your content here...
   ```
3. За save the file
4. Cache закінчиться впродовж 30 хвилин ( або перезапуск aplikacjiM SK2

Щоб додати зображення,, просто встановіть їх у вашому настроенні `ImagesPath` katalogу і віднести їх до вашої позначки.

```markdown
![Alt text](your-image.jpg)
```

## Що не вистачає

Цей мінімальний блог навмисно не включає в себе

- **Комментари** - Якщо потрібно, используйте третю службу МSK1
- **Поиск** - Тримай свій контент впорядкований категоріями
- **Метки** - Категорії достатньо для маленьких блогів
- **RSS/Atom** - Просто додавати, якщо вам це потрібно
- **Аuthentication** - API MetaWeblog використовує лише базовий аут
- **Аналітика** - Dodaj фрагмент JavaScript, якщо хочете
- **Оптимізація SEO** - працює добре з базовими мета-тегими
- **Відповідливі зображення** - Веб-браузер керує нею
- **Темна тема** - Одна тема - достатньо

Ці характеристики *можливо* додавати, але вониM SK1 не включені по замовчуванню, тому що більшість маленьких блогів не мають їх

## Характеристики ефективності

Незважаючи на свою простоту, цей блог **швидко**:

- **Камера пам 'яті** означає, що після першого завантаження не буде ніякого файлу I/O
- **Виведення в кэш** означає, що після першого запиту не буде рендерування Razor
- **Немає бази даних** означає, що немає надрахунку
- **Без Javaskrip** означає швидше завантаження сторінки
- **Прості CSS** означає мінімальне розшифровування таблиць стилю

Для малого чи середнього блогу (на основі МSK1 постів МSK2 ця архітектура перевершить більшість баз даних - закріплених блогових платформ

## Коли використовувати це проти. у повному Mostlylucid Blog

Використовувати **Найяскравіший.MinimalBlog** коли:

- You'you are starting a personal blog
- У вас менше ніж 500 постів
- Вам не потрібні багато мов
- Ви хочете, щоб все було просто
- Ви - МСК0 - задоволені файлами відмітки
- Ви просто хочете написати і опублікувати

Використовуйте **pełna платформа Mostlylucid** коли:

- Ви' використовуєте свій блог як **навчальна лабораторія** для нових технологій
- Ви хочете експериментувати з стратегіями застосування, моніторієюM SK1 та оптимізацією продуктивності
- Ви потребуєте конкретних властивостей, таких як багатомовна підтримка, повний- пошук текстуM SK2 або коментарі
- Ви – МСК0 – створюєте пакети і потребуєте справжнього тестування
- Ви – МСК0 – документуєте складні технічні втілення
- Дорога побудови платформи така ж цінна, як і контент, який вона створює

## Завершення: Простість як риса

У сучасному світі веб-розробки ми часто шукаємо складні рішення по замовчуванню.

Але іноді найпростішим рішенням є *праворуч* рішення. НайяскравішийM SK1MinimalBlog доводить, що ви можете побудувати функціональну, швидкуМSK3 і підтримуючу блогову платформу зMSC4

- **342 лінії CM SK1** (MarkdownBlogService
- **~120 лінії марkupу Razor** МSK0 сторінки)
- **55 лінії CSS**
- **1 Відлежність від NuGet** МSK0Markdig)

Те, що **менше ніж 520 строки коду в цілому** для повноцінної blogging-платформи.

Проект служить як функціональна блогова платформа, так і нагадувачем.: перед тим, як додати складність. , запитайте себе, чи ви дійсно потребуєте цього.

Полний вихідний код можна знайти в [Найяскравіший.MinimalBlog directory](https://github.com/scottgal/mostlylucidweb/tree/main/Mostlylucid.MinimalBlog) з головного хранилища. IM SK1 я випустим пакет нугета, як тільки я добряче задовольну кодом

Щасливі блоги!