astro-theme-international

An Astro theme, focused on internationalization.

👀 DEMO

Usage

🛠️ How to use this theme?

1. Use this repository as a template.
   
2. Enable Github Pages in the repository settings:
   
3. Open the repository with Visual Studio Code.
4. Make sure you have Docker and the Dev Containers extension installed.
5. Open the repository in a Dev Container.
6. Start making changes.

🎁 How to contribute to this theme?

1. Fork the project.
2. Make your changes.
3. Open a pull request.

Features

• Internationalization and Localization by using astro-loader-i18n
  • UI translations
  • Content translations
  • Route translations
  • Language switcher
  • hreflang and others meta tags
• Automated testing
  • Unit and integration tests using vitest
  • Coverage reports
• Opinionated pre-configured developer setup
  • Visual Studio Code Dev Containers
  • Type-safe development with Typescript
  • Pre-configured Github Actions for CI/CD
  • Compatible with Github Pages
  • Works on a subpath (e.g. http://example.com/my-cool-astro-site/)
  • MDX support (@astrojs/mdx)
  • Release cycle including changelogs generation with changesets
  • .editorconfig
• Connectivity
  • RSS Feeds with i18n support (@astrojs/rss)
  • Sitemaps with i18n support (@astrojs/sitemap)
  • Static search using Pagefind
  • 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/