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

[Docs > Tutorial] page translation #77

Open
wants to merge 19 commits into
base: main
Choose a base branch
from

Conversation

dkasperczyk
Copy link

No description provided.

@dkasperczyk dkasperczyk self-assigned this Jul 24, 2024
@dkasperczyk dkasperczyk linked an issue Jul 24, 2024 that may be closed by this pull request
12 tasks

The tutorial assumes basic familiarity with HTML, CSS and JavaScript. If you are totally new to front-end development, it might not be the best idea to jump right into a framework as your first step - grasp the basics then come back! Prior experience with other frameworks helps, but is not required.
Samouczek zakłada podstawową znajomość HTML, CSS i JavaScript. Jeśli jesteś zupełnie nowy w rozwoju front-endu, może nie być najlepszym pomysłem przeskakiwanie od razu do frameworka jako pierwszego kroku - opanuj podstawy, a następnie wróć! Wcześniejsze doświadczenie z innymi frameworkami pomaga, ale nie jest wymagane.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
Samouczek zakłada podstawową znajomość HTML, CSS i JavaScript. Jeśli jesteś zupełnie nowy w rozwoju front-endu, może nie być najlepszym pomysłem przeskakiwanie od razu do frameworka jako pierwszego kroku - opanuj podstawy, a następnie wróć! Wcześniejsze doświadczenie z innymi frameworkami pomaga, ale nie jest wymagane.
Samouczek zakłada podstawową znajomość HTML, CSS i JavaScript. Jeśli jesteś zupełnie nowy w budowaniu front-endu, może nie być najlepszym pomysłem zaczynanie od razu do frameworka jako pierwszy krok - opanuj podstawy, a następnie wróć! Wcześniejsze doświadczenie z innymi frameworkami pomaga, ale nie jest wymagane.

I'm not entirely sure about the first suggestion but I think the idea was more like "being new to developing frontend" 😅
The second one I think should be more in line with the idea of "starting with a framework while still being a beginner in frontend things" 🤔


You can edit the code <span class="wide">on the right</span><span class="narrow">below</span> and see the result update instantly. Each step will introduce a core feature of Vue, and you will be expected to complete the code to get the demo working. If you get stuck, you will have a "Show me!" button that reveals the working code for you. Try not to rely on it too much - you'll learn faster by figuring things out on your own.
Możesz edytować kod <span class="wide">po prawej</span><span class="narrow">stronie</span> i natychmiast zobaczyć aktualizację wyniku. Każdy krok przedstawi podstawową funkcję Vue, a od użytkownika oczekuje się ukończenia kodu w celu uruchomienia wersji demonstracyjnej. Jeśli utkniesz, możesz skorzystać z przycisku „Pokaż odpowiedź!”, który ujawni działający kod. Postaraj się nie polegać na nim zbyt często - szybciej nauczysz się samodzielnie.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
Możesz edytować kod <span class="wide">po prawej</span><span class="narrow">stronie</span> i natychmiast zobaczyć aktualizację wyniku. Każdy krok przedstawi podstawową funkcję Vue, a od użytkownika oczekuje się ukończenia kodu w celu uruchomienia wersji demonstracyjnej. Jeśli utkniesz, możesz skorzystać z przycisku „Pokaż odpowiedź!”, który ujawni działający kod. Postaraj się nie polegać na nim zbyt często - szybciej nauczysz się samodzielnie.
Możesz edytować kod <span class="wide">po prawej</span><span class="narrow">poniżej</span> i natychmiast zobaczyć aktualizację wyniku. Każdy krok przedstawi podstawową funkcję Vue, a od użytkownika oczekuje się ukończenia kodu w celu uruchomienia wersji demonstracyjnej. Jeśli utkniesz, możesz skorzystać z przycisku „Pokaż odpowiedź!”, który ujawni działający kod. Postaraj się nie polegać na nim zbyt często - szybciej nauczysz się samodzielnie.

The .narrow and .wide spans are displayed conditionally based on media queries as layout changes. This should be more in line now 😄


