https://github.com/openscript/astro-theme-international
An Astro theme demonstrating internationalization.
https://github.com/openscript/astro-theme-international
Last synced: 4 months ago
JSON representation
An Astro theme demonstrating internationalization.
- Host: GitHub
- URL: https://github.com/openscript/astro-theme-international
- Owner: openscript
- License: mit
- Created: 2024-06-26T07:47:44.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-09-30T02:31:10.000Z (4 months ago)
- Last Synced: 2025-09-30T04:19:03.719Z (4 months ago)
- Language: Astro
- Homepage: https://openscript.github.io/astro-theme-international/
- Size: 26.5 MB
- Stars: 31
- Watchers: 1
- Forks: 3
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# `astro-theme-international`
An Astro theme, focused on internationalization.
[👀 **DEMO**](https://openscript.github.io/astro-theme-international)
## Usage
🛠️ How to use this theme?
1. Use this repository as a template.
[](https://github.com/new?template_name=astro-theme-international&template_owner=openscript)
1. Enable Github Pages in the repository settings:
1. Open the repository with Visual Studio Code.
1. Make sure you have [Docker](https://docs.docker.com/desktop/) and the [Dev Containers extension](https://code.visualstudio.com/docs/devcontainers/containers#_installation) installed.
1. Open the repository in a Dev Container.
1. Start making changes.
🎁 How to contribute to this theme?
1. Fork the project.
1. Make your changes.
1. Open a pull request.
## Features
- Internationalization and Localization by using [astro-loader-i18n](https://github.com/openscript/astro-loader-i18n)
- UI translations
- Content translations
- Route translations
- Language switcher
- `hreflang` and others meta tags
- Automated testing
- Unit and integration tests using [vitest](https://vitest.dev/)
- Coverage reports [](https://codecov.io/github/openscript/astro-theme-international)
- Opinionated pre-configured developer setup
- [Visual Studio Code Dev Containers](https://code.visualstudio.com/docs/remote/containers)
- Type-safe development with [Typescript](https://www.typescriptlang.org/)
- Pre-configured [Github Actions](https://github.com/features/actions) for CI/CD
- Compatible with [Github Pages](https://pages.github.com/)
- Works on a subpath (e.g. `http://example.com/my-cool-astro-site/`)
- MDX support [(@astrojs/mdx)](https://docs.astro.build/en/guides/mdx/)
- Release cycle including changelogs generation with [changesets](https://github.com/changesets/changesets)
- [.editorconfig](https://editorconfig.org/)
- Connectivity
- RSS Feeds with i18n support [(@astrojs/rss)](https://docs.astro.build/en/guides/rss/)
- Sitemaps with i18n support [(@astrojs/sitemap)](https://docs.astro.build/en/guides/integrations-guide/sitemap/)
- Static search using [Pagefind](https://pagefind.app/)
- Inject infos from Git into frontmatter via custom remark plugin
- Userfacing features
- Dark mode
- Pagination
- 404 page
- Favicons
- Custom fonts
- Responsivness
- Burger menu
- Markdown
- Autolink headings
- Table of Contents generation
### Content types
- Page (`pages`): A simple page with a title and content.
- Post (`blog`): A blog post with a title, content, and date.
### Layouts
- DefaultLayout: Layout with a header, main and footer.
### Sections
## Resources
- Fonts: https://fontsource.org/
- Colors: https://colorhunt.co/palette/f8ededff8225b43f3f173b45
- Icons: https://tabler.io/icons
- Backgrounds: https://www.fffuel.co/
- Favicon Generator: https://realfavicongenerator.net/
- Data Protection: https://gdpr.eu/privacy-notice/
- Images:
- https://unsplash.com/photos/desk-globe-on-table-nXt5HtLmlgE
### Articles
- https://dominuskelvin.dev/blog/understanding-astro-components
- https://simonhearne.com/2021/layout-shifts-webfonts/
- https://github.com/remarkjs/remark/blob/main/doc/plugins.md
- https://github.com/rehypejs/rehype/blob/main/doc/plugins.md
- https://danilafe.com/blog/blog_microfeatures/