tutorials: polish translation (PL)

_tutorials-PL/101_quickstart/101_Quickstart.md

@@ -0,0 +1,7 @@
+---
+layout: tutoriale
+type: tutorial
+name: "POCZĄTKUJĄCY: szybki start"
+fullname: "5-minutowy tutorial szybki start z MEI"
+data: "101_quickstart.json"
+---

_tutorials-PL/101_quickstart/101_quickstart.json

@@ -0,0 +1,95 @@
+{
+  "steps": [
+    {
+      "label":"Witamy w MEI",
+      "descFile": "101_quickstart_step-00-desc.html"
+    },
+    {
+      "label":"Pierwsza Nuta",
+      "editorLines":1,
+      "descFile": "101_quickstart_step-01-desc.html",
+      "xmlFile": "101_quickstart_step-01.xml",
+      "prefillFile": "101_quickstart_step-01-prefill.xml",
+      "xpaths": [
+        {"rule":"count(//mei:note) = 1", "renderanyway": false, "hint": "Potrzebujesz jeden element nutowy."},
+        {"rule":"count(//mei:note/@*) = 3 and //mei:note/@pname and //mei:note/@oct and //mei:note/@dur", "renderanyway": false, "hint": "Potrzebujesz trzech atrybutów: @pname, @oct, and @dur."},
+        {"rule":"//mei:note/@pname", "renderanyway": false, "hint": "Atrybut @pname pozwala wartości od 'a' to 'g'."},
+        {"rule":"//mei:note/@oct", "renderanyway": false, "hint": "Atrybut @oct wymaga liczby całkowite."},
+        {"rule":"//mei:note/@dur", "renderanyway": false, "hint": "Atrybut @dur pozwala wartości takich jak '1', '2', '4', '8'…"},
+        {"rule":"//mei:note/@pname = 'e'", "renderanyway": true, "hint": "Potrzebujesz atrybut @pname z wartością e."},
+        {"rule":"//mei:note/@oct = '4'", "renderanyway": true, "hint": "Potrzebujesz atrybut @oct z wartością 4."},
+        {"rule":"//mei:note/@dur = '4'", "renderanyway": true, "hint": "Potrzebujesz atrybut @dur z wartością 4."}
+      ]
+    },
+    {
+      "label":"Wiele Nut",
+      "editorLines":8,
+      "descFile": "101_quickstart_step-02-desc.html",
+      "xmlFile": "101_quickstart_step-02.xml",
+      "prefillFile": "101_quickstart_step-02-prefill.xml",
+      "xpaths": [
+        {"rule":"count(//mei:note) = 7", "renderanyway": true},
+        {"rule":"//mei:note[1]/@pname = 'e'", "renderanyway": true},
+        {"rule":"//mei:note[1]/@oct = '4'", "renderanyway": true},
+        {"rule":"//mei:note[1]/@dur = '4'", "renderanyway": true},
+        {"rule":"//mei:note[2]/@pname = 'd'", "renderanyway": true},
+        {"rule":"//mei:note[2]/@oct = '4'", "renderanyway": true},
+        {"rule":"//mei:note[2]/@dur = '4'", "renderanyway": true},
+        {"rule":"//mei:note[3]/@pname = 'c'", "renderanyway": true},
+        {"rule":"//mei:note[3]/@oct = '4'", "renderanyway": true},
+        {"rule":"//mei:note[3]/@dur = '4'", "renderanyway": true},
+        {"rule":"//mei:note[4]/@pname = 'd'", "renderanyway": true},
+        {"rule":"//mei:note[4]/@oct = '4'", "renderanyway": true},
+        {"rule":"//mei:note[4]/@dur = '4'", "renderanyway": true},
+        {"rule":"//mei:note[5]/@pname = 'e'", "renderanyway": true},
+        {"rule":"//mei:note[5]/@oct = '4'", "renderanyway": true},
+        {"rule":"//mei:note[5]/@dur = '4'", "renderanyway": true},
+        {"rule":"//mei:note[6]/@pname = 'e'", "renderanyway": true},
+        {"rule":"//mei:note[6]/@oct = '4'", "renderanyway": true},
+        {"rule":"//mei:note[6]/@dur = '4'", "renderanyway": true},
+        {"rule":"//mei:note[7]/@pname = 'e'", "renderanyway": true},
+        {"rule":"//mei:note[7]/@oct = '4'", "renderanyway": true},
+        {"rule":"//mei:note[7]/@dur = '4'", "renderanyway": true}
+      ]
+    },
+    {
+      "label":"Prosta Melodia",
+      "editorLines":8,
+      "descFile": "101_quickstart_step-03-desc.html",
+      "xmlFile": "101_quickstart_step-03.xml",
+      "prefillFile": "101_quickstart_step-03-prefill.xml",
+      "xpaths": [
+        {"rule":"count(//mei:note) = 7", "renderanyway": true},
+        {"rule":"//mei:note[1]/@pname = 'e'", "renderanyway": true},
+        {"rule":"//mei:note[1]/@oct = '4'", "renderanyway": true},
+        {"rule":"//mei:note[1]/@dur = '4'", "renderanyway": true},
+        {"rule":"//mei:note[1]/@dots = '1'", "renderanyway": true},
+        {"rule":"//mei:note[2]/@pname = 'd'", "renderanyway": true},
+        {"rule":"//mei:note[2]/@oct = '4'", "renderanyway": true},
+        {"rule":"//mei:note[2]/@dur = '8'", "renderanyway": true},
+        {"rule":"//mei:note[3]/@pname = 'c'", "renderanyway": true},
+        {"rule":"//mei:note[3]/@oct = '4'", "renderanyway": true},
+        {"rule":"//mei:note[3]/@dur = '4'", "renderanyway": true},
+        {"rule":"//mei:note[4]/@pname = 'd'", "renderanyway": true},
+        {"rule":"//mei:note[4]/@oct = '4'", "renderanyway": true},
+        {"rule":"//mei:note[4]/@dur = '4'", "renderanyway": true},
+        {"rule":"//mei:note[5]/@pname = 'e'", "renderanyway": true},
+        {"rule":"//mei:note[5]/@oct = '4'", "renderanyway": true},
+        {"rule":"//mei:note[5]/@dur = '4'", "renderanyway": true},
+        {"rule":"//mei:note[6]/@pname = 'e'", "renderanyway": true},
+        {"rule":"//mei:note[6]/@oct = '4'", "renderanyway": true},
+        {"rule":"//mei:note[6]/@dur = '4'", "renderanyway": true},
+        {"rule":"//mei:note[7]/@pname = 'e'", "renderanyway": true},
+        {"rule":"//mei:note[7]/@oct = '4'", "renderanyway": true},
+        {"rule":"//mei:note[7]/@dur = '2'", "renderanyway": true}
+      ]
+    }
+  ],
+  "end":"101_quickstart_end.html",
+  "resp":[
+    {
+      "name":"Johannes Kepper",
+      "affiliation":"Beethovens Werkstatt | Universität Paderborn"
+    }
+  ]
+}

