feat: docs i18n support (continuation from #14818) (#17190)

* Initial commit for i18n support

* Bring out index page

* Lint
	modified:   src/pages/index.js

* More Crowdin ephemera

* copy src content to i18n/**/docusaurus-plugin-content-docs/current folders

* run write-translations

* remove superflous files in i18n

* fix formatting

* remove icons folders from translations, add ja, pt, vi translations

* fix formatting

* update translation JSON files

* add crowdin support & crowdin:sync command, sync with crowdin

* exclude failing locales

* remove i18n from git cache, add write-heading-ids script

* add crowdin:sync to before_install.sh script

* add write-i18m shortening script & crowdin:download script (also to before_install.sh)

* move crowdin:download from before_install.sh to prebuild hook

* remove prebuild hook

* remove crowdin script, bump deps

* re-add cli/usage

* update package-lock.json

* add translation sync to build.sh for master

* update README

* add ja to localesNotBuilding, write e-ids

* fix formatting

* get on sync with master

* replace check for master branch

* change build script to work on travis

* use refs instead of names

* fix build.sh

* replace head ref check with channel check

* get stable channel in build.sh

* remove zip

* remove header ids

Co-authored-by: rmshea <8948187+rmshea@users.noreply.github.com>
This commit is contained in:
Tim Hagn
2021-05-28 06:21:37 +02:00
committed by GitHub
parent e833d2ba5b
commit 53c91ee89e
171 changed files with 15824 additions and 26701 deletions

View File

@@ -1,38 +1,45 @@
---
title: Solana Test Validator
---
During early stage development, it is often convenient to target a cluster with
fewer restrictions and more configuration options than the public offerings
provide. This is easily achieved with the `solana-test-validator` binary, which
starts a full-featured, single-node cluster on the developer's workstation.
## Advantages
- No RPC rate-limits
- No airdrop limits
- Direct [on-chain program](on-chain-programs/overview) deployment
(`--bpf-program ...`)
(`--bpf-program ...`)
- Clone accounts from a public cluster, including programs (`--clone ...`)
- Configurable transaction history retention (`--limit-ledger-size ...`)
- Configurable epoch length (`--slots-per-epoch ...`)
- Jump to an arbitrary slot (`--warp-slot ...`)
## Installation
The `solana-test-validator` binary ships with the Solana CLI Tool Suite.
[Install](/cli/install-solana-cli-tools) before continuing.
## Running
First take a look at the configuration options
```
solana-test-validator --help
```
Next start the test validator
```
solana-test-validator
```
By default, basic status information is printed while the process is running.
See [Appendix I](#appendix-i-status-output) for details
```
Ledger location: test-ledger
Log: test-ledger/validator.log
@@ -50,80 +57,96 @@ Leave `solana-test-validator` running in its own terminal. When it is no longer
needed, it can be stopped with ctrl-c.
## Interacting
Open a new terminal to interact with a [running](#running) `solana-test-validator`
instance using other binaries from the Solana CLI Tool Suite or your own client
software.
#### Configure the CLI Tool Suite to target a local cluster by default
```
solana config set --url http://127.0.0.1:8899
```
#### Verify the CLI Tool Suite configuration
```
solana genesis-hash
```
* **NOTE:** The result should match the `Genesis Hash:` field in the
`solana-test-validator` status output
- **NOTE:** The result should match the `Genesis Hash:` field in the
`solana-test-validator` status output
#### Check the wallet balance
```
solana balance
```
* **NOTE:** `Error: No such file or directory (os error 2)` means that the default
wallet does not yet exist. Create it with `solana-keygen new`.
* **NOTE:** If the wallet has a zero SOL balance, airdrop some localnet SOL with
`solana airdrop 10`
- **NOTE:** `Error: No such file or directory (os error 2)` means that the default
wallet does not yet exist. Create it with `solana-keygen new`.
- **NOTE:** If the wallet has a zero SOL balance, airdrop some localnet SOL with
`solana airdrop 10`
#### Perform a basic transfer transaction
```
solana transfer EPhgPANa5Rh2wa4V2jxt7YbtWa3Uyw4sTeZ13cQjDDB8 1
```
#### Monitor `msg!()` output from on-chain programs
```
solana logs
```
* **NOTE:** This command needs to be running when the target transaction is
executed. Run it in its own terminal
- **NOTE:** This command needs to be running when the target transaction is
executed. Run it in its own terminal
## Appendix I: Status Output
```
Ledger location: test-ledger
```
* File path of the ledger storage directory. This directory can get large. Store
less transaction history with `--limit-ledger-size ...` or relocate it with
`--ledger ...`
- File path of the ledger storage directory. This directory can get large. Store
less transaction history with `--limit-ledger-size ...` or relocate it with
`--ledger ...`
```
Log: test-ledger/validator.log
```
* File path of the validator text log file. The log can also be streamed by
passing `--log`. Status output is suppressed in this case.
- File path of the validator text log file. The log can also be streamed by
passing `--log`. Status output is suppressed in this case.
```
Identity: EPhgPANa5Rh2wa4V2jxt7YbtWa3Uyw4sTeZ13cQjDDB8
```
* The validator's identity in the [gossip network](/validator/gossip#gossip-overview)
- The validator's identity in the [gossip network](/validator/gossip#gossip-overview)
```
Version: 1.6.7
```
* The software version
- The software version
```
Gossip Address: 127.0.0.1:1024
TPU Address: 127.0.0.1:1027
JSON RPC URL: http://127.0.0.1:8899
```
* The network address of the [Gossip](/validator/gossip#gossip-overview),
[Transaction Processing Unit](/validator/tpu) and [JSON RPC](clients/jsonrpc-api#json-rpc-api-reference)
service, respectively
- The network address of the [Gossip](/validator/gossip#gossip-overview),
[Transaction Processing Unit](/validator/tpu) and [JSON RPC](clients/jsonrpc-api#json-rpc-api-reference)
service, respectively
```
⠈ 00:36:02 | Processed Slot: 5142 | Confirmed Slot: 5142 | Finalized Slot: 5110 | Snapshot Slot: 5100 | Transactions: 5142 | ◎499.974295000
```
* Session running time, current slot of the the three block
[commitment levels](clients/jsonrpc-api#configuring-state-commitment),
slot height of the last snapshot, transaction count,
[voting authority](/running-validator/vote-accounts#vote-authority) balance
- Session running time, current slot of the the three block
[commitment levels](clients/jsonrpc-api#configuring-state-commitment),
slot height of the last snapshot, transaction count,
[voting authority](/running-validator/vote-accounts#vote-authority) balance