+ gRPC is a modern open source high performance RPC framework that can
+ run in any environment. It can efficiently connect services in and
+ across data centers with pluggable support for load balancing,
+ tracing, health checking and authentication. It is also applicable
+ in last mile of distributed computing to connect devices, mobile
+ applications and browsers to backend services.
+
+
gRPC is a modern open source high performance RPC framework that can run in any
environment. It can efficiently connect services in and across data centers with
pluggable support for load balancing, tracing, health checking and
authentication. It is also applicable in last mile of distributed computing to
connect devices, mobile applications and browsers to backend services.
+
+
### The main usage scenarios
* Efficiently connecting polyglot services in microservices style architecture
@@ -31,7 +45,9 @@ Below are details and quotes from some of our early adopters.
Check out what people are saying below.
+
{{< testimonials >}}
+
## The story behind gRPC
@@ -46,9 +62,16 @@ Google to power use cases from microservices to the "last mile" of computing
For more background on why we created gRPC, see the [gRPC Motivation and Design
Principles](/blog/principles/) on the [gRPC blog](/blog/).
-{{< note >}}
-
+{{< alert title="Note" color="info" >}}
+
- Our table of **officially supported languages and platforms** has moved!
- See [Official support](/docs/#official-support).
-{{< /note >}}
+Our table of **officially supported languages and platforms** has moved!
+See [Official support](/docs/#official-support).
+{{< /alert >}}
+
+
+
+{{< page/toc placement="sidebar" >}}
+
+
+
diff --git a/content/blog/_index.md b/content/en/blog/_index.md
similarity index 100%
rename from content/blog/_index.md
rename to content/en/blog/_index.md
diff --git a/content/blog/a-short-introduction-to-channelz.md b/content/en/blog/a-short-introduction-to-channelz.md
similarity index 100%
rename from content/blog/a-short-introduction-to-channelz.md
rename to content/en/blog/a-short-introduction-to-channelz.md
diff --git a/content/blog/bazel-rules-protobuf.md b/content/en/blog/bazel-rules-protobuf.md
similarity index 100%
rename from content/blog/bazel-rules-protobuf.md
rename to content/en/blog/bazel-rules-protobuf.md
diff --git a/content/blog/beta-release.md b/content/en/blog/beta-release.md
similarity index 100%
rename from content/blog/beta-release.md
rename to content/en/blog/beta-release.md
diff --git a/content/blog/cmake-improvements.md b/content/en/blog/cmake-improvements.md
similarity index 100%
rename from content/blog/cmake-improvements.md
rename to content/en/blog/cmake-improvements.md
diff --git a/content/blog/community-meeting-update.md b/content/en/blog/community-meeting-update.md
similarity index 100%
rename from content/blog/community-meeting-update.md
rename to content/en/blog/community-meeting-update.md
diff --git a/content/blog/coreos.md b/content/en/blog/coreos.md
similarity index 100%
rename from content/blog/coreos.md
rename to content/en/blog/coreos.md
diff --git a/content/blog/deadlines.md b/content/en/blog/deadlines.md
similarity index 100%
rename from content/blog/deadlines.md
rename to content/en/blog/deadlines.md
diff --git a/content/blog/ga-announcement.md b/content/en/blog/ga-announcement.md
similarity index 100%
rename from content/blog/ga-announcement.md
rename to content/en/blog/ga-announcement.md
diff --git a/content/blog/graceful-cleanup-junit-tests.md b/content/en/blog/graceful-cleanup-junit-tests.md
similarity index 100%
rename from content/blog/graceful-cleanup-junit-tests.md
rename to content/en/blog/graceful-cleanup-junit-tests.md
diff --git a/content/blog/grpc-cloud-run.md b/content/en/blog/grpc-cloud-run.md
similarity index 100%
rename from content/blog/grpc-cloud-run.md
rename to content/en/blog/grpc-cloud-run.md
diff --git a/content/blog/grpc-dotnet-build.md b/content/en/blog/grpc-dotnet-build.md
similarity index 100%
rename from content/blog/grpc-dotnet-build.md
rename to content/en/blog/grpc-dotnet-build.md
diff --git a/content/blog/grpc-flatbuffers.md b/content/en/blog/grpc-flatbuffers.md
similarity index 100%
rename from content/blog/grpc-flatbuffers.md
rename to content/en/blog/grpc-flatbuffers.md
diff --git a/content/blog/grpc-go-engineering-practices.md b/content/en/blog/grpc-go-engineering-practices.md
similarity index 100%
rename from content/blog/grpc-go-engineering-practices.md
rename to content/en/blog/grpc-go-engineering-practices.md
diff --git a/content/blog/grpc-go-perf-improvements.md b/content/en/blog/grpc-go-perf-improvements.md
similarity index 100%
rename from content/blog/grpc-go-perf-improvements.md
rename to content/en/blog/grpc-go-perf-improvements.md
diff --git a/content/blog/grpc-js-1.0.md b/content/en/blog/grpc-js-1.0.md
similarity index 100%
rename from content/blog/grpc-js-1.0.md
rename to content/en/blog/grpc-js-1.0.md
diff --git a/content/blog/grpc-load-balancing.md b/content/en/blog/grpc-load-balancing.md
similarity index 100%
rename from content/blog/grpc-load-balancing.md
rename to content/en/blog/grpc-load-balancing.md
diff --git a/content/blog/grpc-on-dotnetcore.md b/content/en/blog/grpc-on-dotnetcore.md
similarity index 100%
rename from content/blog/grpc-on-dotnetcore.md
rename to content/en/blog/grpc-on-dotnetcore.md
diff --git a/content/blog/grpc-on-http2.md b/content/en/blog/grpc-on-http2.md
similarity index 100%
rename from content/blog/grpc-on-http2.md
rename to content/en/blog/grpc-on-http2.md
diff --git a/content/blog/grpc-stacks.md b/content/en/blog/grpc-stacks.md
similarity index 100%
rename from content/blog/grpc-stacks.md
rename to content/en/blog/grpc-stacks.md
diff --git a/content/blog/grpc-web-ga.md b/content/en/blog/grpc-web-ga.md
similarity index 100%
rename from content/blog/grpc-web-ga.md
rename to content/en/blog/grpc-web-ga.md
diff --git a/content/blog/grpc-web-interceptor.md b/content/en/blog/grpc-web-interceptor.md
similarity index 98%
rename from content/blog/grpc-web-interceptor.md
rename to content/en/blog/grpc-web-interceptor.md
index d6d42b1..a1d1bce 100644
--- a/content/blog/grpc-web-interceptor.md
+++ b/content/en/blog/grpc-web-interceptor.md
@@ -47,10 +47,10 @@ The `StreamInterceptor` interface declaration is similar, except that the
`invoker` return type is `ClientReadableStream` instead of `Promise`. For
implementation details, see [interceptor.js][].
-{{< note >}}
+{{< alert title="Note" color="info" >}}
A `StreamInterceptor` can be applied to any RPC with a `ClientReadableStream`
return type, whether it's a unary or a server-streaming RPC.
-{{< /note >}}
+{{< /alert >}}
## What can I do with an interceptor?
@@ -182,12 +182,12 @@ const client = new MyServiceClient(
host, creds, {'streamInterceptors': [interceptor1, interceptor2, interceptor3]});
```
-{{< note >}}
+{{< alert title="Note" color="info" >}}
Interceptors are executed in reverse order for request processing, and in
order for response processing, as illustrated here:
-{{< /note >}}
+{{< /alert >}}
## Feedback
diff --git a/content/blog/grpc-with-json.md b/content/en/blog/grpc-with-json.md
similarity index 100%
rename from content/blog/grpc-with-json.md
rename to content/en/blog/grpc-with-json.md
diff --git a/content/blog/hello-pancakes.md b/content/en/blog/hello-pancakes.md
similarity index 100%
rename from content/blog/hello-pancakes.md
rename to content/en/blog/hello-pancakes.md
diff --git a/content/blog/helm-grpc.md b/content/en/blog/helm-grpc.md
similarity index 100%
rename from content/blog/helm-grpc.md
rename to content/en/blog/helm-grpc.md
diff --git a/content/blog/installation.md b/content/en/blog/installation.md
similarity index 100%
rename from content/blog/installation.md
rename to content/en/blog/installation.md
diff --git a/content/blog/kotlin-gradle-projects.md b/content/en/blog/kotlin-gradle-projects.md
similarity index 100%
rename from content/blog/kotlin-gradle-projects.md
rename to content/en/blog/kotlin-gradle-projects.md
diff --git a/content/blog/kotlin-meet-grpc.md b/content/en/blog/kotlin-meet-grpc.md
similarity index 100%
rename from content/blog/kotlin-meet-grpc.md
rename to content/en/blog/kotlin-meet-grpc.md
diff --git a/content/blog/meetup-kit.md b/content/en/blog/meetup-kit.md
similarity index 100%
rename from content/blog/meetup-kit.md
rename to content/en/blog/meetup-kit.md
diff --git a/content/blog/mobile-benchmarks.md b/content/en/blog/mobile-benchmarks.md
similarity index 100%
rename from content/blog/mobile-benchmarks.md
rename to content/en/blog/mobile-benchmarks.md
diff --git a/content/blog/optimizing-grpc-part-1.md b/content/en/blog/optimizing-grpc-part-1.md
similarity index 100%
rename from content/blog/optimizing-grpc-part-1.md
rename to content/en/blog/optimizing-grpc-part-1.md
diff --git a/content/blog/optimizing-grpc-part-2.md b/content/en/blog/optimizing-grpc-part-2.md
similarity index 100%
rename from content/blog/optimizing-grpc-part-2.md
rename to content/en/blog/optimizing-grpc-part-2.md
diff --git a/content/blog/principles.md b/content/en/blog/principles.md
similarity index 100%
rename from content/blog/principles.md
rename to content/en/blog/principles.md
diff --git a/content/blog/pubsub.md b/content/en/blog/pubsub.md
similarity index 100%
rename from content/blog/pubsub.md
rename to content/en/blog/pubsub.md
diff --git a/content/blog/state-of-grpc-web.md b/content/en/blog/state-of-grpc-web.md
similarity index 100%
rename from content/blog/state-of-grpc-web.md
rename to content/en/blog/state-of-grpc-web.md
diff --git a/content/blog/take-the-grpc-survey.md b/content/en/blog/take-the-grpc-survey.md
similarity index 100%
rename from content/blog/take-the-grpc-survey.md
rename to content/en/blog/take-the-grpc-survey.md
diff --git a/content/blog/vendasta.md b/content/en/blog/vendasta.md
similarity index 100%
rename from content/blog/vendasta.md
rename to content/en/blog/vendasta.md
diff --git a/content/blog/vsco.md b/content/en/blog/vsco.md
similarity index 100%
rename from content/blog/vsco.md
rename to content/en/blog/vsco.md
diff --git a/content/blog/wireshark.md b/content/en/blog/wireshark.md
similarity index 99%
rename from content/blog/wireshark.md
rename to content/en/blog/wireshark.md
index 7533685..433f83e 100644
--- a/content/blog/wireshark.md
+++ b/content/en/blog/wireshark.md
@@ -41,14 +41,14 @@ This post focuses on the analysis of captured gRPC messages. To learn how to
store network traffic in _capture files_, see the [Capturing Live Network
Data][] section of the [Wireshark User’s Guide][].
-{{}}
+{{< alert title="Note" color="info" >}}
Currently, only **plain text** gRPC messages can be parsed by Wireshark. While
[Wireshark supports TLS dissection][], it requires per-session secret keys. As
of the time of writing, gRPC libraries do not support the exporting of such
keys.
[Wireshark supports TLS dissection]: https://gitlab.com/wireshark/wireshark/-/wikis/tls
-{{}}
+{{}}
## Examples
diff --git a/content/blog/yikyak.md b/content/en/blog/yikyak.md
similarity index 100%
rename from content/blog/yikyak.md
rename to content/en/blog/yikyak.md
diff --git a/content/community.md b/content/en/community/_index.md
similarity index 86%
rename from content/community.md
rename to content/en/community/_index.md
index 7cf3717..33b9839 100644
--- a/content/community.md
+++ b/content/en/community/_index.md
@@ -2,21 +2,35 @@
title: Community
---
+{{< blocks/cover color="primary" height="sm" >}}
+{{< page/header >}}
+{{< /blocks/cover >}}
+
+
+
gRPC has an active community of developers who are using, enhancing, and building valuable integrations with other software projects. We'd love your help to improve and extend the project. You can reach us via the [Mailing List](https://groups.google.com/forum/#!forum/grpc-io), [Gitter channel](https://gitter.im/grpc/grpc), or [Twitter](https://twitter.com/grpcio) to start engaging with the project and its members.
+
+
## Contribute on GitHub
gRPC has an active community of developers who are using, enhancing and building valuable integrations with other software projects. We are always looking for active contributors in gRPC and gRPC Ecosystem. Here are a few areas where we would love community contribution in grpc project. Be sure to follow our [community addition guidelines](/contribute/).
-## [gRPC C-based](https://github.com/grpc/grpc/labels/disposition%2Fhelp%20wanted)
+### [gRPC C-based](https://github.com/grpc/grpc/labels/disposition%2Fhelp%20wanted)
Or shortcut to [C](https://github.com/grpc/grpc/issues?q=is%3Aopen+is%3Aissue+label%3Aarea%2Fcore+label%3A%22disposition%2Fhelp+wanted%22), [C++](https://github.com/grpc/grpc/issues?q=is%3Aopen+is%3Aissue+label%3A%22disposition%2Fhelp+wanted%22+label%3Alang%2Fc%2B%2B), [Node.js](https://github.com/grpc/grpc/issues?q=is%3Aopen+is%3Aissue+label%3A%22disposition%2Fhelp+wanted%22+label%3Alang%2Fnode), [Python](https://github.com/grpc/grpc/issues?q=is%3Aopen+is%3Aissue+label%3A%22disposition%2Fhelp+wanted%22+label%3Alang%2FPython), [Ruby](https://github.com/grpc/grpc/issues?q=is%3Aopen+is%3Aissue+label%3A%22disposition%2Fhelp+wanted%22+label%3Alang%2Fruby), [Objective-C](https://github.com/grpc/grpc/issues?q=is%3Aopen+is%3Aissue+label%3A%22disposition%2Fhelp+wanted%22+label%3Alang%2FObjC), [PHP](https://github.com/grpc/grpc/issues?q=is%3Aopen+is%3Aissue+label%3A%22disposition%2Fhelp+wanted%22+label%3Alang%2Fphp), and [C#](https://github.com/grpc/grpc/issues?utf8=%E2%9C%93&q=is%3Aopen+is%3Aissue+label%3A%22disposition%2Fhelp+wanted%22+label%3Alang%2Fc%23+).
-## [gRPC Java](https://github.com/grpc/grpc-java/labels/help%20wanted)
+### [gRPC Java](https://github.com/grpc/grpc-java/labels/help%20wanted)
For Android Java and Java.
-## [gRPC Go](https://github.com/grpc/grpc-go/labels/Status:%20help%20wanted)
+### [gRPC Go](https://github.com/grpc/grpc-go/labels/Status:%20help%20wanted)
For the Go implementation.
@@ -41,3 +55,10 @@ Join the [subreddit](https://www.reddit.com/r/grpc/).
## Community meetings
We hold a community video conference every other week. It's a way to discuss the status of work and show off things the community is working on. Meeting information and notes can be found at [bit.ly/grpcmeetings](https://bit.ly/grpcmeetings).
+
+
+
+{{< page/toc placement="sidebar" >}}
+
+
+
diff --git a/content/contribute.md b/content/en/contribute.md
similarity index 79%
rename from content/contribute.md
rename to content/en/contribute.md
index 8b353a5..e8e856c 100644
--- a/content/contribute.md
+++ b/content/en/contribute.md
@@ -2,6 +2,23 @@
title: Contributing to gRPC
---
+{{< blocks/cover height="sm" color="primary" >}}
+{{< page/header >}}
+{{< /blocks/cover >}}
+
+
+
+
+
+
+{{< page/toc collapsed=true >}}
+
+
+
+
+
+
+
To contribute to gRPC documentation, please fork the [gRPC repository on GitHub](https://github.com/grpc/grpc.io) and start submitting pull requests.
## Contribute guidelines for gRPC
@@ -14,18 +31,37 @@ We welcome contributions to any of our three core repositories:
{{< button text="View guidelines" url="https://github.com/grpc/grpc/blob/master/CONTRIBUTING.md" >}}
+
+
+
## Contribution guidelines for the gRPC Ecosystem
The [gRPC Ecosystem](https://github.com/grpc-ecosystem/) is a different organization where we collect and curate valuable integrations of other projects with gRPC. You can propose a new project for it by filling out the **Propose new project** form.
{{< button text="View guidelines" url="https://github.com/grpc/grpc-contrib/blob/master/CONTRIBUTING.md" >}}
+
+
+
## Edit our site on GitHub
Click the below button to visit the repo for our site. You can then click the "Fork" button in the upper-right area of the screen to create a copy of our site on your GitHub account called a "fork." Make any changes you want in your fork, and when you are ready to send those changes to us, go to the index page for your fork and click **New Pull Request** to let us know about it.
{{< button text="Browse this site's source code" url="https://github.com/grpc/grpc.io" >}}
+
+
+
## Being a member of the gRPC organization on github
Being an organization member is not required for the vast majority of the contributions. Membership is required for certain administrative tasks such as accepting a pull request, or closing issues. If you wish to be part of the gRPC organization on github, please [get in touch with us](/community/). Please note that in order to be part of the organization, your GitHub account needs to have [two-factor authentication enabled](https://help.github.com/articles/securing-your-account-with-two-factor-authentication-2fa/).
+
+
+
+
+
+{{< page/toc >}}
+
+
+
+
diff --git a/content/docs/_index.md b/content/en/docs/_index.md
similarity index 98%
rename from content/docs/_index.md
rename to content/en/docs/_index.md
index c84f5a5..aadb311 100644
--- a/content/docs/_index.md
+++ b/content/en/docs/_index.md
@@ -1,5 +1,6 @@
---
title: Documentation
+no_list: true
---
Learn about key gRPC concepts, try a quick start, find tutorials and reference
diff --git a/content/docs/guides/_index.md b/content/en/docs/guides/_index.md
similarity index 65%
rename from content/docs/guides/_index.md
rename to content/en/docs/guides/_index.md
index 0853649..9c0eb9b 100644
--- a/content/docs/guides/_index.md
+++ b/content/en/docs/guides/_index.md
@@ -6,7 +6,3 @@ nav_children: pages
---
The documentation covers the following techniques:
-
-- [Authentication](auth/)
-- [Benchmarking](benchmarking/)
-- [Error handling](error/)
diff --git a/content/docs/guides/auth.md b/content/en/docs/guides/auth.md
similarity index 99%
rename from content/docs/guides/auth.md
rename to content/en/docs/guides/auth.md
index 499d149..74cf9bf 100644
--- a/content/docs/guides/auth.md
+++ b/content/en/docs/guides/auth.md
@@ -44,11 +44,11 @@ The following authentication mechanisms are built-in to gRPC:
most gRPC language implementations will not let you send credentials on an
unencrypted channel.
-{{< warning >}}
+{{< alert title="Warning" color="warning" >}}
Google credentials should only be used to connect to Google services. Sending
a Google issued OAuth2 token to a non-Google service could result in this
token being stolen and used to impersonate the client to Google services.
-{{< /warning >}}
+{{< /alert >}}
### Authentication API
diff --git a/content/docs/guides/benchmarking.md b/content/en/docs/guides/benchmarking.md
similarity index 98%
rename from content/docs/guides/benchmarking.md
rename to content/en/docs/guides/benchmarking.md
index c374102..61d906d 100644
--- a/content/docs/guides/benchmarking.md
+++ b/content/en/docs/guides/benchmarking.md
@@ -19,12 +19,13 @@ visualization.
* [Multi-language performance dashboard @master (latest dev version)](https://performance-dot-grpc-testing.appspot.com/explore?dashboard=5652536396611584)
* [C++ detailed performance dashboard @master (latest dev version)](https://performance-dot-grpc-testing.appspot.com/explore?dashboard=5685265389584384)
-{{< note >}}
+{{< alert title="Note" color="info" >}}
Are you seeing "**no data available**" messages in the performance dashboard?
This is a known issue, see [grpc/grpc#23297][].
[grpc/grpc#23297]: https://github.com/grpc/grpc/issues/23297
-{{< /note >}}
+
+{{< /alert >}}
### Performance testing design
diff --git a/content/docs/guides/error.md b/content/en/docs/guides/error.md
similarity index 100%
rename from content/docs/guides/error.md
rename to content/en/docs/guides/error.md
diff --git a/content/docs/languages/_index.md b/content/en/docs/languages/_index.md
similarity index 54%
rename from content/docs/languages/_index.md
rename to content/en/docs/languages/_index.md
index fe216ba..403d940 100644
--- a/content/docs/languages/_index.md
+++ b/content/en/docs/languages/_index.md
@@ -1,8 +1,10 @@
---
title: Supported languages
-short: Languages
+short_title: Languages
weight: 2
nav_children: section
+notoc: true
+simple_list: true
---
Each gRPC language / [platform][] has links to the following pages and more:
@@ -13,16 +15,4 @@ Each gRPC language / [platform][] has links to the following pages and more:
Select a language to get started:
-- [C# / .NET](csharp/)
-- [C++](cpp/)
-- [Dart](dart/)
-- [Go](go/)
-- [Java](java/)
-- [Kotlin/JVM](kotlin/)
-- [Node.js](node/)
-- [Objective-C](objective-c/)
-- [PHP](php/)
-- [Python](python/)
-- [Ruby](ruby/)
-
[platform]: {{< relref "platforms" >}}
diff --git a/content/docs/languages/cpp/_index.md b/content/en/docs/languages/cpp/_index.md
similarity index 91%
rename from content/docs/languages/cpp/_index.md
rename to content/en/docs/languages/cpp/_index.md
index 1d17977..29f9e14 100644
--- a/content/docs/languages/cpp/_index.md
+++ b/content/en/docs/languages/cpp/_index.md
@@ -1,6 +1,7 @@
---
title: C++
-layout: prog_lang_home
+prog_lang_home: true
+notoc: true
src_repo: https://github.com/grpc/grpc
content:
- learn_more:
diff --git a/content/docs/languages/cpp/alts.md b/content/en/docs/languages/cpp/alts.md
similarity index 97%
rename from content/docs/languages/cpp/alts.md
rename to content/en/docs/languages/cpp/alts.md
index eca6f74..2fc5ad0 100644
--- a/content/docs/languages/cpp/alts.md
+++ b/content/en/docs/languages/cpp/alts.md
@@ -1,7 +1,6 @@
---
title: ALTS authentication in C++
-short: ALTS
-layout: auth_alts
+short_title: ALTS
description: >
An overview of gRPC authentication in C++ using Application Layer Transport
Security (ALTS).
@@ -58,3 +57,5 @@ code:
context->auth_context(), {"foo@iam.gserviceaccount.com"});
```
---
+
+{{% docs/auth_alts %}}
diff --git a/content/docs/languages/cpp/api.md b/content/en/docs/languages/cpp/api.md
similarity index 87%
rename from content/docs/languages/cpp/api.md
rename to content/en/docs/languages/cpp/api.md
index ea8f670..671d20e 100644
--- a/content/docs/languages/cpp/api.md
+++ b/content/en/docs/languages/cpp/api.md
@@ -1,6 +1,6 @@
---
title: API reference
-short: API
+short_title: API
weight: 90
# Note: this is a placeholder page. The URL to this page redirects elsewhere.
---
diff --git a/content/docs/languages/cpp/async.md b/content/en/docs/languages/cpp/async.md
similarity index 99%
rename from content/docs/languages/cpp/async.md
rename to content/en/docs/languages/cpp/async.md
index 11446ec..1e96de8 100644
--- a/content/docs/languages/cpp/async.md
+++ b/content/en/docs/languages/cpp/async.md
@@ -1,6 +1,6 @@
---
title: Asynchronous-API tutorial
-short: Async-API tutorial
+short_title: Async-API tutorial
weight: 60
spelling: cSpell:ignore classgrpc Impl's
---
diff --git a/content/docs/languages/cpp/basics.md b/content/en/docs/languages/cpp/basics.md
similarity index 99%
rename from content/docs/languages/cpp/basics.md
rename to content/en/docs/languages/cpp/basics.md
index d108ef2..f94d6f2 100644
--- a/content/docs/languages/cpp/basics.md
+++ b/content/en/docs/languages/cpp/basics.md
@@ -357,9 +357,9 @@ address and port we want to connect to - in our case we'll use no SSL:
grpc::CreateChannel("localhost:50051", grpc::InsecureChannelCredentials());
```
-{{< note >}}
+{{< alert title="Note" color="info" >}}
In order to set additional options for the *channel*, use the `grpc::CreateCustomChannel()` api with any special channel arguments - `grpc::ChannelArguments`.
-{{< /note >}}
+{{< /alert >}}
Now we can use the channel to create our stub using the `NewStub` method provided in the `RouteGuide` class we generated from our .proto.
diff --git a/content/docs/languages/cpp/quickstart.md b/content/en/docs/languages/cpp/quickstart.md
similarity index 98%
rename from content/docs/languages/cpp/quickstart.md
rename to content/en/docs/languages/cpp/quickstart.md
index eea9041..5563fd2 100644
--- a/content/docs/languages/cpp/quickstart.md
+++ b/content/en/docs/languages/cpp/quickstart.md
@@ -141,12 +141,11 @@ the steps of the previous section.
$ make -j
```
- {{< note >}}
+ {{< alert title="Note" color="info" >}}
**Getting build failures?** Most issues, at this point, are a result of a
faulty installation. Ensure that the have the right versions of `cmake`, and
carefully recheck your installation.
- {{< /note >}}
-
+ {{< /alert >}}
### Try it!
@@ -342,13 +341,14 @@ from the example **build** directory `examples/cpp/helloworld/cmake/build`:
Greeter received: Hello again world
```
-{{< note >}}
+{{< alert title="Note" color="info" >}}
Interested in an **asynchronous** version of the client and server?
You'll find the `greeter_async_{client,server}.cc` files in the
[example's source directory][src].
[src]: https://github.com/grpc/grpc/tree/master/examples/cpp/helloworld
-{{< /note >}}
+
+{{< /alert >}}
### What's next
diff --git a/content/docs/languages/csharp/_index.md b/content/en/docs/languages/csharp/_index.md
similarity index 95%
rename from content/docs/languages/csharp/_index.md
rename to content/en/docs/languages/csharp/_index.md
index 9b00df2..3f9de2c 100644
--- a/content/docs/languages/csharp/_index.md
+++ b/content/en/docs/languages/csharp/_index.md
@@ -2,7 +2,7 @@
title: C#
description: The original core-library implementation of gRPC for C#
api_path: grpc/LANG/api/Grpc.Core
-layout: prog_lang_home
+prog_lang_home: true
src_repo: https://github.com/grpc/grpc
content:
- learn_more:
@@ -15,4 +15,3 @@ content:
- "[grpc repo]($src_repo_url)"
- "[Daily builds](daily-builds)"
---
-
diff --git a/content/docs/languages/csharp/api.md b/content/en/docs/languages/csharp/api.md
similarity index 87%
rename from content/docs/languages/csharp/api.md
rename to content/en/docs/languages/csharp/api.md
index ea8f670..671d20e 100644
--- a/content/docs/languages/csharp/api.md
+++ b/content/en/docs/languages/csharp/api.md
@@ -1,6 +1,6 @@
---
title: API reference
-short: API
+short_title: API
weight: 90
# Note: this is a placeholder page. The URL to this page redirects elsewhere.
---
diff --git a/content/docs/languages/csharp/basics.md b/content/en/docs/languages/csharp/basics.md
similarity index 100%
rename from content/docs/languages/csharp/basics.md
rename to content/en/docs/languages/csharp/basics.md
diff --git a/content/docs/languages/csharp/daily-builds.md b/content/en/docs/languages/csharp/daily-builds.md
similarity index 100%
rename from content/docs/languages/csharp/daily-builds.md
rename to content/en/docs/languages/csharp/daily-builds.md
diff --git a/content/docs/languages/csharp/dotnet.md b/content/en/docs/languages/csharp/dotnet.md
similarity index 92%
rename from content/docs/languages/csharp/dotnet.md
rename to content/en/docs/languages/csharp/dotnet.md
index 87adebe..96d7172 100644
--- a/content/docs/languages/csharp/dotnet.md
+++ b/content/en/docs/languages/csharp/dotnet.md
@@ -13,10 +13,10 @@ The following pages cover the C# implementation of gRPC for .NET
Several sample applications are available from the [examples][] folder in the
[grpc-dotnet][] repository.
-{{< note >}}
+{{< alert title="Note" color="info" >}}
Looking for gRPC C# core-library documentation?
See the [gRPC C# main page](..).
-{{< /note >}}
+{{< /alert >}}
[examples]: https://github.com/grpc/grpc-dotnet/tree/master/examples
[grpc-dotnet]: https://github.com/grpc/grpc-dotnet
diff --git a/content/docs/languages/csharp/quickstart.md b/content/en/docs/languages/csharp/quickstart.md
similarity index 98%
rename from content/docs/languages/csharp/quickstart.md
rename to content/en/docs/languages/csharp/quickstart.md
index 2501e83..6155147 100644
--- a/content/docs/languages/csharp/quickstart.md
+++ b/content/en/docs/languages/csharp/quickstart.md
@@ -4,12 +4,13 @@ description: This guide gets you started with gRPC in C# with a simple working e
weight: 10
---
-{{< note >}}
+{{< alert title="Note" color="info" >}}
This page uses the [gRPC C# core-library][core-library] implementation. For
documentation covering gRPC for .NET, see [gRPC for .NET](../dotnet/).
[core-library]: https://github.com/grpc/grpc/tree/master/src/csharp
-{{< /note >}}
+
+{{< /alert >}}
### Prerequisites
@@ -55,10 +56,10 @@ From the `examples/csharp/Helloworld` directory:
> dotnet build Greeter.sln
```
-{{< note >}}
+{{< alert title="Note" color="info" >}}
If you want to use gRPC C# from a project that uses the "classic" .csproj files (supported by Visual Studio 2013, 2015 and older versions of Mono), please refer to the
[Greeter using "classic" .csproj](https://github.com/grpc/grpc/blob/{{< param grpc_vers.core >}}/examples/csharp/HelloworldLegacyCsproj/README.md) example.
-{{< /note >}}
+{{< /alert >}}
### Run a gRPC application
diff --git a/content/docs/languages/dart/_index.md b/content/en/docs/languages/dart/_index.md
similarity index 88%
rename from content/docs/languages/dart/_index.md
rename to content/en/docs/languages/dart/_index.md
index 85408ba..3c59adc 100644
--- a/content/docs/languages/dart/_index.md
+++ b/content/en/docs/languages/dart/_index.md
@@ -1,6 +1,7 @@
---
title: Dart
-layout: prog_lang_home
+prog_lang_home: true
+notoc: true
api_path: https://pub.dev/documentation/grpc
content:
- learn_more:
diff --git a/content/docs/languages/dart/api.md b/content/en/docs/languages/dart/api.md
similarity index 87%
rename from content/docs/languages/dart/api.md
rename to content/en/docs/languages/dart/api.md
index ea8f670..671d20e 100644
--- a/content/docs/languages/dart/api.md
+++ b/content/en/docs/languages/dart/api.md
@@ -1,6 +1,6 @@
---
title: API reference
-short: API
+short_title: API
weight: 90
# Note: this is a placeholder page. The URL to this page redirects elsewhere.
---
diff --git a/content/docs/languages/dart/basics.md b/content/en/docs/languages/dart/basics.md
similarity index 100%
rename from content/docs/languages/dart/basics.md
rename to content/en/docs/languages/dart/basics.md
diff --git a/content/docs/languages/dart/quickstart.md b/content/en/docs/languages/dart/quickstart.md
similarity index 99%
rename from content/docs/languages/dart/quickstart.md
rename to content/en/docs/languages/dart/quickstart.md
index 157fd60..bc31171 100644
--- a/content/docs/languages/dart/quickstart.md
+++ b/content/en/docs/languages/dart/quickstart.md
@@ -31,9 +31,9 @@ spelling: cSpell:ignore Iprotos
$ export PATH="$PATH:$HOME/.pub-cache/bin"
```
-{{< note >}}
+{{< alert title="Note" color="info" >}}
Dart gRPC supports the Flutter and Server platforms.
-{{< /note >}}
+{{< /alert >}}
### Get the example code
diff --git a/content/docs/languages/go/_index.md b/content/en/docs/languages/go/_index.md
similarity index 97%
rename from content/docs/languages/go/_index.md
rename to content/en/docs/languages/go/_index.md
index 9fe3caf..05c1b48 100644
--- a/content/docs/languages/go/_index.md
+++ b/content/en/docs/languages/go/_index.md
@@ -1,6 +1,7 @@
---
title: Go
-layout: prog_lang_home
+prog_lang_home: true
+notoc: true
api_path: https://pkg.go.dev/google.golang.org/grpc
content:
- learn_more:
diff --git a/content/docs/languages/go/alts.md b/content/en/docs/languages/go/alts.md
similarity index 96%
rename from content/docs/languages/go/alts.md
rename to content/en/docs/languages/go/alts.md
index 07e25f6..d240079 100644
--- a/content/docs/languages/go/alts.md
+++ b/content/en/docs/languages/go/alts.md
@@ -1,7 +1,6 @@
---
title: ALTS authentication in Go
-short: ALTS
-layout: auth_alts
+short_title: ALTS
description: >
An overview of gRPC authentication in Go using Application Layer Transport
Security (ALTS).
@@ -50,3 +49,5 @@ code:
err := alts.ClientAuthorizationCheck(ctx, []string{"foo@iam.gserviceaccount.com"})
```
---
+
+{{% docs/auth_alts %}}
diff --git a/content/docs/languages/go/api.md b/content/en/docs/languages/go/api.md
similarity index 87%
rename from content/docs/languages/go/api.md
rename to content/en/docs/languages/go/api.md
index ea8f670..671d20e 100644
--- a/content/docs/languages/go/api.md
+++ b/content/en/docs/languages/go/api.md
@@ -1,6 +1,6 @@
---
title: API reference
-short: API
+short_title: API
weight: 90
# Note: this is a placeholder page. The URL to this page redirects elsewhere.
---
diff --git a/content/docs/languages/go/basics.md b/content/en/docs/languages/go/basics.md
similarity index 99%
rename from content/docs/languages/go/basics.md
rename to content/en/docs/languages/go/basics.md
index bfc0ff9..2b0f987 100644
--- a/content/docs/languages/go/basics.md
+++ b/content/en/docs/languages/go/basics.md
@@ -600,10 +600,10 @@ Got message Third message at point(0, 3)
Got message Sixth message at point(0, 3)
```
-{{< note >}}
+{{< alert title="Note" color="info" >}}
We've omitted timestamps from the client and server trace output shown in this
page.
-{{< /note >}}
+{{< /alert >}}
[download]: https://github.com/grpc/grpc-go/archive/{{< param grpc_vers.go >}}.zip
[grpc-go]: https://github.com/grpc/grpc-go
diff --git a/content/docs/languages/go/generated-code.md b/content/en/docs/languages/go/generated-code.md
similarity index 99%
rename from content/docs/languages/go/generated-code.md
rename to content/en/docs/languages/go/generated-code.md
index 85fd41e..3f6d671 100644
--- a/content/docs/languages/go/generated-code.md
+++ b/content/en/docs/languages/go/generated-code.md
@@ -1,6 +1,6 @@
---
title: Go Generated-code reference
-short: Generated code
+short_title: Generated code
weight: 95
---
diff --git a/content/docs/languages/go/quickstart.md b/content/en/docs/languages/go/quickstart.md
similarity index 100%
rename from content/docs/languages/go/quickstart.md
rename to content/en/docs/languages/go/quickstart.md
diff --git a/content/docs/languages/java/_index.md b/content/en/docs/languages/java/_index.md
similarity index 96%
rename from content/docs/languages/java/_index.md
rename to content/en/docs/languages/java/_index.md
index 7f78858..3b180f8 100644
--- a/content/docs/languages/java/_index.md
+++ b/content/en/docs/languages/java/_index.md
@@ -1,6 +1,7 @@
---
title: Java
-layout: prog_lang_home
+prog_lang_home: true
+notoc: true
spelling: cSpell:ignore javadoc Kanti Katirtzis Nikos Sharma Tomo Tuhin youtube Varun
api_path: grpc-java/javadoc
content:
diff --git a/content/docs/languages/java/alts.md b/content/en/docs/languages/java/alts.md
similarity index 96%
rename from content/docs/languages/java/alts.md
rename to content/en/docs/languages/java/alts.md
index ca99cb3..481b7b8 100644
--- a/content/docs/languages/java/alts.md
+++ b/content/en/docs/languages/java/alts.md
@@ -1,7 +1,6 @@
---
title: ALTS authentication in Java
-short: ALTS
-layout: auth_alts
+short_title: ALTS
description: >
An overview of gRPC authentication in Java using Application Layer Transport
Security (ALTS).
@@ -45,3 +44,5 @@ code:
call, Lists.newArrayList("foo@iam.gserviceaccount.com"));
```
---
+
+{{% docs/auth_alts %}}
diff --git a/content/en/docs/languages/java/api.md b/content/en/docs/languages/java/api.md
new file mode 100644
index 0000000..671d20e
--- /dev/null
+++ b/content/en/docs/languages/java/api.md
@@ -0,0 +1,6 @@
+---
+title: API reference
+short_title: API
+weight: 90
+# Note: this is a placeholder page. The URL to this page redirects elsewhere.
+---
diff --git a/content/docs/languages/java/basics.md b/content/en/docs/languages/java/basics.md
similarity index 100%
rename from content/docs/languages/java/basics.md
rename to content/en/docs/languages/java/basics.md
diff --git a/content/docs/languages/java/generated-code.md b/content/en/docs/languages/java/generated-code.md
similarity index 99%
rename from content/docs/languages/java/generated-code.md
rename to content/en/docs/languages/java/generated-code.md
index ed837f3..e089f1a 100644
--- a/content/docs/languages/java/generated-code.md
+++ b/content/en/docs/languages/java/generated-code.md
@@ -1,6 +1,6 @@
---
title: Java generated-code reference
-short: Generated code
+short_title: Generated code
weight: 95
spelling: cSpell:ignore buildscript classpath grpcexample motd srcs xolstice
---
@@ -318,4 +318,4 @@ the command-line syntax is as follows:
```sh
$ protoc --plugin=protoc-gen-grpc-java \
--grpc-java_out="$OUTPUT_FILE" --proto_path="$DIR_OF_PROTO_FILE" "$PROTO_FILE"
-```
\ No newline at end of file
+```
diff --git a/content/docs/languages/java/quickstart.md b/content/en/docs/languages/java/quickstart.md
similarity index 99%
rename from content/docs/languages/java/quickstart.md
rename to content/en/docs/languages/java/quickstart.md
index 178ed5a..6fa62bc 100644
--- a/content/docs/languages/java/quickstart.md
+++ b/content/en/docs/languages/java/quickstart.md
@@ -52,10 +52,10 @@ From the `examples` directory:
Congratulations! You've just run a client-server application with gRPC.
-{{< note >}}
+{{< alert title="Note" color="info" >}}
We've omitted timestamps from the client and server trace output shown in this
page.
-{{< /note >}}
+{{< /alert >}}
### Update the gRPC service
diff --git a/content/docs/languages/kotlin/_index.md b/content/en/docs/languages/kotlin/_index.md
similarity index 96%
rename from content/docs/languages/kotlin/_index.md
rename to content/en/docs/languages/kotlin/_index.md
index 907d105..b695bcf 100644
--- a/content/docs/languages/kotlin/_index.md
+++ b/content/en/docs/languages/kotlin/_index.md
@@ -1,6 +1,7 @@
---
title: Kotlin/JVM
-layout: prog_lang_home
+prog_lang_home: true
+notoc: true
language: Kotlin
api_path: https://javadocs.dev/io.grpc/grpc-kotlin-stub/latest
content:
diff --git a/content/en/docs/languages/kotlin/api.md b/content/en/docs/languages/kotlin/api.md
new file mode 100644
index 0000000..671d20e
--- /dev/null
+++ b/content/en/docs/languages/kotlin/api.md
@@ -0,0 +1,6 @@
+---
+title: API reference
+short_title: API
+weight: 90
+# Note: this is a placeholder page. The URL to this page redirects elsewhere.
+---
diff --git a/content/docs/languages/kotlin/basics.md b/content/en/docs/languages/kotlin/basics.md
similarity index 100%
rename from content/docs/languages/kotlin/basics.md
rename to content/en/docs/languages/kotlin/basics.md
diff --git a/content/docs/languages/kotlin/quickstart.md b/content/en/docs/languages/kotlin/quickstart.md
similarity index 100%
rename from content/docs/languages/kotlin/quickstart.md
rename to content/en/docs/languages/kotlin/quickstart.md
diff --git a/content/docs/languages/node/_index.md b/content/en/docs/languages/node/_index.md
similarity index 92%
rename from content/docs/languages/node/_index.md
rename to content/en/docs/languages/node/_index.md
index 14a0f56..b189a54 100644
--- a/content/docs/languages/node/_index.md
+++ b/content/en/docs/languages/node/_index.md
@@ -1,5 +1,6 @@
---
title: Node
+notoc: true
---
These language-specific pages are available:
diff --git a/content/en/docs/languages/node/api.md b/content/en/docs/languages/node/api.md
new file mode 100644
index 0000000..671d20e
--- /dev/null
+++ b/content/en/docs/languages/node/api.md
@@ -0,0 +1,6 @@
+---
+title: API reference
+short_title: API
+weight: 90
+# Note: this is a placeholder page. The URL to this page redirects elsewhere.
+---
diff --git a/content/docs/languages/node/basics.md b/content/en/docs/languages/node/basics.md
similarity index 100%
rename from content/docs/languages/node/basics.md
rename to content/en/docs/languages/node/basics.md
diff --git a/content/docs/languages/node/quickstart.md b/content/en/docs/languages/node/quickstart.md
similarity index 100%
rename from content/docs/languages/node/quickstart.md
rename to content/en/docs/languages/node/quickstart.md
diff --git a/content/docs/languages/objective-c/_index.md b/content/en/docs/languages/objective-c/_index.md
similarity index 97%
rename from content/docs/languages/objective-c/_index.md
rename to content/en/docs/languages/objective-c/_index.md
index 9566248..a73cfd9 100644
--- a/content/docs/languages/objective-c/_index.md
+++ b/content/en/docs/languages/objective-c/_index.md
@@ -1,6 +1,7 @@
---
title: Objective-C
api_path: grpc/objc
+notoc: true
---
These language-specific pages are available:
diff --git a/content/en/docs/languages/objective-c/api.md b/content/en/docs/languages/objective-c/api.md
new file mode 100644
index 0000000..671d20e
--- /dev/null
+++ b/content/en/docs/languages/objective-c/api.md
@@ -0,0 +1,6 @@
+---
+title: API reference
+short_title: API
+weight: 90
+# Note: this is a placeholder page. The URL to this page redirects elsewhere.
+---
diff --git a/content/docs/languages/objective-c/basics.md b/content/en/docs/languages/objective-c/basics.md
similarity index 99%
rename from content/docs/languages/objective-c/basics.md
rename to content/en/docs/languages/objective-c/basics.md
index 5d939ab..13339a1 100644
--- a/content/docs/languages/objective-c/basics.md
+++ b/content/en/docs/languages/objective-c/basics.md
@@ -223,11 +223,11 @@ In this section, we'll look at creating an Objective-C client for our
`RouteGuide` service. You can see our complete example client code in
[examples/objective-c/route_guide/ViewControllers.m](https://github.com/grpc/grpc/blob/{{< param grpc_vers.core >}}/examples/objective-c/route_guide/ViewControllers.m).
-{{< note >}}
+{{< alert title="Note" color="info" >}}
In your apps, for maintainability and readability reasons, you shouldn't
put all of your view controllers in a single file; it's done here only to
simplify the learning process).
-{{< /note >}}
+{{< /alert >}}
#### Constructing a service object
diff --git a/content/docs/languages/objective-c/oauth2.md b/content/en/docs/languages/objective-c/oauth2.md
similarity index 99%
rename from content/docs/languages/objective-c/oauth2.md
rename to content/en/docs/languages/objective-c/oauth2.md
index ae987be..5b54306 100644
--- a/content/docs/languages/objective-c/oauth2.md
+++ b/content/en/docs/languages/objective-c/oauth2.md
@@ -46,7 +46,7 @@ expects Google account credentials, but neither gRPC nor the Objective-C client
library is tied to any specific OAuth2 provider). The second view makes a gRPC
request to the test server, using the access token obtained by the first view.
-{{< note >}}
+{{< alert title="Note" color="info" >}}
OAuth2 libraries need the application to register and obtain an ID from
the identity provider (in the case of this example app, Google). The app's XCode
project is configured using that ID, so you shouldn't copy this project "as is"
@@ -54,7 +54,7 @@ for your own app: it would result in your app being identified in the consent
screen as "gRPC-AuthSample", and not having access to real Google services.
Instead, configure your own XCode project following the [instructions
here](https://developers.google.com/identity/sign-in/ios/).
-{{< /note >}}
+{{< /alert >}}
As with the other Objective-C examples, you also should have
[CocoaPods](https://cocoapods.org/#install) installed, as well as the relevant
diff --git a/content/docs/languages/objective-c/quickstart.md b/content/en/docs/languages/objective-c/quickstart.md
similarity index 100%
rename from content/docs/languages/objective-c/quickstart.md
rename to content/en/docs/languages/objective-c/quickstart.md
diff --git a/content/docs/languages/php/_index.md b/content/en/docs/languages/php/_index.md
similarity index 94%
rename from content/docs/languages/php/_index.md
rename to content/en/docs/languages/php/_index.md
index b894904..5349de0 100644
--- a/content/docs/languages/php/_index.md
+++ b/content/en/docs/languages/php/_index.md
@@ -1,6 +1,7 @@
---
title: PHP
api_path: grpc/LANG/namespace_grpc
+notoc: true
---
These language-specific pages are available:
diff --git a/content/en/docs/languages/php/api.md b/content/en/docs/languages/php/api.md
new file mode 100644
index 0000000..671d20e
--- /dev/null
+++ b/content/en/docs/languages/php/api.md
@@ -0,0 +1,6 @@
+---
+title: API reference
+short_title: API
+weight: 90
+# Note: this is a placeholder page. The URL to this page redirects elsewhere.
+---
diff --git a/content/docs/languages/php/basics.md b/content/en/docs/languages/php/basics.md
similarity index 100%
rename from content/docs/languages/php/basics.md
rename to content/en/docs/languages/php/basics.md
diff --git a/content/docs/languages/php/daily-builds.md b/content/en/docs/languages/php/daily-builds.md
similarity index 100%
rename from content/docs/languages/php/daily-builds.md
rename to content/en/docs/languages/php/daily-builds.md
diff --git a/content/docs/languages/php/quickstart.md b/content/en/docs/languages/php/quickstart.md
similarity index 99%
rename from content/docs/languages/php/quickstart.md
rename to content/en/docs/languages/php/quickstart.md
index c6b828f..414c551 100644
--- a/content/docs/languages/php/quickstart.md
+++ b/content/en/docs/languages/php/quickstart.md
@@ -74,9 +74,9 @@ or specific version
sudo pecl install grpc-1.7.0
```
-{{< warning >}}
+{{< alert title="Warning" color="warning" >}}
This step unfortunately won’t work on CentOS/RHEL 6. Please follow the instructions below to compile the PECL extension from source.
-{{< /warning >}}
+{{< /alert >}}
##### Install on Windows
diff --git a/content/docs/languages/python/_index.md b/content/en/docs/languages/python/_index.md
similarity index 92%
rename from content/docs/languages/python/_index.md
rename to content/en/docs/languages/python/_index.md
index 8e96049..4d64bc1 100644
--- a/content/docs/languages/python/_index.md
+++ b/content/en/docs/languages/python/_index.md
@@ -1,6 +1,7 @@
---
title: Python
-layout: prog_lang_home
+prog_lang_home: true
+notoc: true
src_repo: https://github.com/grpc/grpc
content:
- learn_more:
diff --git a/content/docs/languages/python/alts.md b/content/en/docs/languages/python/alts.md
similarity index 93%
rename from content/docs/languages/python/alts.md
rename to content/en/docs/languages/python/alts.md
index 6d11181..119329d 100644
--- a/content/docs/languages/python/alts.md
+++ b/content/en/docs/languages/python/alts.md
@@ -1,7 +1,6 @@
---
title: ALTS authentication in Python
-short: ALTS
-layout: auth_alts
+short_title: ALTS
description: >
An overview of gRPC authentication in Python using Application Layer Transport
Security (ALTS).
@@ -26,3 +25,5 @@ code:
# server_authorization:
# client_authorization:
---
+
+{{% docs/auth_alts %}}
diff --git a/content/en/docs/languages/python/api.md b/content/en/docs/languages/python/api.md
new file mode 100644
index 0000000..671d20e
--- /dev/null
+++ b/content/en/docs/languages/python/api.md
@@ -0,0 +1,6 @@
+---
+title: API reference
+short_title: API
+weight: 90
+# Note: this is a placeholder page. The URL to this page redirects elsewhere.
+---
diff --git a/content/docs/languages/python/basics.md b/content/en/docs/languages/python/basics.md
similarity index 99%
rename from content/docs/languages/python/basics.md
rename to content/en/docs/languages/python/basics.md
index ea21e4e..6099f2f 100644
--- a/content/docs/languages/python/basics.md
+++ b/content/en/docs/languages/python/basics.md
@@ -162,9 +162,9 @@ than creates a new one. The generated code files are called
- `add_RouteGuideServicer_to_server`, which adds a RouteGuideServicer to
a `grpc.Server`
-{{< note >}}
+{{< alert title="Note" color="info" >}}
The `2` in pb2 indicates that the generated code is following Protocol Buffers Python API version 2. Version 1 is obsolete. It has no relation to the Protocol Buffers Language version, which is the one indicated by `syntax = "proto3"` or `syntax = "proto2"` in a .proto file.
-{{< /note >}}
+{{< /alert >}}
### Creating the server {#server}
diff --git a/content/docs/languages/python/daily-builds.md b/content/en/docs/languages/python/daily-builds.md
similarity index 100%
rename from content/docs/languages/python/daily-builds.md
rename to content/en/docs/languages/python/daily-builds.md
diff --git a/content/docs/languages/python/generated-code.md b/content/en/docs/languages/python/generated-code.md
similarity index 98%
rename from content/docs/languages/python/generated-code.md
rename to content/en/docs/languages/python/generated-code.md
index 6f3bbd8..24157eb 100644
--- a/content/docs/languages/python/generated-code.md
+++ b/content/en/docs/languages/python/generated-code.md
@@ -1,6 +1,6 @@
---
title: Python Generated-code reference
-short: Generated code
+short_title: Generated code
weight: 80
spelling: cSpell:ignore docstrings
---
@@ -117,12 +117,11 @@ generated:
`add_FooServicer_to_server` function used to register a servicer with a
`grpc.Server` object.
-
### Stub
The generated `Stub` class is used by the gRPC clients. It
has a constructor that takes a `grpc.Channel` object and initializes the
-stub. For each method in the service, the initializer adds a corresponding
+stub. For each method in the service, the initializer adds a corresponding
attribute to the stub object with the same name. Depending on the RPC type
(unary or streaming), the value of that attribute will be callable
objects of type
diff --git a/content/docs/languages/python/quickstart.md b/content/en/docs/languages/python/quickstart.md
similarity index 100%
rename from content/docs/languages/python/quickstart.md
rename to content/en/docs/languages/python/quickstart.md
diff --git a/content/docs/languages/ruby/_index.md b/content/en/docs/languages/ruby/_index.md
similarity index 94%
rename from content/docs/languages/ruby/_index.md
rename to content/en/docs/languages/ruby/_index.md
index a2ede95..e68352d 100644
--- a/content/docs/languages/ruby/_index.md
+++ b/content/en/docs/languages/ruby/_index.md
@@ -1,6 +1,7 @@
---
title: Ruby
api_path: https://rubydoc.info/gems/grpc
+notoc: true
---
These language-specific pages are available:
diff --git a/content/en/docs/languages/ruby/api.md b/content/en/docs/languages/ruby/api.md
new file mode 100644
index 0000000..671d20e
--- /dev/null
+++ b/content/en/docs/languages/ruby/api.md
@@ -0,0 +1,6 @@
+---
+title: API reference
+short_title: API
+weight: 90
+# Note: this is a placeholder page. The URL to this page redirects elsewhere.
+---
diff --git a/content/docs/languages/ruby/basics.md b/content/en/docs/languages/ruby/basics.md
similarity index 99%
rename from content/docs/languages/ruby/basics.md
rename to content/en/docs/languages/ruby/basics.md
index b34146e..a71d6c1 100644
--- a/content/docs/languages/ruby/basics.md
+++ b/content/en/docs/languages/ruby/basics.md
@@ -376,9 +376,9 @@ Run the server:
$ bundle exec route_guide/route_guide_server.rb ../python/route_guide/route_guide_db.json
```
-{{< note >}}
+{{< alert title="Note" color="info" >}}
The `route_guide_db.json` file is actually language-agnostic, it happens to be located in the `python` folder.
-{{< /note >}}
+{{< /alert >}}
From a different terminal, run the client:
diff --git a/content/docs/languages/ruby/daily-builds.md b/content/en/docs/languages/ruby/daily-builds.md
similarity index 100%
rename from content/docs/languages/ruby/daily-builds.md
rename to content/en/docs/languages/ruby/daily-builds.md
diff --git a/content/docs/languages/ruby/quickstart.md b/content/en/docs/languages/ruby/quickstart.md
similarity index 100%
rename from content/docs/languages/ruby/quickstart.md
rename to content/en/docs/languages/ruby/quickstart.md
diff --git a/content/docs/platforms/_index.md b/content/en/docs/platforms/_index.md
similarity index 83%
rename from content/docs/platforms/_index.md
rename to content/en/docs/platforms/_index.md
index c9d4c8e..8837ffd 100644
--- a/content/docs/platforms/_index.md
+++ b/content/en/docs/platforms/_index.md
@@ -1,21 +1,22 @@
---
title: Supported platforms
description: gRPC is supported across different software and hardware platforms.
-short: Platforms
+short_title: Platforms
weight: 2
nav_children: section
+simple_list: true
---
Each gRPC [language][] / platform has links to the following pages and more:
quick start, tutorials, API reference.
-Select a development or target platform to get started:
+New sections coming soon:
- Flutter
- Docs coming soon
- Mobile:
- - [Android]({{< relref "android">}})
- iOS -- docs coming soon
-- [Web]({{< relref "web" >}})
+
+Select a development or target platform to get started:
[language]: {{< relref "languages" >}}
diff --git a/content/docs/platforms/android/_index.md b/content/en/docs/platforms/android/_index.md
similarity index 100%
rename from content/docs/platforms/android/_index.md
rename to content/en/docs/platforms/android/_index.md
diff --git a/content/docs/platforms/android/java/_index.md b/content/en/docs/platforms/android/java/_index.md
similarity index 95%
rename from content/docs/platforms/android/java/_index.md
rename to content/en/docs/platforms/android/java/_index.md
index 1ba8f26..328e64c 100644
--- a/content/docs/platforms/android/java/_index.md
+++ b/content/en/docs/platforms/android/java/_index.md
@@ -2,7 +2,7 @@
title: Android Java
layout: prog_lang_home
language: &lang Java
-short: *lang
+short_title: *lang
spelling: cSpell:ignore javadoc
api_path: grpc-java/javadoc
content:
diff --git a/content/docs/platforms/android/java/api.md b/content/en/docs/platforms/android/java/api.md
similarity index 89%
rename from content/docs/platforms/android/java/api.md
rename to content/en/docs/platforms/android/java/api.md
index ad19bbb..c0a267e 100644
--- a/content/docs/platforms/android/java/api.md
+++ b/content/en/docs/platforms/android/java/api.md
@@ -1,6 +1,6 @@
---
title: API reference
-short: API
+short_title: API
path: grpc-java/javadoc
weight: 90
# Note: this is a placeholder page. The URL to this page redirects elsewhere.
diff --git a/content/docs/platforms/android/java/basics.md b/content/en/docs/platforms/android/java/basics.md
similarity index 100%
rename from content/docs/platforms/android/java/basics.md
rename to content/en/docs/platforms/android/java/basics.md
diff --git a/content/docs/platforms/android/java/quickstart.md b/content/en/docs/platforms/android/java/quickstart.md
similarity index 98%
rename from content/docs/platforms/android/java/quickstart.md
rename to content/en/docs/platforms/android/java/quickstart.md
index 2e83188..fdcee8f 100644
--- a/content/docs/platforms/android/java/quickstart.md
+++ b/content/en/docs/platforms/android/java/quickstart.md
@@ -24,11 +24,11 @@ weight: 10
- An android device set up for [USB debugging][] or an
[Android Virtual Device][]
-{{< note >}}
+{{< alert title="Note" color="info" >}}
gRPC Java does not support running a server on an Android device. For this
quick start, the Android client app will connect to a server running on your
local (non-Android) computer.
-{{< /note >}}
+{{< /alert >}}
### Get the example code
@@ -83,10 +83,10 @@ The example code is part of the [grpc-java][] repo.
Congratulations! You've just run a client-server application with gRPC.
-{{< note >}}
+{{< alert title="Note" color="info" >}}
We've omitted timestamps from the client and server trace output shown in this
page.
-{{< /note >}}
+{{< /alert >}}
### Update the gRPC service
diff --git a/content/docs/platforms/android/kotlin/_index.md b/content/en/docs/platforms/android/kotlin/_index.md
similarity index 95%
rename from content/docs/platforms/android/kotlin/_index.md
rename to content/en/docs/platforms/android/kotlin/_index.md
index 1c41810..333a0f3 100644
--- a/content/docs/platforms/android/kotlin/_index.md
+++ b/content/en/docs/platforms/android/kotlin/_index.md
@@ -2,7 +2,7 @@
title: Kotlin for Android
layout: prog_lang_home
language: &lang Kotlin
-short: *lang
+short_title: *lang
api_path: https://javadocs.dev/io.grpc/grpc-kotlin-stub/latest
content:
- learn_more:
diff --git a/content/en/docs/platforms/android/kotlin/api.md b/content/en/docs/platforms/android/kotlin/api.md
new file mode 100644
index 0000000..671d20e
--- /dev/null
+++ b/content/en/docs/platforms/android/kotlin/api.md
@@ -0,0 +1,6 @@
+---
+title: API reference
+short_title: API
+weight: 90
+# Note: this is a placeholder page. The URL to this page redirects elsewhere.
+---
diff --git a/content/docs/platforms/android/kotlin/quickstart.md b/content/en/docs/platforms/android/kotlin/quickstart.md
similarity index 98%
rename from content/docs/platforms/android/kotlin/quickstart.md
rename to content/en/docs/platforms/android/kotlin/quickstart.md
index 641c65c..41139c2 100644
--- a/content/docs/platforms/android/kotlin/quickstart.md
+++ b/content/en/docs/platforms/android/kotlin/quickstart.md
@@ -1,6 +1,6 @@
---
title: Quick start - Kotlin for Android
-short: Quick start
+short_title: Quick start
description: This guide gets you started with Kotlin gRPC on Android with a simple working example.
weight: 10
---
@@ -26,11 +26,11 @@ weight: 10
- An android device set up for [USB debugging][] or an
[Android Virtual Device][]
-{{< note >}}
+{{< alert title="Note" color="info" >}}
gRPC Kotlin does not support running a server on an Android device. For this
quick start, the Android client app will connect to a server running on your
local (non-Android) computer.
-{{< /note >}}
+{{< /alert >}}
### Get the example code
diff --git a/content/docs/platforms/web/_index.md b/content/en/docs/platforms/web/_index.md
similarity index 100%
rename from content/docs/platforms/web/_index.md
rename to content/en/docs/platforms/web/_index.md
diff --git a/content/docs/platforms/web/basics.md b/content/en/docs/platforms/web/basics.md
similarity index 100%
rename from content/docs/platforms/web/basics.md
rename to content/en/docs/platforms/web/basics.md
diff --git a/content/docs/platforms/web/quickstart.md b/content/en/docs/platforms/web/quickstart.md
similarity index 97%
rename from content/docs/platforms/web/quickstart.md
rename to content/en/docs/platforms/web/quickstart.md
index 357d3d9..9d66a42 100644
--- a/content/docs/platforms/web/quickstart.md
+++ b/content/en/docs/platforms/web/quickstart.md
@@ -39,14 +39,14 @@ From the `grpc-web` directory:
$ docker-compose pull
```
- {{< note >}}
+ {{< alert title="Note" color="info" >}}
Getting the following warning? You can ignore it for the purpose of running the
example app:
```nocode
WARNING: Some service image(s) must be built from source
```
- {{< /note >}}
+ {{< /alert >}}
2. Launch services as background processes:
diff --git a/content/docs/protoc-installation.md b/content/en/docs/protoc-installation.md
similarity index 96%
rename from content/docs/protoc-installation.md
rename to content/en/docs/protoc-installation.md
index 87c029b..bd92fe9 100644
--- a/content/docs/protoc-installation.md
+++ b/content/en/docs/protoc-installation.md
@@ -1,8 +1,9 @@
---
title: Protocol Buffer Compiler Installation
-short: Protoc Installation
+short_title: Protoc Installation
description: How to install the protocol buffer compiler.
protoc-version: 3.13.0
+toc_hide: true
---
While not mandatory, gRPC applications often leverage [Protocol Buffers][pb] for
@@ -18,7 +19,7 @@ to install `protoc`.
You can install the protocol compiler, `protoc`, with a package manager under
Linux or macOS using the following commands.
-{{< warning >}}
+{{< alert title="Warning" color="warning" >}}
**Check the version of `protoc`** (as indicated below) after installation to
ensure that it is sufficiently recent. The versions of `protoc` installed by
some package managers can be quite dated.
@@ -26,7 +27,7 @@ Linux or macOS using the following commands.
Installing from pre-compiled binaries, as indicated in the [next
section](#binary-install), is the best way to ensure that you're using the
latest release of `protoc`.
-{{< /warning >}}
+{{< /alert >}}
- Linux, using `apt` or `apt-get`, for example:
diff --git a/content/docs/quickstart.md b/content/en/docs/quickstart.md
similarity index 93%
rename from content/docs/quickstart.md
rename to content/en/docs/quickstart.md
index a998cca..89ba852 100644
--- a/content/docs/quickstart.md
+++ b/content/en/docs/quickstart.md
@@ -1,6 +1,7 @@
---
title: Quick start
robots: noindex, nofollow
+toc_hide: true
---
Select a [language][] or [platform][], then choose its **Quick start**.
diff --git a/content/docs/tutorials.md b/content/en/docs/tutorials.md
similarity index 92%
rename from content/docs/tutorials.md
rename to content/en/docs/tutorials.md
index 8b5babf..2e23ac5 100644
--- a/content/docs/tutorials.md
+++ b/content/en/docs/tutorials.md
@@ -1,6 +1,7 @@
---
title: Tutorials
robots: noindex, nofollow
+toc_hide: true
---
Select a [language][] or [platform][] to view available tutorials.
diff --git a/content/en/docs/what-is-grpc/_index.md b/content/en/docs/what-is-grpc/_index.md
new file mode 100644
index 0000000..34f1e48
--- /dev/null
+++ b/content/en/docs/what-is-grpc/_index.md
@@ -0,0 +1,5 @@
+---
+title: What is gRPC?
+description: New to gRPC? Start with the following pages
+weight: 1
+---
diff --git a/content/docs/what-is-grpc/core-concepts.md b/content/en/docs/what-is-grpc/core-concepts.md
similarity index 99%
rename from content/docs/what-is-grpc/core-concepts.md
rename to content/en/docs/what-is-grpc/core-concepts.md
index 7b8e09b..ecb36d8 100644
--- a/content/docs/what-is-grpc/core-concepts.md
+++ b/content/en/docs/what-is-grpc/core-concepts.md
@@ -1,6 +1,6 @@
---
title: Core concepts, architecture and lifecycle
-short: Core concepts
+short_title: Core concepts
description: >-
An introduction to key gRPC concepts, with an overview of gRPC architecture
and RPC life cycle.
@@ -188,9 +188,9 @@ complete before a client has sent all its requests.
Either the client or the server can cancel an RPC at any time. A cancellation
terminates the RPC immediately so that no further work is done.
-{{< warning >}}
+{{< alert title="Warning" color="warning" >}}
Changes made before a cancellation are not rolled back.
-{{< /warning >}}
+{{< /alert >}}
#### Metadata
diff --git a/content/faq.md b/content/en/docs/what-is-grpc/faq.md
similarity index 100%
rename from content/faq.md
rename to content/en/docs/what-is-grpc/faq.md
diff --git a/content/docs/what-is-grpc/introduction.md b/content/en/docs/what-is-grpc/introduction.md
similarity index 99%
rename from content/docs/what-is-grpc/introduction.md
rename to content/en/docs/what-is-grpc/introduction.md
index 540e806..e5502ac 100644
--- a/content/docs/what-is-grpc/introduction.md
+++ b/content/en/docs/what-is-grpc/introduction.md
@@ -1,6 +1,6 @@
---
title: Introduction to gRPC
-short: Introduction
+short_title: Introduction
description: An introduction to gRPC and protocol buffers.
weight: 10
spelling: cSpell:ignore ponycopter
diff --git a/content/en/search.md b/content/en/search.md
new file mode 100644
index 0000000..394feea
--- /dev/null
+++ b/content/en/search.md
@@ -0,0 +1,4 @@
+---
+title: Search Results
+layout: search
+---
diff --git a/content/showcase.md b/content/en/showcase/_index.md
similarity index 64%
rename from content/showcase.md
rename to content/en/showcase/_index.md
index 37e296c..5feb968 100644
--- a/content/showcase.md
+++ b/content/en/showcase/_index.md
@@ -5,72 +5,76 @@ url_use_grpc: https://www.cncf.io/case-studies/?_sft_lf-project=grpc
spelling: cSpell:ignore youtube Kubernetes Nulab Protop
---
+{{< blocks/cover height="sm" color="primary" >}}
+{{< page/header >}}
+{{< /blocks/cover >}}
+
+
+
## Customer success stories
-
+Here are a few of the customers who [successfully adopted **gRPC**][use-of-grpc]
+and other [CNCF technologies](https://www.cncf.io/projects/) in the past year
-Here are a few of the customers who [successfully adopted **gRPC**][use-of-gRPC]
-and other [CNCF technologies](https://www.cncf.io/projects/) in the past year:
+
+{{ end }}
\ No newline at end of file
diff --git a/layouts/partials/content.html b/layouts/partials/content.html
deleted file mode 100644
index 696ab42..0000000
--- a/layouts/partials/content.html
+++ /dev/null
@@ -1,16 +0,0 @@
-{{/*
-
-2020/10 You must load this partial by passing a `dict` constructed context
-(rather than just the dot ".") like so:
-
- {{ partial "content.html" (dict "Page" .) }}
-
-This is because we can't apply the `index` function to a Hugo page object, which
-is what the dot usually seems to be.
-
-*/}}
-
-{{- $size := index . "size" | default "normal" -}}
-
- {{ index . "content" | default .Page.Content }}
-
-
\ No newline at end of file
diff --git a/layouts/partials/home/info.html b/layouts/partials/home/info.html
deleted file mode 100644
index f28acf3..0000000
--- a/layouts/partials/home/info.html
+++ /dev/null
@@ -1,44 +0,0 @@
-{{ $features := site.Params.features }}
-
-
-
- Why gRPC?
-
-
- gRPC is a modern open source high performance RPC framework that can run
- in any environment. It can efficiently connect services in and across data
- centers with pluggable support for load balancing, tracing, health
- checking and authentication. It is also applicable in last mile of
- distributed computing to connect devices, mobile applications and browsers
- to backend services.
-
-
diff --git a/layouts/partials/hooks/body-end.html b/layouts/partials/hooks/body-end.html
new file mode 100644
index 0000000..15a471d
--- /dev/null
+++ b/layouts/partials/hooks/body-end.html
@@ -0,0 +1 @@
+{{/* Use this file to include anything you wish to append to the end of the body tag */}}
\ No newline at end of file
diff --git a/layouts/partials/hooks/head-end.html b/layouts/partials/hooks/head-end.html
new file mode 100644
index 0000000..1ede838
--- /dev/null
+++ b/layouts/partials/hooks/head-end.html
@@ -0,0 +1,5 @@
+{{/* Use this file to include anything you wish to append to the end of the body tag */}}
+
+{{ partial "google-analytics.html" . }}
+{{ partial "meta.html" . }}
+{{ partial "favicons.html" . }}
\ No newline at end of file
diff --git a/layouts/partials/javascript.html b/layouts/partials/javascript.html
deleted file mode 100644
index ecdc7f4..0000000
--- a/layouts/partials/javascript.html
+++ /dev/null
@@ -1,23 +0,0 @@
-
-
-{{/* Algolia DocSearch JS */}}
-
-
-
-{{/* Anchor link scroll offset */}}
-
diff --git a/layouts/partials/nav.html b/layouts/partials/nav.html
deleted file mode 100644
index cd74ad3..0000000
--- a/layouts/partials/nav.html
+++ /dev/null
@@ -1,98 +0,0 @@
-{{ $this := . -}}
-{{ $here := .RelPermalink -}}
-{{ $currentSection := .CurrentSection -}}
-{{ $docSections := (index (where site.Sections "Section" "docs") 0).Sections -}}
-
-
-{{ else -}}
-{{ $name := .Name -}}
-{{ $url := .URL -}}
-{{ $isExternal := hasPrefix .URL "http" -}}
-
- {{- $name -}}
- {{ if $isExternal -}}
-
-
-
- {{- end -}}
-
-{{- end }}
-{{- end -}}
diff --git a/layouts/partials/navbar.html b/layouts/partials/navbar.html
deleted file mode 100644
index 8e52f2d..0000000
--- a/layouts/partials/navbar.html
+++ /dev/null
@@ -1,27 +0,0 @@
-
\ No newline at end of file
diff --git a/layouts/partials/search-bar.html b/layouts/partials/search-bar.html
deleted file mode 100644
index 3eb3a6d..0000000
--- a/layouts/partials/search-bar.html
+++ /dev/null
@@ -1,9 +0,0 @@
-
-
-
-
-
-
-
-
-
\ No newline at end of file
diff --git a/layouts/partials/sidebar-tree.html b/layouts/partials/sidebar-tree.html
new file mode 100644
index 0000000..ee3b2f7
--- /dev/null
+++ b/layouts/partials/sidebar-tree.html
@@ -0,0 +1,64 @@
+{{/* We cache this partial for bigger sites and set the active class client side. */}}
+{{ $shouldDelayActive := ge (len .Site.Pages) 2000 }}
+
+ {{ if not .Site.Params.ui.sidebar_search_disable }}
+
+ {{ end }}
+
+
+
+
+
+
- 
-
- 
- 
-
-