FAQ - najczęściej zadawane pytania
[edytuj] Jaki jest cel istnienia tej strony?
Naszym ostatecznym celem jest zapewnienie (względnie) kompletnej dokumetacji języka C i C++ i bibliotek standardowych.
Pierwszorzędnym celem jest jednak zapewnienie dobrej specyfikacji języków C i C++. Oznacza to, że rzeczy oczywiste dla doświadczonego programisty powinny być pomijane, lub przynajmniej oddzielone od głównego opisu funkcji/klasy. Dobrym miejscem do zaprezentowania różnych możliwości użycia czegoś jest sekcja "przykład", którą można umieścić na dole strony.
[edytuj] Jak powstaje polska wersja? Co jest już dostępne?
Polska wersja powstaje głównie poprzez tłumaczenie materiałów z wersji angielskiej, wraz z ewentualnym sprawdzeniem ich poprawności w dokumentach opisujących odpowiednie standardy. Na razie dostępne jest większość stron z biblioteki kontenerów. Wciąż pracujemy nad tłumaczeniem nowych materiałów.
[edytuj] W jakim celu powstaje polska wersja dokumentacji?
Wersja krótka: bo może :)
Wersja długa: dla osób uczących się C/C++, bądź nie władających biegle językiem angielskim korzystanie z angielskiej wersji cppreference może być trudne i zajmować dużo czasu. Nie istnieje też obecnie żadna inna polska dokumentacja tych języków, z której można by skorzystać. Wierzymy, że tworząc dokumentację w języku polskim uda się zainteresować nowe osoby językami C/C++ oraz wspomóc obecnych programistów z Polski dokumentacją w ich ojczystym języku.
Również dla nas, tłumaczących, jest to okazja do poznania bliżej niektórych z aspektów języka.
[edytuj] Czemu materiał zamieszczany tutaj jest ograniczony do standardów C i C++?
Angielskie FAQ tłumaczy to wyborem jakości nad ilością. W przypadku wersji polskiej, mamy przed sobą jeszcze taki ogrom materiałów do przetłumaczenia z samego standardu, że dokładanie do tego dodatkowych bibliotek, tj. boost nie ma najmniejszego sensu.
[edytuj] Do której wersji Standardu C odnosi się ta dokumentacja?
C11 jest najnowszym opublikowanym Standardem C. Kiedy dokumentacja tego języka będzie tłumaczona, będzie opisywała ten właśnie standard (z notkami wskazującymi na zmiany, jakie nastąpiły od poprzednich standardów), tak jak angielski cppreference. Na razie jednak skupiamy się na tłumaczeniu dokumentacji C++. Jeśli zależy Ci na dokumentacji C w języku polskim, zachęcamy do samodzielnego zabrania się za jej tłumaczenie. Porady odnośnie samodzielnego tworzenia nowych materiałów znajdują się niżej.
[edytuj] Do której wersji Standardu C++ odnosi się ta dokumentacja?
C++17 jest najnowszym opublikowanym Standardem C++. Jednak naszym pierwszym celem jest zapewnienie najpierw dobrej dokumentacji standardu C++11, a dopiero później próba rozszerzenia jej na nowsze standardy. Jest to znowu związane z olbrzymią ilością materiału, który pozostał nam do przetłumaczenia.
Staramy się także dołączać opis odnoszący się do poprzednich wersji standardu (C++98, C++03), ze wskazaniem zaistniałych zmian. Wszystkie informacje zależne od wersji standardu powinny być odpowiednio oznaczone.
Uwaga dla potencjalnych tłumaczy: przy kopiowaniu materiału z wersji angielskiej cppreference zaleca się nie usuwać informacji odnoszących się do nowszych standardów, ale komentować je. Dzięki temu później łatwiej będzie przejść z dokumentacją do nowego standardu.
Poniższa lista przedstawia, gdzie można znaleźć same Standardy C++:
- C++20
- The latest free working draft is n4713 (2017-11-27)
- The most up-to-date version can be found, in source form, at https://github.com/cplusplus/draft and in browseable form at eel.is/c++draft.
- C++17
- The official C++17 standard can be purchased directly from ISO and is expected to also be made available by ANSI and other member organizations.
- The final draft of C++17 is n4659 (2017-03-21).
- C++14
- The C++14 standard was withdrawn and is no longer available from ISO. It can still be purchased through ANSI and other member organizations
- A free C++14 final draft (n4140) is available as well as the diff between it and the standard (n4141)
- C++11
- The C++11 standard was withdrawn and is no longer available from ISO.
- A free C++11 Working Draft (n3337) is available. (The differences between the Working Draft and the C++11 Standard are minor.)
- C++03
- The C++03 standard was withdrawn and is no longer available from ISO.
- C++98
- The C++98 standard was withdrawn and is no longer available from ISO.
[edytuj] Czy jest dostępna wersja tej dokumentacji możliwa do oglądania offline?
Niestety, nie posiadamy na razie takiej wersji. Istnieje za to wersja offline dokumentacji w języku angielskim.
[edytuj] Czy istnieje możliwość zmiany wyglądu strony?
Ciemny motyw może być dla Ciebie łatwiejszy do czytania niż domyślny, jasny motyw.
[edytuj] Co mogę zrobić z materiałem na tej stronie?
Zawartość jest umieszczana pod licencją [Creative Commons Attribution-Sharealike 3.0 Unported License] (CC-BY-SA) i pod licencją [GNU Free Documentation License] (GFDL) (unversioned, with no invariant sections, front-cover texts, or back-cover texts). Oznacza to, że możesz korzystać z zawartych tu materiałów jak tylko chcesz, włączając ich duplikowanie, kopiowanie, udostępnianie, tłumaczenie itd. Jedyne, o co byśmy prosili to umieszczenie obok publikowanych materiałów linka do cppreference.com, aby potencjalni czytelnicy mieli dostęp do najaktualniejszej wersji, jeśli by jej potrzebowali. Dodatkowo, jakakolwiek zmodyfikowana zawartość może zostać opublikowana pod równoważną licencją, aby nadal każdy mógł z niej korzystać.
[edytuj] Co? To jest wiki? Mogę zmieniać rzeczy?
Jak najbardziej. Jeśli znajdziesz jakikolwiek błąd lub nieścisłość, możesz ją naprawić. Pamiętaj, że ta wiki jest ograniczona do zawartości standardów C11 i C++11 (oraz starszych), więc nie powinieneś dodawać informacji o zewnętrznych bibliotekach, opcji charakterystycznych dla konkretnego kompilatora ani informacji odnoszących się do nowyszch standardów. Pamiętaj, aby najpierw dwa razy sprawdzić zgodność wprowadzanych zmian z odpowiednim standardem. Jeśli jesteś czegokolwiek niepewien/niepewna, możesz zawsze spytać na stronach dyskusji.
[edytuj] Jak mogę edytować strony? Jakie są zasady składni?
Ta wiki używa Mediawiki, tego samego systemu, z którego korzysta projekt Wikipedia. Możesz skorzystać z ich stron pomocy, aby zapoznać się ze składnią Mediawiki wikicode. Jednakże, większość zawartości tej wiki jest opakowana w dosyć złożone szablony. Wykonują one większość formatowania i pomagają zebrać powtarzane materiały w jedno miejsce, aby w razie porzeby jakiejś zmiany, nie trzeba było dokonywać tej samej modyfikacji dziesiątki czy setki razy. Aby dowiedzieć się więcej o szablonach wykorzystywanych na wiki, zobacz Pomoc:Szablony.
Ta wiki stara się utrzymać jednolity styl. Jeśli chcesz stworzyć nową stronę od zera, zapoznaj się ze stroną Pomoc:Poradnik stylu, gdzie znajdziesz porady, jak utrzymać taki styl i formatowanie, jak na reszcie stron.
Jeśli jednak tłumaczysz z wersji angielskiej, wystarczy, że zachowasz istniejące tam formatowanie. Aby to zrobić, przejdź na angielskiej wersji do edycji strony (przycisk w prawym górnym rogu artykułu, edit lub view source), a następnie skopiuj stamtąd jej kod źródłowy. Przetłumacz tylko tekst, pozostawiając użyte szablony bez zmian.
Więcej odnośnie edycji możesz znaleźć w Poradniku edytowania stron.
[edytuj] Chcę pomóc. Jak mogę zacząć?
Świetnie! Możesz zacząć od przeczytania stron, wymagających przejrzenia:
Jeśli chciałbyś samemu zacząć pisać, dobre na start będą:
Jeśli chcesz podjąć się tłumaczenia jakiejś strony lub większej sekcji, najlepiej powiadomić o tym na naszej [grupie]. Zostanie to oznaczone w odpowiednim poście, i inni tłumaczący zostawią całą stronę/sekcję tylko dla Ciebie, tak długo, jak będziesz się nią zajmował.
Przy tłumaczeniu pamiętaj o zachowaniu ustalonych już konwencji.
[edytuj] Kto stoi za tą stroną?
cppreference.com zostało stworzone i jest utrzymywane przez grupę entuzjastów C++ z całego świata. Za tłumaczenie wersji polskiej jest odpowiedzialna niewielka (na razie) grupa pasjonatów języka, która stwierdziła, że warto poświęcić swój czas w celu jego rozpowszechnienia. Można do nas dołączyć na naszej [grupie facebookowej] - dyskutujemy tu o tłumaczeniu różnych określeń, odostępniamy postęp swoich prac, decydujemy o kierunku, w którym będzie się posuwać tłumaczenie.
Pieniądze na utrzymanie serwerów są pozyskiwane przez angielskich twórców z dotacji i sprzedaży upominków z C++owymi sucharami.
[edytuj] Jak mogę się z Wami skontaktować?
Na stronie angielskiego FAQ widnieje mail comments@cppreference.com. Z doświadczenia możemy powiedzieć, że nie jest on najlepszą metodą kontaktu z angielskimi twórcami :) Jeśli chcesz skontaktować się z polskimi tłumaczącymi, odwiedź naszą [grupę facebookową]. Większość z nas się tam znajduje. Jeśli potrzebujesz kontaktu w sprawach wymagających interwencji administratora serwisu, znajdź na angielskiej wersji listę administratorów, i napisz do tego, który był ostatnio dostępny.
Jeśli masz jakieś istotne pytanie, bądź chciałbyś zgłosić znaleziony błąd, możesz to zrobić tutaj.
