|
| 1 | +# 🍥Fuwari |
| 2 | + |
| 3 | + |
| 4 | +[](https://deepwiki.com/saicaca/fuwari) |
| 5 | +[](https://app.fossa.com/projects/git%2Bgithub.com%2Fsaicaca%2Ffuwari?ref=badge_shield&issueType=license) |
| 6 | + |
| 7 | +A static blog template built with [Astro](https://astro.build). |
| 8 | + |
| 9 | +[**🖥️ Live Demo (Vercel)**](https://fuwari.vercel.app) |
| 10 | + |
| 11 | + |
| 12 | + |
| 13 | +🌏 README in |
| 14 | +[**中文**](https://github.com/saicaca/fuwari/blob/main/docs/README.zh-CN.md) / |
| 15 | +[**日本語**](https://github.com/saicaca/fuwari/blob/main/docs/README.ja.md) / |
| 16 | +[**한국어**](https://github.com/saicaca/fuwari/blob/main/docs/README.ko.md) / |
| 17 | +[**Español**](https://github.com/saicaca/fuwari/blob/main/docs/README.es.md) / |
| 18 | +[**ไทย**](https://github.com/saicaca/fuwari/blob/main/docs/README.th.md) / |
| 19 | +[**Tiếng Việt**](https://github.com/saicaca/fuwari/blob/main/docs/README.vi.md) (Provided by the community and may not always be up-to-date) |
| 20 | + |
| 21 | +## ✨ Features |
| 22 | + |
| 23 | +- [x] Built with [Astro](https://astro.build) and [Tailwind CSS](https://tailwindcss.com) |
| 24 | +- [x] Smooth animations and page transitions |
| 25 | +- [x] Light / dark mode |
| 26 | +- [x] Customizable theme colors & banner |
| 27 | +- [x] Responsive design |
| 28 | +- [x] Search functionality with [Pagefind](https://pagefind.app/) |
| 29 | +- [x] [Markdown extended features](https://github.com/saicaca/fuwari?tab=readme-ov-file#-markdown-extended-syntax) |
| 30 | +- [x] Table of contents |
| 31 | +- [x] RSS feed |
| 32 | + |
| 33 | +## 🚀 Getting Started |
| 34 | + |
| 35 | +1. Create your blog repository: |
| 36 | + - [Generate a new repository](https://github.com/saicaca/fuwari/generate) from this template or fork this repository. |
| 37 | + - Or run one of the following commands: |
| 38 | + ```sh |
| 39 | + npm create fuwari@latest |
| 40 | + yarn create fuwari |
| 41 | + pnpm create fuwari@latest |
| 42 | + bun create fuwari@latest |
| 43 | + deno run -A npm:create-fuwari@latest |
| 44 | + ``` |
| 45 | +2. To edit your blog locally, clone your repository, run `pnpm install` to install dependencies. |
| 46 | + - Install [pnpm](https://pnpm.io) `npm install -g pnpm` if you haven't. |
| 47 | +3. Edit the config file `src/config.ts` to customize your blog. |
| 48 | +4. Run `pnpm new-post <filename>` to create a new post and edit it in `src/content/posts/`. |
| 49 | +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. |
| 50 | +
|
| 51 | +## 📝 Frontmatter of Posts |
| 52 | +
|
| 53 | +```yaml |
| 54 | +--- |
| 55 | +title: My First Blog Post |
| 56 | +published: 2023-09-09 |
| 57 | +description: This is the first post of my new Astro blog. |
| 58 | +image: ./cover.jpg |
| 59 | +tags: [Foo, Bar] |
| 60 | +category: Front-end |
| 61 | +draft: false |
| 62 | +lang: jp # Set only if the post's language differs from the site's language in `config.ts` |
| 63 | +--- |
| 64 | +``` |
| 65 | +
|
| 66 | +## 🧩 Markdown Extended Syntax |
| 67 | +
|
| 68 | +In addition to Astro's default support for [GitHub Flavored Markdown](https://github.github.com/gfm/), several extra Markdown features are included: |
| 69 | + |
| 70 | +- Admonitions ([Preview and Usage](https://fuwari.vercel.app/posts/markdown-extended/#admonitions)) |
| 71 | +- GitHub repository cards ([Preview and Usage](https://fuwari.vercel.app/posts/markdown-extended/#github-repository-cards)) |
| 72 | +- Enhanced code blocks with Expressive Code ([Preview](https://fuwari.vercel.app/posts/expressive-code/) / [Docs](https://expressive-code.com/)) |
| 73 | + |
| 74 | +## ⚡ Commands |
| 75 | + |
| 76 | +All commands are run from the root of the project, from a terminal: |
| 77 | + |
| 78 | +| Command | Action | |
| 79 | +|:---------------------------|:----------------------------------------------------| |
| 80 | +| `pnpm install` | Installs dependencies | |
| 81 | +| `pnpm dev` | Starts local dev server at `localhost:4321` | |
| 82 | +| `pnpm build` | Build your production site to `./dist/` | |
| 83 | +| `pnpm preview` | Preview your build locally, before deploying | |
| 84 | +| `pnpm check` | Run checks for errors in your code | |
| 85 | +| `pnpm format` | Format your code using Biome | |
| 86 | +| `pnpm new-post <filename>` | Create a new post | |
| 87 | +| `pnpm astro ...` | Run CLI commands like `astro add`, `astro check` | |
| 88 | +| `pnpm astro --help` | Get help using the Astro CLI | |
| 89 | + |
| 90 | +## ✏️ Contributing |
| 91 | + |
| 92 | +Check out the [Contributing Guide](https://github.com/saicaca/fuwari/blob/main/CONTRIBUTING.md) for details on how to contribute to this project. |
| 93 | + |
| 94 | +## 📄 License |
| 95 | + |
| 96 | +This project is licensed under the MIT License. |
| 97 | + |
| 98 | +[](https://app.fossa.com/projects/git%2Bgithub.com%2Fsaicaca%2Ffuwari?ref=badge_large&issueType=license) |
0 commit comments