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.

Sign up for GitHub

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

Sync filesystem functions files with EN #7

Merged
merged 6 commits into from
May 24, 2024
Merged

Sync filesystem functions files with EN #7

Show file tree
Hide file tree
Changes from 3 commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
8b555a6
Sync filesystem functions with EN
grzegorz-bankowski May 21, 2024
604be6b
Change disk-total-space.xml file
grzegorz-bankowski May 21, 2024
bc38a06
Change fgetcsv.xml file
grzegorz-bankowski May 21, 2024
35a48bf
Update reference/filesystem/functions/dirname.xml
grzegorz-bankowski May 23, 2024
b8f4074
Update reference/filesystem/functions/dirname.xml
grzegorz-bankowski May 23, 2024
8002181
Update reference/filesystem/functions/file-get-contents.xml
grzegorz-bankowski May 23, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 11 additions & 10 deletions reference/filesystem/functions/basename.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,19 +1,19 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 7e4167f3f2e202ba4463fbc3851e56067f085326 Maintainer: sobak Status: ready -->
<!-- EN-Revision: 88c1f8d6c9fecf352c5ce152a6f758ed013fc2c0 Maintainer: sobak Status: ready -->
<!-- $Revision$ -->
<!-- CREDITS: adi -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.basename">
<!-- CREDITS: adi, sobak, grzesiek -->
<refentry xml:id="function.basename" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>basename</refname>
<refpurpose>Zwraca nazwę pliku, będącego składową ścieżki</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>basename</methodname>
<methodparam><type>string</type><parameter>ścieżka</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>przyrostek</parameter></methodparam>
<methodparam><type>string</type><parameter>path</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>suffix</parameter><initializer>""</initializer></methodparam>
</methodsynopsis>
<para>
Z podanego łańcucha zawierającego ścieżkę do pliku, funkcja
Expand All @@ -31,6 +31,8 @@
<function>basename</function> bierze pod uwagę obecnią lokalizację systemu, więc aby widzieć
prawidłowe basename ze ścieżek zawierających znaki spoza alfabetu łacińskiego, musi zostać
ustawiona odpowiednia lokalizacja przy pomocy funkcji <function>setlocale</function>.
Jeśli parametr <parameter>path</parameter> zawiera znaki, które są nieprawidłowe dla
bieżących ustawień regionalnych, zachowanie <function>basename</function> jest niezdefiniowane.
Copy link
Contributor

Choose a reason for hiding this comment

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

To jest coś co na 100% chcę opisać w readme (glossary, czy jakkolwiek to nazwiemy), wydaje mi się że trzeba tutaj coś dobrze pomyśleć. Zakładam że tłumaczyłeś frazę "locale settings". Nie wiem czy istnieje jakieś powszechnie używane tłumaczenie w j. polskim, więc ja tłumaczyłem na "ustawienia locale", co brzmi fatalnie ale przynajmniej pozwala wyszukać coś w Google na ten temat.

Co Ty na to, żeby połączyć Twoje lepsze tlumaczenie z moim i tłumaczyć to jako "ustawień regionalnych (locale)"? Wtedy mógłbym to z czystym sumieniem dać do tego glossary bo chyba łączy zalety obu.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Super pasuje mi to "ustawień regionalnych (locale)" i oczywiście będzie to w README / Glossary.

</para>
</note>
</refsect1>
Expand All @@ -40,7 +42,7 @@
<para>
<variablelist>
<varlistentry>
<term><parameter>ścieżka</parameter></term>
<term><parameter>path</parameter></term>
<listitem>
<para>
Ścieżka
Expand All @@ -53,10 +55,10 @@
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>przyrostek</parameter></term>
<term><parameter>suffix</parameter></term>
<listitem>
<para>
Jeśli plik kończy się <parameter>przyrostkiem</parameter> to także zostanie on
Jeśli plik kończy się przyrostkiem <parameter>suffix</parameter> to także zostanie on
obcięty.
</para>
</listitem>
Expand Down Expand Up @@ -115,7 +117,6 @@ echo "6) ".basename("/");
</refsect1>

</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Expand Down
44 changes: 9 additions & 35 deletions reference/filesystem/functions/clearstatcache.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,19 +1,19 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: d1d11ef7fa6e705dec67a2269204778c0e74887f Maintainer: adi Status: ready -->
<!-- EN-Revision: e82ff8a846af03b863c4a57fbedc0a93af0e68db Maintainer: adi Status: ready -->
<!-- $Revision$ -->
<!-- CREDITS: sobak -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.clearstatcache">
<!-- CREDITS: sobak, grzesiek -->
<refentry xml:id="function.clearstatcache" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>clearstatcache</refname>
<refpurpose>Czyści bufor statusu pliku</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>void</type><methodname>clearstatcache</methodname>
<methodparam choice="opt"><type>bool</type><parameter>clear_realpath_cache</parameter><initializer>false</initializer></methodparam>
<methodparam choice="opt"><type>string</type><parameter>nazwa_pliku</parameter></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>clear_realpath_cache</parameter><initializer>&false;</initializer></methodparam>
<methodparam choice="opt"><type>string</type><parameter>filename</parameter><initializer>""</initializer></methodparam>
</methodsynopsis>
<para>
Kiedy używasz <function>stat</function>, <function>lstat</function> lub
Expand All @@ -31,7 +31,7 @@
Jeśli wywołasz <function>file_exists</function> na pliku, który nie istnieje
zostanie zwrócone &false; dopóki nie stworzysz tego pliku. Jeśli go utworzysz
funkcja zwróci &true; nawet jeśli go później skasujesz.
Jednakże <function>unlink</function> czyści automatycznie bufor.
Jednakże <function>unlink</function> czyści automatycznie bufor.
</para>
<note>
<para>
Expand Down Expand Up @@ -71,12 +71,12 @@
<term><parameter>clear_realpath_cache</parameter></term>
<listitem>
<para>
Czy czyścić bufor o prawdziwej ścieżce, czy nie.
Czy czyścić <emphasis>również</emphasis> bufor ścieżki prawdziwej.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>nazwa_pliku</parameter></term>
<term><parameter>filename</parameter></term>
<listitem>
<para>
Czyści bufor o prawdziwej ścieżce tylko dla podanego pliku; tylko jeśli
Expand All @@ -95,31 +95,6 @@
</para>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>5.3.0</entry>
<entry>
Dodano opcjonalne parametry <parameter>clear_realpath_cache</parameter>
i <parameter>filename</parameter>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<para>
Expand Down Expand Up @@ -162,7 +137,6 @@ UID @ Sun, 12 Oct 2008 20:48:28 +0100: ross
</refsect1>

