This website is built using Docusaurus 2 with MeiliSearch for the docs indexation and is deployed by Netlify.
If you seek to change something from our guides, please refer to the docs folder from the Core repository.
When browsing the website, you will find edit links at the bottom of these docs.
The API docs are generated from our Rust and TypeScript source code.
In the end, as the guides and the API live in the Core repository, tauri-docs just holds the components and various pages that don't need to follow the Core repository version; this way, we don't pollute the Core repository with commits, PRs or issues related to the website only.
$ yarn
$ yarn start
This command starts a local development server and open up a browser window. Most changes are reflected live without having to restart the server.
To develop in another language, use this command (setting your desired language):
$ yarn start --locale fr
$ yarn build
This command generates static content and can be served using any static contents hosting service.
To build for only a specific language use:
yarn build --locale fr
$ GIT_USER=<Your GitHub username> USE_SSH=true yarn deploy
If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the gh-pages branch.
Feel free to open an issue/a PR if you find something weird in the docs.
Your PR once submitted to us, will automatically deploy to a temporary Netlify instance for us or you to review through GitHub's CI/CD checks: you will be able to click on a preview link once the build is ready.
We're working with Crowdin to manage translations, if you feel like you want to lend a hand for translations, take a look at the documentation project: https://tauri.crowdin.com/documentation
To add a language to the site, add it to docusaurus.config.js's siteconfig.i18n.locales object.
The following items should be translated before enabling a language:
- strings in i18n/[language] json files
- docs/about/intro.md and docs/about/security.md;
- all files in docs/get-started;
- all files in docs/development;
MIT License
Copyright (c) 2020-2021 Tauri Programme within The Commons Conservancy