Skip to content

Commit c9de94d

Browse files
grzegorz-bankowskigrzegorz-bankowski
authored
Sync language/wrappers with EN (#24)
1 parent f4d7706 commit c9de94d

12 files changed

Lines changed: 2330 additions & 0 deletions

File tree

‎language/wrappers/audio.xml‎

Lines changed: 194 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,194 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: 8bc832a464e33122e8129f5a623bd845b69fa7e0 Maintainer: grzesiek Status: ready -->
3+
<!-- $Revision$ -->
4+
5+
<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">
6+
<refnamediv>
7+
<refname>ogg://</refname>
8+
<refpurpose>Strumienie audio</refpurpose>
9+
</refnamediv>
10+
11+
<refsect1 role="description"><!-- {{{ -->
12+
&reftitle.description;
13+
<para>
14+
Pliki otwierane do odczytu przez wrapper <filename>ogg://</filename>
15+
są traktowane jako skompresowane dane audio zakodowane przy użyciu kodeka <literal>OGG/Vorbis</literal>.
16+
Podobnie, pliki otwierane do zapisu lub dołączania przez wrapper
17+
<filename>ogg://</filename> są zapisywane jako skompresowane dane audio.
18+
Funkcja <function>stream_get_meta_data</function>, gdy zostanie użyta na pliku <literal>OGG/Vorbis</literal>
19+
otwartym do odczytu, zwróci różne szczegóły dotyczące strumienia,
20+
w tym znacznik <parameter>vendor</parameter>, wszelkie dołączone
21+
<parameter>comments</parameter>, liczbę
22+
<parameter>channels</parameter>, próbkowanie <parameter>rate</parameter>,
23+
i zakres szybkości kodowania opisany przez:
24+
<parameter>bitrate_lower</parameter>, <parameter>bitrate_upper</parameter>,
25+
<parameter>bitrate_nominal</parameter>, i <parameter>bitrate_window</parameter>.
26+
</para>
27+
28+
<simpara><filename>ogg://</filename> (PECL)</simpara>
29+
<note>
30+
<title>Ten wrapper nie jest domyślnie włączony</title>
31+
<simpara>
32+
Aby użyć wrappera <filename>ogg://</filename>,
33+
rozszerzenie
34+
<link xlink:href="&url.pecl.package;oggvorbis">OGG/Vorbis</link>
35+
dostępne z &link.pecl; musi być zainstalowane.
36+
</simpara>
37+
</note>
38+
</refsect1><!-- }}} -->
39+
40+
<refsect1 role="usage"> <!-- {{{ -->
41+
&reftitle.usage;
42+
<itemizedlist>
43+
<listitem><simpara><filename>ogg://soundfile.ogg</filename></simpara></listitem>
44+
<listitem><simpara><filename>ogg:///path/to/soundfile.ogg</filename></simpara></listitem>
45+
<listitem><simpara><filename>ogg://http://www.example.com/path/to/soundstream.ogg</filename></simpara></listitem>
46+
</itemizedlist>
47+
</refsect1> <!-- }}} -->
48+
49+
<refsect1 role="options"><!-- {{{ -->
50+
&reftitle.options;
51+
<para>
52+
<table>
53+
<title>Podsumowanie wrappera</title>
54+
<tgroup cols="2">
55+
<thead>
56+
<row>
57+
<entry>Atrybut</entry>
58+
<entry>Obsługiwany</entry>
59+
</row>
60+
</thead>
61+
<tbody>
62+
<row>
63+
<entry>Zastrzeżone przez <link linkend="ini.allow-url-fopen">allow_url_fopen</link></entry>
64+
<entry>Nie</entry>
65+
</row>
66+
<row>
67+
<entry>Umożliwia odczytywanie</entry>
68+
<entry>Tak</entry>
69+
</row>
70+
<row>
71+
<entry>Umożliwia zapisywanie</entry>
72+
<entry>Tak</entry>
73+
</row>
74+
<row>
75+
<entry>Umożliwia dołączanie</entry>
76+
<entry>Tak</entry>
77+
</row>
78+
<row>
79+
<entry>Umożliwia jednocześnie odczytywanie i zapisywanie</entry>
80+
<entry>Nie</entry>
81+
</row>
82+
<row>
83+
<entry>Obsługuje <function>stat</function></entry>
84+
<entry>Nie</entry>
85+
</row>
86+
<row>
87+
<entry>Obsługuje <function>unlink</function></entry>
88+
<entry>Nie</entry>
89+
</row>
90+
<row>
91+
<entry>Obsługuje <function>rename</function></entry>
92+
<entry>Nie</entry>
93+
</row>
94+
<row>
95+
<entry>Obsługuje <function>mkdir</function></entry>
96+
<entry>Nie</entry>
97+
</row>
98+
<row>
99+
<entry>Obsługuje <function>rmdir</function></entry>
100+
<entry>Nie</entry>
101+
</row>
102+
</tbody>
103+
</tgroup>
104+
</table>
105+
</para>
106+
<!-- FIXME: This should not be here! context.audio... -->
107+
<para>
108+
<table>
109+
<title>Opcje kontekstu</title>
110+
<tgroup cols="3">
111+
<thead>
112+
<row>
113+
<entry>Nazwa</entry>
114+
<entry>Użycie</entry>
115+
<entry>Domyśnie</entry>
116+
<entry>Tryb</entry>
117+
</row>
118+
</thead>
119+
<tbody>
120+
<row>
121+
<entry><literal>pcm_mode</literal></entry>
122+
<entry>
123+
Kodowanie PCM do zastosowania podczas odczytu, jedno z:
124+
<constant>OGGVORBIS_PCM_U8</constant>, <constant>OGGVORBIS_PCM_S8</constant>,
125+
<constant>OGGVORBIS_PCM_U16_BE</constant>, <constant>OGGVORBIS_PCM_S16_BE</constant>,
126+
<constant>OGGVORBIS_PCM_U16_LE</constant> i <constant>OGGVORBIS_PCM_S16_LE</constant>.
127+
(8 lub 16 bitów, ze znakiem lub bez znaku, duży lub mały <literal>endian</literal>)
128+
</entry>
129+
<entry>OGGVORBIS_PCM_S16_LE</entry>
130+
<entry>Odczyt</entry>
131+
</row>
132+
<row>
133+
<entry><literal>rate</literal></entry>
134+
<entry>
135+
Częstotliwość próbkowania danych wejściowych, wyrażona w Hz
136+
</entry>
137+
<entry>44100</entry>
138+
<entry>Zapis/Dołączenie</entry>
139+
</row>
140+
<row>
141+
<entry><literal>bitrate</literal></entry>
142+
<entry>
143+
Gdy podana jako liczba całkowita, stała szybkość transmisji bitów, przy której ma być kodowana. (16000 do 131072)
144+
Podana jako liczba zmiennoprzecinkowa, zmienna jakość bitrate do użycia. (-1.0 do 1.0)
145+
</entry>
146+
<entry>128000</entry>
147+
<entry>Zapis/Dołączenie</entry>
148+
</row>
149+
<row>
150+
<entry><literal>channels</literal></entry>
151+
<entry>
152+
Liczba kanałów audio do zakodowania, zazwyczaj 1 (Mono) lub 2 (Stereo).
153+
Może wynosić nawet 16.
154+
</entry>
155+
<entry>2</entry>
156+
<entry>Zapis/Dołączenie</entry>
157+
</row>
158+
<row>
159+
<entry><literal>comments</literal></entry>
160+
<entry>
161+
Tablica wartości ciągów znaków do zakodowania w nagłówku ścieżki.
162+
</entry>
163+
<entry/>
164+
<entry>Zapis/Dołączenie</entry>
165+
</row>
166+
</tbody>
167+
</tgroup>
168+
</table>
169+
</para>
170+
</refsect1> <!-- }}} -->
171+
172+
</refentry>
173+
174+
<!-- Keep this comment at the end of the file
175+
Local variables:
176+
mode: sgml
177+
sgml-omittag:t
178+
sgml-shorttag:t
179+
sgml-minimize-attributes:nil
180+
sgml-always-quote-attributes:t
181+
sgml-indent-step:1
182+
sgml-indent-data:t
183+
indent-tabs-mode:nil
184+
sgml-parent-document:nil
185+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
186+
sgml-exposed-tags:nil
187+
sgml-local-catalogs:nil
188+
sgml-local-ecat-files:nil
189+
End:
190+
vim600: syn=xml fen fdm=syntax fdl=2 si
191+
vim: et tw=78 syn=sgml
192+
vi: ts=1 sw=1
193+
-->
194+

‎language/wrappers/compression.xml‎

Lines changed: 143 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,143 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: 8bc832a464e33122e8129f5a623bd845b69fa7e0 Maintainer: grzesiek Status: ready -->
3+
<!-- $Revision$ -->
4+
5+
<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">
6+
<refnamediv>
7+
<refname>zlib://</refname>
8+
<refname>bzip2://</refname>
9+
<refname>zip://</refname>
10+
<refpurpose>Strumienie kompresji</refpurpose>
11+
</refnamediv>
12+
13+
<refsect1 role="description"><!-- {{{ -->
14+
&reftitle.description;
15+
<simpara><filename>compress.zlib://</filename> i <filename>compress.bzip2://</filename></simpara>
16+
17+
<simpara>
18+
<filename>zlib:</filename> działa jak <function>gzopen</function>, z wyjątkiem tego, że
19+
strumień może być używany z funkcją <function>fread</function> i innymi
20+
funkcjami systemu plików. Jest to przestarzałe z powodu
21+
niejednoznaczności z nazwami plików zawierającymi znaki ':'; zamiast tego
22+
należy użyć <filename>compress.zlib://</filename>.
23+
</simpara>
24+
25+
<simpara>
26+
<filename>compress.zlib://</filename> i
27+
<filename>compress.bzip2://</filename> odpowiednikami odpowiednio
28+
<function>gzopen</function> i <function>bzopen</function>
29+
i działają nawet na systemach, które nie obsługują
30+
fopencookie.
31+
</simpara>
32+
33+
<simpara>
34+
<link linkend="book.zip">Rozszerzenie ZIP</link> rejestruje wrapper <filename>zip:</filename>. Począwszy
35+
od PHP 7.2.0 i libzip 1.2.0+, dodano obsługę haseł dla zaszyfrowanych archiwów, umożliwiając dostarczanie
36+
haseł przez konteksty strumieni. Hasła można ustawić za pomocą opcji <literal>'password'</literal>
37+
kontekstu strumienia.
38+
</simpara>
39+
</refsect1><!-- }}} -->
40+
41+
<refsect1 role="usage"> <!-- {{{ -->
42+
&reftitle.usage;
43+
<itemizedlist>
44+
<listitem><simpara><filename>compress.zlib://file.gz</filename></simpara></listitem>
45+
<listitem><simpara><filename>compress.bzip2://file.bz2</filename></simpara></listitem>
46+
<listitem><simpara><filename>zip://archive.zip#dir/file.txt</filename></simpara></listitem>
47+
</itemizedlist>
48+
</refsect1> <!-- }}} -->
49+
50+
<refsect1 role="options"><!-- {{{ -->
51+
&reftitle.options;
52+
<para>
53+
<table>
54+
<title>Wrapper Summary</title>
55+
<tgroup cols="2">
56+
<thead>
57+
<row>
58+
<entry>Atrybut</entry>
59+
<entry>Obsługiwany</entry>
60+
</row>
61+
</thead>
62+
<tbody>
63+
<row>
64+
<entry>Zasrzeżony przez <link linkend="ini.allow-url-fopen">allow_url_fopen</link></entry>
65+
<entry>Nie</entry>
66+
</row>
67+
<row>
68+
<entry>Umożliwia odczytywanie</entry>
69+
<entry>Tak</entry>
70+
</row>
71+
<row>
72+
<entry>Umożliwia zapisywanie</entry>
73+
<entry>Tak (oprócz <literal>zip://</literal>)</entry>
74+
</row>
75+
<row>
76+
<entry>Umożliwia dołączanie</entry>
77+
<entry>Tak (oprócz <literal>zip://</literal>)</entry>
78+
</row>
79+
<row>
80+
<entry>Umożliwia jednocześnie odczytywanie i zapisywanie</entry>
81+
<entry>Nie</entry>
82+
</row>
83+
<row>
84+
<entry>Obsługuje <function>stat</function></entry>
85+
<entry>
86+
Nie, użyj normalnego wrappera <literal>file://</literal>
87+
do uzyskania informacji o skompresowanych plikach.
88+
</entry>
89+
</row>
90+
<row>
91+
<entry>Obsługuje <function>unlink</function></entry>
92+
<entry>
93+
Nie, użyj normalnego wrappera <literal>file://</literal>
94+
aby usuąć skompresowane pliki.
95+
</entry>
96+
</row>
97+
<row>
98+
<entry>Obsługuje <function>rename</function></entry>
99+
<entry>Nie</entry>
100+
</row>
101+
<row>
102+
<entry>Obsługuje <function>mkdir</function></entry>
103+
<entry>Nie</entry>
104+
</row>
105+
<row>
106+
<entry>Obsługuje <function>rmdir</function></entry>
107+
<entry>Nie</entry>
108+
</row>
109+
</tbody>
110+
</tgroup>
111+
</table>
112+
</para>
113+
</refsect1> <!-- }}} -->
114+
115+
<refsect1 role="seealso">
116+
&reftitle.seealso;
117+
<simplelist>
118+
<member><xref linkend="context.zlib" /></member>
119+
</simplelist>
120+
</refsect1>
121+
</refentry>
122+
123+
<!-- Keep this comment at the end of the file
124+
Local variables:
125+
mode: sgml
126+
sgml-omittag:t
127+
sgml-shorttag:t
128+
sgml-minimize-attributes:nil
129+
sgml-always-quote-attributes:t
130+
sgml-indent-step:1
131+
sgml-indent-data:t
132+
indent-tabs-mode:nil
133+
sgml-parent-document:nil
134+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
135+
sgml-exposed-tags:nil
136+
sgml-local-catalogs:nil
137+
sgml-local-ecat-files:nil
138+
End:
139+
vim600: syn=xml fen fdm=syntax fdl=2 si
140+
vim: et tw=78 syn=sgml
141+
vi: ts=1 sw=1
142+
-->
143+

0 commit comments

Comments
 (0)