quick tour synced

Author: petk

quick_tour/the_architecture.rst

@@ -3,13 +3,13 @@ Arhitektura
 
 Ste moj junak! Kdo bi si mislil, da boste tu še vedno po prvih treh delih?
 Vaši dosežki bodo kmalu dobro nagrajeni. Prvi trije deli niso podrobno
-pogledali v arhitekturo ogrodja. Ker le ta naredi Symfony2 izstopajočega
+pogledali v arhitekturo ogrodja. Ker le ta naredi Symfony izstopajočega
 iz množice ogrodij, si sedaj poglejmo arhitekturo.
 
 Razumevanje strukture direktorijev
 ----------------------------------
 
-Struktura direktorijev Symfony2 :term:`application` je nekoliko fleksibilna,
+Struktura direktorijev Symfony :term:`application` je nekoliko fleksibilna,
 vendar priporočena struktura je sledeča:
 
 * ``app/``:    nastavitve aplikacije;
@@ -64,15 +64,14 @@ Lahko jih shranite kamorkoli želite, globalno na vaš strežnik ali lokalno v v
 Razumevanje sistema paketov
 ---------------------------
 
-Ta sekcija uvaja eno izmed najboljših in najmočnejših lastnosti Symfony2
-This section introduces one of the greatest and most powerful features of,
+Ta sekcija uvaja eno izmed najboljših in najmočnejših lastnosti Symfony
 sistem :term:`bundle`-ov.
 
 Paket (bundle) je neke vrste vtičnik v drugo programsko opremo. Torej zakaj
-se imenuje *paket* in ne *vtičnik*? To je zato, ker je *vse* paket v Symfony2,
+se imenuje *paket* in ne *vtičnik*? To je zato, ker je *vse* paket v Symfony,
 od lastnosti jedra ogrodja do kode, ki jo pišete za vašo aplikacijo.
 
-Paketi so prvorazredni elementi v Symfony2. To vam ponuja fleksibilnost,
+Paketi so prvorazredni elementi v Symfony. To vam ponuja fleksibilnost,
 da uporabite vnaprej zgrajene lastnosti zapakirane v tretje osebne pakete ali za distribuiranje
 vaših lastnih paketov. Omogoča vam, da enostavno uporabite in izberete katere lastnosti bodo omogočene
 v vaši aplikaciji in jih optimizirati, kot želite. Na koncu dneva,
@@ -232,7 +231,7 @@ Logična imena datotek
 .....................
 
 Ko želite referenco datoteke iz paketa, uporabite ta zapis:
-``@BUNDLE_NAME/path/to/file``; Symfony2 bo rešil ``@BUNDLE_NAME``
+``@BUNDLE_NAME/path/to/file``; Symfony bo rešil ``@BUNDLE_NAME``
 v pravo pot do paketa. Na primer, logična pot
 ``@AcmeDemoBundle/Controller/DemoController.php`` bi bila pretvorjena v
 ``src/Acme/DemoBundle/Controller/DemoController.php``, ker Symfony ve
@@ -266,7 +265,7 @@ najprej pogledal za ``WelcomeController`` razred v AcmeNewBundle in če
 ne obstaja, potem pogleda znotraj AcmeDemoBundle. To pomeni, da en paket
 lahko prepiše skoraj katerikoli del drugega paketa!
 
-Sedaj razumete zakaj je Symfony2 tako fleksibilen? Delite vaše pakete med aplikacijami,
+Sedaj razumete zakaj je Symfony tako fleksibilen? Delite vaše pakete med aplikacijami,
 shranite jih lokalno ali globalno, vaša izbira.
 
 .. _using-vendors:
@@ -276,17 +275,17 @@ Uporaba izdelovalcev (vendors)
 
 Možnosti so, da bo vaša aplikacija odvisna od tretje-osebnih knjižnic. Te
 bi morale biti shranjene v ``vendor/`` direktoriju. Ta direktorij že vsebuje
-Symfony2 knjižnice, knjižnico SwiftMailer, Doctrine ORM, Twig sistem predlog in
+Symfony knjižnice, knjižnico SwiftMailer, Doctrine ORM, Twig sistem predlog in
 nekatere ostale knjižnice tretjih oseb in paketov.
 
 Razumevanje predpomnilnika in dnevnikov
 ---------------------------------------
 
