Mamy projekt dotyczący odpowiedzialności społecznej, mający na celu zachęcenie młodych ludzi do nauki tworzenia aplikacji mobilnych. Głównym problemem, przed którym stajemy, jest przede wszystkim język. Większość młodych ludzi w naszym kraju nie ma wystarczającej znajomości języka angielskiego, aby móc wyszukiwać lub uczyć się czegoś po angielsku. Dlatego nasza jedna z największych różnic w porównaniu z ogólnoświatowymi samouczkami/stronami do nauki jest w języku ojczystym.Dokumentacja wielojęzycznego systemu Android Sdk
Jako pomocnik projektu w dziedzinie technicznej odpowiadamy na pytania, piszemy posty na blogu i staramy się pomóc ludziom w nauce programowania aplikacji mobilnych w ich ojczystym języku. Jednym z problemów, z jakimi borykam się, pomagając ludziom, jest niemożność dostarczenia oficjalnych referencji (w języku ojczystym) na temat udzielonych przez nas odpowiedzi. Ten problem popchnął mnie do przetłumaczenia całej dokumentacji sdk androida na nasz ojczysty język :) Wiem, że to ogromna praca, możemy próbować tłumaczyć - pozyskiwanie jej nie wiem ale rzeczą, o którą chcę tutaj zapytać, są tylko sugestie dotyczące implementacji takiej dokumentacji projekt.
Jakiego rodzaju technologii używałbyś, w jaki sposób byłoby możliwe zsynchronizowanie z najnowszymi wersjami sdk. Czy sądzisz, że aktualne strony z dokumentacją SDK do androida zostały wygenerowane automatycznie? Czy to tylko java-doc? Jak obsługiwać wiele języków za pomocą java-doc? Lub w jakikolwiek inny sposób?
Mam nadzieję, że pytania nie będą zamknięte, nie będą ze sobą powiązane, to jest pytanie całkowicie techniczne.
Dziękuję wszystkim
"Czy uważasz, że aktualne strony z dokumentacją SDK na Androida są generowane automatycznie?" -- tak. "Czy to po prostu java-doc?" - JavaDocs z pewnością są, prawdopodobnie za pomocą jakiegoś niestandardowego docletu, który zna adnotacje specyficzne dla systemu Android, takie jak '@ hide'. – CommonsWare
Warto sprawdzić tego bro. http://stackoverflow.com/questions/5538586/generate-localized-javadoc – Tanhan
_Jak wspierać obsługę wielu języków za pomocą java-doc? _ Nie znam jeszcze DK Androida, ale jak wspomniał CommonsWare, dostosowany doclet. (Lub taglet), który wykorzystuje zasoby zewnętrzne. Tło: dla przeszłego projektu Java (SE) zrobiłem taglet, który importuje pliki HTML i/lub obrazy z innych źródeł do Javadoc. (Ale to nie jest widoczne dla IDE). W twoim przypadku, wskazując na różne "pliki dokumentów", na przykład, specyficzne dla każdego języka, możesz zbudować odpowiednio wiele wersji javadoc API. – eruve