diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..aa1295b --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,21 @@ + +# Contributing + +Thank you for your interest in contributing! + +## Before You Start + +If you plan to make major changes (especially new features or design changes), please open an issue or discussion before starting work. This helps ensure your effort aligns with the project's direction. + +## Submitting Code + +Please keep each pull request focused on a single purpose. Avoid mixing unrelated changes in one PR, as this can make reviewing and merging code more difficult. + +Please use the [Conventional Commits](https://www.conventionalcommits.org/) format for your commit messages whenever possible. This keeps our history clear and consistent. + +Before submitting code, please run the appropriate commands to check for errors and format your code. + +```bash +pnpm check +pnpm format +``` \ No newline at end of file diff --git a/README.md b/README.md index b598c85..bdc5086 100644 --- a/README.md +++ b/README.md @@ -1,19 +1,18 @@ -# 🍥Fuwari +# 🍥Fuwari ![Node.js >= 20](https://img.shields.io/badge/node.js-%3E%3D20-brightgreen) ![pnpm >= 9](https://img.shields.io/badge/pnpm-%3E%3D9-blue) [![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fsaicaca%2Ffuwari.svg?type=shield&issueType=license)](https://app.fossa.com/projects/git%2Bgithub.com%2Fsaicaca%2Ffuwari?ref=badge_shield&issueType=license) A static blog template built with [Astro](https://astro.build). -[**🖥️ Live Demo (Vercel)**](https://fuwari.vercel.app)   /    -[**📦 Old Hexo Version**](https://github.com/saicaca/hexo-theme-vivia)   /    -[**🌏 中文**](https://github.com/saicaca/fuwari/blob/main/README.zh-CN.md)   /    -[**🌏 日本語**](https://github.com/saicaca/fuwari/blob/main/README.ja-JP.md)   /    -[**🌏 한국어**](https://github.com/saicaca/fuwari/blob/main/README.ko.md)   /    -[**🌏 Español**](https://github.com/saicaca/fuwari/blob/main/README.es.md)   /    -[**🌏 ไทย**](https://github.com/saicaca/fuwari/blob/main/README.th.md) - -> README version: `2025-04-24` +[**🖥️ Live Demo (Vercel)**](https://fuwari.vercel.app) ![Preview Image](https://raw.githubusercontent.com/saicaca/resource/main/fuwari/home.png) +🌏 README in +[**中文**](https://github.com/saicaca/fuwari/blob/main/docs/README.zh-CN.md) / +[**日本語**](https://github.com/saicaca/fuwari/blob/main/docs/README.ja.md) / +[**한국어**](https://github.com/saicaca/fuwari/blob/main/docs/README.ko.md) / +[**Español**](https://github.com/saicaca/fuwari/blob/main/docs/README.es.md) / +[**ไทย**](https://github.com/saicaca/fuwari/blob/main/docs/README.th.md) (Provided by the community and may not always be up-to-date) + ## ✨ Features - [x] Built with [Astro](https://astro.build) and [Tailwind CSS](https://tailwindcss.com) @@ -21,50 +20,30 @@ A static blog template built with [Astro](https://astro.build). - [x] Light / dark mode - [x] Customizable theme colors & banner - [x] Responsive design -- [ ] Comments -- [x] Search -- [x] TOC +- [x] Search functionality with [Pagefind](https://pagefind.app/) +- [x] [Markdown extended features](https://github.com/saicaca/fuwari?tab=readme-ov-file#-markdown-extended-syntax) +- [x] Table of contents +- [x] RSS feed -## require +## 🚀 Getting Started -- Node.js <= 22 -- pnpm <= 9 - -## 🚀 How to Use 1 - -Initialize the project locally using [create-fuwari](https://github.com/L4Ph/create-fuwari). - -```sh -# npm -npm create fuwari@latest - -# yarn -yarn create fuwari - -# pnpm -pnpm create fuwari@latest - -# bun -bun create fuwari@latest - -# deno -deno run -A npm:create-fuwari@latest -``` - -1. Edit the config file `src/config.ts` to customize your blog. -2. Run `pnpm new-post ` to create a new post and edit it in `src/content/posts/`. -3. Deploy your blog to Vercel, Netlify, GitHub Pages, etc. following [the guides](https://docs.astro.build/en/guides/deploy/). You need to edit the site configuration in `astro.config.mjs` before deployment. - -## 🚀 How to Use - -1. [Generate a new repository](https://github.com/saicaca/fuwari/generate) from this template or fork this repository. -2. To edit your blog locally, clone your repository, run `pnpm install` AND `pnpm add sharp` to install dependencies. - - Install [pnpm](https://pnpm.io) `npm install -g pnpm` if you haven't. +1. Create your blog repository: + - [Generate a new repository](https://github.com/saicaca/fuwari/generate) from this template or fork this repository. + - Or run one of the following commands: + ```sh + npm create fuwari@latest + yarn create fuwari + pnpm create fuwari@latest + bun create fuwari@latest + deno run -A npm:create-fuwari@latest + ``` +2. To edit your blog locally, clone your repository, run `pnpm install` to install dependencies. + - Install [pnpm](https://pnpm.io) `npm install -g pnpm` if you haven't. 3. Edit the config file `src/config.ts` to customize your blog. 4. Run `pnpm new-post ` to create a new post and edit it in `src/content/posts/`. 5. Deploy your blog to Vercel, Netlify, GitHub Pages, etc. following [the guides](https://docs.astro.build/en/guides/deploy/). You need to edit the site configuration in `astro.config.mjs` before deployment. -## ⚙️ Frontmatter of Posts +## 📝 Frontmatter of Posts ```yaml --- @@ -79,16 +58,36 @@ lang: jp # Set only if the post's language differs from the site's language --- ``` -## 🧞 Commands +## 🧩 Markdown Extended Syntax + +In addition to Astro's default support for [GitHub Flavored Markdown](https://github.github.com/gfm/), several extra Markdown features are included: + +- Admonitions ([Preview and Usage](https://fuwari.vercel.app/posts/markdown-extended/#admonitions)) +- GitHub repository cards ([Preview and Usage](https://fuwari.vercel.app/posts/markdown-extended/#github-repository-cards)) +- Enhanced code blocks with Expressive Code ([Preview](https://fuwari.vercel.app/posts/expressive-code/) / [Docs](https://expressive-code.com/)) + +## ⚡ Commands All commands are run from the root of the project, from a terminal: -| Command | Action | -|:------------------------------------|:-------------------------------------------------| -| `pnpm install` AND `pnpm add sharp` | 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 new-post ` | Create a new post | -| `pnpm astro ...` | Run CLI commands like `astro add`, `astro check` | -| `pnpm astro --help` | Get help using the Astro CLI | +| 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 check` | Run checks for errors in your code | +| `pnpm format` | Format your code using Biome | +| `pnpm new-post ` | Create a new post | +| `pnpm astro ...` | Run CLI commands like `astro add`, `astro check` | +| `pnpm astro --help` | Get help using the Astro CLI | + +## ✏️ Contributing + +Check out the [Contributing Guide](https://github.com/saicaca/fuwari/blob/main/CONTRIBUTING.md) for details on how to contribute to this project. + +## 📄 License + +This project is licensed under the MIT License. + +[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fsaicaca%2Ffuwari.svg?type=large&issueType=license)](https://app.fossa.com/projects/git%2Bgithub.com%2Fsaicaca%2Ffuwari?ref=badge_large&issueType=license) \ No newline at end of file diff --git a/README.es.md b/docs/README.es.md similarity index 94% rename from README.es.md rename to docs/README.es.md index 0b2e252..8734530 100644 --- a/README.es.md +++ b/docs/README.es.md @@ -2,10 +2,7 @@ Un tema estático para blogs construido con [Astro](https://astro.build). -[**🖥️ Demostración en Vivo (Vercel)**](https://fuwari.vercel.app)   /    -[**📦 Versión Antigua de Hexo**](https://github.com/saicaca/hexo-theme-vivia)   /    - -> Versión del README: `2025-04-24` +[**🖥️ Demostración en Vivo (Vercel)**](https://fuwari.vercel.app) ![Imagen de Vista Previa](https://raw.githubusercontent.com/saicaca/resource/main/fuwari/home.png) diff --git a/README.ja-JP.md b/docs/README.ja.md similarity index 96% rename from README.ja-JP.md rename to docs/README.ja.md index 9d090d9..87a3d7f 100644 --- a/README.ja-JP.md +++ b/docs/README.ja.md @@ -2,10 +2,7 @@ [Astro](https://astro.build) で構築された静的ブログテンプレート -[**🖥️ライブデモ (Vercel)**](https://fuwari.vercel.app)   /    -[**📦旧 Hexo バージョン**](https://github.com/saicaca/hexo-theme-vivia) - -> README バージョン：`2025-04-24` +[**🖥️ライブデモ (Vercel)**](https://fuwari.vercel.app) ![Preview Image](https://raw.githubusercontent.com/saicaca/resource/main/fuwari/home.png) diff --git a/README.ko.md b/docs/README.ko.md similarity index 82% rename from README.ko.md rename to docs/README.ko.md index 0ac0a45..7ad828f 100644 --- a/README.ko.md +++ b/docs/README.ko.md @@ -2,15 +2,7 @@ [Astro](https://astro.build)로 구축된 정적 블로그 템플릿입니다. -[**🖥️미리보기 (Vercel)**](https://fuwari.vercel.app)   /    -[**📦Old Hexo Version**](https://github.com/saicaca/hexo-theme-vivia)   /    -[**🌏 English**](https://github.com/saicaca/fuwari/blob/main/README.md)   /    -[**🌏 中文**](https://github.com/saicaca/fuwari/blob/main/README.zh-CN.md)   /    -[**🌏 日本語**](https://github.com/saicaca/fuwari/blob/main/README.ja-JP.md)   /    -[**🌏 Español**](https://github.com/saicaca/fuwari/blob/main/README.es.md)   /    -[**🌏 ไทย**](https://github.com/saicaca/fuwari/blob/main/README.th.md) - -> README 버전: `2025-04-24` +[**🖥️미리보기 (Vercel)**](https://fuwari.vercel.app) ![Preview Image](https://raw.githubusercontent.com/saicaca/resource/main/fuwari/home.png) diff --git a/README.th.md b/docs/README.th.md similarity index 95% rename from README.th.md rename to docs/README.th.md index 3039271..0ed820e 100644 --- a/README.th.md +++ b/docs/README.th.md @@ -2,10 +2,7 @@ แม่แบบสำหรับเว็บบล็อกแบบ static สร้างด้วย [Astro](https://astro.build) -[**🖥️ ตัวอย่างการใช้งานจริง (Vercel)**](https://fuwari.vercel.app)   /    -[**📦 เวอร์ชั่นเก่าสำหรับ Hexo**](https://github.com/saicaca/hexo-theme-vivia) - -> เวอร์ชั่นของ README: `2025-04-24` +[**🖥️ ตัวอย่างการใช้งานจริง (Vercel)**](https://fuwari.vercel.app) ![ภาพตัวอย่าง](https://raw.githubusercontent.com/saicaca/resource/main/fuwari/home.png) diff --git a/README.zh-CN.md b/docs/README.zh-CN.md similarity index 95% rename from README.zh-CN.md rename to docs/README.zh-CN.md index 0b852b2..68fdd2b 100644 --- a/README.zh-CN.md +++ b/docs/README.zh-CN.md @@ -2,10 +2,7 @@ 基于 [Astro](https://astro.build) 开发的静态博客模板。 -[**🖥️在线预览（Vercel）**](https://fuwari.vercel.app)   /    -[**📦旧 Hexo 版本**](https://github.com/saicaca/hexo-theme-vivia) - -> README 版本：`2025-04-24` +[**🖥️在线预览（Vercel）**](https://fuwari.vercel.app) ![Preview Image](https://raw.githubusercontent.com/saicaca/resource/main/fuwari/home.png)