-Symfony2 je verjetno eno najhitrejših celotnih ogrodij naokrog. Vendar kako
+Symfony je verjetno eno najhitrejših celotnih ogrodij naokrog. Vendar kako
 je lahko tako hitro, če pa razčlenjuje in interpretira desetine YAML in XML datotek
 za vsak zahtevek? Hitros je delno zaradi njegovega sistema predpomnilnika. Aplikacijske
 nastavitve so samo razčlenjene za prvi zahtevek in potem prevedene v enostavno
-PHP kodo shranjeno v ``app/cache`` direktoriju. V razvojnem okolju je Symfony2 dovolj
+PHP kodo shranjeno v ``app/cache`` direktoriju. V razvojnem okolju je Symfony dovolj
 pameten, da sprazni predpomnilnik, ko spremenite datoteko. Vendar v produkcijskem okolju,
 za pohitritev stvari, je vaša dolžnost, da počistite predpomnilnik, ko posodobite vašo kodo ali spremenite njene
 nastavitve.
@@ -318,12 +317,12 @@ Zaključne misli
 ---------------
 
 Recite, da sem nor, vendar po prebranju tega dela, bi vam moralo biti že udobno
-s premikanjem stvari okrog in narediti, da Symfony dela za vas. Vse v Symfony2
+s premikanjem stvari okrog in narediti, da Symfony dela za vas. Vse v Symfony
 je načrtovano, da vam ne hodi v napoto. Torej, imejte proste roke pri preimenovanju,
 premikanju direktorijev okoli, da bo ustrezno.
 
 In to je vse za hiter pregled. Iz testiranja do pošiljanja mailov, se morate še vedno
-naučiti veliko, da postanete Symfony2 mojster. Pripravljeni, da se zakopljete v te teme
+naučiti veliko, da postanete Symfony mojster. Pripravljeni, da se zakopljete v te teme
 zdaj? Ne glejte več - pojdite na uradno :doc:`/book/index` in izberite katerokoi
 temo želite.
 

quick_tour/the_big_picture.rst

@@ -1,30 +1,32 @@
 Velika slika
 ============
 
-Pričnite uporabljati Symfony2 v 10-ih minutah! To poglavje vas bo vodilo skozi
-nekatere najbolj pomembne koncepte za Symfony2 in vam razložilo, kako lahko pričnete
+Pričnite uporabljati Symfony v 10-ih minutah! To poglavje vas bo vodilo skozi
+nekatere najbolj pomembne koncepte za Symfony in vam razložilo, kako lahko pričnete
 hitro s prikazom enostavnega projekta v delovanju.
 
-Če ste že uporabljali spletno ogrodje, se boste s Symfony2 počutili kot doma.
+Če ste že uporabljali spletno ogrodje, se boste s Symfony počutili kot doma.
 Drugače pa dobrodošli v novem načinu razvoja spletnih aplikacij.
 
-Namestitev Symfony2
--------------------
+.. _installing-symfony2:
+
+Namestitev Symfony
+------------------
 
 Najprej preverite, da verzija PHP nameščena na vašem računalniku zadostuje za zahteve
-Symfony2: 5.3.3 ali več. Nato odprite ukazno vrstico in izvršite sledeči
-ukaz za namestitev najnovejše verzije Symfony2 v direktorij
+Symfony: 5.3.3 ali več. Nato odprite ukazno vrstico in izvršite sledeči
+ukaz za namestitev najnovejše verzije Symfony v direktorij
 ``myproject/``:
 
 .. code-block:: bash
 
-    $composer create-project symfony/framework-standard-edition myproject/ ~2.5
+    $composer create-project symfony/framework-standard-edition myproject/ "~2.3"
 
 
 .. note::
 
     `Composer`_ je upravljalnik paketov, ki je uporabljen v modernih PHP aplikacijah in
-    edini priporočljivi način za namestitev Symfony2. Za namestitev Composer-ja na vaš
+    edini priporočljivi način za namestitev Symfony. Za namestitev Composer-ja na vaš
     Linux ali Mac sistem, izvršite sledeče ukaze:
 
     .. code-block:: bash
