Manual PHP pomóżcie! Opcje

[splatch]

Każdy wie, jak wygląda manual php, jak wygląda polski manual. Wiadomo, częściowo spolszczony, praktycznie nie zmieniany. Już nie każdy wie, że pracuje nad nim tylko kilka osób. Są to różni ludzie od nauczyciela informatyki i angielskiego po studenta. Każda z tych osób ma własne życie i nie możemy wymagać, że będą pracować nad manualem od świtu do nocy za nic. Wiele razy czytałem o tym, że polski manual jest zły, że mógłby być lepszy, że ... właśnie, ludzie pracujący nad nim często nie słyszą nawet dziękuję, wyobrażacie to sobie?
Teraz przychodzi kolej na zasadniczą część mojego wywodu. Jest nas wielu, programistów php, znających angielski. Wielu z nas mogłoby przetłumaczyć chociaż jeden opis funkcji, nie chodzi o rozdział, nie chodzi o całość, chodzi o jeden rzetelny przekład opisu funkcji, nic więcej. Czy byłbyś w stanie przetłumaczyć opis funkcji preg_replace()? Jeśli tak to czemu tego nie zrobisz? Wyobraźcie sobie - przetłumaczysz jeden opis a w zamian dostaniesz w całośći spolszczony manual. Czy to się opłaca? Moim zdaniem tak. Już przetłumaczyłem, chociaż z trudem, dwie strony manuala. Jestem z siebie cholernie zadowolony tymbardziej, że może się on przydać tysiącom ludzi. Kto wie, może kiedyś i ty z tego tłumaczenia skorzystasz?
Właśnie do was ludzie kieruję mój apel. Ludzie tłumaczcie choćby po jednej małej stronie manuala. Jest nas tak wielu, że przetłumaczymy dokumentację i wreszcie będziemy mogli się cieszyć dokumentacją w rodzimym języku! To gra warta poświęcenia tych piętnastu minut!
Pamiętaj nie jest to obowiązek, zrób to jeśli czujesz się na siłach. W zamian nie dostaniesz nic, ba jeszcze ktoś może się przyczepić do twojego tłumaczenia. Chciałbyś być na liście osób tłumaczących manuala? Chciałbyś aby twoje imię i nazwisko stało obok Leszka Krupińskiego, tak niedaleko Rasmusa Lerdorf'a nieco niżej niż Andrei Zmievski? Ja chciałbym, ja pragnę tego z całego serca, móc się pochwalić! Tłumaczę co mogę, co jestem w stanie. Na razie jest tego mało, ale wystarczy mi w odpowiedzi dziękuję, a nawet milczenie, że wszystko jest dobrze (IMG:http://forum.php.pl/style_emoticons/default/smile.gif) .
Weźmy przykład z flashzone.pl - gdzie ludzie się zorganizowali i przetłumaczyli cały manual do flash'a 5, gdzie 375 stron tłumaczyło 37 osób. 7 osób przetłumaczyło po jednej stronie, gdyby nas było na to stać? Co wy na to? Jeśli możesz to usiądź spokojnie wybierz sobie jednąskromną stronę i przetłumacz. Gdy już skończysz wyślij to co masz na adres leszek@faq.pl on ci będzie na pewno wdzięczny tak samo jak ja i społeczność programistów php korzystających z dokumentacji php.

Acha nie tłumaczcie pierwszej strony odnośnie cURL'a i opisu funkcji imagecopy() (IMG:http://forum.php.pl/style_emoticons/default/smile.gif) .

[DeyV]

odpowiednie starania dotyczące tego systemu zostały już kiedyś poczynione - jednak brak czasu i nadmiar obowiązków naszego zespołu skutecznie je spowolnił.

1. Mamy otwarty projekt http://sourceforge.net/projects/phpgt/ czyli phpGroupTranslator mający stać się narzędziem właśnie do tego celu.

2. prace nad tym softem nie zostały niestety - na poważnie rozpoczęte.

