Google Code Search - Najczęściej zadawane pytania

Google Code Search - informacje

Najczęściej zadawane pytania

Jaki rodzaj kodu indeksujecie?

Jaką składnię wyrażeń regularnych regexp obsługuje wyszukiwarka Code Search?

Które języki programowania obsługujecie?

W jaki sposób ograniczyć wyniki wyszukiwania według języków, licencji lub nazw plików?

Czy mogę dodać wyniki Google Code Search do mojej witryny, rozszerzenia IDE lub aplikacji?

Jak decydujecie, którą licencję wyświetlić dla fragmentu kodu?

Jak dodać własny kod do wyników wyszukiwania Google Code Search?

Jak upewnić się, że stosujecie prawidłowy język i licencję w przypadku moich plików z kodem?

Jak zablokować indeksowanie kodu?

Mam propozycje ulepszeń produktu. Jak je zgłosić?

Jak poinformować Google o wyniku wyszukiwania, który powinien zostać usunięty z indeksu Code Search?

Na jakich warunkach można korzystać z usługi?

Google Code Search - informacje

Wyszukiwarka Google Code Search ułatwia znalezienie definicji funkcji i przykładów kodu, umożliwiając wyszukiwanie w jednym miejscu kodu źródłowego publicznie dostępnego w internecie. Korzystając z wyszukiwarki Google Code Search, można:

Używać wyrażeń regularnych w celu precyzyjnego wyszukiwania.

Ograniczyć wyniki wyszukiwania według języków, licencji lub nazw plików.

Wyświetlić plik źródłowy z linkami do całego pakietu oraz do strony internetowej, z której pochodzi plik.

Najczęściej zadawane pytania

1. Jaki rodzaj kodu indeksujecie?

Indeksujemy wszelki dostępny publicznie kod źródłowy, który możemy znaleźć, włącznie z plikami archiwalnymi (w formatach .tar.gz, .tar.bz2, .tar oraz .zip), repozytoriami CVS i repozytoriami Subversion (SVN).

2. Jaką składnię wyrażeń regularnych regexp obsługuje wyszukiwarka Code Search?

Wyszukiwarka Google Code Search obsługuje składnię rozszerzonych wyrażeń regularnych POSIX, z wyjątkiem odwołań wstecznych oraz elementów i klas sortowania z porównaniem. Aby wyszukać znak spacji, należy go poprzedzić znakiem ucieczki (odwróconą kreską ułamkową), na przykład witaj,\ świecie. Można wyszukiwać dokładne ciągi znaków, ujmując je w cudzysłowy górne proste, na przykład "witaj, świecie".

Obsługujemy również następujące rozszerzenia języka Perl:

`\w`	Dopasowuje znak słowa. (alfanumeryczne oraz znak "_")
`\W`	Dopasowuje znak inny niż znak słowa.
`\s`	Dopasowuje znak spacji.
`\S`	Dopasowuje znak inny niż znak spacji.
`\d`	Dopasowuje znak cyfry.
`\D`	Dopasowuje znak inny niż znak cyfry.

3. Które języki programowania obsługujecie?

Strona Zaawansowane wyszukiwanie kodu zawiera listę wykrywanych przez nas języków programowania. Nawet jeśli żądanego języka nie ma na tej liście, można wyszukać napisany w nim kod. Udostępniamy do wyszukiwania każdy dostępny kod, włącznie z kodem, którego języka nie możemy wykryć. Jeśli możemy wykryć język programowania użytego w pliku, informujemy o tym w wynikach wyszukiwania. Użytkownik może wówczas zawęzić wyszukiwanie do kodu napisanego w tym języku.

Jeśli nie wykrywamy żądanego języka, za pomocą operatora file: można przeprowadzić wyszukiwanie plików o określonym rozszerzeniu. Można na przykład zawęzić wyszukiwanie do plików o rozszerzeniu .x lub .abc, stosując zapytanie takie jak moje_zapytanie file:\.(x|abc)$. Jeśli na liście wykrywanych języków brakuje ważnego języka, prosimy o informację.

4. W jaki sposób ograniczyć wyniki wyszukiwania według języków, licencji lub nazw plików?

Można użyć w tym celu strony Zaawansowane wyszukiwanie kodu albo odpowiednich operatorów wyszukiwania. Dostępne są następujące operatory:

Operator lang:, zawężający kryterium języka programowania (np. lang:"c++", -lang:java lub lang:^(c|c#|c\+\+)$)

Operator license:, zawężający kryterium licencji oprogramowania (np. license:apache, -license:gpl lub license:bsd|mit)

Operator package:, zawężający kryterium adresu URL pakietu (np. package:"www.kernel.org" lub package:\.tgz$)

Operator file:, zawężający kryterium nazwy pliku (np. file:include/linux/$ lub -file:\.cc$)

Argumentem każdego z tych operatorów może być ciąg znaków ujęty w cudzysłowy górne proste lub wyrażenie regularne. Jak widać w niektórych powyższych przykładach, każdego z operatorów można użyć jako kryterium wykluczającego, umieszczając przed nim znak minusa ("-").

5. Czy mogę dodać wyniki Google Code Search do mojej witryny, rozszerzenia IDE lub aplikacji?

Tak. Wyniki wyszukiwania w Code Search są dostępne za pośrednictwem kanału GData/XML i zachęcamy użytkowników do tworzenia dodatków plug-in rozszerzeń IDE oraz dodawania wyszukiwania Google Code Search do witryn.

6. Jak decydujecie, którą licencję wyświetlić dla fragmentu kodu?

W celu wykrycia licencji na oprogramowanie pakietów kodu szukamy licencji w komentarzach lub oddzielnym pliku licencji (np. LICENSE, LICENCE, COPYRIGHT, COPYING). Jeśli nie możemy znaleźć licencji, w wynikach wyszukiwania wyświetlamy oznaczenie licencji "Nieznana". Należy pamiętać, że nasze wykrywanie licencji nie jest doskonałe - staramy się podać licencję zgodnie z informacjami pochodzącymi od autora kodu, ale możemy się pomylić (a czasami autor podaje nieprawidłowe informacje na temat licencji). Wyniki Code Search nie zawierają również informacji na temat patentów, którymi może być chroniony fragment oprogramowania. Podajemy prawdopodobne informacje o warunkach licencji, ale zapoznanie się z wymogami prawnymi związanymi z wykorzystaniem fragmentu kodu jest obowiązkiem użytkownika.

7. Jak dodać własny kod do wyników wyszukiwania Google Code Search?

Kod można zgłosić za pomocą formularza internetowego. W przypadku dużej liczby zgłaszanych kodów warto utworzyć mapę witryny wyszukiwarki Code Search, dzięki czemu możliwe będzie określenie wszystkich plików z kodem w danej witrynie. Należy pamiętać, że do indeksu nie dodajemy całego zgłoszonego kodu. Nie możemy także przewidzieć ani zagwarantować, kiedy i czy dany kod się w nim pojawi.

8. Jak upewnić się, że stosujecie prawidłowy język i licencję w przypadku moich plików z kodem?

Można utworzyć plik packagemap zawierający informacje na temat języka i licencji każdego pliku w pakiecie. Plik można utworzyć, stosując format packagemap XML. Następnie należy umieścić ten plik w katalogu najwyższego poziomu archiwum kodów.

9. Jak zablokować indeksowanie kodu?

Wyszukiwarka Google Code Search stosuje się do pliku robots.txt, a zatem indeksowanie kodu przez nasze roboty można zablokować na kilka sposobów:

Jeśli masz dostęp do pliku robots na serwerze internetowym, możesz dodać ścieżkę kodu do wiersza Disallow:. Więcej informacji.

Można również po prostu umieścić plik robots w katalogu głównym pakietu kodu. Metoda ta jest skuteczna zarówno w przypadku archiwów, jak i repozytoriów służących do kontroli źródeł, takich jak CVS i Subversion. Aby zablokować indeksowanie całego kodu przez roboty, wystarczy dodać do katalogu głównego plik o nazwie robots.txt zawierający następujące wpisy:


                         User-agent: *

                          Disallow: /

Należy pamiętać, że zaktualizowanie indeksu i usunięcie kodu z wyszukiwarki Code Search może zająć nieco czasu. Jeśli żądanie jest pilne, prosimy o wysłanie e-maila na adres codesearch-issues+pl@google.com.

10. Mam propozycje ulepszeń produktu. Jak je zgłosić?

Najlepiej jest w tym celu wysłać post na grupę dyskusyjną. Google Code Search to usługa we wczesnej fazie rozwoju i stanowi część Google Labs. Opinie użytkowników są dla nas cenne, gdyż pozwalają nam doskonalić produkt.

11. Jak poinformować Google o wyniku wyszukiwania, który powinien zostać usunięty z indeksu Code Search?

Google Code Search to usługa dopiero opracowywana w Google Labs, a zatem wyniki wyszukiwania mogą być niedoskonałe. W przypadku istotnego problemu związanego z wynikami wyszukiwania prosimy o informacje pod adresem codesearch-issues+pl@google.com. Jeśli jesteś właścicielem praw autorskich i uważasz, że znalezione wyniki wyszukiwania naruszają Twoje prawa autorskie, możesz zażądać ich usunięcia zgodnie z procedurą DMCA.

12. Na jakich warunkach można korzystać z usługi?

Odpowiednie informacje można znaleźć na stronie Warunków korzystania z usługi Google Code.