</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Expand Down
67 changes: 15 additions & 52 deletions reference/filesystem/functions/copy.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,23 +1,25 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 26646268168d57f4c916dc102b9fa473800d36f2 Maintainer: adi Status: ready -->
<!-- EN-Revision: ea62fb83196997032641b50fe44420305466195e Maintainer: adi Status: ready -->
<!-- $Revision$ -->
<!-- CREDITS: sobak, grzesiek -->
<refentry xml:id="function.copy" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>copy</refname>
<refpurpose>Kopiuje plik</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>copy</methodname>
<methodparam><type>string</type><parameter>źródło</parameter></methodparam>
<methodparam><type>string</type><parameter>przeznaczenie</parameter></methodparam>
<methodparam choice="opt"><type>resource</type><parameter>kontekst</parameter></methodparam>
<methodparam><type>string</type><parameter>from</parameter></methodparam>
<methodparam><type>string</type><parameter>to</parameter></methodparam>
<methodparam choice="opt"><type class="union"><type>resource</type><type>null</type></type>
<parameter>context</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
Kopiuje plik z <parameter>źródło</parameter> do
<parameter>przeznaczenie</parameter>.
Kopiuje plik z parametru <parameter>from</parameter> do
parametru <parameter>to</parameter>.
</para>
<para>
Jeśli chcesz przenieść plik, użyj funkcji <function>rename</function>.
Expand All @@ -29,18 +31,18 @@
<para>
<variablelist>
<varlistentry>
<term><parameter>źródło</parameter></term>
<term><parameter>from</parameter></term>
<listitem>
<para>
Ścieżka do pliku źródłowego.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>przeznaczenie</parameter></term>
<term><parameter>to</parameter></term>
<listitem>
<para>
Ścieżka docelowa. Jeśli <parameter>przeznaczenie</parameter> jest URLem,
Ścieżka docelowa. Jeśli parametr <parameter>to</parameter> jest URLem,
operacja kopiowania może się niepowieść, jeśli wrapper nie obsługuje nadpisywania
istniejących plików.
</para>
Expand Down Expand Up @@ -71,48 +73,9 @@
</para>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>5.3.4</entry>
<entry>
Parametr <parameter>kontekst</parameter> faktycznie ma wpływ.
Wcześniej dowolny <parameter>kontekst</parameter> był ignorowany.
</entry>
</row>
<row>
<entry>5.3.0</entry>
<entry>
Dodano obsługę kontekstu.
</entry>
</row>
<row>
<entry>4.3.0</entry>
<entry>
Zarówno <parameter>źródło</parameter> i <parameter>przeznaczenie</parameter>
mogą być URLami jeśli "wrappery fopen" zostały włączone.
Zobacz <function>fopen</function> w celu poznania więcej szczegółów.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>

<refsect1 role="examples">
<refsect1 role="examples">
&reftitle.examples;
<para>
<para>
<example>
<title><function>copy</function> przykład</title>
<programlisting role="php">
Expand All @@ -137,7 +100,7 @@ if (!copy($file, $newfile)) {
<simplelist>
<member><function>move_uploaded_file</function></member>
<member><function>rename</function></member>
<member>Rozdział podręcznika dotyczący<link
<member>Rozdział podręcznika dotyczący<link
linkend="features.file-upload">obsługi wgrywania plików</link></member>
</simplelist>
</para>
Expand Down
15 changes: 8 additions & 7 deletions reference/filesystem/functions/delete.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,19 +1,20 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 9514f50e8909210419382868c321703037375191 Maintainer: adi Status: ready -->
<!-- EN-Revision: ec6e871a47fa15228aa3299f46fed826422adbc0 Maintainer: adi Status: ready -->
<!-- $Revision$ -->
<refentry xml:id="function.delete" xmlns="http://docbook.org/ns/docbook" annotations="verify_info:false">
<!-- CREDITS: sobak, grzesiek -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.delete" annotations="verify_info:false">
<refnamediv>
<refname>delete</refname>
<refpurpose>Zobacz <function>unlink</function> lub
<function>unset</function></refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<para>
To jest ślepy wpis aby zadowolić ludzi którzy szukają
<function>unlink</function> lub <function>unset</function>
w nie właściwym miejscu.
W języku PHP nie ma słowa kluczowego ani funkcji delete.
Jeśli trafiłeś na tę stronę w celu usunięcia pliku, wypróbuj funkcję <function>unlink</function>.
Aby usunąć zmienną z zakresu lokalnego, sprawdź funkcję <function>unset</function>.
</para>
</refsect1>

Expand All @@ -26,7 +27,7 @@
</simplelist>
</para>
</refsect1>

</refentry>

<!-- Keep this comment at the end of the file
Expand Down
Loading