From bbb376fb03efcc2142caf0cd3c90cf3e6bedda12 Mon Sep 17 00:00:00 2001
From: skirtle <65301168+skirtles-code@users.noreply.github.com>
Date: Wed, 27 Jan 2021 05:07:41 +0000
Subject: [PATCH 1/3] docs: translations guide
---
.../guide/contributing/translations-data.js | 21 ++
.../guide/contributing/translations.vue | 206 ++++++++++++++++++
src/.vuepress/config.js | 3 +
src/community/join.md | 4 +-
src/guide/contributing/translations.md | 40 +++-
5 files changed, 267 insertions(+), 7 deletions(-)
create mode 100644 src/.vuepress/components/guide/contributing/translations-data.js
create mode 100644 src/.vuepress/components/guide/contributing/translations.vue
diff --git a/src/.vuepress/components/guide/contributing/translations-data.js b/src/.vuepress/components/guide/contributing/translations-data.js
new file mode 100644
index 0000000000..e85f76d6f4
--- /dev/null
+++ b/src/.vuepress/components/guide/contributing/translations-data.js
@@ -0,0 +1,21 @@
+export const labels = {
+ language: 'Language',
+ github: 'GitHub',
+ lastCommit: 'Last commit',
+ last90Days: 'Last 90 days',
+ loadDetails: 'Load Details',
+ commits: 'commits',
+ loading: 'Loading...'
+}
+
+// Repos are in alphabetical order by the language code
+// You may need to clear your sessionStorage when adding a new item to this list
+export const repos = [
+ { lang: 'en-us', owner: 'vuejs', repo: 'docs-next', branch: 'master', url: 'https://v3.vuejs.org/' },
+ { lang: 'id', owner: 'vuejs-id', repo: 'docs-next', branch: 'indonesian' },
+ { lang: 'ja', owner: 'vuejs-jp', repo: 'ja.vuejs.org', branch: 'lang-ja', url: 'https://v3.ja.vuejs.org/' },
+ { lang: 'ko', owner: 'vuejs-kr', repo: 'docs-next', branch: 'rootKoKr', url: 'https://v3.ko.vuejs.org/' },
+ { lang: 'pt-br', owner: 'vuejs-br', repo: 'docs-next', branch: 'master', url: 'https://vuejsbr-docs-next.netlify.app/' },
+ { lang: 'ru', owner: 'translation-gang', repo: 'docs-next', branch: 'master' },
+ { lang: 'zh-cn', owner: 'vuejs', repo: 'docs-next-zh-cn', branch: 'master', url: 'https://v3.cn.vuejs.org/' }
+]
diff --git a/src/.vuepress/components/guide/contributing/translations.vue b/src/.vuepress/components/guide/contributing/translations.vue
new file mode 100644
index 0000000000..81103c2ace
--- /dev/null
+++ b/src/.vuepress/components/guide/contributing/translations.vue
@@ -0,0 +1,206 @@
+
+
+
+
+
+
+
+
+
diff --git a/src/.vuepress/config.js b/src/.vuepress/config.js
index 496fc7014d..5879df6079 100644
--- a/src/.vuepress/config.js
+++ b/src/.vuepress/config.js
@@ -406,6 +406,9 @@ module.exports = {
{
text: '中文',
link: 'https://v3.cn.vuejs.org/'
+ }, {
+ text: 'More Translations',
+ link: '/guide/contributing/translations#community-translations'
}
]
}
diff --git a/src/community/join.md b/src/community/join.md
index a6face1a4d..bd00209ce9 100644
--- a/src/community/join.md
+++ b/src/community/join.md
@@ -45,11 +45,9 @@ Apart from answering questions and sharing resources in the forum and chat, ther
### Translate Docs
-Vue has already spread across the globe, with even the core team in at least half a dozen timezones. [The forum](https://forum.vuejs.org/) includes 7 languages and counting and many of our docs have [actively-maintained translations](https://github.com/vuejs?utf8=%E2%9C%93&q=vuejs.org). We're very proud of Vue's international reach, but we can do even better.
-
I hope that right now, you're reading this sentence in your preferred language. If not, would you like to help us get there?
-If so, please feel free to fork the repo for [these docs](https://github.com/vuejs/vuejs.org/) or for any other officially maintained documentation, then start translating. Once you've made some progress, open an issue or pull request in the main repo and we'll put out a call for more contributors to help you out.
+See the [Translations guide](/guide/contributing/translations.html) for more details on how you can get involved.
### Become a Community Leader
diff --git a/src/guide/contributing/translations.md b/src/guide/contributing/translations.md
index 23e4999a16..9e900ccbd1 100644
--- a/src/guide/contributing/translations.md
+++ b/src/guide/contributing/translations.md
@@ -1,11 +1,43 @@
# Translations
-Vue has spread across the globe, with the core team being in at least half a dozen different timezones. [The forum](https://forum.vuejs.org/) includes 7 languages and counting and many of our docs have [actively-maintained translations](https://github.com/vuejs?utf8=%E2%9C%93&q=vuejs.org). We're very proud of Vue's international reach, but we can do even better.
+Vue has spread across the globe, with the core team being in at least half a dozen different timezones. The community is growing all the time and we want to make the documentation accessible to as many people as possible.
-## Can we start translating Vue 3 docs?
+Providing translations for the documentation is not something that the core team can manage alone. Thankfully, we have a great community of translators making contributions both large and small. If you've been thinking about contributing to the project, perhaps this is a good place to start?
-Yes! We are ready for translation!
+## Community translations
+
+The table below lists GitHub repositories for community translations. These are translations made by the community, for the community. Some of these translations may be incomplete but they can still make the Vue experience significantly more enjoyable for readers who prefer these languages.
+
+For completeness, we've also included the official documentation in the list.
+
+
+
+
+
+ {{ labels.language }}
+ {{ labels.github }}
+ {{ labels.lastCommit }}
+ {{ labels.last90Days }}
+
+
+
+
+
+ {{ lang }}
+
+
+ {{ lang }}
+
+
+
+ {{ owner }}/{{ repo }}
+
+
+
+
+
+
+
+ {{ date }}
+
+ {{ count }}{{ count === 100 ? '+' : '' }}
+
+ {{ labels.commits }}
+
+
+
+