Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/carlosulisesochoa/astro-i18n-multilanguage-blog
Astro + Multilanguage (i18n) + Static Blog System Example
https://github.com/carlosulisesochoa/astro-i18n-multilanguage-blog
astro blog english i18n multilanguage spanish theme
Last synced: about 1 month ago
JSON representation
Astro + Multilanguage (i18n) + Static Blog System Example
- Host: GitHub
- URL: https://github.com/carlosulisesochoa/astro-i18n-multilanguage-blog
- Owner: CarlosUlisesOchoa
- Created: 2024-08-01T02:32:08.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2024-08-18T19:07:53.000Z (6 months ago)
- Last Synced: 2024-11-08T06:12:21.279Z (3 months ago)
- Topics: astro, blog, english, i18n, multilanguage, spanish, theme
- Language: Astro
- Homepage: https://astro-i18n-blog.netlify.app/
- Size: 383 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Astro 4 + Multilanguage (i18n) + Blog System Example
### Take a look at this basic but pretty and clean example
## Features
- 🎨 Theme system (Light/Dark), it detect and set preferred browser theme
- 🌐 Language Switcher (ES/EN)
- ⛓️ Linked translations via a reference property: no need for matching slugs between locales.
- 🏖️ Allow adding pages for a new locale with minimal effort; use the default locale\* as a fallback for missing settings and strings.
- 🏷️ Content tags á la WordPress
- 🗺️ Sitemap support with translation links
- 📡 Localized RSS Feeds
- 🌍 Customizable URL structure, like `domain.tld/locale/directory/slug`
- 🪽 Skip to content link for screen reader and keyboard users
- 👩💼 Localized author profiles from a single data file
- 🔏 Secret/draft state to exclude posts from rendering
- 🔚 404 Page not found page
- 🐭 Ultra minimal styling without CSS classes with [new.css](https://newcss.net/) (remove only two lines of code to remove it!)
- 🔗 `target="_blank"` for external links with [Rehype plugin](https://github.com/rehypejs/rehype-external-links)
- 😉 Separate favicon for dev server to not get confused between dev and production
- ✅ 100/100 Lighthouse performance
- ✅ SEO-friendly with canonical URLs and OpenGraph data
- ✅ Markdown & MDX support
## 🚀 Project Structure
You'll see the following folders and files:
```text
├── public/
├── src/
│ ├── components/
│ ├── content/
│ ├── i18n/
│ │ ├── i18n.ts ← Set up locales here
│ │ ├── uiStrings.js ← Localized headings, labels, etc.
│ │ └── utilities ← i18n-specific functions
│ ├── layouts/
│ ├── libs/
│ ├── styles/
│ ├── utilities/
│ ├── consts.ts ← Settings loaded by astro.config.mjs
│ ├── env.d.ts
│ └── header.ts ← Settings for header menus, optionally per locale
├── astro.config.mjs
├── README.md
├── package.json
└── tsconfig.json
```
Astro looks for `.astro` or `.md` files in the `src/pages/` directory. Each page is exposed as a route based on its file name.
There's nothing special about `src/components/`, but that's where we like to put any Astro/React/Vue/Svelte/Preact components.
The `src/content/` directory contains collections of related markdown and MDX documents. A 'blog' collection has been defined already.
Any static assets, like images, can be placed in the `public/` directory.
## 🧞 Commands
All default commands can be run from the root of the project, from a terminal:
| Command | Action |
| :------------------------- | :----------------------------------------------- |
| `pnpm install` | Installs dependencies |
| `pnpm run dev` | Starts local dev server at `localhost:4321` |
| `pnpm run build` | Build your production site to `./dist/` |
| `pnpm run preview` | Preview your build locally, before deploying |
| `pnpm run astro ...` | Run CLI commands like `astro add`, `astro check` |
| `pnpm run astro -- --help` | Get help using the Astro CLI |
## ✅ TODO
You can check TODO-List at [TODO.md](./.github/TODO.md)
## Acknowledgements
- Special thanks to [@kslstn](https://github.com/kslstn) for the [astro-i18n-blog-starter](https://github.com/kslstn/astro-i18n-blog-starter), which served as a base for this version.