{:html}` at the start of a blog post on desktop. You'd need to go to the top of the page to navigate through items. I've added a sticky `{:html}` component which always hangs out around the unused left side margin of a blog post. I also attached a very tiny client-side script using [`IntersectionObserver{:js}`](https://developer.mozilla.org/en-US/docs/Web/API/IntersectionObserver) to highlight all of the headings you're viewing within the TOC as you scroll through the page—it also will handle nested headings in that the parent heading of a visible child will still be highlighted even if off-screen (see the dummy [2024 Post](/blog/2024-post) for an example of this). I'll still use a collapsible `
-
-
{:html}` element for the table of contents on mobile though since obviously a table of contents on the side is unfeasible for small screens.
-- Every page, except the homepage, will have a `{:html}` component which shows you your current location in the site hierarchy. I don't see these often in blog templates even though they are so amazing for both discoverability (SEO and crawling) and user experience (the user always knows how "deep" they are in the site).
-- You can specify multiple post authors via frontmatter. If this post author's ID is found within the `Authors` collection, then it will render particular info from that author's frontmatter file, `[author-name].md` (e.g. avatar, link to profile). For example, the previous post (2024 Post) has two authors: "enscribe" and "jktrn", where "enscribe" is the only author with a custom avatar since "jktrn" is unregistered.
- - Each author will have their own page, which lists all of their posts. If you're the only author throughout the entire blog then you can simply disregard all aspects regarding both inserting authors and the `Authors` collection.
-- Each tag will also have their own page, which lists all of the posts under that tag!
-- $\LaTeX$ is fully supported with [KaTeX](https://katex.org/):
-
-
+
- - To solve the cubic equation $t^3 + pt + q = 0$ (where the real numbers - $p, q$ satisfy ${4p^3 + 27q^2} > 0$) one can use Cardano's formula: - - $$ - \sqrt[{3}]{ - -\frac{q}{2} - +\sqrt{\frac{q^2}{4} + {\frac{p^{3}}{27}}} - }+ - \sqrt[{3}]{ - -\frac{q}{2} - -\sqrt{\frac{q^2}{4} + {\frac{p^{3}}{27}}} - } - $$ - - For any $u_1, \dots, u_n \in \mathbb{C}$ and - $v_1, \dots, v_n \in \mathbb{C}$, the Cauchy–Bunyakovsky–Schwarz - inequality can be written as follows: - - $$ - \left| \sum_{k=1}^n {u_k \bar{v_k}} \right|^2 - \leq - { - \left( \sum_{k=1}^n {|u_k|} \right)^2 - \left( \sum_{k=1}^n {|v_k|} \right)^2 - } - $$ - - Finally, the determinant of a Vandermonde matrix can be calculated - using the following expression: - - $$ - \begin{vmatrix} - 1 & x_1 & x_1^2 & \dots & x_1^{n-1} \\ - 1 & x_2 & x_2^2 & \dots & x_2^{n-1} \\ - 1 & x_3 & x_3^2 & \dots & x_3^{n-1} \\ - \vdots & \vdots & \vdots & \ddots & \vdots \\ - 1 & x_n & x_n^2 & \dots & x_n^{n-1} \\ - \end{vmatrix} - = {\prod_{1 \leq {i,j} \leq n} {(x_i - x_j)}} - $$ - - —[Three famous mathematical formulas](https://developer.mozilla.org/en-US/docs/Learn/MathML/First_steps/Three_famous_mathematical_formulas) (Mozilla Docs) - -- -## Foregoing some slop - -- Goodbye, [ESLint](https://eslint.org/)! There have been so many occasions where I've had to deal with blogging templates with in-built pre-commit hooks which enforce contrived and arbitrary linting rules that, frankly, I couldn't be bothered with. Obviously, linting is awesome for ensuring consistency and best practice, but that's for shared and large codebases. You're dealing with, at most, your MDX blog posts and some interior fetching. It's just not worth the headache. -- You probably don't need analytics via [Umami](https://umami.is) or [Plausible](https://plausible.io). Let's be realistic: for many personal blogs, unless you're an anime profile picture Twitter microcelebrity, you don't need to know how many of your readers click Big Button A versus how many click Big Button B. -- You likely don't need a comments section via [Giscus](https://giscus.app). This opens up a can of worms involving the ability to spam comments and the necessity to moderate them. If you want organic discussion about your blog posts to happen, then share on social media and let people discuss there. - - Speaking of sharing on social media, let's get rid of the share buttons. When was the last time you actually used a share button on a blog post rather than just copying the URL? -- You probably don't need a CMS unless you have thousands of posts and/or are willing to navigate through a clunky management interface. Markdown and folders is really all you need, which you can organize to your preference via folder or file naming conventions. -- If you have literally anything involving an `.env` file in a blogging site, maybe think about what you are doing for a moment. -- Please consider not overriding the browser's Ctrl + K functionality to open up a command palette. There should not be a single reason why a user would use a small context menu to browse your blog over the `/blog` route. Most of the time, command palettes on sites do nothing more than regurgitate shortcuts that are already on the same page you're hiding with the palette's modal. - -## Something important - -Obviously a disclaimer: everything that I've shared here are my own personal gripes and, while I'd like for you to agree with me on a lot of these points for the better of the community, you can go ahead and disagree. The web development community, especially in spaces like Twitter and various online forums, is constantly engaged in heated debates about what constitutes "best practices." You'll find a wide spectrum of viewpoints: - -1. Fundamentalists who adhere strictly to established patterns and completely disregard change, -2. Accelerationists who eat up whatever Vercel cooks as if it's the second coming of Christ, -3. and everyone in between this spectrum. - -I wanted to share what particular technology stack worked the best for me in this particular use case. A stack for one project can be completely unusable for another. If you vehemently hate any of the design choices I've made then simply get rid of them. MIT license! Happy blogging. diff --git a/src/content/projects/project-a.md b/src/content/projects/project-a.md deleted file mode 100644 index d7a8f5f..0000000 --- a/src/content/projects/project-a.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -name: 'Project A' -description: 'This is an example project description! You should replace this with a description of your own project.' -tags: ['Framework A', 'Library B', 'Tool C', 'Resource D'] -image: '../../../public/static/1200x630.png' -link: 'https://example.com' ---- diff --git a/src/content/projects/project-b.md b/src/content/projects/project-b.md deleted file mode 100644 index 17004a8..0000000 --- a/src/content/projects/project-b.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -name: 'Project B' -description: 'This is an example project description! You should replace this with a description of your own project.' -tags: ['Framework A', 'Library B', 'Tool C', 'Resource D'] -image: '../../../public/static/1200x630.png' -link: 'https://example.com' ---- diff --git a/src/content/projects/project-c.md b/src/content/projects/project-c.md deleted file mode 100644 index b9d0af5..0000000 --- a/src/content/projects/project-c.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -name: 'Project C' -description: 'This is an example project description! You should replace this with a description of your own project.' -tags: ['Framework A', 'Library B', 'Tool C', 'Resource D'] -image: '../../../public/static/1200x630.png' -link: 'https://example.com' ---- diff --git a/src/layouts/Layout.astro b/src/layouts/Layout.astro index 91160b0..32f71a1 100644 --- a/src/layouts/Layout.astro +++ b/src/layouts/Layout.astro @@ -7,20 +7,15 @@ import { SITE } from '@/consts' type Props = { title: string description: string - image?: string } -const { title, description, image } = Astro.props +const { title, description } = Astro.props --- -
-
-
-
-
-
diff --git a/src/pages/authors/[...id].astro b/src/pages/authors/[...id].astro
deleted file mode 100644
index 098b72e..0000000
--- a/src/pages/authors/[...id].astro
+++ /dev/null
@@ -1,65 +0,0 @@
----
-import AuthorCard from '@/components/AuthorCard.astro'
-import BlogCard from '@/components/BlogCard.astro'
-import Breadcrumbs from '@/components/Breadcrumbs.astro'
-import Container from '@/components/Container.astro'
-import Layout from '@/layouts/Layout.astro'
-import { type CollectionEntry, getCollection } from 'astro:content'
-
-export async function getStaticPaths() {
- const authors = await getCollection('authors')
- return authors.map((author) => ({
- params: { id: author.id },
- props: { author },
- }))
-}
-
-type Props = {
- author: CollectionEntry<'authors'>
-}
-
-const { author } = Astro.props
-
-const allPosts = await getCollection('blog')
-const authorPosts = allPosts
- .filter((post) => {
- return post.data.authors && post.data.authors.includes(author.id)
- })
- .sort((a, b) => b.data.date.valueOf() - a.data.date.valueOf())
----
-
-
-
-
-
-
-
-
-
diff --git a/src/pages/authors/index.astro b/src/pages/authors/index.astro
deleted file mode 100644
index cbb5902..0000000
--- a/src/pages/authors/index.astro
+++ /dev/null
@@ -1,28 +0,0 @@
----
-import AuthorCard from '@/components/AuthorCard.astro'
-import Breadcrumbs from '@/components/Breadcrumbs.astro'
-import Container from '@/components/Container.astro'
-import Layout from '@/layouts/Layout.astro'
-import { getCollection } from 'astro:content'
-
-const authors = await getCollection('authors')
----
-
-
-
-
-
diff --git a/src/pages/blog/[...id].astro b/src/pages/blog/[...id].astro
index 7d07090..26a3f59 100644
--- a/src/pages/blog/[...id].astro
+++ b/src/pages/blog/[...id].astro
@@ -1,9 +1,7 @@
---
import Breadcrumbs from '@/components/Breadcrumbs.astro'
-import Link from '@/components/Link.astro'
import PostNavigation from '@/components/PostNavigation.astro'
import TableOfContents from '@/components/TableOfContents.astro'
-import { badgeVariants } from '@/components/ui/badge'
import { Button } from '@/components/ui/button'
import { Separator } from '@/components/ui/separator'
import Layout from '@/layouts/Layout.astro'
@@ -54,11 +52,7 @@ const { Content, headings } = await render(post)
const authors = await parseAuthors(post.data.authors ?? [])
---
-
+
@@ -89,62 +83,12 @@ const authors = await parseAuthors(post.data.authors ?? [])
-
-
-
-
- - astro-erudite is an opinionated, unstyled static blogging template - that prioritizes simplicity and performance, built with Astro, Tailwind, and shadcn/ui. It provides a clean foundation for your content while being - extremely easy to customize. -
-- To learn more about the philosophy behind this template, check out - the following blog post: The State of Static Blogs in 2024. -
-Example Projects Listing
-
- {projects.map((project) =>
- Posts by {author.data.name}
- { - authorPosts.length > 0 ? ( --
- {authorPosts.filter(post => !post.data.draft).map((post) => (
-
-
-
-
- ))}
-
- No posts available from this author. -
- ) - } --
- {authors.map((author) => (
-
-
-
-
- ))}
-
No authors found.
- ) - } -
- {
- authors.length > 0 && (
- <>
-
-
- {authors.map((author) => (
-
-
-
- ))}
-
{formatDate(post.data.date)}
- {
- post.data.tags && post.data.tags.length > 0 ? (
- post.data.tags.map((tag) => (
-
-
-
-
-
- er·u·dite
-- /ˈer(y)əˌdīt/ • adjective -
-
-
- - astro-erudite is an opinionated, unstyled static blogging template - built with Astro, Tailwind, and shadcn/ui. Extraordinarily loosely based on the Astro Micro theme. -
-- To use this template, check out the GitHub repository. To learn more about why this template exists, read this - blog post: The State of Static Blogs in 2024. -
-Latest posts
-
diff --git a/src/pages/robots.txt.ts b/src/pages/robots.txt.ts
index 679a44d..8fa2c2f 100644
--- a/src/pages/robots.txt.ts
+++ b/src/pages/robots.txt.ts
@@ -1,8 +1,52 @@
import type { APIRoute } from 'astro'
const getRobotsTxt = (sitemapURL: URL) => `
-User-agent: *
-Allow: /
+User-agent: AI2Bot
+User-agent: Ai2Bot-Dolma
+User-agent: Amazonbot
+User-agent: anthropic-ai
+User-agent: Applebot
+User-agent: Applebot-Extended
+User-agent: Bytespider
+User-agent: CCBot
+User-agent: ChatGPT-User
+User-agent: Claude-Web
+User-agent: ClaudeBot
+User-agent: cohere-ai
+User-agent: cohere-training-data-crawler
+User-agent: Crawlspace
+User-agent: Diffbot
+User-agent: DuckAssistBot
+User-agent: FacebookBot
+User-agent: FriendlyCrawler
+User-agent: Google-Extended
+User-agent: GoogleOther
+User-agent: GoogleOther-Image
+User-agent: GoogleOther-Video
+User-agent: GPTBot
+User-agent: iaskspider/2.0
+User-agent: ICC-Crawler
+User-agent: ImagesiftBot
+User-agent: img2dataset
+User-agent: ISSCyberRiskCrawler
+User-agent: Kangaroo Bot
+User-agent: Meta-ExternalAgent
+User-agent: Meta-ExternalFetcher
+User-agent: OAI-SearchBot
+User-agent: omgili
+User-agent: omgilibot
+User-agent: PanguBot
+User-agent: PerplexityBot
+User-agent: PetalBot
+User-agent: Scrapy
+User-agent: SemrushBot-OCOB
+User-agent: SemrushBot-SWA
+User-agent: Sidetrade indexer bot
+User-agent: Timpibot
+User-agent: VelenPublicWebCrawler
+User-agent: Webzio-Extended
+User-agent: YouBot
+Disallow: /
Sitemap: ${sitemapURL.href}
`
diff --git a/src/pages/tags/[...id].astro b/src/pages/tags/[...id].astro
deleted file mode 100644
index 01fa0e0..0000000
--- a/src/pages/tags/[...id].astro
+++ /dev/null
@@ -1,70 +0,0 @@
----
-import BlogCard from '@/components/BlogCard.astro'
-import Breadcrumbs from '@/components/Breadcrumbs.astro'
-import Container from '@/components/Container.astro'
-import Layout from '@/layouts/Layout.astro'
-import { Icon } from 'astro-icon/components'
-import { type CollectionEntry, getCollection } from 'astro:content'
-
-type BlogPost = CollectionEntry<'blog'>
-
-type Props = {
- tag: string
- posts: BlogPost[]
-}
-
-const { tag, posts } = Astro.props
-
-export async function getStaticPaths() {
- const posts = await getCollection('blog')
- const tags = posts.flatMap((post) => post.data.tags || [])
- const uniqueTags = Array.from(
- new Set(tags.filter((tag): tag is string => typeof tag === 'string')),
- )
-
- return uniqueTags.map((tag) => ({
- params: { id: tag },
- props: {
- tag,
- posts: posts.filter((post) => post.data.tags?.includes(tag)),
- },
- }))
-}
----
-
-
-
-
-
-
-
- Posts tagged with
- -
- {
- posts.map((post) => (
-
-
- ))
- }
-
-
-
- -
-
-
-
- {
- tags.map((tag) => (
-
-
-