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.

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

DG tutorial POL - proof-read #237

Merged
merged 9 commits into from
Jan 17, 2015
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
4 changes: 2 additions & 2 deletions pl/css/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ Nasz blog nadal wygląda dość surowo, prawda? Czas, aby to zmienić! Użyjemy

Kaskadowe arkusze stylów (ang. Cascading Style Sheets, CSS) to język używany do określania wyglądu i formatowania strony internetowej napisanej w języku znaczników (np. HTML). Traktuj go jak make-up dla naszej strony :).

Ale nie chcemy znów zaczynać od samego początku, prawda? Użyjemy, raz jeszcze, narzędzia uprzednio stworzonego przez programistów i opublikowanego przez nich w Internecie, za darmo. Nie ma sensu ponownie wynajdować koła.
Ale nie chcemy znów zaczynać od samego początku, prawda? Użyjemy, raz jeszcze, narzędzia uprzednio stworzonego przez programistów i opublikowanego przez nich w Internecie, za darmo. Nie ma sensu ponownie wymyślać koła.

## Użyjmy Bootstrap!

Expand Down Expand Up @@ -37,7 +37,7 @@ Arkusz CSS jest plikiem statycznym, więc aby modyfikować style kaskadowe, musi

### Konfigurowanie plików statycznych w Django

Pierw, musimy stworzyć katalog w którym będziemy przetrzymywać nasze pliki statyczne. Utwórz katalog o nazwie `static` w folderze `djangogirls`.
Teraz musimy stworzyć katalog, w którym będziemy przetrzymywać nasze pliki statyczne. Utwórz katalog o nazwie `static` w folderze `djangogirls`.

