refactor: add Content module to manage static markdown content

- Added Algora.Content module to handle loading and listing markdown content with frontmatter.
- Updated BlogLive module to utilize the new content management functions for loading blog posts and formatting dates.
- Removed deprecated functions related to blog post loading and listing.

Author: zcesur

lib/algora/content.ex

@@ -0,0 +1,46 @@
+defmodule Algora.Content do
+  @moduledoc """
+  Handles markdown content with frontmatter for blog posts, changelogs, docs, etc.
+  """
+
+  alias Algora.Markdown
+
+  defstruct [:slug, :title, :date, :tags, :authors, :content]
+
+  def load_content(directory, slug) do
+    with {:ok, content} <- File.read(Path.join(directory, "#{slug}.md")),
+         [frontmatter, markdown] <- content |> String.split("---\n", parts: 3) |> Enum.drop(1),
+         {:ok, parsed_frontmatter} <- YamlElixir.read_from_string(frontmatter) do
+      {:ok,
+       %__MODULE__{
+         slug: slug,
+         title: parsed_frontmatter["title"],
+         date: parsed_frontmatter["date"],
+         tags: parsed_frontmatter["tags"],
+         authors: parsed_frontmatter["authors"],
+         content: Markdown.render_unsafe(markdown)
+       }}
+    end
+  end
+
+  def list_content(directory) do
+    directory
+    |> File.ls!()
+    |> Enum.filter(&String.ends_with?(&1, ".md"))
+    |> Enum.map(fn filename ->
+      slug = String.replace(filename, ".md", "")
+      {:ok, content} = load_content(directory, slug)
+      content
+    end)
+    |> Enum.sort_by(& &1.date, :desc)
+  end
+
+  def format_date(date_string) when is_binary(date_string) do
+    case Date.from_iso8601(date_string) do
+      {:ok, date} -> Calendar.strftime(date, "%B %d, %Y")
+      _ -> date_string
+    end
+  end
+
+  def format_date(_), do: ""
+end

lib/algora_web/live/blog_live.ex

@@ -2,19 +2,19 @@ defmodule AlgoraWeb.BlogLive do
   @moduledoc false
   use AlgoraWeb, :live_view
 
-  alias Algora.Markdown
   alias AlgoraWeb.Components.Footer
   alias AlgoraWeb.Components.Header
 
+  defp blog_path, do: Path.join([:code.priv_dir(:algora), "blog"])
+
   @impl true
   def mount(%{"slug" => slug}, _session, socket) do
-    case load_blog_post(slug) do
-      {:ok, {frontmatter, content}} ->
+    case Algora.Content.load_content(blog_path(), slug) do
+      {:ok, content} ->
         {:ok,
          assign(socket,
-           content: Markdown.render_unsafe(content),
-           frontmatter: frontmatter,
-           page_title: frontmatter["title"]
+           content: content,
+           page_title: content.title
          )}
 
       {:error, _reason} ->
@@ -24,7 +24,7 @@ defmodule AlgoraWeb.BlogLive do
 
   @impl true
   def mount(_params, _session, socket) do
-    posts = list_blog_posts()
+    posts = Algora.Content.list_content(blog_path())
     {:ok, assign(socket, posts: posts, page_title: "Blog")}
   end
 
@@ -44,7 +44,7 @@ defmodule AlgoraWeb.BlogLive do
                     {post.title}
                   </h2>
                   <div class="flex items-center gap-4 text-sm text-muted-foreground">
-                    <time datetime={post.date}>{format_date(post.date)}</time>
+                    <time datetime={post.date}>{Algora.Content.format_date(post.date)}</time>
                     <div class="flex items-center gap-2">
                       <%= for author <- post.authors do %>
                         <img src={"https://github.com/#{author}.png"} class="w-6 h-6 rounded-full" />
@@ -66,13 +66,13 @@ defmodule AlgoraWeb.BlogLive do
           <article class="prose dark:prose-invert max-w-none">
             <header class="mb-8 not-prose">
               <h1 class="text-5xl font-display font-extrabold tracking-tight mb-4 bg-clip-text text-transparent bg-gradient-to-r from-emerald-400 to-emerald-300">
-                {@frontmatter["title"]}
+                {@content.title}
               </h1>
 
               <div class="flex items-center gap-4 text-muted-foreground mb-4">
-                <time datetime={@frontmatter["date"]}>{format_date(@frontmatter["date"])}</time>
+                <time datetime={@content.date}>{Algora.Content.format_date(@content.date)}</time>
                 <div class="flex items-center gap-3">
-                  <%= for author <- @frontmatter["authors"] do %>
+                  <%= for author <- @content.authors do %>
                     <div class="flex items-center gap-2">
                       <img src={"https://github.com/#{author}.png"} class="w-8 h-8 rounded-full" />
                       <.link
@@ -88,58 +88,20 @@ defmodule AlgoraWeb.BlogLive do
               </div>
 
               <div class="flex flex-wrap gap-2">
-                <%= for tag <- @frontmatter["tags"] do %>
+                <%= for tag <- @content.tags do %>
                   <.badge>
                     {tag}
                   </.badge>
                 <% end %>
               </div>
             </header>
 
-            {raw(@content)}
+            {raw(@content.content)}
           </article>
         <% end %>
       </div>
       <Footer.footer />
     </div>
     """
   end
-
-  defp load_blog_post(slug) do
-    with {:ok, content} <- File.read(Path.join(blog_path(), "#{slug}.md")),
-         [frontmatter, markdown] <- content |> String.split("---\n", parts: 3) |> Enum.drop(1),
-         {:ok, parsed_frontmatter} <- YamlElixir.read_from_string(frontmatter) do
-      {:ok, {parsed_frontmatter, markdown}}
-    end
-  end
-
-  defp list_blog_posts do
-    blog_path()
-    |> File.ls!()
-    |> Enum.filter(&String.ends_with?(&1, ".md"))
-    |> Enum.map(fn filename ->
-      {:ok, {frontmatter, _content}} = load_blog_post(String.replace(filename, ".md", ""))
-
-      %{
-        slug: String.replace(filename, ".md", ""),
-        title: frontmatter["title"],
-        date: frontmatter["date"],
-        tags: frontmatter["tags"],
-        authors: frontmatter["authors"]
-      }
-    end)
-    |> Enum.sort_by(& &1.date, :desc)
-  end
-
-  # Add this function to format dates
-  def format_date(date_string) when is_binary(date_string) do
-    case Date.from_iso8601(date_string) do
-      {:ok, date} -> Calendar.strftime(date, "%B %d, %Y")
-      _ -> date_string
-    end
-  end
-
-  def format_date(_), do: ""
-
-  defp blog_path, do: Path.join([:code.priv_dir(:algora), "blog"])
 end