If you are an experienced developer coming from Vue 2 or other frameworks, there are a few settings you can tweak to make the best use of this tutorial. If you are a beginner, it's recommended to go with the defaults.
Jeśli jesteś doświadczonym programistą pochodzącym z Vue 2 lub innych frameworków, istnieje kilka ustawień, które możesz dostosować, aby jak najlepiej wykorzystać ten samouczek. Jeśli jesteś początkującym programistą, zalecamy skorzystanie z ustawień domyślnych.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
Jeśli jesteś doświadczonym programistą pochodzącym z Vue 2 lub innych frameworków, istnieje kilka ustawień, które możesz dostosować, aby jak najlepiej wykorzystać ten samouczek. Jeśli jesteś początkującym programistą, zalecamy skorzystanie z ustawień domyślnych.
Jeśli jesteś doświadczonym programistą z doświadczeniem z Vue 2 lub innych frameworków, istnieje kilka ustawień, które możesz dostosować, aby jak najlepiej wykorzystać ten samouczek. Jeśli jesteś początkującym programistą, zalecamy skorzystanie z ustawień domyślnych.


```js
import { ... } from 'vue/dist/vue.esm-bundler.js'
```

inside your scripts or configure your build tool to resolve `vue` accordingly. Sample config for [Vite](https://vitejs.dev/):
wewnątrz skryptów lub skonfiguruj narzędzie kompilacji, aby odpowiednio rozwiązaywało `vue`. Przykładowa konfiguracja dla [Vite](https://vitejs.dev/):
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
wewnątrz skryptów lub skonfiguruj narzędzie kompilacji, aby odpowiednio rozwiązaywało `vue`. Przykładowa konfiguracja dla [Vite](https://vitejs.dev/):
wewnątrz skryptów lub skonfiguruj narzędzie kompilacji, aby odpowiednio rozumiało `vue`. Przykładowa konfiguracja dla [Vite](https://vitejs.dev/):

console.log(`new count is: ${newCount}`)
}
}
}
```

Here, we are using the `watch` option to watch changes to the `count` property. The watch callback is called when `count` changes, and receives the new value as the argument. More details are covered in <a target="_blank" href="/guide/essentials/watchers.html">Guide - Watchers</a>.
Tutaj używamy opcji `watch` do obserwowania zmian we właściwości `count`. Wywołanie zwrotne watch jest wywoływane, gdy zmienia się `count` i otrzymuje nową wartość jako argument. Więcej szczegółów znajduje się w <a target="_blank" href="/guide/essentials/watchers.html">Przewodnik - Obserwatorz</a>.
Copy link
Collaborator

Choose a reason for hiding this comment

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

We might want to stick to one convention - we used untranslated (Watchers) above. Should we stick to english here or polish? WDYT? 🤔

Copy link
Author

@dkasperczyk dkasperczyk Jul 31, 2024

Choose a reason for hiding this comment

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

Personally, I would prefer to stick with English, but I checked how it was done in other translations, and they translated it as well. So maybe we should also translate technical words/sentences to Polish, even if they do not sound good. 🙈

Edit: I saw your comments below, and maybe we should use more familiar words. I think 'Watchers' will be clearer

@@ -99,6 +99,6 @@ createApp({
+ <li v-for="todo in filteredTodos">
```

A computed property tracks other reactive state used in its computation as dependencies. It caches the result and automatically updates it when its dependencies change.
Obliczana właściwość śledzi inne stany reaktywne używane w jej obliczeniach jako zależności. Buforuje wynik i automatycznie aktualizuje go, gdy zmieniają się jego zależności.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
Obliczana właściwość śledzi inne stany reaktywne używane w jej obliczeniach jako zależności. Buforuje wynik i automatycznie aktualizuje go, gdy zmieniają się jego zależności.
Właściwość computed śledzi inne stany reaktywne używane w jej obliczeniach jako zależności. Cache'uje wynik i automatycznie aktualizuje go, gdy zmieniają się jego zależności.

It might be better to stick to more familiar terms 😄

Copy link
Author

Choose a reason for hiding this comment

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

Agree!


Now, try to add the `filteredTodos` computed property and implement its computation logic! If implemented correctly, checking off a todo when hiding completed items should instantly hide it as well.
Teraz spróbuj dodać właściwość obliczaną `filteredTodos` i zaimplementuj jej logikę obliczeniową! Jeśli zostanie zaimplementowana poprawnie, zaznaczenie todo podczas ukrywania ukończonych elementów powinno natychmiast je ukryć.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
Teraz spróbuj dodać właściwość obliczaną `filteredTodos` i zaimplementuj jej logikę obliczeniową! Jeśli zostanie zaimplementowana poprawnie, zaznaczenie todo podczas ukrywania ukończonych elementów powinno natychmiast je ukryć.
Teraz spróbuj dodać właściwość computed `filteredTodos` i zaimplementuj jej logikę obliczeniową! Jeśli zostanie zaimplementowana poprawnie, zaznaczenie todo podczas ukrywania ukończonych elementów powinno natychmiast je ukryć.

@@ -1,16 +1,16 @@
# Lifecycle and Template Refs {#lifecycle-and-template-refs}
# Cykl życia i odnośniki do elementów w szablonie {#lifecycle-and-template-refs}
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
# Cykl życia i odnośniki do elementów w szablonie {#lifecycle-and-template-refs}
# Cykl życia i template refs {#lifecycle-and-template-refs}


```vue-html
<p ref="pElementRef">hello</p>
```

<div class="composition-api">

To access the ref, we need to declare<span class="html"> and expose</span> a ref with matching name:
Aby uzyskać dostęp do referencji, musimy zadeklarować<span class="html"> i udostępnić</span> referencję o pasującej nazwie:
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
Aby uzyskać dostęp do referencji, musimy zadeklarować<span class="html"> i udostępnić</span> referencję o pasującej nazwie:
Aby uzyskać dostęp do referencji, musimy zadeklarować<span class="html"> i udostępnić</span> wartość ref o pasującej nazwie:

}
})
```

</div>
</div>

This is called a **lifecycle hook** - it allows us to register a callback to be called at certain times of the component's lifecycle. There are other hooks such as <span class="options-api">`created` and `updated`</span><span class="composition-api">`onUpdated` and `onUnmounted`</span>. Check out the <a target="_blank" href="/guide/essentials/lifecycle.html#lifecycle-diagram">Lifecycle Diagram</a> for more details.
Nazywa się to **lifecycle hook** - pozwala nam zarejestrować wywołanie zwrotne, które będzie wywoływane w określonych momentach cyklu życia komponentu. Istnieją inne hook'i, takie jak <span class="options-api">`created` i `updated`</span><span class="composition-api">`onUpdated` i `onUnmounted`</span>. Sprawdź <a target="_blank" href="/guide/essentials/lifecycle.html#lifecycle-diagram">diagram cyklu życia komponentu</a> aby uzyskać więcej informacji.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
Nazywa się to **lifecycle hook** - pozwala nam zarejestrować wywołanie zwrotne, które będzie wywoływane w określonych momentach cyklu życia komponentu. Istnieją inne hook'i, takie jak <span class="options-api">`created` i `updated`</span><span class="composition-api">`onUpdated` i `onUnmounted`</span>. Sprawdź <a target="_blank" href="/guide/essentials/lifecycle.html#lifecycle-diagram">diagram cyklu życia komponentu</a> aby uzyskać więcej informacji.
Nazywa się to **lifecycle hook** - pozwala nam zarejestrować funkcję, która będzie wywoływana w określonych momentach cyklu życia komponentu. Istnieją inne hook'i, takie jak <span class="options-api">`created` i `updated`</span><span class="composition-api">`onUpdated` i `onUnmounted`</span>. Sprawdź <a target="_blank" href="/guide/essentials/lifecycle.html#lifecycle-diagram">diagram cyklu życia komponentu</a> aby uzyskać więcej informacji.

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.

[Docs > Tutorial] page translation
2 participants