ЧаВо о поиске кода Google

Какой синтаксис регулярных выражений поддерживается в поиске кода Google?

Какие языки программирования поддерживаются?

Как ограничить поиск по языку, лицензии или названию файла?

Можно ли добавить результаты поиска поиска кода Google на свой веб-сайт, в интегрированную среду разработки программного обеспечения или приложение?

Каким образом определяется, какую лицензию на ПО указывать для части кода?

Как добавить свой код в результаты поиска кода Google?

Как убедиться в том, что для моих файлов кода выбраны правильные язык и лицензия?

Что нужно сделать, чтобы мой код не сканировали?

У меня есть предложения по улучшению продукта. Кому о них написать?

Как сообщить в Google, если я считаю, что какой-то из результатов поиска кода Google нужно удалить?

Каковы условия использования?

О поиске кода Google

Поиск кода Google помогает найти описания функций и образцы кода, предоставляя возможность поиска кода в общедоступных источниках, размещенных в Интернете. Поиск кода Google позволяет:

использовать регулярные выражения, чтобы выполнять более точный поиск,

ограничивать поиск по языку, лицензии или названию файла,

просматривать исходный файл, снабженный ссылками на весь пакет и на веб-страницу, на которой он находится.

Часто задаваемые вопросы

1. Какие типы кода сканируются?

Мы сканируем все общедоступные исходные коды, которые удается найти, включая архивы (.tar.gz, .tar.bz2, .tar, и .zip), хранилища CVS и Subversion.

2. Какой синтаксис регулярных выражений поддерживается в поиске кода Google?

Поиск кода Google поддерживает синтаксис расширенных регулярных выражений стандарта POSIX, за исключением обратных ссылок, упорядочивающих элементов и классов упорядочения. Чтобы найти символ пробела, отделите его обратной косой чертой, например, привет,\ мир. Можно искать текстовые строки, заключая строки в кавычки, например, "привет, мир".

Мы также поддерживаем следующие расширения языка Perl:

`\w`	Соответствует буквенным символам (буквенно-цифровые символы и знак "_")
`\W`	Соответствует символам, за исключением буквенно-цифровых
`\s`	Соответствует символам табуляции и пробела
`\S`	Соответствует печатным символам, за исключением пробельных
`\d`	Соответствует цифровым символам
`\D`	Соответствует нецифровым символам

3. Какие языки программирования поддерживаются?

На странице расширенного поиска кода Google перечислены языки программирования, которые мы можем распознавать. Но даже если на этой странице нет нужного языка, все равно можно выполнять поиск кода, написанного на этом языке. Мы стараемся включить в поиск как можно больше кодов, включая те, в которых нам не удается определить язык. Если нам удается определить язык программирования, на котором написан файл, то мы указываем на это в результатах поиска, чтобы можно было ограничить поиск по коду, написанному на этом языке.

Если нам не удается определить нужный Вам язык, может пригодиться оператор file:, позволяющий искать файлы с определенным расширением. Например, можно ограничить поиск файлами с расширением .x или .abc, введя запрос типа moj_zapros file:\.(x|abc)$. Если нам не удается определить язык, который, по Вашему мнению, важен, обязательно свяжитесь с нами.

4. Как ограничить поиск по языку, лицензии или названию файла?

Можно использовать страницу для расширенного поиска кода Google или наши операторы. Существуют следующие операторы:

lang: - ограничивает поиск по языку программирования (например, lang:"c++", -lang:java или lang:^(c|c#|c\+\+)$)

license: - ограничивает поиск по лицензии на ПО (например, license:apache, -license:gpl или license:bsd|mit)

package: - ограничивает поиск по URL пакета (например, package:"www.kernel.org" или package:\.tgz$)

file: - ограничивает поиск по названию файла (например, file:include/linux/$ или -file:\.cc$)

Аргументом для каждого из этих операторов может быть либо текстовая строка, заключенная в кавычки, либо регулярное выражение. Как показано в некоторых примерах, приведенных выше, каждый из операторов можно использовать в прямо противоположном смысле, поместив перед ним знак минуса ("-").

5. Можно ли добавить результаты поиска кода Google на свой веб-сайт, в интегрированную среду разработки программного обеспечения или приложение?

Да. Результаты поиска кода Google доступны через канал GData/XML, и мы рекомендуем создавать подключаемые модули для среды разработки программного обеспечения и добавить поиск кода Google на свой сайт.

6. Каким образом определяется, какую лицензию на ПО указывать для части кода?

Мы делаем все возможное, чтобы определить лицензию на ПО для пакетов кода, выполняя поиск лицензии в комментариях или отдельном файле с лицензией (например, LICENSE, LICENCE, COPYRIGHT, COPYING). Если нам не удается найти лицензию, то указываем, что лицензия "Неизвестна". Учтите, что наша система определения лицензии требует доработки. Мы указываем лицензию, ориентируясь на автора кода, но можем допускать ошибки, тем более что автор иногда указывает неправильную лицензию. Кроме того, в результатах поиска кода не указывается, какие патенты могут защищать часть ПО. Мы сообщаем обо всех возможных условиях лицензии, но вся юридическая ответственность за повторное использование части кода лежит на Вас.

7. Как добавить свой код в результаты поиска кода Google?

Код можно отправить, заполнив веб-форму. Чтобы отправить большой объем кода, создайте файл Sitemap для поиска кода, который позволяет указать все файлы кода на вашем сайте. Имейте в виду, что мы добавляем в свой индекс не все предлагаемые нам коды и не можем предвидеть или гарантировать факт и момент включения того или иного кода.

8. Как убедиться в том, что для моих файлов кода выбраны правильные язык и лицензия?

Можно создать файл packagemap, в котором сведения о языке и лицензии указываются для каждого файла в пакете. Создайте файл в формате packagemap XML, а затем скопируйте его в корневой каталог архива кодов.

9. Что нужно сделать, чтобы мой код не сканировали?

Поиск кода Google признает robots.txt, поэтому существует несколько способов, позволяющих запретить сканирование кода.

Если у Вас есть доступ к файлу роботов для Вашего сервера, можно добавить путь к коду в строку Disallow:. Дополнительная информация.

Также можно просто поместить файл robots.txt в корневой каталог пакета кода. Это применимо и к архивам, и к таким хранилищам, как CVS и Subversion. Например, чтобы показать, что Вы не хотите, чтобы Ваш код сканировали, можно добавить файл с названием robots.txt в корневой каталог, включив в него следующую информацию:


                          User-agent: *

                          Disallow: /

Учтите, что обновление индекса для поиска кода Google и удаление кода может занять некоторое время. Если это нужно сделать срочно, сообщите нам по адресу codesearch-issues+ru@google.com..

10. У меня есть предложения по улучшению продукта. Кому о них написать?

Чтобы мы узнали о Ваших идеях, разместите их в группе обсуждения. Поиск кода Google является частью службы Google Labs, поэтому она все еще находится в начальной стадии разработки. Ваши отзывы важны. Они могут помочь нам улучшить этот продукт.

11. Как сообщить в Google, если я считаю, что какой-то из результатов поиска кода Google нужно удалить?

Поиск кода Google все еще входит в Google Labs, поэтому результаты поиска иногда оставляют желать лучшего. Если Вы заметите в результатах поиска проблемное место, сообщите нам об этом по адресу codesearch-issues+ru@google.com. Если Вы являетесь владельцем авторских прав и считаете, что найденные результаты нарушают Ваши авторские права, следуйте инструкциям в процедуре DMCA, чтобы отправить запрос на удаление.

12. Каковы условия использования?

Эту информацию см. в разделе Условия использования Google Code.