djangogirls
├─── static
Expand Down
6 changes: 3 additions & 3 deletions pl/deploy/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -217,15 +217,15 @@ Teraz możemy otworzyć naszą aplikację w przeglądarce za pomocą polecenia `
$ heroku open


> **Uwaga**: Zobacz stronę z komunikatem o błędzie! Zajmiemy się tym za momencik
> **Uwaga**: Zobaczysz stronę z komunikatem o błędzie. Zajmiemy się tym za momencik!

W Twojej przeglądarce otworzy się strona pod adresem zbliżonym do [https://djangogirlsblog.herokuapp.com/](), no i w tym momencie prawdopodobnie pojawi się błąd. Jak dotąd stworzyłyśmy w naszej aplikacji jedynie widok admina, więc dodaj do adresu `admin/` (np. [https://djangogirlsblog.herokuapp.com/admin/]()), aby zobaczyć działającą stronę Twojej aplikacji.

Błąd, który widziałaś wcześniej, był spowodowany tym, że przy wdrażaniu strony na Heroku stworzyłyśmy nową bazę danych - i teraz jest ona pusta. Aby poprawnie przygotować naszą bazę danych do pracy, musimy wykonać polecenie ~~~ migrate~~~ w taki sam sposób, jak wtedy, gdy zaczynałyśmy tworzyć nasz projekt:
Błąd, który widziałaś wcześniej, był spowodowany tym, że przy wdrażaniu strony na Heroku stworzyłyśmy nową bazę danych - i teraz jest ona pusta. Aby poprawnie przygotować naszą bazę danych do pracy, musimy wykonać polecenie `migrate` w taki sam sposób, jak wtedy, gdy zaczynałyśmy tworzyć nasz projekt:

$ heroku run python manage.py migrate

$ heroku run python manage.py createsuperuser


Teraz powinnaś być w stanie zobaczyć swoją stronę w przeglądarce. Gratulacje :)!
Teraz powinnaś być w stanie zobaczyć swoją stronę w przeglądarce. Gratulacje! :)
8 changes: 4 additions & 4 deletions pl/django_forms/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,9 +29,9 @@ Dobrze, a teraz otwórzmy go i wprowadźmy następujący kod:

Musimy najpierw zaimportować formularze Django (`from django import forms`) oraz, naturalnie, nasz model wpisu (`from .models import Post`).

`PostForm`, jak zapewne podejrzewasz, to nazwa naszego formularza. Musimy poinformować Django, że ten formularz formularzem modelu (`ModelForm`), dzięki czemu Django wyręczy nas w pewnych czynnościach - właśnie za to odpowiada `forms.ModelForm`.
`PostForm`, jak zapewne podejrzewasz, to nazwa naszego formularza. Musimy poinformować Django, że ten formularz jest formularzem modelu (`ModelForm`), dzięki czemu Django wyręczy nas w pewnych czynnościach - właśnie za to odpowiada `forms.ModelForm`.

Dalej mam `class Meta`, gdzie przekazujemy Django informację o tym, jaki model powinien być wykorzystany do stworzenia tego formularza (`model = Post`).
Dalej mamy `class Meta`, gdzie przekazujemy Django informację o tym, jaki model powinien być wykorzystany do stworzenia tego formularza (`model = Post`).

I wreszcie możemy wskazać, które pole (lub pola) powinny pojawić się w naszym formularzu. W tym przypaku chcemy udostępnić tylko pola `title` (tytuł) i `text` (treść wpisu) - pole autora, czyli `author` powinno zawierać aktualnie zalogowanego użytkownika (Ciebie!), zaś data stworzenia wpisu (`created_date`) powinna być ustawiana automatycznie gdy stworzymy wpis (czyli za pomocą kodu) - zgadza się?

Expand Down Expand Up @@ -235,7 +235,7 @@ Django dba o walidację pól w naszym formularzu, upewniając się, czy są uzup

## Edycja formularza

Teraz już wimy, jak dodać nowy formularz. Ale co w przypadku, gdy zapragniemy zmienić już istniejący? Proces jest bardzo podobny do tego, który przeszłyśmy przed chwilą. Dodajmy szybko potrzebne elementy (jeżeli masz problem ze zrozumieniem czegoś - zapytaj osobę prowadzącą kurs lub przejrzyj poprzednie rozdziały, gdyż wszystkie kroki mamy już omówione).
Teraz już wiemy, jak dodać nowy formularz. Ale co w przypadku, gdy zapragniemy zmienić już istniejący? Proces jest bardzo podobny do tego, który przeszłyśmy przed chwilą. Dodajmy szybko potrzebne elementy (jeżeli masz problem ze zrozumieniem czegoś - zapytaj osobę prowadzącą kurs lub przejrzyj poprzednie rozdziały, gdyż wszystkie kroki mamy już omówione).

Otwórz `blog/templates/blog/post_detail.html` i dodaj poniższą linijkę:

Expand Down Expand Up @@ -307,7 +307,7 @@ Jeżeli potrzebujesz więcej informacji o formularzach Django, zajrzyj do dokume

## Jeszcze jedno: czas na wdrożenie!

Byłoby dobrze, aby zobaczyć, jeśli witryna nadal będzie działać na Heroku, prawda? Spróbuj ponownie ją zaktualizować. Jeśli nie pamiętasz jak to zrobić, sprawdź na końcu rozdziału 15:
Dobrze byłoby wiedzieć, że nasza witryna nadal działa na Heroku, prawda? Spróbuj ponownie ją zaktualizować. Jeśli nie pamiętasz jak to zrobić, sprawdź na końcu rozdziału 15:

$ git status
...
Expand Down
4 changes: 2 additions & 2 deletions pl/django_start_project/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,11 +14,11 @@ Nazwy niektórych plików i katalogów są bardzo ważne dla Django. Nie powinna

Uruchom w konsoli (pamiętaj, że nie musisz pisać `(myvenv) ~/djangogirls$`, OK?):

> Pamiętaj, aby uruchamiać wszystko w virtualenv. Jeśli nie widzisz prefiksu `(myvenv)` w konsoli, to znaczy że musisz uruchomić swój virtualenv. Wyjaśniłyśmy, jak to zrobić w rozdziale **Instalacja Django** w części **Praca z virtualenv**.
> Pamiętaj, aby uruchamiać wszystko w virtualenv. Jeśli nie widzisz prefiksu `(myvenv)` w konsoli, to znaczy że musisz uruchomić swój virtualenv. Wyjaśniłyśmy, jak to zrobić w rozdziale **Instalowanie Django** w części **Praca z virtualenv**.

Uruchom w Windows:

(myvenv) ~/djangogirls$ python myvenv\Scripts\django-admin.py startproject mysite .
(myvenv) ~/djangogirls> python myvenv\Scripts\django-admin.py startproject mysite .


a w Linuksie lub Mac OS:
Expand Down
2 changes: 1 addition & 1 deletion pl/django_templates/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ Zapewne zauważyłaś, że tym razem użyłyśmy nieco innej składni: `{{ post.

## Jeszcze jedno

Byłoby dobrze, aby zobaczyć, jeśli witryna nadal będzie nad Heroku, prawa? Spróbuj ponownie wdrażania. Jeśli nie pamiętasz jak to zrobić, sprawdź na końcu rozdziału 15:
Dobrze byłoby wiedzieć, że nasza witryna nadal działa na Heroku, prawda? Spróbuj ponownie wdrażania. Jeśli nie pamiętasz jak to zrobić, sprawdź na końcu rozdziału 15:

$ git status
...
Expand Down
8 changes: 4 additions & 4 deletions pl/how_internet_works/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ Założymy się, że używasz internetu codziennie. Ale czy wiesz co dzieje się

Aby zrozumieć jak działa internet powinnaś najpierw dowiedzieć się czym tak naprawdę jest strona internetowa, a jest ona tylko zbiorem plików zapisanych na dysku twardym. Dokładnie tak samo jak filmy, muzyka czy zdjęcia na Twoim komputerze. Aczkolwiek strony internetowe różnią się od nich tym, że zawierają kod komputerowy zwany HTML.

Jeśli do tej pory nie miałaś stycznoście z programowaniem, na początku może być Ci trudno zrozumieć czym jest HTML ale Twoje przeglądarki (takie jak Chrome, Safari, Firefox itp.) go uwielbiają. Przeglądarki internetowe są zaprojektowane i stworzone tak aby rozumieć ten kod, wykonywać zawarte w nim instrukcje i wyświetlać wszystkie pliki składające się na stronę internetową w taki sposób jak Ty tego chcesz.
Jeśli do tej pory nie miałaś styczności z programowaniem, na początku może być Ci trudno zrozumieć czym jest HTML ale Twoje przeglądarki (takie jak Chrome, Safari, Firefox itp.) go uwielbiają. Przeglądarki internetowe są zaprojektowane i stworzone tak aby rozumieć ten kod, wykonywać zawarte w nim instrukcje i wyświetlać wszystkie pliki składające się na stronę internetową w taki sposób jak Ty tego chcesz.

Tak jak w przypadku każdego innego pliku, musimy umiejscowić pliki HTML na dysku twardym. Do przechowywania plików HTML używamy specjalnych, potężnych komputerów zwanych *serwerami (ang. servers)*. Serwery nie posiadają monitorów, myszy ani klawiatur, ponieważ ich głownym celem jest przechowywanie danych i serwowanie ich. Dlatego są one nazywane *serwerami* -- ponieważ służą do *serwowania* danych.

Expand All @@ -20,15 +20,15 @@ Wygląda dość chaotycznie, prawda? W rzeczywistości jest to sieć połączony

![Rysunek 1.2](images/internet_3.png)

To fascynujące, czyż nie? Ale oczywiście niemożliwe jest stworzenie bezpośredniego połączenia kablowego między każdymi komputerem w internecie. Więc aby dostać się do maszyny dostępnej w internecie (na przykład tej, na której zapisane jest http://djangogirls.org) potrzebujemy wykonać zapytanie przez wiele, wiele różnych maszyn.
To fascynujące, prawda? Ale oczywiście niemożliwe jest stworzenie bezpośredniego połączenia kablowego między każdymi komputerem w internecie. Więc aby dostać się do maszyny dostępnej w internecie (na przykład tej, na której zapisane jest http://djangogirls.org) potrzebujemy wykonać zapytanie przez wiele, wiele różnych maszyn.

Wygląda to tak:

![Rysunek 1.3](images/internet_2.png)

Wyobraź sobie, że po wpisaniu http://djangogirls.org, wysyłasz list o treści: "Drogie Django Girls, chcę zobaczyć stronę djangogirls.org. Wyślijcie ją do mnie, proszę! "

List trafia do urzędu pocztowego najbliżej Ciebie. Następnie trafia do kolejnego urzędu bliżej adresata, i do następnego i następnego, aż zostanie doręczony do miejsca przeznaczenia. W sytuacji stron internetowych różnica jest tylko taka, że jeśli wysyłasz listy (*pakiety danych*) często do tego samego miejsca, każdy z nich może być przesyłany poprzez zupełnie różne urzędy pocztowe pośrednie (*routery*), w zależności od tego dokąd są one przekazywane w każdym z urzędów.
List trafia do urzędu pocztowego najbliżej Ciebie. Następnie trafia do kolejnego urzędu bliżej adresata, i do następnego, i następnego, aż zostanie doręczony do miejsca przeznaczenia. Jeśli chodzi o strony internetowe, sytuacja jest bardzo podobna. Różnica polega na tym, że nawet jeśli wysyłasz listy (*pakiety danych*) do tego samego miejsca to każdy z nich może "przejść" przez zupełnie inne pośrednie urzędy pocztowe (*routery*).

![Rysunek 1.4](images/internet_4.png)

Expand All @@ -40,6 +40,6 @@ Listy muszą spełniać konkretne warunki, żeby zostały poprawnie doręczone:

Tak więc, ogólnie rzecz ujmując, aby mieć stronę internetową musisz mieć *serwer* (komputer) gdzie będzie ona funkcjonować. *Serwer* oczekuje na nadchodzące *żądania* (listy, które proszą o wysłanie Twojej strony) i odsyła odpowiedź z Twoją stroną internetową (jako kolejny list).

Zapytasz pewnie co robi Django, skoro masz przed sobą tutorial Django. Kiedy odpowiadasz na żądanie, nie chcesz aby każdy dostawał tę samą odpowiedź, prawda? Zdecydowanie lepiej jest jeśli listy są spersonalizowane i skierowane do konkretnej osoby, do tej, która napisała do Ciebie. Django pomaga Ci w tworzeniu tych spersonalizowanych, interesujących listów :).
Zapytasz pewnie co robi Django, skoro masz przed sobą tutorial Django. Kiedy odpowiadasz na żądanie, nie chcesz aby każdy dostawał tę samą odpowiedź, prawda? Zdecydowanie lepiej jest jeśli listy są spersonalizowane i skierowane do konkretnej osoby, do tej, która napisała do Ciebie. Django pomaga Ci w tworzeniu tych spersonalizowanych, interesujących listów. :)

Wystarczy teorii, zabieramy się za tworzenie!
2 changes: 1 addition & 1 deletion pl/html/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -142,7 +142,7 @@ Chcemy wyświetlić prawdziwe wpisy dodane w naszym panelu admina Django - i tym

## Jeszcze jedno

Byłoby dobrze, aby zobaczyć, jeśli Twoja strona będzie nadal dobrze działa na Heroku, prawda? Spróbujmy zaktualizować naszą strone na serwerze.
Byłoby dobrze zobaczyć, czy Twoja strona będzie nadal dobrze działała na Heroku, prawda? Spróbujmy zaktualizować naszą stronę na serwerze.

Po pierwsze, zobaczmy, jakie pliki zostały zmienione od ostatniej aktualizacji:

Expand Down
4 changes: 2 additions & 2 deletions pl/intro_to_command_line/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,9 @@

Za chwilę napiszesz swoją pierwszą linijkę kodu. Jesteś już podekscytowana? :)

**Pozwól, że przedstawimy Ci, Twojego pierwszego przyjaciela: wiersz poleceń!**
**Pozwól, że przedstawimy Ci Twojego pierwszego przyjaciela: wiersz poleceń!**

Następujące kroki pokażą Ci, jak wykorzystać tajemnicze czarne okno, które używają wszyscy hakerzy. Na początku może to wyglądać nieco przerażająco ale tak naprawdę to tylko zachęta do wpisywania komend.
Następujące kroki pokażą Ci, jak wykorzystać tajemnicze czarne okno, którego używają wszyscy hakerzy. Na początku może to wyglądać nieco przerażająco ale tak naprawdę to tylko zachęta do wpisywania komend.

## Czym jest wiersz poleceń?

Expand Down
8 changes: 4 additions & 4 deletions pl/whats_next/README.md
Original file line number Diff line number Diff line change
@@ -1,25 +1,25 @@
# Co dalej?

Możesz z siebie być dumna! **Jesteś absolutnie świetna**. Jesteśmy takie dumne! < 3
Możesz być z siebie zadowolona! **Jesteś absolutnie świetna**. Jesteśmy takie dumne! <3

### Co teraz?

Zrób sobie przerwę i zrelaksuj się. Odwaliłaś kawał dobrej roboty!

Zaraz po tym, upewnij się że:

* Obserwujesz Django Girls na [Facebooku][1] lub [Twitterze][2] żeby być na bieżąco
* Obserwujesz Django Girls na [Facebooku][1] lub [Twitterze][2], żeby być na bieżąco

[1]: http://facebook.com/djangogirls
[2]: http://twitter.com/djangogirls

### Czy możesz polecić kolejne materiały?

Tak! Najpierw możesz spróbować naszej kolejnej książki: [Django Girls Tutorial: Extensions][3] -- to rozszerzenia i dodatkowe zadania do tego co już zrobiłaś.
Tak! Najpierw możesz spróbować naszej kolejnej książki: [Django Girls Tutorial: Extensions][3] - zawiera rozszerzenia i dodatkowe zadania związane z tym, co już tutaj przerobiłaś.

[3]: http://djangogirls.gitbooks.io/django-girls-tutorial-extensions/

Później możesz także spróbować któregoś z materiałów poniżej. Wszystkie bardzo polecane!
Możesz też spróbować któregoś z materiałów poniżej. Wszystkie bardzo polecamy!

- [Oficjalna dokumentacja Django][4]
- [instrukcje New Coder][5]
Expand Down