_tutorials-PL/101_quickstart/101_quickstart_end.html

@@ -0,0 +1,14 @@
+<div>
+    <h3>Gratulacje!</h3>
+    <p>Właśnie skończyłaś swój pierwszy tutorial na temat MEI i powinnaś już być w stanie zakodować bardzo prostą melodię z MEI. Oczywiście do stworzenia kompletnego pliku MEI potrzeba znacznie więcej - pominęliśmy wszystkie informacje strukturalne dotyczące miarek i pięciolinii, a także musisz dowiedzieć się, jak ustawić metrum, klucze i klucze wiolinowe. 
+
+        Jako kolejne kroki z MEI, chcielibyśmy polecić nasze tutoriale na temat
+        <a href="/tutorials/103-chords.html" target="_blank" rel="noopener, noreferrer">akordy</a> or
+        <a href="/tutorials/104-rests.html" target="_blank" rel="noopener, noreferrer">pauzy</a>.
+
+        Oczywiście zawsze możesz wrócić do nich (lub nawet do tego), gdy będziesz chciała przypomnieć sobie, jak robić pewne rzeczy w MEI.
+    </p>
+    <p>Gdy tylko zapoznasz się w pewnym stopniu z MEI, zapraszamy Cię do podzielenia się swoimi doświadczeniami ze społecznością MEI i napisania tutoriala na temat aspektu MEI, który szczególnie Cię interesuje. Nie musisz być ekspertem - dobrze jest mieć tutoriale na różnych poziomach.
+
+    Często tutorial napisany przez innych początkujących, którzy właśnie opanowali zadanie, jest łatwiejszy do naśladowania niż przewodnik napisany przez kogoś, kto w ogóle nie widzi problemu. Mamy tutoriale na temat pisania poradników i szablony do naśladowania. Tak łatwo jest zostać aktywnym członkiem społeczności MEI :-)</p>
+</div>

_tutorials-PL/101_quickstart/101_quickstart_step-00-desc.html

@@ -0,0 +1,11 @@
+<div>
+    <p>W tym tutorialu nauczysz się kodować bardzo prostą melodię w MEI. Nauczysz się opisywać najbardziej podstawowe aspekty notacji muzycznej jako dane strukturalne, aby komputery mogły parsować twój kod.
+    </p>
+    <p>
+        Napisany kod zostanie natychmiast wyrenderowany, a renderowanie będzie reagować na twoje zmiany. W ten sposób, będziesz mógła zobaczyć, jak różne parametry współdziałają ze sobą.
+    </p>
+    <p>
+        Po ukończeniu tego tutorialu warto zapoznać się z innymi tutorialami, które wprowadzą inne ważne aspekty MEI. Te tutoriale służą również jako proste odniesienie do MEI - zawsze możesz do nich wrócić.
+    </p>
+    <p>Aby rozpocząć, kliknij przycisk "Kontynuuj" w prawym dolnym rogu tego paragrafu.</p>
+</div>

_tutorials-PL/101_quickstart/step-01/101_quickstart_step-01-desc.html

