From 2b03ac03b8a49d90c4ba72bc5da477c2f60e68c2 Mon Sep 17 00:00:00 2001 From: Peer Hanna Date: Mon, 25 May 2026 17:03:24 +0200 Subject: [PATCH 1/5] docs(readme): add new title --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 51f06e0..fe78a35 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# AstroPaper 📄 +# Pierre Hanna ![AstroPaper](public/default-og.jpg) [![Figma](https://img.shields.io/badge/Figma-F24E1E?style=for-the-badge&logo=figma&logoColor=white)](https://www.figma.com/community/file/1356898632249991861) From 56f824427c27cc03d604c0493dd0af7f89efa2a3 Mon Sep 17 00:00:00 2001 From: Peer Hanna Date: Mon, 25 May 2026 17:07:50 +0200 Subject: [PATCH 2/5] docs(readme): delete comitizen friendly banner I deleted the comitizen friendly banner since I am using neither cz nor czg in this project. I kept the `cz.yaml` file for future forks --- README.md | 1 - 1 file changed, 1 deletion(-) diff --git a/README.md b/README.md index fe78a35..ffbbaee 100644 --- a/README.md +++ b/README.md @@ -5,7 +5,6 @@ ![Typescript](https://img.shields.io/badge/TypeScript-007ACC?style=for-the-badge&logo=typescript&logoColor=white) ![GitHub](https://img.shields.io/github/license/satnaing/astro-paper?color=%232F3741&style=for-the-badge) [![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-%23FE5196?logo=conventionalcommits&logoColor=white&style=for-the-badge)](https://conventionalcommits.org) -[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg?style=for-the-badge)](http://commitizen.github.io/cz-cli/) AstroPaper is a minimal, responsive, accessible and SEO-friendly Astro blog theme. This theme is designed and crafted based on [my personal blog](https://satnaing.dev/blog). From 41b1d588ad6ed0715c06c18475e7ea71762c16e0 Mon Sep 17 00:00:00 2001 From: Peer Hanna Date: Mon, 25 May 2026 17:13:25 +0200 Subject: [PATCH 3/5] docs(readme): add desc and docs for commands --- README.md | 109 +++++++++++++++++++++++++++--------------------------- 1 file changed, 55 insertions(+), 54 deletions(-) diff --git a/README.md b/README.md index ffbbaee..b08f667 100644 --- a/README.md +++ b/README.md @@ -6,37 +6,29 @@ ![GitHub](https://img.shields.io/github/license/satnaing/astro-paper?color=%232F3741&style=for-the-badge) [![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-%23FE5196?logo=conventionalcommits&logoColor=white&style=for-the-badge)](https://conventionalcommits.org) -AstroPaper is a minimal, responsive, accessible and SEO-friendly Astro blog theme. This theme is designed and crafted based on [my personal blog](https://satnaing.dev/blog). - -Read [the blog posts](https://astro-paper.pages.dev/posts/) or check [the README Documentation Section](#-documentation) for more info. - -## 🔥 Features - -- [x] type-safe markdown -- [x] super fast performance -- [x] accessible (Keyboard/VoiceOver) -- [x] responsive (mobile ~ desktops) -- [x] SEO-friendly -- [x] light & dark mode -- [x] static search ([Pagefind](https://pagefind.app/)) -- [x] draft posts & pagination -- [x] sitemap & rss feed -- [x] MDX support -- [x] collapsible table of contents -- [x] followed best practices -- [x] highly customizable -- [x] dynamic OG image generation for blog posts ([Blog Post](https://astro-paper.pages.dev/posts/dynamic-og-image-generation-in-astropaper-blog-posts/)) -- [x] i18n ready - -_Note: I've tested screen-reader accessibility of AstroPaper using **VoiceOver** on Mac and **TalkBack** on Android. I couldn't test all other screen-readers out there. However, accessibility enhancements in AstroPaper should be working fine on others as well._ - -## ✅ Lighthouse Score - -

- - AstroPaper Lighthouse Score - -

