Skip to content

Commit a095c07

Browse files
GuiDevloperGuiDevloper
committed
Merge branch 'master' into pr/33
2 parents c4ecd38 + c9a2b77 commit a095c07

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

54 files changed

+1277
-9211
lines changed

‎.vscode/settings.json

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
{
2+
"cSpell.language": "en,pt-BR",
3+
"cSpell.enableFiletypes": [
4+
"svg",
5+
"vue",
6+
"vue-html",
7+
"html",
8+
"css",
9+
"javascript"
10+
],
11+
"cSpell.words": [
12+
"vuejs",
13+
"codepen",
14+
"vuemastery"
15+
]
16+
}

‎README.md

Lines changed: 26 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,33 +1,47 @@
1-
# v3.vuejs.org
1+
# vuejs-br/docs-next
22

3-
This site is built with [VuePress](https://vuepress.vuejs.org/). Site content is written in Markdown format located in `src`.
3+
Este é o repositório oficial da tradução para português brasileiro da documentação do [Vue.js](https://v3.vuejs.org/). Este _site_ é produzido com [VuePress](https://vuepress.vuejs.org/). Todo o conteúdo é escrito em Markdown e os arquivos podem ser encontrados em `src`.
44

5-
## Writing
5+
> Nota da equipe de tradução: o trabalho nesta nova versão da documentação ainda está em andamento, portanto muitos conteúdos estão em seu estado original (em inglês). Ajuda é muito bem-vinda!
66
7-
See the [Vue Docs Writing Guide](https://v3.vuejs.org/guide/writing-guide.html) for our rules and recommendations on writing and maintaining documentation.
7+
## Traduzindo
88

9-
> The docs are in beta: The team is currently in the midst of changes and we are not ready for additional contributions yet. All content is subject to change. If you see a problem that you would like to bring to our attention, please [create an issue](https://github.com/vuejs/docs-next/issues/new) and we will get to it when we can. You may want to wait until the content is finalized, though.
9+
Se você quer participar da tradução, ajudando a traduzir conteúdos que ainda permanecem em inglês e/ou ajudando a revisar conteúdos já traduzidos, sinta-se em casa. Para entender como tudo funciona e saber por onde começar, leia nosso guia de [Contribuição com a Documentação](https://vuejsbr-docs-next.netlify.app/guide/contributing/translations.html).
1010

11-
## Developing
11+
> O _workflow_ para a realização da tradução está detalhadamente descrito em [Como colaborar com a versão em português?](https://vuejsbr-docs-next.netlify.app/guide/contributing/translations.html#como-colaborar-com-a-versao-em-portugues) Ler é o primeiro passo para todo colaborador em potencial.
1212
13-
1. Clone repository
13+
## Escrevendo
14+
15+
Se você quer participar ajudando na construção e atualização da documentação principal (em inglês), veja o [Guia de Escrita](https://v3.vuejs.org/guide/writing-guide.html) para regras e recomendações sobre escrever e manter a documentação.
16+
17+
> Neste momento a documentação principal (em inglês) está em beta: o time está atualmente no meio de muitas mudanças e não está recebendo contribuições. Todo o conteúdo está sujeito a mudanças. Se você viu algo que gostaria de trazer à atenção do time, [crie uma _issue_](https://github.com/vuejs/docs-next/issues/new) e todos farão o possível para analisar. No entanto, provavelmente você precisará esperar até que todo o conteúdo esteja finalizado.
18+
19+
## Desenvolvendo
20+
21+
Se deseja executar o projeto localmente, seja para contribuir com a documentação ou seja para olhar como as coisas funcionam, sigua os passos a seguir.
22+
23+
1. Clone este repositório:
1424

1525
```bash
16-
git clone git@github.com:vuejs/docs-next.git
26+
git clone https://github.com/vuejs-br/docs-next.git
1727
```
1828

19-
2. Install dependencies
29+
2. Instale as dependências:
2030

2131
```bash
2232
yarn # or npm install
2333
```
2434

25-
3. Start local development environment
35+
3. Inicie um ambiente de desenvolvimento local:
2636

2737
```bash
2838
yarn serve # or npm run serve
2939
```
3040

31-
## Deploying
41+
## Publicando
42+
43+
[![Netlify Status](https://api.netlify.com/api/v1/badges/35e551aa-2430-4ca9-aae6-72ba49d7ffec/deploy-status)](https://app.netlify.com/sites/vuejsbr-docs-next/deploys)
44+
45+
O _site_ é automaticamente publicado quando _commits_ chegam em `master`, via [Netlify](https://www.netlify.com/).
3246

33-
The site is automatically deployed when commits land in `master`, via [Netlify](https://www.netlify.com/).
47+
O processo é disparado somente por um grupo de contribuidores selecionados para isso, a fim de manter a organização do projeto. Colabore apenas enviando _pull requests_ e, depois de revisados e aceitos, serão mesclados em `master` pela equipe. Ou seja, não se preocupe com a publicação, o _deploy_ é automático.

‎package.json

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,7 @@
55
"vuepress": "^1.5.4"
66
},
77
"scripts": {
8+
"dev": "yarn serve",
89
"serve": "vuepress dev src",
910
"build": "vuepress build src"
1011
},

‎src/.vuepress/components/FirstExample.vue

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<template>
22
<div class="demo">
3-
<p>Counter: {{ counter }}</p>
4-
<button @click="clearInterval">Stop timer</button>
3+
<p>Contador: {{ counter }}</p>
4+
<button @click="clearInterval">Parar</button>
55
</div>
66
</template>
77

‎src/.vuepress/components/VideoLesson.vue

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
<script>
2+
export default {
3+
props: {
4+
href: {
5+
type: String,
6+
required: true
7+
},
8+
title: {
9+
type: String,
10+
default: ''
11+
}
12+
}
13+
}
14+
</script>
15+
16+
<template>
17+
<section class="video-lesson">
18+
<a :href="href" target="_blank" rel="sponsored noopener" :title="title">
19+
<slot></slot>
20+
</a>
21+
</section>
22+
</template>
23+
24+
<style lang="scss">
25+
.video-lesson {
26+
display: flex;
27+
align-items: center;
28+
background-color: #e7ecf3;
29+
padding: 1em 1.25em;
30+
border-radius: 2px;
31+
color: #486491;
32+
position: relative;
33+
margin: 24px 0;
34+
35+
a {
36+
color: #486491;
37+
position: relative;
38+
padding-left: 16px;
39+
}
40+
41+
&::before {
42+
content: '\f144';
43+
font-family: 'FontAwesome';
44+
font-size: 2em;
45+
display: inline-block;
46+
color: #73abfe;
47+
vertical-align: middle;
48+
}
49+
}
50+
</style>

‎src/.vuepress/components/common/codepen-snippet.vue

Lines changed: 53 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,53 @@
1+
<template>
2+
<p class="codepen" data-height="300" data-theme-id="39028" data-default-tab="result" data-preview="true" data-editable="true"
3+
:data-user="user.slug"
4+
:data-slug-hash="slug"
5+
:data-pen-title="title">
6+
<span>Veja o exemplo <a :href="`https://codepen.io/${user.slug}/pen/${slug}`">
7+
{{ title }}</a> por {{ user.name }} (<a :href="`https://codepen.io/${user.slug}`">@${user.slug}</a>)
8+
no <a href="https://codepen.io">CodePen</a>.</span>
9+
</p>
10+
</template>
11+
12+
<script>
13+
export default {
14+
props: {
15+
user: {
16+
type: Object,
17+
default: () => ({
18+
slug: 'vuejs-br',
19+
name: 'Vue.js Brasil'
20+
}),
21+
},
22+
23+
title: {
24+
type: String,
25+
default: null,
26+
},
27+
28+
slug: {
29+
type: String,
30+
default: null,
31+
},
32+
},
33+
mounted() {
34+
const codepenScript = document.createElement('script')
35+
codepenScript.setAttribute('src', 'https://static.codepen.io/assets/embed/ei.js')
36+
codepenScript.async = true
37+
this.$el.appendChild(codepenScript)
38+
}
39+
}
40+
</script>
41+
42+
<style lang="scss">
43+
.codepen {
44+
box-sizing: border-box;
45+
height: 300px;
46+
display: flex;
47+
align-items: center;
48+
justify-content: center;
49+
border: 2px solid;
50+
margin: 1em 0;
51+
padding: 1em;
52+
}
53+
</style>

‎src/.vuepress/components/common/vuemastery-video-modal.vue

Lines changed: 17 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,18 @@
11
<template>
22
<div class="overlay" v-show="isOpen">
33
<div ref="modal" class="modal" :class="{ open: isOpen }">
4-
<div class="video-space" style="padding: 56.25% 0 0 0; position: relative;">
4+
<div
5+
class="video-space"
6+
style="padding: 56.25% 0 0 0; position: relative;"
7+
>
58
<iframe
69
src="https://player.vimeo.com/video/455611549?dnt=1"
710
style="height: 100%; left: 0; position: absolute; top: 0; width: 100%; margin: 0"
811
frameborder="0"
912
webkitallowfullscreen
1013
mozallowfullscreen
1114
allowfullscreen
15+
allow="autoplay"
1216
ref="videoIframe"
1317
></iframe>
1418
</div>
@@ -20,14 +24,15 @@
2024
target="_blank"
2125
rel="sponsored noopener"
2226
title="Vue.js Courses on Vue Mastery"
23-
>Vue Mastery</a>.
24-
Watch Vue Mastery’s free
27+
>Vue Mastery</a
28+
>. Watch Vue Mastery’s free
2529
<a
2630
href="https://www.vuemastery.com/courses/intro-to-vue-3/intro-to-vue3"
2731
target="_blank"
2832
rel="sponsored noopener"
2933
title="Vue.js Courses on Vue Mastery"
30-
>Intro to Vue course</a>.
34+
>Intro to Vue course</a
35+
>.
3136
</p>
3237
</div>
3338
</div>
@@ -47,7 +52,7 @@ export default {
4752
}),
4853
4954
methods: {
50-
initVideoModal () {
55+
initVideoModal() {
5156
const modalButton = document.querySelector(this.triggerSelector)
5257
const player = new Vimeo.Player(this.$refs.videoIframe)
5358
@@ -59,7 +64,11 @@ export default {
5964
})
6065
6166
document.body.addEventListener('click', event => {
62-
if (this.isOpen && event.target !== modalButton && !this.$refs.modal.contains(event.target)) {
67+
if (
68+
this.isOpen &&
69+
event.target !== modalButton &&
70+
!this.$refs.modal.contains(event.target)
71+
) {
6372
this.isOpen = false
6473
document.body.classList.remove('stop-scroll')
6574
player.pause()
@@ -68,7 +77,7 @@ export default {
6877
}
6978
},
7079
71-
mounted () {
80+
mounted() {
7281
if (typeof window !== 'undefined') {
7382
this.initVideoModal()
7483
}
@@ -77,7 +86,7 @@ export default {
7786
</script>
7887

7988
<style lang="scss">
80-
@import "@theme/styles/_settings.scss";
89+
@import '@theme/styles/_settings.scss';
8190
8291
.modal {
8392
box-sizing: border-box;

‎src/.vuepress/config.js

Lines changed: 33 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -107,37 +107,41 @@ const sidebar = {
107107
]
108108
},
109109
{
110-
title: 'Migration from Vue 2',
110+
title: 'Migration Guide',
111111
collapsable: true,
112112
children: [
113-
'migration/introduction',
114-
'migration/async-components',
115-
'migration/attribute-coercion',
116-
'migration/custom-directives',
117-
'migration/custom-elements-interop',
118-
'migration/data-option',
119-
'migration/events-api',
120-
'migration/filters',
121-
'migration/fragments',
122-
'migration/functional-components',
123-
'migration/global-api',
124-
'migration/global-api-treeshaking',
125-
'migration/inline-template-attribute',
126-
'migration/key-attribute',
127-
'migration/keycode-modifiers',
128-
'migration/render-function-api',
129-
'migration/slots-unification',
130-
'migration/transition',
131-
'migration/v-model'
113+
'/guide/migration/introduction',
114+
'/guide/migration/array-refs',
115+
'/guide/migration/async-components',
116+
'/guide/migration/attribute-coercion',
117+
'/guide/migration/custom-directives',
118+
'/guide/migration/custom-elements-interop',
119+
'/guide/migration/data-option',
120+
'/guide/migration/events-api',
121+
'/guide/migration/filters',
122+
'/guide/migration/fragments',
123+
'/guide/migration/functional-components',
124+
'/guide/migration/global-api',
125+
'/guide/migration/global-api-treeshaking',
126+
'/guide/migration/inline-template-attribute',
127+
'/guide/migration/key-attribute',
128+
'/guide/migration/keycode-modifiers',
129+
'/guide/migration/props-default-this',
130+
'/guide/migration/render-function-api',
131+
'/guide/migration/slots-unification',
132+
'/guide/migration/transition',
133+
'/guide/migration/v-model',
134+
'/guide/migration/v-if-v-for',
135+
'/guide/migration/v-bind'
132136
]
133137
},
134138
{
135139
title: 'Contribute to the Docs',
136140
collapsable: true,
137141
children: [
138-
'contributing/writing-guide',
139-
'contributing/doc-style-guide',
140-
'contributing/translations'
142+
'/guide/contributing/writing-guide',
143+
'/guide/contributing/doc-style-guide',
144+
'/guide/contributing/translations'
141145
]
142146
}
143147
],
@@ -235,6 +239,10 @@ module.exports = {
235239
text: 'Guide',
236240
link: '/guide/introduction'
237241
},
242+
{
243+
text: 'Migration Guide',
244+
link: '/guide/migration/introduction'
245+
},
238246
{
239247
text: 'Style Guide',
240248
link: '/style-guide/'
@@ -280,7 +288,7 @@ module.exports = {
280288
text: 'Official Projects',
281289
items: [{
282290
text: 'Vue Router',
283-
link: 'https://router.vuejs.org/'
291+
link: 'https://next.router.vuejs.org/'
284292
},
285293
{
286294
text: 'Vuex',
@@ -292,7 +300,7 @@ module.exports = {
292300
},
293301
{
294302
text: 'Vue Test Utils',
295-
link: 'https://vue-test-utils.vuejs.org/'
303+
link: 'https://vuejs.github.io/vue-test-utils-next-docs/guide/introduction.html'
296304
},
297305
{
298306
text: 'Devtools',

0 commit comments

Comments
 (0)