Skip to content

Commit

Permalink
Add localized files
Browse files Browse the repository at this point in the history
  • Loading branch information
Adrien committed Jan 13, 2024
1 parent 864ecb8 commit 74b3332
Show file tree
Hide file tree
Showing 106 changed files with 8,095 additions and 0 deletions.
404 changes: 404 additions & 0 deletions i18n/fr/code.json

Large diffs are not rendered by default.

Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
---
slug: first-blog-post
title: First Blog Post
authors:
name: Gao Wei
title: Docusaurus Core Team
url: https://github.com/wgao19
image_url: https://github.com/wgao19.png
tags: [hola, docusaurus]
---

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
---
slug: long-blog-post
title: Long Blog Post
authors: endi
tags: [hello, docusaurus]
---

This is the summary of a very long blog post,

Use a `<!--` `truncate` `-->` comment to limit blog post size in the list view.

<!--truncate-->

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
---
slug: mdx-blog-post
title: MDX Blog Post
authors: [slorber]
tags: [docusaurus]
---

Blog posts support [Docusaurus Markdown features](https://docusaurus.io/docs/markdown-features), such as [MDX](https://mdxjs.com/).

:::tip

Use the power of React to create interactive blog posts.

```js
<button onClick={() => alert('button clicked!')}>Click me!</button>
```

<button onClick={() => alert('button clicked!')}>Click me!</button>

:::
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
25 changes: 25 additions & 0 deletions i18n/fr/docusaurus-plugin-content-blog/2021-08-26-welcome/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
---
slug: welcome
title: Welcome
authors: [slorber, yangshun]
tags: [facebook, hello, docusaurus]
---

[Docusaurus blogging features](https://docusaurus.io/docs/blog) are powered by the [blog plugin](https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-content-blog).

Simply add Markdown files (or folders) to the `blog` directory.

Regular blog authors can be added to `authors.yml`.

The blog post date can be extracted from filenames, such as:

- `2019-05-30-welcome.md`
- `2019-05-30-welcome/index.md`

A blog post folder can be convenient to co-locate blog post images:

![Docusaurus Plushie](./docusaurus-plushie-banner.jpeg)

The blog supports tags as well!

**And if you don't want a blog**: just delete this directory, and use `blog: false` in your Docusaurus config.
17 changes: 17 additions & 0 deletions i18n/fr/docusaurus-plugin-content-blog/authors.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
endi:
name: Endilie Yacop Sucipto
title: Maintainer of Docusaurus
url: https://github.com/endiliey
image_url: https://github.com/endiliey.png

yangshun:
name: Yangshun Tay
title: Front End Engineer @ Facebook
url: https://github.com/yangshun
image_url: https://github.com/yangshun.png

slorber:
name: Sébastien Lorber
title: Docusaurus maintainer
url: https://sebastienlorber.com
image_url: https://github.com/slorber.png
14 changes: 14 additions & 0 deletions i18n/fr/docusaurus-plugin-content-blog/options.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
{
"title": {
"message": "Blog",
"description": "The title for the blog used in SEO"
},
"description": {
"message": "Blog",
"description": "The description for the blog used in SEO"
},
"sidebar.title": {
"message": "Recent posts",
"description": "The label for the left sidebar"
}
}
94 changes: 94 additions & 0 deletions i18n/fr/docusaurus-plugin-content-docs/current.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,94 @@
{
"version.label": {
"message": "Next",
"description": "The label for version current"
},
"sidebar.massaStationSidebar.category.Setup": {
"message": "Setup",
"description": "The label for category Setup in sidebar massaStationSidebar"
},
"sidebar.massaStationSidebar.category.Massa Wallet": {
"message": "Massa Wallet",
"description": "The label for category Massa Wallet in sidebar massaStationSidebar"
},
"sidebar.learnSidebar.category.Node Architecture": {
"message": "Node Architecture",
"description": "The label for category Node Architecture in sidebar learnSidebar"
},
"sidebar.buildSidebar.category.Smart Contract": {
"message": "Smart Contract",
"description": "The label for category Smart Contract in sidebar buildSidebar"
},
"sidebar.buildSidebar.category.Develop": {
"message": "Develop",
"description": "The label for category Develop in sidebar buildSidebar"
},
"sidebar.buildSidebar.category.Wallets": {
"message": "Wallets",
"description": "The label for category Wallets in sidebar buildSidebar"
},
"sidebar.buildSidebar.category.Massa-Web3": {
"message": "Massa-Web3",
"description": "The label for category Massa-Web3 in sidebar buildSidebar"
},
"sidebar.buildSidebar.category.Networks & Faucets": {
"message": "Networks & Faucets",
"description": "The label for category Networks & Faucets in sidebar buildSidebar"
},
"sidebar.buildSidebar.category.API": {
"message": "API",
"description": "The label for category API in sidebar buildSidebar"
},
"sidebar.buildSidebar.doc.Introduction": {
"message": "Introduction",
"description": "The label for the doc item Introduction in sidebar buildSidebar, linking to the doc build/smart-contract/intro"
},
"sidebar.buildSidebar.doc.WebAssembly Module": {
"message": "WebAssembly Module",
"description": "The label for the doc item WebAssembly Module in sidebar buildSidebar, linking to the doc build/smart-contract/sdk"
},
"sidebar.nodeSidebar.doc.Home": {
"message": "Home",
"description": "The label for the doc item Home in sidebar nodeSidebar, linking to the doc node/home"
},
"sidebar.nodeSidebar.doc.Installing a node": {
"message": "Installing a node",
"description": "The label for the doc item Installing a node in sidebar nodeSidebar, linking to the doc node/install"
},
"sidebar.nodeSidebar.doc.Routability": {
"message": "Routability",
"description": "The label for the doc item Routability in sidebar nodeSidebar, linking to the doc node/routability"
},
"sidebar.nodeSidebar.doc.Running a node": {
"message": "Running a node",
"description": "The label for the doc item Running a node in sidebar nodeSidebar, linking to the doc node/run"
},
"sidebar.nodeSidebar.doc.Creating a wallet": {
"message": "Creating a wallet",
"description": "The label for the doc item Creating a wallet in sidebar nodeSidebar, linking to the doc node/wallet"
},
"sidebar.nodeSidebar.doc.Staking": {
"message": "Staking",
"description": "The label for the doc item Staking in sidebar nodeSidebar, linking to the doc node/stake"
},
"sidebar.nodeSidebar.doc.Checking the node's status": {
"message": "Checking the node's status",
"description": "The label for the doc item Checking the node's status in sidebar nodeSidebar, linking to the doc node/check_status"
},
"sidebar.nodeSidebar.doc.Node and client configuration": {
"message": "Node and client configuration",
"description": "The label for the doc item Node and client configuration in sidebar nodeSidebar, linking to the doc node/all-configs"
},
"sidebar.nodeSidebar.doc.Initial node runners": {
"message": "Initial node runners",
"description": "The label for the doc item Initial node runners in sidebar nodeSidebar, linking to the doc node/initial"
},
"sidebar.nodeSidebar.doc.Frequently Asked Questions": {
"message": "Frequently Asked Questions",
"description": "The label for the doc item Frequently Asked Questions in sidebar nodeSidebar, linking to the doc node/faq"
},
"sidebar.nodeSidebar.doc.Tutorials and community resources": {
"message": "Tutorials and community resources",
"description": "The label for the doc item Tutorials and community resources in sidebar nodeSidebar, linking to the doc node/community-resources"
}
}
105 changes: 105 additions & 0 deletions i18n/fr/docusaurus-plugin-content-docs/current/build/api/grpc.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,105 @@
---
id: grpc
sidebar_label: gRPC
---

# Massa gRPC API

The [gRPC](https://grpc.io/) API allows you to communicate with the Massa blockchain.

The Massa gRPC API is splitted in two parts:

- **Public API**: used for blockchain interactions. Default port:
33037 e.g. <grpc://localhost:33037>
- **Private API**: used for node management. Default port: 33038 e.g.
<grpc://localhost:33038>

:::info
To enable events (blocks, endorsements, operations...) brodcast via gRPC streams in your Massa node, add or edit the file
`massa-node/config/config.toml` with the following content:

```toml
[api]
# whether to broadcast for blocks, endorsement and operations
enable_broadcast = true
```
:::

## Documentation

- gRPC **API** [documentation](https://htmlpreview.github.io/?https://github.com/massalabs/massa-proto/blob/main/doc/api.html).
- gRPC **Commons** [documentation](https://htmlpreview.github.io/?https://github.com/massalabs/massa-proto/blob/main/doc/commons.html).
- gRPC **API** [specification](https://github.com/massalabs/massa-proto/tree/main/proto/apis/massa/api/v1).

## Integrations

- **Postman**: You can find our Massa Postman collections on our official
[workspace](https://www.postman.com/massalabs).
- **Massa proto rs**: is a Rust library which contains generated code from Massa protobuf files. See
[massa-proto-rs](https://github.com/massalabs/massa-proto-rs).

## Code generation

**Step 1: Clone `massa-proto` repository**

```shell
git clone -b MASSA_PROTO_TAG https://github.com/massalabs/massa-proto.git --depth 1
```

:::note
If you are using an older version of the Massa node, please use the tag version or commit hash corresponding to your node version.
Find all `massa-proto` tags [here](https://github.com/massalabs/massa-proto/tags).
:::

**Step 2: Install Buf CLI**

1. Download the latest version of Buf CLI from the [official website](https://docs.buf.build/installation).
2. Extract the downloaded file to a folder on your computer.
3. Add the buf binary to your system PATH environment variable.

**Step 3: Set up Buf**

1. Add the following content to `buf.work.yml`:

```yaml
version: v1
directories:
- proto/apis
- proto/commons
- proto/third_party
```

By specifying the directories in the configuration file, Buf knows which
[.proto]{.title-ref} files to include in the build process.

1. Create a file called `buf.gen.yml` and add the following content:

```yaml
version: v1
managed:
enabled: true
plugins:
- remote: buf.build/community/timostamm-protobuf-ts:v2.9.0
out: gen/ts
```

The configuration uses the official [timostamm-protobuf-ts](https://buf.build/community/timostamm-protobuf-ts)
plugin to generate gRPC client and classes in TypeScript.

:::info
For other languages check the complete list of [official Buf plugins](https://buf.build/plugins).
:::

**Step 4: Generate gRPC client/classes in TypeScript**

1. Launch the code generation:

```yaml
buf generate
```

2. Install the required dependencies for the generated code to your project:

```shell
npm install @protobuf-ts/runtime@^2.9.0 @protobuf-ts/runtime-rpc@^2.9.0
```
Loading

0 comments on commit 74b3332

Please sign in to comment.