+This is the source code for my personal website, hosted with GitHub Pages at +[alkhatir.github.io](https://alkhatir.github.io). + +The site is built from the AstroPaper template and customized as a place for my +projects, notes, technical writing, and personal updates. I use it to document +work around artificial intelligence, software engineering, data science, web +development, and tools I am currently exploring. + +## About This Site + +- Personal homepage for Pierre Hanna. +- Blog and notes powered by Markdown. +- Project writeups for AI, software engineering, and related technical work. +- Fast static site generated with Astro. +- Responsive layout with light and dark mode. +- SEO, RSS, sitemap, search, and dynamic Open Graph image support inherited from + AstroPaper. + +## Status + +This website is in active development. The current focus is replacing the +default AstroPaper content with my own homepage, about page, project notes, and +blog posts. ## 🚀 Project Structure @@ -97,7 +89,9 @@ Documentation can be read in two formats\_ _markdown_ & _blog post_. ## 👨🏻‍💻 Running Locally -You can start using this project locally by running the following command in your desired directory: +### In case you want to start from scratch + +You can have the same project template by running the following command in your desired directory: ```bash # pnpm @@ -113,6 +107,8 @@ yarn create astro --template satnaing/astro-paper bun create astro@latest -- --template satnaing/astro-paper ``` +### Starting the server and installing the dependencies + Then start the project by running the following commands: ```bash @@ -123,34 +119,38 @@ pnpm install pnpm dev ``` -## Google Site Verification (optional) +As an alternative approach, if you have Docker installed, you can use Docker to run this project locally. Here's how: -You can add your [Google Site Verification HTML tag](https://support.google.com/webmasters/answer/9008080#meta_tag_verification&zippy=%2Chtml-tag) by setting `site.googleVerification` in `astro-paper.config.ts`: +```bash +# Build the Docker image +docker build -t astropaper . -```ts file="astro-paper.config.ts" -export default defineAstroPaperConfig({ - site: { - // ... - googleVerification: "your-google-site-verification-value", - }, - // ... -}); +# Run the Docker container +docker run -p 4321:80 astropaper ``` -> See [this discussion](https://github.com/satnaing/astro-paper/discussions/334#discussioncomment-10139247) for adding AstroPaper to the Google Search Console. - ## 🧞 Commands All commands are run from the root of the project, from a terminal: -| Command | Action | -| :--------------- | :------------------------------------------------------------------------------------------------------------------------------- | -| `pnpm install` | Installs dependencies | -| `pnpm dev` | Starts local dev server at `localhost:4321` | -| `pnpm build` | Type-checks, builds the site, runs Pagefind indexing, and copies the index to `public/pagefind/` | -| `pnpm preview` | Preview your build locally, before deploying | -| `pnpm sync` | Generates TypeScript types for all Astro modules. [Learn more](https://docs.astro.build/en/reference/cli-reference/#astro-sync). | -| `pnpm astro ...` | Run CLI commands like `astro add`, `astro check` | +> **_Note!_** For `Docker` commands we must have it [installed](https://docs.docker.com/engine/install/) in your machine. + +| Command | Action | +| :----------------------------------- | :------------------------------------------------------------------------------------------------------------------------------- | +| `pnpm install` | Installs dependencies | +| `pnpm dev` | Starts local dev server at `localhost:4321` | +| `pnpm build` | Build your production site to `./dist/` | +| `pnpm preview` | Preview your build locally, before deploying | +| `pnpm format:check` | Check code format with Prettier | +| `pnpm format` | Format codes with Prettier | +| `pnpm sync` | Generates TypeScript types for all Astro modules. [Learn more](https://docs.astro.build/en/reference/cli-reference/#astro-sync). | +| `pnpm lint` | Lint with ESLint | +| `docker compose up -d` | Run AstroPaper on docker, You can access with the same hostname and port informed on `dev` command. | +| `docker compose run app npm install` | You can run any command above into the docker container. | +| `docker build -t astropaper .` | Build Docker image for AstroPaper. | +| `docker run -p 4321:80 astropaper` | Run AstroPaper on Docker. The website will be accessible at `http://localhost:4321`. | + +> **_Warning!_** Windows PowerShell users may need to install the [concurrently package](https://www.npmjs.com/package/concurrently) if they want to [run diagnostics](https://docs.astro.build/en/reference/cli-reference/#astro-check) during development (`astro check --watch & astro dev`). For more info, see [this issue](https://github.com/satnaing/astro-paper/issues/113). ## ✨ Feedback & Suggestions @@ -158,8 +158,9 @@ If you have any suggestions/feedback, you can contact me via [my email](mailto:s ## 📜 License -Licensed under the MIT License, Copyright © 2026 +This site is based on the MIT-licensed +[AstroPaper](https://github.com/satnaing/astro-paper) template. --- -Made with 🤍 by [Sat Naing](https://satnaing.dev) 👨🏻‍💻 and [contributors](https://github.com/satnaing/astro-paper/graphs/contributors). +Built by [Pierre Hanna](https://github.com/Alkhatir). From 923838a7c8fefa0092939c7e660a292e852e5929 Mon Sep 17 00:00:00 2001 From: Peer Hanna Date: Mon, 25 May 2026 17:19:23 +0200 Subject: [PATCH 4/5] docs(readme): adjust the feedback and suggestions section --- README.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index b08f667..769fd8e 100644 --- a/README.md +++ b/README.md @@ -154,7 +154,12 @@ All commands are run from the root of the project, from a terminal: ## ✨ Feedback & Suggestions -If you have any suggestions/feedback, you can contact me via [my email](mailto:satnaingdev+astropaper@gmail.com). Alternatively, feel free to open an issue if you find bugs or want to request new features. +Please feel free to contact me in case you a suggestion or an issue with the +website. Otherwise, I am open for a chit-chat! + +You can find me on [GitHub](https://github.com/Alkhatir), +[X](https://x.com/Peet_Alkhatir), or +[LinkedIn](https://www.linkedin.com/in/peer-hanna/). ## 📜 License From d519dddfb8eb3512ed2fee3724fb0103780d01c6 Mon Sep 17 00:00:00 2001 From: Peer Hanna Date: Mon, 25 May 2026 17:56:04 +0200 Subject: [PATCH 5/5] style(package.json): formate by prettier --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index d47a406..40caec9 100644 --- a/package.json +++ b/package.json @@ -45,4 +45,4 @@ "prettier-plugin-tailwindcss": "^0.8.0", "typescript": "^6.0.3" } -} \ No newline at end of file +}