@@ -34,32 +36,29 @@ ukaz za namestitev najnovejše verzije Symfony2 v direktorij
 
     Za namestitev Composer-ja na Windows sistem prenesite `izvršljivi namestitveni program`_.
 
-Bodite pozorni, da ko prvič nameščate Symfony2, lahko traja nekaj minut, da
+Bodite pozorni, da ko prvič nameščate Symfony, lahko traja nekaj minut, da
 se prenesejo vse njegove komponente. Na koncu namestitvenega procesa,
-vas bo namestitveni program vprašal štiri vprašanja:
-
-1. **Would you like to use Symfony 3 directory structure? [y/N]** Prihajajoča
-   verzija Symfony 3 bo spremenila privzeto strukturo direktorijev za aplikacije
-   Symfony. Če želite stestirati to novo strukturo, vtipkajte ``y``.
-   Da sledite temu vodiču, pritisnite ``<Enter>`` tipko, da sprejmete
-   privzeto ``N`` vrednost in uporabljate privzeto Symfoyn2 strukturo.
-2. **Would you like to install Acme demo bundle? [y/N]** Symfony verzije pred
+vas bo namestitveni program vprašal tri vprašanja:
+
+1. **Would you like to install Acme demo bundle? [y/N]** Symfony verzije pred
    2.5 vključujejo demo aplikacijo za testiranje nekaterih lastnosti
    ogrodja. Vendar ta demo aplikacija je uporabna samo za nove uporabnike,
    njena namestitev pa je opcijska. Da sledite temu vodiču, vtipkajte
    tipko ``y``, da namestite demo aplikacijo.
-3. **Some parameters are missing. Please provide them.** Symfony2 vas vpraša za
+2. **Some parameters are missing. Please provide them.** Symfony vas vpraša za
    vrednost vseh nastavitvenih parametrov. Za ta prvi projekt
    lahko varno ignorirate to nastavitev s ponavljajočim pritiskanjem tipke
    ``<Enter>``.
-4. **Do you want to remove the existing VCS (.git, .svn..) history? [Y,n]?**
+3. **Do you want to remove the existing VCS (.git, .svn..) history? [Y,n]?**
    Razvojna zgodovina velikih projektov kot je Symfony lahko zavzame veliko
    prostora na disku. Pritisnite tipko ``<Enter>`` za varno odstranitev vseh teh podatkov zgodovine.
 
-Poganjanje Symfony2
--------------------
+.. _running-symfony2:
 
-Preden prvič poženete Symfony2, izvršite sledeči ukaz, da
+Poganjanje Symfony
+------------------
+
+Preden prvič poženete Symfony, izvršite sledeči ukaz, da
 se prepričate, da vaš sistem zadosti vsem tehničnim zahtevam:
 
 .. code-block:: bash
@@ -74,18 +73,22 @@ za pogon Symfony:
 
     $ php app/console server:run
 
+.. seealso::
+
+    Preberite več o notranjem strežniku :doc:`v receptih </cookbook/web_server/built_in>`.
+
 Če dobite napako `There are no commands defined in the "server" namespace.`,
 potem verjetno uporabljate PHP 5.3. To je v redu! Vendar vgrajeni spletni strežnik je
 na voljo samo za PHP 5.4.0 ali več. Če imate starešo verzijo PHP ali
 če imate raje običajni spletni strežnik kot je Apache ali Nginx, preberite
 članek :doc:`/cookbook/configuration/web_server_configuration`.
 
 Odprite vaš brskalnik in obiščite URL ``http://localhost:8000``, da vidite
-pozdravno stran Symfony2:
+pozdravno stran Symfony:
 
 .. image:: /images/quick_tour/welcome.png
    :align: center
-   :alt:   Symfony2 Welcome Page
+   :alt:   Symfony Welcome Page
 
 Razumevanje osnov
 -----------------
@@ -96,7 +99,7 @@ podatkovne baze, HTML značk in poslobne logike v isti skripti. Za doseg tega ci
 s Symfony, se boste najprej morali naučiti nekaj osnovnih konceptov in izrazov.
 
 Symfony prihaja z nekaj primerov kode, ki jo lahko uporabite, da se naučite več o njegovih
