найяскравіший.MinimalBlog - Як просто може бути ASPM SK2NET блог (Українська (Ukrainian))

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

Monday, 01 December 2025

//

9 minute read

Введение

Якщо ви ' читали цей блог , ви могли помітити, що моя основна блогова платформа - це М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: Подивіться на кінець статті, щоб побачити зв 'язок з джерелом пакет нугета як тільки я отримую час, щоб переконатися в тому, що МСК0 МСК1 надійний і що МSK2 не жахливий '

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

Весь проект розроблений за принципом МСК0 . тримай це просто. Немає бази даних , немає конвеєра збудування МSK2 немає фреймворка JavaScript M SK3 лише ASP MSC4 NET 9.0, Маркідж для відмітки для розшифровування NOTE: Ви можете навіть зробити це з боку клієнта, використовуючи знизити а потім просто мати статичну карту сервера .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 і завантажує їх в пам 'ять:

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

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

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

# Post Title




Your content here...

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

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: 
    var categoryMatch = CategoryRegex().Match(markdown);
    var categories = categoryMatch.Success
        ? categoryMatch.Groups[1].Value.Split(',', StringSplitOptions.TrimEntries)
        : [];

    // Extract date: 
    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 щоб уникнути перечитування та аналізу файлів на кожному запиті

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

: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

Для письменників, які віддають перевагу Монстр Маркдау, проект включає в себе повну implementaцію API MetaWeblog

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

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

Konfiguracja

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

{
  "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

dotnet add package mostlylucid.MinimalBlog

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

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) і у вас є робочий блог

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

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

cd Mostlylucid.MinimalBlog
dotnet run

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

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

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

  1. Створити новий .md файл у вашому настроенні MarkdownPath
  2. Додайте стандартні метадані:
    # Your Post Title
    
    
    
    
    Your content here...
    
  3. За save the file
  4. Cache закінчиться впродовж 30 хвилин ( або перезапуск aplikacjiM SK2

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

![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 з головного хранилища. IM SK1 я випустим пакет нугета, як тільки я добряче задовольну кодом

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

Finding related posts...
logo

© 2026 Scott Galloway — Unlicense — All content and source code on this site is free to use, copy, modify, and sell.