Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[feat] Translation of docs>guide>essentials #153

Draft
wants to merge 7 commits into
base: main
Choose a base branch
from

Conversation

unnunhexium
Copy link

Description of Problem

Proposed Solution

Additional Information


An application instance won't render anything until its `.mount()` method is called. It expects a "container" argument, which can either be an actual DOM element or a selector string:
Instancja aplikacji nie wyrenderuje niczego, dopóki nie zostanie wywołana jej metoda `.mount()`. Oczekuje ona argumentu „kontener”, którym może być rzeczywisty element DOM lub selektor:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think that "container" in this sentence should not be translated since it's actual name of a argument. WDYT?


```html
<div id="app">
<button @click="count++">{{ count }}</button>
<button @click="licznik++">{{ licznik }}</button>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As it's a part of a code "count" should not be changed. We should keep variable names and function names in examples intact. Same approach we can observe for other translations.


```js
const app1 = createApp({
/* ... */
})
app1.mount('#container-1')
app1.mount('#kontener-1')
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same thing as above, we should keep initial naming intact.


const app2 = createApp({
/* ... */
})
app2.mount('#container-2')
app2.mount('#kontener-2')
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same thing as above, we should keep initial naming intact.

```

If you are using Vue to enhance server-rendered HTML and only need Vue to control specific parts of a large page, avoid mounting a single Vue application instance on the entire page. Instead, create multiple small application instances and mount them on the elements they are responsible for.
Jeśli używasz Vue do wzbogacenia renderowanego po stronie serwera HTML i chcesz, aby Vue kontrolowało tylko określone części dużej strony, unikaj montowania jednej instancji Vue na całej stronie. Zamiast tego utwórz wiele małych instancji aplikacji i zamontuj je na elementach, za które są odpowiedzialne.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Jeśli używasz Vue do wzbogacenia renderowanego po stronie serwera HTML i chcesz, aby Vue kontrolowało tylko określone części dużej strony, unikaj montowania jednej instancji Vue na całej stronie. Zamiast tego utwórz wiele małych instancji aplikacji i zamontuj je na elementach, za które są odpowiedzialne.
Jeśli używasz Vue do wzbogacenia HTML renderowanego po stronie serwera i potrzebujesz Vue tylko do kontrolowania określonych części dużej strony, unikaj montowania jednej instancji Vue na całej stronie. Zamiast tego utwórz wiele małych instancji aplikacji i zamontuj je na elementach, za które są odpowiedzialne.

This translation might be a bit clearer WDYT?


Vue uses an HTML-based template syntax that allows you to declaratively bind the rendered DOM to the underlying component instance's data. All Vue templates are syntactically valid HTML that can be parsed by spec-compliant browsers and HTML parsers.
Vue używa składni szablonów opartej na HTML, która pozwala deklaratywnie powiązać renderowany DOM z danymi w instancji komponentu. Wszystkie szablony Vue są składniowo poprawnym HTML, który może być parsowany przez zgodne z przepisami przeglądarki i analizatory HTML.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Vue używa składni szablonów opartej na HTML, która pozwala deklaratywnie powiązać renderowany DOM z danymi w instancji komponentu. Wszystkie szablony Vue są składniowo poprawnym HTML, który może być parsowany przez zgodne z przepisami przeglądarki i analizatory HTML.
Vue wykorzystuje składnię szablonów opartą na HTML, która pozwala deklaratywnie powiązać renderowany DOM z danymi bazowej instancji komponentu. Wszystkie szablony Vue są składniowo poprawnym kodem HTML, który może być analizowany przez przeglądarki i parsery HTML zgodne ze specyfikacją.

WDYT?


## Raw HTML {#raw-html}
## Surowy HTML {#raw-html}

The double mustaches interpret the data as plain text, not HTML. In order to output real HTML, you will need to use the [`v-html` directive](/api/built-in-directives#v-html):
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This line should be deleted since it's translated right?

Comment on lines +42 to +43
:::warning Ostrzeżenie dotyczące bezpieczeństwa
Dynamiczne renderowanie dowolnego HTML-a może prowadzić do [luk XSS](https://en.wikipedia.org/wiki/Cross-site_scripting). Używaj `v-html` tylko z zaufaną zawartością i **nigdy** z danymi dostarczonymi przez użytkownika. :::
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
:::warning Ostrzeżenie dotyczące bezpieczeństwa
Dynamiczne renderowanie dowolnego HTML-a może prowadzić do [luk XSS](https://en.wikipedia.org/wiki/Cross-site_scripting). Używaj `v-html` tylko z zaufaną zawartością i **nigdy** z danymi dostarczonymi przez użytkownika. :::
:::warning Ostrzeżenie dotyczące bezpieczeństwa
Dynamiczne renderowanie dowolnego HTML-a może prowadzić do [luk XSS](https://en.wikipedia.org/wiki/Cross-site_scripting). Używaj `v-html` tylko z zaufaną zawartością i **nigdy** z danymi dostarczonymi przez użytkownika.
:::

Should be the same as it is in original

<div :id></div>

<!-- this also works -->
<!-- to również działą -->
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<!-- to również działą -->
<!-- to również działa -->

{{ var a = 1 }}

<!-- flow control won't work either, use ternary expressions -->
<!-- kontrola przepływu również nie będzie działać, użyj wyrażeń ternary -->
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<!-- kontrola przepływu również nie będzie działać, użyj wyrażeń ternary -->
<!-- sterowanie przepływem nie zadziała, użyj wyrażeń warunkowych (trójargumentowych) -->

WDYT?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants