Skip to content

Sync language/wrappers with EN #24

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

Merged
Sobak merged 1 commit into from
Dec 10, 2025
Merged

Sync language/wrappers with EN #24

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
194 changes: 194 additions & 0 deletions language/wrappers/audio.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,194 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8bc832a464e33122e8129f5a623bd845b69fa7e0 Maintainer: grzesiek Status: ready -->
<!-- $Revision$ -->

<refentry xml:id="wrappers.audio" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" annotations="verify_info:false" role="stream_wrapper">
<refnamediv>
<refname>ogg://</refname>
<refpurpose>Strumienie audio</refpurpose>
</refnamediv>

<refsect1 role="description"><!-- {{{ -->
&reftitle.description;
<para>
Pliki otwierane do odczytu przez wrapper <filename>ogg://</filename>
są traktowane jako skompresowane dane audio zakodowane przy użyciu kodeka <literal>OGG/Vorbis</literal>.
Podobnie, pliki otwierane do zapisu lub dołączania przez wrapper
<filename>ogg://</filename> są zapisywane jako skompresowane dane audio.
Funkcja <function>stream_get_meta_data</function>, gdy zostanie użyta na pliku <literal>OGG/Vorbis</literal>
otwartym do odczytu, zwróci różne szczegóły dotyczące strumienia,
w tym znacznik <parameter>vendor</parameter>, wszelkie dołączone
<parameter>comments</parameter>, liczbę
<parameter>channels</parameter>, próbkowanie <parameter>rate</parameter>,
i zakres szybkości kodowania opisany przez:
<parameter>bitrate_lower</parameter>, <parameter>bitrate_upper</parameter>,
<parameter>bitrate_nominal</parameter>, i <parameter>bitrate_window</parameter>.
</para>

<simpara><filename>ogg://</filename> (PECL)</simpara>
<note>
<title>Ten wrapper nie jest domyślnie włączony</title>
<simpara>
Aby użyć wrappera <filename>ogg://</filename>,
rozszerzenie
<link xlink:href="&url.pecl.package;oggvorbis">OGG/Vorbis</link>
dostępne z &link.pecl; musi być zainstalowane.
</simpara>
</note>
</refsect1><!-- }}} -->

<refsect1 role="usage"> <!-- {{{ -->
&reftitle.usage;
<itemizedlist>
<listitem><simpara><filename>ogg://soundfile.ogg</filename></simpara></listitem>
<listitem><simpara><filename>ogg:///path/to/soundfile.ogg</filename></simpara></listitem>
<listitem><simpara><filename>ogg://http://www.example.com/path/to/soundstream.ogg</filename></simpara></listitem>
</itemizedlist>
</refsect1> <!-- }}} -->

<refsect1 role="options"><!-- {{{ -->
&reftitle.options;
<para>
<table>
<title>Podsumowanie wrappera</title>
<tgroup cols="2">
<thead>
<row>
<entry>Atrybut</entry>
<entry>Obsługiwany</entry>
</row>
</thead>
<tbody>
<row>
<entry>Zastrzeżone przez <link linkend="ini.allow-url-fopen">allow_url_fopen</link></entry>
<entry>Nie</entry>
</row>
<row>
<entry>Umożliwia odczytywanie</entry>
<entry>Tak</entry>
</row>
<row>
<entry>Umożliwia zapisywanie</entry>
<entry>Tak</entry>
</row>
<row>
<entry>Umożliwia dołączanie</entry>
<entry>Tak</entry>
</row>
<row>
<entry>Umożliwia jednocześnie odczytywanie i zapisywanie</entry>
<entry>Nie</entry>
</row>
<row>
<entry>Obsługuje <function>stat</function></entry>
<entry>Nie</entry>
</row>
<row>
<entry>Obsługuje <function>unlink</function></entry>
<entry>Nie</entry>
</row>
<row>
<entry>Obsługuje <function>rename</function></entry>
<entry>Nie</entry>
</row>
<row>
<entry>Obsługuje <function>mkdir</function></entry>
<entry>Nie</entry>
</row>
<row>
<entry>Obsługuje <function>rmdir</function></entry>
<entry>Nie</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<!-- FIXME: This should not be here! context.audio... -->
<para>
<table>
<title>Opcje kontekstu</title>
<tgroup cols="3">
<thead>
<row>
<entry>Nazwa</entry>
<entry>Użycie</entry>
<entry>Domyśnie</entry>
<entry>Tryb</entry>
</row>
</thead>
<tbody>
<row>
<entry><literal>pcm_mode</literal></entry>
<entry>
Kodowanie PCM do zastosowania podczas odczytu, jedno z:
<constant>OGGVORBIS_PCM_U8</constant>, <constant>OGGVORBIS_PCM_S8</constant>,
<constant>OGGVORBIS_PCM_U16_BE</constant>, <constant>OGGVORBIS_PCM_S16_BE</constant>,
<constant>OGGVORBIS_PCM_U16_LE</constant> i <constant>OGGVORBIS_PCM_S16_LE</constant>.
(8 lub 16 bitów, ze znakiem lub bez znaku, duży lub mały <literal>endian</literal>)
</entry>
<entry>OGGVORBIS_PCM_S16_LE</entry>
<entry>Odczyt</entry>
</row>
<row>
<entry><literal>rate</literal></entry>
<entry>
Częstotliwość próbkowania danych wejściowych, wyrażona w Hz
</entry>
<entry>44100</entry>
<entry>Zapis/Dołączenie</entry>
</row>
<row>
<entry><literal>bitrate</literal></entry>
<entry>
Gdy podana jako liczba całkowita, stała szybkość transmisji bitów, przy której ma być kodowana. (16000 do 131072)
Podana jako liczba zmiennoprzecinkowa, zmienna jakość bitrate do użycia. (-1.0 do 1.0)
</entry>
<entry>128000</entry>
<entry>Zapis/Dołączenie</entry>
</row>
<row>
<entry><literal>channels</literal></entry>
<entry>
Liczba kanałów audio do zakodowania, zazwyczaj 1 (Mono) lub 2 (Stereo).
Może wynosić nawet 16.
</entry>
<entry>2</entry>
<entry>Zapis/Dołączenie</entry>
</row>
<row>
<entry><literal>comments</literal></entry>
<entry>
Tablica wartości ciągów znaków do zakodowania w nagłówku ścieżki.
</entry>
<entry/>
<entry>Zapis/Dołączenie</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</refsect1> <!-- }}} -->

</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

143 changes: 143 additions & 0 deletions language/wrappers/compression.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,143 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8bc832a464e33122e8129f5a623bd845b69fa7e0 Maintainer: grzesiek Status: ready -->
<!-- $Revision$ -->

<refentry xml:id="wrappers.compression" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" annotations="verify_info:false" role="stream_wrapper">
<refnamediv>
<refname>zlib://</refname>
<refname>bzip2://</refname>
<refname>zip://</refname>
<refpurpose>Strumienie kompresji</refpurpose>
</refnamediv>

<refsect1 role="description"><!-- {{{ -->
&reftitle.description;
<simpara><filename>compress.zlib://</filename> i <filename>compress.bzip2://</filename></simpara>

<simpara>
<filename>zlib:</filename> działa jak <function>gzopen</function>, z wyjątkiem tego, że
strumień może być używany z funkcją <function>fread</function> i innymi
funkcjami systemu plików. Jest to przestarzałe z powodu
niejednoznaczności z nazwami plików zawierającymi znaki ':'; zamiast tego
należy użyć <filename>compress.zlib://</filename>.
</simpara>

<simpara>
<filename>compress.zlib://</filename> i
<filename>compress.bzip2://</filename> odpowiednikami odpowiednio
<function>gzopen</function> i <function>bzopen</function>
i działają nawet na systemach, które nie obsługują
fopencookie.
</simpara>

<simpara>
<link linkend="book.zip">Rozszerzenie ZIP</link> rejestruje wrapper <filename>zip:</filename>. Począwszy
od PHP 7.2.0 i libzip 1.2.0+, dodano obsługę haseł dla zaszyfrowanych archiwów, umożliwiając dostarczanie
haseł przez konteksty strumieni. Hasła można ustawić za pomocą opcji <literal>'password'</literal>
kontekstu strumienia.
</simpara>
</refsect1><!-- }}} -->

<refsect1 role="usage"> <!-- {{{ -->
&reftitle.usage;
<itemizedlist>
<listitem><simpara><filename>compress.zlib://file.gz</filename></simpara></listitem>
<listitem><simpara><filename>compress.bzip2://file.bz2</filename></simpara></listitem>
<listitem><simpara><filename>zip://archive.zip#dir/file.txt</filename></simpara></listitem>
</itemizedlist>
</refsect1> <!-- }}} -->

<refsect1 role="options"><!-- {{{ -->
&reftitle.options;
<para>
<table>
<title>Wrapper Summary</title>
<tgroup cols="2">
<thead>
<row>
<entry>Atrybut</entry>
<entry>Obsługiwany</entry>
</row>
</thead>
<tbody>
<row>
<entry>Zasrzeżony przez <link linkend="ini.allow-url-fopen">allow_url_fopen</link></entry>
<entry>Nie</entry>
</row>
<row>
<entry>Umożliwia odczytywanie</entry>
<entry>Tak</entry>
</row>
<row>
<entry>Umożliwia zapisywanie</entry>
<entry>Tak (oprócz <literal>zip://</literal>)</entry>
</row>
<row>
<entry>Umożliwia dołączanie</entry>
<entry>Tak (oprócz <literal>zip://</literal>)</entry>
</row>
<row>
<entry>Umożliwia jednocześnie odczytywanie i zapisywanie</entry>
<entry>Nie</entry>
</row>
<row>
<entry>Obsługuje <function>stat</function></entry>
<entry>
Nie, użyj normalnego wrappera <literal>file://</literal>
do uzyskania informacji o skompresowanych plikach.
</entry>
</row>
<row>
<entry>Obsługuje <function>unlink</function></entry>
<entry>
Nie, użyj normalnego wrappera <literal>file://</literal>
aby usuąć skompresowane pliki.
</entry>
</row>
<row>
<entry>Obsługuje <function>rename</function></entry>
<entry>Nie</entry>
</row>
<row>
<entry>Obsługuje <function>mkdir</function></entry>
<entry>Nie</entry>
</row>
<row>
<entry>Obsługuje <function>rmdir</function></entry>
<entry>Nie</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</refsect1> <!-- }}} -->

<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
<member><xref linkend="context.zlib" /></member>
</simplelist>
</refsect1>
</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

Loading