Tomasz Wiktorski - DevNotes

Na początek, przy okazji, chciałem powiadomić Was, że wersja 1.5.0 Zend Frameworka PR jest już oficjalnie dostępna i można ja ściągnąć z http://framework.zend.com. Natomiast samo oświadczenie przeczytamy na http://devzone.zend(...)now-available

A teraz do rzeczy. Otóż nie wiem czemu ale nienawidzę wykorzystywania wiki do tworzenia czegokolwiek innego niż encyklopedii. W takich przypadkach jak wiki Zend Frameworka po prostu można oszaleć. Nigdy tam nie mogę nic konkretnego znaleźć. Wszystkie potrzebne mi treści są tak skrzętnie poukrywane że nie wiadomo jak do nich dotrzeć. Można klikać pół dnia, znaleźć przy okazji parę fajnych tekstów, ale nigdy tego co się poszukuje.

Od jakiegoś czasu polski manual nie jest dostępny na stronie z dokumentacja, ponieważ nie ma przetłumaczonych 50% treści. Zresztą nawet jak były, to połowa była nieaktualna. Dlatego, bardzo często korzystałem z polskiej wersji manuala na wiki. Niestety jakiś czas temu przeprowadzona tam jakąś reorganizacje i wszystko zmieniło swoje miejsce. Od tego czasu nie widziałem wersji z wiki na oczy. Jeśli ktoś byłby w stanie mi wskazać dokładnego linka to będę wdzięczny.

Poruszony tą całą sytuacją nawet nabrałem ochoty na przetłumaczenie jakiejś części dokumentacji. Niestety tu też się zawiodłem. żeby móc to zrobić, trzeba przejść uciążliwy proces rejestracji. Jednym z wymogów jest podpisanie licencji i wysłanie jej faksem, bądź przeskanowanie i wysłanie e-mailem. Niestety, ani faksu, ani skanera nie mam. Pytałem trochę po kolegach, ale tak samo krucho. Trochę się zdenerwowałem, bo bym popchnął tą dokumentacje choćby trochę do przodu, ale wszystko działa na niekorzyść.

Po tym wszystkim, pomyślałem sobie że ściągnę dokumentacje która jest zamieszczona w snapshotach. Niestety powstał kolejny problem. Jest ona napisana w docbooku - kolejna uciążliwość. żeby ją jakoś ogarnąć trzeba ja przekonwertować. Niestety pod Windowsa nie ma na to prostych narzędzi (masakra!). Poprosiłem jednak kolegę, który korzysta z linuxa aby mi to uczynił, bo to - jak czytamy - kwestia trzech poleceń. Oczywiście niestety nie ma tak łatwo. Polska wersja wypluwa masę błędów i kończy się niepowodzeniem. Na szczęście en daje pożądany wynik. Dodatkowo można jeszcze z niej zrobić wersje CHM, co jest dużym plusem. Jakby ktoś był zainteresowany umieszczam link poniżej.

Dla tych, którym nie chce się tego wszystkiego czytać:
- mamy oficjalne wydanie Zend Framework 1.5.0 PR
- nie lubię/nie umiem korzystać z wiki
- nie umiem znaleźć polskiego manuala ZF
- nie mogę pomóc w jego tłumaczeniu
- docbook to nędzny format
- angielski manual w wersji chm

Inne