-glavnih konceptih. Pojdite na sledeči URL, da vas Symfony2 pozdravi (zamenjajte
+glavnih konceptih. Pojdite na sledeči URL, da vas Symfony pozdravi (zamenjajte
 *Fabien* z vašim prvim imenom):
 
 .. code-block:: text
@@ -106,6 +109,14 @@ glavnih konceptih. Pojdite na sledeči URL, da vas Symfony2 pozdravi (zamenjajte
 .. image:: /images/quick_tour/hello_fabien.png
    :align: center
 
+.. note::
+
+    Namesto pozdravne strani, lahko vidite prazno stran ali stran z napako.
+    To povzročajo napačne nastavitve pravic direktorija. Obstoja nekaj
+    možnih rešitev odvisno od vašega operacijskega sistema. Vse od njih so
+    razložene v sekciji :ref:`Nastavitve pravic <book-installation-permissions>`
+    uradne knjige.
+
 Kaj se tukaj dogaja? Poglejte vsak del URL-ja:
 
 * ``app_dev.php``: To je t.i. :term:`prednji krmilnik`. Je unikatna vnosna
@@ -121,7 +132,7 @@ Vaša odgovornost kot razvijalec je pisanje kode, ki preslika uporabnikov
 Usmerjanje
 ~~~~~~~~~~
 
-Symfony2 usmeri zahtevek do kode, ki ga uredi s poskušanjem ujemanja
+Symfony usmeri zahtevek do kode, ki ga uredi s poskušanjem ujemanja
 zahtevanega URL-ja (t.j. virtualna pot) proti nekaterim nastavljenim potem. Demo
 poti so definirane v ``app/config/routing_dev.yml`` nastavitveni datoteki:
 
@@ -159,7 +170,7 @@ naučili točno, kaj to pomeni.
 
     K dodatku datotekam YAML, so lahko usmeritve nastavljene v XML ali PHP datotekah
     in so celo lahko vključene v PHP anotacijah. Ta fleksibilnost je ena
-    glavnih lastnosti Symfony2, ogrodja, ki nikoli ne nalaga določenega
+    glavnih lastnosti Symfony, ogrodja, ki nikoli ne nalaga določenega
     nastavitvenega formata na vas.
 
 Krmilniki
@@ -178,7 +189,7 @@ krmilnik lahko ustvari odziv ročno, na osnovi zahtevka::
 
     return new Response('Hello '.$name);
 
-Symfony2 izbere krmilnik na osnovi ``_controller`` vrednosti iz nastavitev poti:
+Symfony izbere krmilnik na osnovi ``_controller`` vrednosti iz nastavitev poti:
 ``AcmeDemoBundle:Welcome:index``. Ta niz je
 krmilnikovo *logično ime*, in se sklicuje na ``indexAction`` metodo iz
 ``Acme\DemoBundle\Controller\WelcomeController`` razreda::
@@ -298,17 +309,17 @@ predlogo (ali ``AcmeDemoBundle:Demo:hello.html.twig`` če uporabljate logično i
         <h1>Hello {{ name }}!</h1>
     {% endblock %}
 
-Privzeto, Symfony2 uporablja `Twig`_ kot svoj motor predlog, vendar lahko uporabite tudi običajne
+Privzeto, Symfony uporablja `Twig`_ kot svoj motor predlog, vendar lahko uporabite tudi običajne
 PHP predloge, če to izberete.
 :doc:`Drugi del tega vodiča</quick_tour/the_view>` bo predstavil, kako
-predloge delujejo v Symfony2.
+predloge delujejo v Symfony.
 
 Paketi
 ~~~~~~
 
 Verjetno ste se spraševali, zakaj je beseda paket (:term:`Bundle`) uporabljena v tako veliko
 imenih do sedaj. Vsa koda, ki jo pišete za vašo aplikacijo je organizirana v paketih.
-V Symfony2 primeru je paket strukturiran skupek datotek (PHP datotek, stilov, JavaScript-a,
+V Symfony primeru je paket strukturiran skupek datotek (PHP datotek, stilov, JavaScript-a,
 slik, ...), ki implementirajo neko lastnost (blog, forum, ...) in ki so lahko enostavno deljene
 z drugimi razvijalci. Do sedaj ste ravnali z enim paketom, AcmeDemoBundle. Naučili se boste več
 o paketih v :doc:`zadnjem delu tega vodiča</quick_tour/the_architecture>`.
@@ -318,9 +329,9 @@ o paketih v :doc:`zadnjem delu tega vodiča</quick_tour/the_architecture>`.
 Delo z okolji
 -------------
 
-Sedaj, ko imate boljše razumevanje, kako Symfony2 deluje, si podrobneje poglejte
-na konec katerekoli Symfony2 izpisane strani. Morali bi opaziti majhno vrstico
-s Symfony2 logotipom. To je "Web Debug Toolbar" in je najboljši prijatelj Symfony2
+Sedaj, ko imate boljše razumevanje, kako Symfony deluje, si podrobneje poglejte
+na konec katerekoli Symfony izpisane strani. Morali bi opaziti majhno vrstico
+s Symfony logotipom. To je "Web Debug Toolbar" in je najboljši prijatelj Symfony
 razvijalca!
 
 .. image:: /images/quick_tour/web_debug_toolbar.png
@@ -343,7 +354,7 @@ Kaj je okolje?
 ~~~~~~~~~~~~~~
 
 Izraz :term:`Okolje` predstavlja skupino nastavitev, ki so uporabljene za poganjanje
-vaše aplikacije. Symfony2 privzeto definira dve okolji: ``dev``
+vaše aplikacije. Symfony privzeto definira dve okolji: ``dev``
 (primerno, ko razvijate aplikacijo lokalno) in ``prod`` (optimizirano,
 ko izvršujete aplikacijo na produkciji).
 
@@ -377,7 +388,7 @@ boste dobili napako 404.
 
     Če namesto uporabe PHP-jevega vgrajenega spletnega strežnika uporabljate Apache z
     omogočenim ``mod_rewrite`` in izkoristite prednosti datoteke ``.htaccess``,
-    ki jo Symfony2 ponuja v ``web/``, lahko celo izpustite del ``app.php``
+    ki jo Symfony ponuja v ``web/``, lahko celo izpustite del ``app.php``
     URL-ja. Privzeta ``.htaccess`` kaže vse zahtevke v prednji krmilnik
     ``app.php``.
 
@@ -391,9 +402,9 @@ Za več podrobnosti o okoljih glejte
 Zaključne misli
 ---------------
 
-Čestitamo! Za pokušino ste dobili vašo prvo Symfony2 kodo. Ni bilo tako težko, kaj?
-Na voljo za odkriti je še več, vendar bi morali že videti, kako naredi Symfony2 res enostavno
-implementacijo spletnih strani boljše in hitrejše. Če ste se željni naučiti več o Symfony2,
+Čestitamo! Za pokušino ste dobili vašo prvo Symfony kodo. Ni bilo tako težko, kaj?
+Na voljo za odkriti je še več, vendar bi morali že videti, kako naredi Symfony res enostavno
+implementacijo spletnih strani boljše in hitrejše. Če ste se željni naučiti več o Symfony,
 se poglobite v naslednjo sekcijo: ":doc:`Pogled<the_view>`".
 
 .. _`Composer`:                      http://getcomposer.org/

quick_tour/the_controller.rst

@@ -1,7 +1,7 @@
 Krmilnik
 ========
 
-Še vedno tu po prvih dveh delih? Postajate Symfony2 odvisnik!
+Še vedno tu po prvih dveh delih? Postajate Symfony odvisnik!
 Brez odlašanja, odkrijte kaj krmilnik lahko naredi za vas.
 
 Uporaba oblik
@@ -10,7 +10,7 @@ Uporaba oblik
 Dandanes bi morale biti spletne aplikacije zmožne dostaviti z več kot
 samo HTML stranmi. Od XML za RSS feeds ali spletne storitve, do JSON za
 Ajax zahtevke, je na izbiro veliko različnih oblik. Podpora teh oblik
-v Symfony2 je enostavna. Uredite pot z dodajanjem privzetih vrednosti za
+v Symfony je enostavna. Uredite pot z dodajanjem privzetih vrednosti za
 ``xml`` za ``_format`` spremenljivko::
 
     // src/Acme/DemoBundle/Controller/DemoController.php
@@ -29,7 +29,7 @@ v Symfony2 je enostavna. Uredite pot z dodajanjem privzetih vrednosti za
     }
 
 Z uporabo oblike zahtevka (kot je definiran s ``_format`` spremenljivko),
-Symfony2 tu avtomatsko izbere pravo predlogo ``hello.xml.twig``:
+Symfony tu avtomatsko izbere pravo predlogo ``hello.xml.twig``:
 
 .. code-block:: xml+php
 
@@ -38,7 +38,7 @@ Symfony2 tu avtomatsko izbere pravo predlogo ``hello.xml.twig``:
         <name>{{ name }}</name>
     </hello>
 
-To je vse okrog tega. Za standardne oblike, Symfony2 tudi
+To je vse okrog tega. Za standardne oblike, Symfony tudi
 avtomatsko izbere najboljšo ``Content-Type`` glavo za odziv. Če
 želite podpirati različne oblike za eno akcijo, raje uporabite ``{_format}``
 lokacijo v usmerni poti::
@@ -134,9 +134,9 @@ V predlogi lahko dostopate do objekta ``Request`` tudi preko
 Pridobitev podatkov v sejo
 --------------------------
 
-Tudi če je HTTP protokol brez stanja, Symfony2 ponuja lep objekt za seje,
+Tudi če je HTTP protokol brez stanja, Symfony ponuja lep objekt za seje,
 ki predstavlja klienta (ali pravega uporabnika z brskalnikom, bot-a ali
-spletni servis). Med dvema zahtevkoma, Symfony2 shranjuje atribute v piškotek
+spletni servis). Med dvema zahtevkoma, Symfony shranjuje atribute v piškotek
 z uporabo prvotnih PHP sej.
 
 Shranjevanje in branje informacij iz seje je enostavno dosegljivo iz
@@ -146,7 +146,7 @@ kateregakoli krmilnika::
 
     public function indexAction(Request $request)
     {
-        $session = $this->request->getSession();
+        $session = $request->getSession();
 
         // store an attribute for reuse during a later user request
         $session->set('foo', 'bar');
@@ -174,7 +174,7 @@ Viri predpomnenja
 -----------------
 
 Takoj ko vaša spletna stran prične generirati več prometa, si boste želeli
-izogniti generiranju istega vira znova in znova. Symfony2 uporablja glave HTTP
+izogniti generiranju istega vira znova in znova. Symfony uporablja glave HTTP
 predpomnilnika za upravljanje virov predpomnenja. Za enostavne strategije predpomnenja
 uporabite uporabno anotacijo ``@Cache()``::
 
@@ -193,7 +193,7 @@ uporabite uporabno anotacijo ``@Cache()``::
     }
 
 V tem primeru bo vir predpomnjen za en dan (``86400`` sekund).
-Predpomnenje vira je upravljano s strani samega Symfony2. Vendar ker je predpomnenje upravljano
+Predpomnenje vira je upravljano s strani samega Symfony. Vendar ker je predpomnenje upravljano
 z uporabo standardnih HTTP glav predpomnilnika, lahko uporabite Varnish ali Squid brez, da morate
 spremeniti eno vrstico kode v vaši aplikaciji.
 
@@ -203,5 +203,5 @@ Zaključne misli
 To je vse, kar se tega tiče in nisem niti prepričan, da ste porabili celotnih
 10 minut. Bili ste na hitro seznanjeni s paketi v prvem delu in vse lastnosti,
 o katerih ste se naučili do sedaj, so del paketov jedra ogrodja.
-Vendar zahvaljujoč paketov, je vse v Symfony2 možno razširiti in zamenjati.
+Vendar zahvaljujoč paketov, je vse v Symfony možno razširiti in zamenjati.
 To je tema :doc:`naslednjega poglavja tega vodiča<the_architecture>`.