Sync array functions with EN by grzegorz-bankowski · Pull Request #4 · php/doc-pl

grzegorz-bankowski · 2024-05-09T16:03:27Z

No description provided.

Sobak

Dobra robota, mnóstwo poprawek starych tłumaczeń zdecydowanie na plus jeśli chodzi o naturalność po polsku. Co prawda nie przejrzałem jeszcze 100% i może się wydawać, że komentarzy jest dużo, ale szybko zobaczysz że to może 3-4 powracające sugestie.

Co-authored-by: Maciej Sobaczewski <msobaczewski@gmail.com>

Sobak

Hej, sorry za bardzo późny review. W sumie mam głównie powtarzalne względem wcześniej poprawionych plików uwagi, plus jakieś tam drobiazgi.

Sobak · 2024-05-17T01:27:57Z

 <para>
- Porównuje <parameter>tablica1</parameter> z jedną lub większą ilością tablic
- i zwraca wartości <parameter>tablica1</parameter>, które nie są obecne w
+ Porównuje <parameter>array</parameter> z jedną lub większą ilością tablic


Suggested change
Porównuje <parameter>array</parameter> z jedną lub większą ilością tablic
Porównuje tablicę <parameter>array</parameter> z jedną lub większą ilością tablic
chodzi mi o to, aby chociaż raz na stronę zaznaczyć że "array" to własnie tablica. Niby oczywiste, ale wydaje mi się że kiedy już tłumaczymy manual to warto o to zadbać. Dokłada jeden wyraz i jeśli zna się angielski, to wychodzi trochę masło maślane, ale unikamy niejasności, w wypadku gdyby ktoś jednak tego nie wiedział.
Analogiczna uwaga tyczy się też innych plików w tym PR, tych poniżej array_diff, bo wcześniejsze już poprawiliśmy,. Spróbuj po prostu przejrzeć pod tym kątem.

Sobak · 2024-05-17T01:30:29Z

+
+ <para>
+ <example>
+ <title><function>array_diff</function> przykład z niepasującymi typami</title>


To tłumaczenie wydaje się być bardzo skalkowane gramatycznie z angielskiego. Dałbym albo klasycznie: "Przykład użycia array_diff z niepasującymi typami" lub "array_diff z niepasującymi typami", jako że przy renderowaniu to i tak będzie miało pełną postać: "Przykład #1: array_diff() z niepasującymi danymi"

Sobak · 2024-05-17T01:32:33Z

+ <para>
+ Dwa elementy są uznawane za równe wtedy i tylko wtedy, gdy
+ <literal>(string) $elem1 === (string) $elem2</literal>. To jest,
+ kiedy <link linkend="language.types.string.casting">reprezentacja łańcuchowa</link> jest taka sama.


Osobiście tłumaczyłem jako "reprezentacja jako ciąg znaków" (jako że też tłumaczyłem sporo stron w reference/array/, tych bez En-Revision), ale tutaj sam nie jestem pewien. Wydaje mi się po prostu, że w tych czasach coraz rzadziej widuję tłumaczenie "string" na "łańcuch", ale zasadniczo to w ogole mało widzę tłumaczenia tego wyrazu, więc może mi się zdawać po prostu

Zamienione na "reprezentacja jako ciąg znaków".

Sobak · 2024-05-17T01:33:30Z