@@ -0,0 +1,12 @@
+<div>
+    <p>Aby zakodować nutę, wszystkie odpowiednie informacje muszą zostać zapisane w formie nadającej się do odczytu maszynowego. W zależności od potrzeb projektu, wybór tego, co jest istotne, a co nie, może się różnić, ale na potrzeby tego wprowadzenia, uzgodnijmy najbardziej podstawową informacje o nucie: Jest to zapisana wysokość dźwięku i czas trwania. Aby wyrazić wysokość dźwięku, MEI używa
+        <a href="https://en.wikipedia.org/wiki/Scientific_pitch_notation" target="_blank" rel="noopener, noreferrer">Naukowa notacja wysokości dźwięków</a>, w której tak zwane środkowe C jest wyrażone jako "C4". Jednak dzieli to na dwie oddzielne informacje: Nazwę wysokości dźwięku (w MEI nazwane <code>@pname</code>) oraz oktawę (<code>@oct</code>). Rozdzielenie to ma różne przyczyny, które nie mają tutaj znaczenia. Ważne jest również, aby pamiętać, że nazwy wysokości dźwięku są podawane w MEI małymi literami.
+</p>
+    <p>Inną ważną informacją jest oczywiście czas trwania (<code>@dur</code>). Tutaj używane są proste liczby całkowite do wskazania czasu trwania nuty. Pełna nuta otrzymuje wartość <code>1</code>, półnuta potrzebuje <code>2</code>, ćwierćnuta wymaga <code>4</code> i tak dalej.</p>
+    <p class="task">Poprosimy o wpisanie następującego kodu w okienku edytora:
+        <code>&lt;note pname="e" oct="4" dur="4"/&gt;</code>. Powinnaś wtedy zobaczyć renderowaną nutę. Możesz pobawić się trochę wartościami atrybutów, aby zobaczyć, jak wpływają one na renderowanie. Zobaczysz również wskazówki, jak napisać poprawny kod. Gdy będziesz gotowa, upewnij się, że masz poprawny kod w edytorze, a następnie naciśnij przycisk "Kontynuuj" w prawym dolnym rogu.</p>
+    <p>
+        PS: Jeśli nie jesteś za bardzo zapoznana z XML: Kiedykolwiek odnosimy się do atrybutów, poprzedzamy ich nazwę znakiem @.
+        Jest to powszechna praktyka i pochodzi z języka <a href="https://en.wikipedia.org/wiki/XPath" target="_blank" rel="noopener, noreferrer">XPath</a>. Pisząc je w XML, nie wolno dołączać znaku @, a jedynie nazwę atrybutu. Zapraszamy do zapoznania się z naszym <a href="/tutorials/100-structure.html" target="_blank" rel="noopener, noreferrer">tutorialem na temat podstaw XML</a>.
+    </p>
+</div>

_tutorials-PL/101_quickstart/step-02/101_quickstart_step-02-desc.html

@@ -0,0 +1,9 @@
+<div>
+    <p>
+       Gratulacje, <b>właśnie zakodowałaś</b> swoją pierwszą nutę w MEI. Teraz kontynuujmy i dodajmy kilka kolejnych nut, aby zakodować pierwszą prostą sekwencję nut:
+        <img style="display: block; margin: .5rem auto; width: 240px;" src="./101_note-sequence.png" alt="Sekwencja nut"/>
+    </p>
+    <p class="task">
+        Spróbuj odtworzyć powyższą sekwencję z MEI (w razie potrzeby możesz skopiować i wkleić pierwszy element notatki). Każda notatka wymaga jednego atrybutu <code>@pname</code>, <code>@oct</code> and <code>@dur</code>. Należy pamiętać, że nazwy wysokości dźwięku są podawane jako ciągi małych liter (od <code>a</code> do <code>g</code>) w MEI.
+    </p>
+</div>

_tutorials-PL/101_quickstart/step-03/101_quickstart_step-03-desc.html

@@ -0,0 +1,12 @@
+<div>
+    <p>Gratulacje, właśnie <b>zakodowałaś</b> swoją pierwszą sekwencję nut w MEI. Teraz dostosujmy wartości czasu trwania, aby zakodować pierwszą prostą melodię - na pewno znasz "Mary had a little lamb": 
+        <img style="display: block; margin: .5rem auto; width: 240px;" src="./101_note-little-lamb.png" alt="Mary had a little lamb"/></p>
+    <p class="task">
+        Spróbuj odtworzyć powyższą melodię za pomocą MEI. Każda nuta wymaga <code>@pname</code>, <code>@oct</code> i <code>@dur</code>.
+    </p>
+    <p>
+        Pamiętaj, że atrybut<code>@dur</code> może mieć wartości takie jak <code>"1"</code>, <code>"2"</code>, <code>"4"</code>,
+        <code>"8"</code> albo <code>"16"</code> aby wskazać różne wartości rytmiczne.
+        Do pierwszej notatki potrzebny jest dodatkowy atrybut <code>@dots</code>, gdzie należy określić liczbę kropek jako liczbę całkowitą - w tym przypadku jest to po prostu <code>dots="1"</code>.
+    </p>
+</div>