3. Mamy jednak dokładne założenia, jak to powinno (mogłoby) działać.
Pozwólcie, że przedstawię pokrótce zasadę działania. A wy ocenicie, czy rzeczywiście projekt jest aż tak banalny, by napisać go w 15 min (IMG:http://forum.php.pl/style_emoticons/default/winksmiley.jpg)

Opis planu działania phpGt:
a. uruchamianie projektu tłumaczenia
Do wybranego folderu (A) wrzucamy pliki do przetłumaczenia (np. w postaci znanej z
"Many HTML files" w manualu php)
Następnie uruchamiamy funkcję skanującą ten folder (A), zapisującą do bazy:
- nazwy plików,
- ich rozmiary
- być może md5 plików
Miel widziane byłoby też wyciąganie jakichś nagłówków już z samego pliku (np. nazwa rozdziału lub funkcji), ale to jest do ustalenia

b. Aktualizacja projektu (zmiana plików oryginalnych)
W przypadku zmiany jakichś plików w oryginale, wrzucamy nowe i zmienione pliki do tego samego folderu (A), i ponownie uruchamiamy skanowanie. Rozpoznaje ono, za pomocą sygnatur md5 lub rozmiaru plików, te które zostały zmienione, i zgłasza je do weryfikacji.

c. baza użytkowników.
Każdy projekt zawiera bazę użytkowników, uprawnionych do dodawania tłumaczeń, a także moderatorów - mających możliwość akceptowania lub odrzucania określonych tłumaczeń. Jest również administrator, sterujący całym projektem, i wybierający moderatorów.

d. praca z systemem.
Zalogowany użytkownik chodzi na stronę, gdzie widzi listę materiałów do przetłumaczenia. Każdy materiał ma oznaczenie, informujące o tym, czy jest aktualnie tłumaczony (zarezerwowany do tłumaczenia) , czy też nie.
Materiały przetłumaczone zawierają procentową informację o stopniu przetłumaczenia.
te przetłumaczone w 100% mogą również zostać uznane za zamknięte (czyli któryś z moderatorów zaakceptował jakość tłumaczenia) i pozostanie w tym stanie do momentu zmodyfikowania pliku oryginalnego (folder A)
Pliki zaakceptowane zapisywane są w folderze wynikowym ((IMG:http://forum.php.pl/style_emoticons/default/cool.gif)
Każdy użytkownik może wybrać sobie dowolny nie zamknięty, oraz nie tłumaczony materiał, i oznaczyć go jako w tłumaczeniu. (na określony czas, np. 2 tygodnie)
W tym okresie powinien na miarę swoich możliwości przetłumaczyć swój dokument, następnie zwolnić go, podając równocześnie orientacyjną (procentową) ilość materiału przetłumaczonego.
Może również zgłosić dokument do akceptacji moderatorom.

e. edycja dokumentów.
Proponuję 2 ramki, w górnej oryginalny dokument (może odpowiednio pokolorowany przy pomocy jakiegoś parsera? ) a w dolnym text area, do wprowadzania materiałów.
Miło by było, by nie było konieczne przepisywanie całej sekcji head dokumentów, - czyli by pracować tylko na tym, co jest pomiędzy body, resztę pozostawiając systemowi.
Można również pokusić sie o jakiś edytor typu htmlArea, ale nie jestem przekonany o konieczności tego.

f. Narzędzia dodatkowe.
Bardzo przydatny może okazać się słownik trudnych wyrażeń, tak by słownictwo było ustandaryzowane.
Do tego słownika każdy użytkownik może zgłaszać swoje propozycje, po akceptacji zostają one uznane za obowiązujące.


Założenia te są przygotowane w oparciu o system skutecznie działajacy na flashzone.pl przy pomocy którego przetłumaczono manual flasha.
Niestety - tamten system jest bardzo mocno zintegrowany z ich forum, więc nie mam prostej możliwości na wykorzystanie go w naszym projekcie. (Zresztą nawet nie wiem, czy jeszcze działa)

No - a teraz pytanie - czy są jacyś chętni do pracy nad tym projektem?
Myślę, że warto by było zrobić to dobrze, bo projekt ma szanse okazać się przydatny nie tylko nam, przy tłumaczeniu manuala php, ale też wielu innym ludziom, pracującym nad tłumaczeniami, (do czego nie ma niestety, zbyt wielu narzędzi).

Mile widziane również propozycje na poprawę "funkcjonalności" tych założeń.