+ <programlisting role="php">
+ <![CDATA[
+<?php
+// Spowoduje to wygenerowanie Powiadomienia, że tablica nie może zostać rzutowana na ciąg znaków.


Suggested change
// Spowoduje to wygenerowanie Powiadomienia, że tablica nie może zostać rzutowana na ciąg znaków.
// Spowoduje to wygenerowanie komunikatu E_NOTICE, że tablica nie może zostać rzutowana na ciąg znaków.
w przeciwnym razie nie wiedziałbym o jakiego rodzaju "powiadomieniu" jest mowa. Przekład nie jest dosłowny, ale powinien być o wiele bardziej zrozumiały.

Tutaj zamieniam na "Ostrzeżenie", było w oryginale "Notice", co może być tłumaczone jako ostrzeżenie lub niezalecane "Powiadomienie". Plik zrzutu z kompilatora w załączeniu. Odziwo dla wersji < 8.0 jest w ang. notice.

To jest ciekawy przypadek, bo śmiem twierdzić że dokumentacja po angielsku jest po prostu błędna lub raczej nieaktualna, i że mają na myśli właśnie e_notice. W tej sytuacji zawsze powstaje dylemat czy powinniśmy poprawiać takie rzeczy tłumacząc, czy nie. Prawdopodobnie powinniśmy tłumaczyć dosłownie i czekać na poprawkę w pierwowzorze.
Z drugiej strony, może chodzić własnie o to, że użyli "notice" jako wyrazu, który ujmie oba te przypadki, a więcej detali jest opisanych w innych częściach tej strony (czyli różnica między e_notice a e_warning zależnie od wersji PHP)

Sobak · 2024-05-17T01:34:41Z

+$filter = [3, 4, [5], 6];
+$result = array_diff($source, $filter);
+
+// Jest to w porządku, ponieważ obiekty mogą rzutować na ciąg znaków.


A może tak? Wydaje mi się że będzie bardziej naturalnie:
Suggested change
// Jest to w porządku, ponieważ obiekty mogą rzutować na ciąg znaków.
// Zadziała ponieważ te obiekty mogą zostać zrzutowane na ciąg znaków.

Sobak · 2024-05-17T01:35:09Z

 <para>
-Wyemituje błąd <constant>E_WARNING</constant> jeżeli <parameter>ilość</parameter> jest
-mniejsza niż zero.
+Zgosi błąd <classname>ValueError</classname> jeśli <parameter>count</parameter> jest


Suggested change
Zgosi błąd <classname>ValueError</classname> jeśli <parameter>count</parameter> jest
Zgłosi błąd <classname>ValueError</classname> jeśli <parameter>count</parameter> jest

Sobak · 2024-05-17T01:35:30Z

+ </para>
+ <para>
+ <example xml:id="function.array-fill.example.negative-start-index">
+ <title><function>array_fill</function> przykład z ujemnym indeksem początkowym</title>


j/w dla tytułu przykładu

Sobak

LGTM!

grzegorz-bankowski added 2 commits May 9, 2024 15:34

Sync array functions with EN
d72f70e

Insert missing closing tag
af70c02

Sobak reviewed May 9, 2024
View reviewed changes

grzegorz-bankowskiand others added 10 commits May 9, 2024 22:15

Change array-filter.xml file
60f4459

Update reference/array/functions/array-diff-uassoc.xml
1bb7d1c
Co-authored-by: Maciej Sobaczewski <msobaczewski@gmail.com>

Update reference/array/functions/array-diff-assoc.xml
b5844af
Co-authored-by: Maciej Sobaczewski <msobaczewski@gmail.com>

Update reference/array/functions/array-count-values.xml
68865af
Co-authored-by: Maciej Sobaczewski <msobaczewski@gmail.com>

Update reference/array/functions/array-count-values.xml
e7bbf56
Co-authored-by: Maciej Sobaczewski <msobaczewski@gmail.com>

Update reference/array/functions/array-combine.xml
4966a7d
Co-authored-by: Maciej Sobaczewski <msobaczewski@gmail.com>

Update reference/array/functions/array-combine.xml
6623df4
Co-authored-by: Maciej Sobaczewski <msobaczewski@gmail.com>

Update reference/array/functions/array-combine.xml
b86328c
Co-authored-by: Maciej Sobaczewski <msobaczewski@gmail.com>

Update reference/array/functions/array-combine.xml
db0587f
Co-authored-by: Maciej Sobaczewski <msobaczewski@gmail.com>

Update reference/array/functions/array-chunk.xml
098495a
Co-authored-by: Maciej Sobaczewski <msobaczewski@gmail.com>

Sobak requested changes May 17, 2024
View reviewed changes

Change array functions files
d92e09f

Sobak approved these changes May 22, 2024
View reviewed changes

Sobak merged commit 0409835 into php:masterMay 22, 2024

grzegorz-bankowski deleted the array-functions branch May 29, 2024 12:26

	Porównuje <parameter>array</parameter> z jedną lub większą ilością tablic
	Porównuje tablicę <parameter>array</parameter> z jedną lub większą ilością tablic

	// Spowoduje to wygenerowanie Powiadomienia, że tablica nie może zostać rzutowana na ciąg znaków.
	// Spowoduje to wygenerowanie komunikatu E_NOTICE, że tablica nie może zostać rzutowana na ciąg znaków.

	// Jest to w porządku, ponieważ obiekty mogą rzutować na ciąg znaków.
	// Zadziała ponieważ te obiekty mogą zostać zrzutowane na ciąg znaków.

	Zgosi błąd <classname>ValueError</classname> jeśli <parameter>count</parameter> jest
	Zgłosi błąd <classname>ValueError</classname> jeśli <parameter>count</parameter> jest

Uh oh!

Conversation

grzegorz-bankowski commented May 9, 2024

Uh oh!

Sobak left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Sobak left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

grzegorz-bankowskiMay 17, 2024• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Sobak left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

grzegorz-bankowskiMay 17, 2024•
edited
Loading