Skip to content

sveltejs-translations/russian-sites

Repository files navigation

SVELTE SITES - RUSSIAN

This repo contains official Svelte and SvelteKit sites localized to russian.

If you looking for russian content(documentation, tutorial, examples etc.) for theese sites, you should go to sveltejs-translations/content-server repo of the unofficial multilangual content server.

How it work?

The content of the official sites repo is downloading to the temporary directory, then all needed files will be replaced or patched according patch directory content. So whenever official sites have some changes we can rebuild russian ones quickly.

Contributing

  • Run npm install
  • Run npm run dev:svelte or npm run dev:kit to start development site of needed project
  • Edit or add any files in patch directory or strings in patch/strings.json file and site will be reloaded with new translation

Change and PR only the files in patch directory

Use this repository as a template for your language

To start developing your own localized site:

  1. Clone this repo.
  2. Then remove all files from patch directory, except strings.json.
  3. Replace russian strings by your own in strings.json
  4. If you need replace whole files, place it inside patch directory, respect relative path of original file.
  5. Run npm run build:svelte or npm run build:kit to build the production site.
  6. Run npm run start:kit or npm run start:svelte to PREVIEW production site. Do not use it in production!, read about deploying in Readme of choosen adapter.

Configuration

In the root of project you can find the translation.config.json file.

{
    "lang": "ru",
    "repo": "https://github.com/sveltejs/sites",
    "adapter": "@sveltejs/adapter-node@next",
    "adapter_config": "{}",
    "api_url": "https://api.svelte.cf/ru",
    "api_url_dev": "http://localhost:3030/ru"
}

You can customize for your needs. Options are:

  • lang - language code of current translation
  • repo - repository URL to fetch original site's files
  • adapter - package name of the needed adapter for build step. By default using @sveltejs/adapter-auto@next
  • adapter_config - set adapter's options if needed (only JSON string here)
  • api_url - URL of the production API to fetch site content
  • api_url_dev - URL of the development API to fetch site content