Difference between revisions of "Lazarus InstantSearch/ru"

From Free Pascal wiki
Jump to navigationJump to search
(Created page with "{{LanguageBar|Lazarus InstantSearch}} == Введение == The instantsearch package is a package to search within sources (or other sources of text) It provides an as-you...")
 
 
(7 intermediate revisions by the same user not shown)
Line 2: Line 2:
  
 
== Введение ==
 
== Введение ==
The instantsearch package is a package to search within sources (or other sources of text)
+
Пакет Instantsearch — это пакет для поиска в исходниках (или других исходниках текста).
  
It provides an as-you-type search mechanism.  
+
Он обеспечивает механизм поиска по мере ввода.
See the 'View - Instantsearch' menu item (or CTRL-ALT-F).
+
См. пункт меню 'View - Instantsearch'(Вид — Мгновенный поиск) (или {{keypress|Ctrl}} + {{keypress|Alt}} + {{keypress|F}}).
  
It uses [https://manticoresearch.com/ Manticore Search] to provide the
+
Он использует [https://manticoresearch.com/ Manticore Search] для предоставления возможностей поиска. Поиск Manticore создает индекс исходных файлов, который затем используется для предоставления вам возможностей поиска.
search capabilities. Manticore search creates an index of the source files,
 
which it then uses to provide you with search capabilities.
 
  
== Installation ==
+
== Установка ==
  
=== Install ManticoreSearch ===
+
=== Установка ManticoreSearch ===
  
Before you can use Lazarus InstantSearch, you must have Manticore Search
+
Прежде чем вы сможете использовать Lazarus InstantSearch, у вас должен быть установлен Manticore Search. Его можно установить локально или на другом компьютере.
installed. It can be installed locally, or on another computer.
 
  
To install Manticore search, please see the  instructions at
+
Чтобы задать возможность поиска посредством Manticore, см. инструкции на
 
[https://manual.manticoresearch.com/Installation]
 
[https://manual.manticoresearch.com/Installation]
  
=== Install InstantSearch ===
+
=== Установка InstantSearch ===
  
Using the package menu, install the '''lazinstantsearch''' package.
+
Используя меню пакетов, установите пакет '''lazinstantsearch'''. Вам нужно будет перекомпилировать IDE.
You will need to recompile the IDE.
 
  
=== Configure instantsearch. ===
+
=== Настройка InstantSearch ===
  
After installing the package, before you can use instantsearch, it needs to be configured:  
+
После установки пакета, прежде чем вы сможете использовать Instantsearch, его необходимо настроить: как минимум указать местоположение поисковой системы manticore.
at least the location of the manticore search engine must be specified.
 
  
Using Tools - options, select the 'Instant Search' item under the Environment
+
Используя Tools - options, выберите элемент 'Instant Search' в группе параметров "Environment".
option group.
 
  
== Configuration ==
+
== Настройка ==
The configuration is done using the 'Instant Search' item under the Environment option group.
+
 
 +
Настройка выполняется с помощью элемента 'Instant Search'(Мгновенный поиск) в группе параметров "Environment".
  
 
[[File:lazarus_instantsearch_options1.png|Options]]
 
[[File:lazarus_instantsearch_options1.png|Options]]
 
   
 
   
You must configure at least the following things:
+
Вы должны настроить как минимум следующие вещи:
* Protocol - MySQL or HTTP
+
* Протокол - MySQL или HTTP
* MySQL Client version - if you selected the MySQL protocol.
+
* Версия клиента MySQL - если вы выбрали протокол MySQL.
 +
 
 +
Вы можете оставить имя хоста и порт пустыми, если вы установились на локальный компьютер с настройками по умолчанию.
  
You can leave hostname and port empty if you installed on the local machine
+
Проверьте соединение с помощью кнопки 'Test connection' (Проверить соединение).
using the default settings.
 
  
Test the connection with the 'Test connection' button.
+
Если с подключением все в порядке, задайте имя используемого индекса и с помощью кнопки 'Create Index'(Создать индекс) создайте таблицу, используемую для хранения поискового индекса.
  
If the connection is OK, set the index name to use, and use the 'Create
+
Если индекс уже существует, вы будете предупреждены об этом.
Index' button to create the table used to store the search index.
 
  
if the index already exists, you will be warned about this.
+
Когда индекс будет создан (или уже создан), диалоговое окно конфигурации проверит, какие исходные деревья существуют (обычно их нет), и предложит начать индексирование. Это делается в фоновом режиме.
  
When the index has been created (or was already created),
+
=== Настройка исходных деревьев ===
the configuration dialog will check which source trees exist (normally
 
none), and will offer to start indexing. This is done in the background.
 
  
=== Configuring source trees ===
+
По умолчанию InstantSearch настраивает 4 исходных дерева:
 +
* RTL : Источники RTL для FPC.
 +
* FCL : исходники пакетов FPC.
 +
* Компилятор : исходники компилятора FPC
 +
* LCL : Исходники lazarus LCL.
  
By default, InstantSearch configures 4 source trees:
+
Вы можете определить любое количество деревьев поиска, используя кнопки на панели инструментов.
* RTL : The RTL sources of FPC.
+
Вы можете использовать кнопки для обновления индексов исходного дерева.
* FCL : The packages sources of FPC.
 
* Compiler : The FPC compiler sources
 
* LCL : The lazarus LCL sources.
 
  
You can define as much search trees as you want, using  the buttons in the toolbar.
+
{{Note| когда вы измените исходный каталог FPC или повторно просканируете его, деревья RTL/FCL/Compiler будут переиндексированы.}}
You can use the buttons to refresh the indexes of a source tree.
 
  
Note: when you change the source directory of FPC or rescan it,
 
the RTL/FCL/Compiler trees will be re-indexed.
 
  
 
[[File:lazarus_instantsearch_options2.png|Source tree definitions]]
 
[[File:lazarus_instantsearch_options2.png|Source tree definitions]]
  
The  4 trees are configured and indexed automatically, a message will appear
+
4 дерева настраиваются и индексируются автоматически, а когда это происходит, в окне сообщений появляется сообщение.
in the messages window when this happens.
+
 
 +
=== Индексация текущего (активного) проекта. ===
 +
 
 +
По исходному коду текущего проекта также можно осуществлять поиск, если он был проиндексирован. Это двухэтапный процесс:
  
=== Indexing the current (active) project. ===
+
* Помечаем проект как индексируемый. Это можно сделать с помощью команды ``Mark project as indexable`` (Отметить проект как индексируемый).
The sources of the current project can also be searched, provided it has
+
: покажется элемент вплывающего меню в инспекторе проектов или ниже меню 'Project' в главном меню.
been indexed. This is a 2-step process:
 
  
* Mark a project as indexable. This can be done using the ``Mark project as indexable``
+
* Тут же индексируем проект. Проект автоматически индексируется, когда вы
: popup menu item in the project inspector, or below the 'Project' menu in the main menu.  
+
: пометите его как индексируемый.
 +
: вручную проиндексируете проект в любое время, используя пункт меню проекта в главном меню,
 +
: или используете элемент всплывающего меню.
  
* Actually index the project. The project is automatically indexed when you
+
== Поиск ==
: mark it as indexable.
 
:  You can manually index a project at any time using the project menu item in the main menu,
 
:  or the popup item.
 
  
== Searching ==
+
Для поиска откройте окно 'Instant search'(Мгновенный поиск) в разделе 'View'(Вид) (или нажмите {{keypress|Ctrl}} + {{keypress|Alt}} + {{keypress|F}})
To search, open the 'Instant search' window under 'View' (or press CTRL-Alt-F)
 
  
If Instant Search was not not configured, you will get a warning and the IDE
+
Если мгновенный поиск не был настроен, вы получите предупреждение, и IDE предложит открыть диалоговое окно настройки.
will offer to open the configuration dialog.
 
  
The dialog will automatically copy the selection (provided it is not too big and does not contain CR/LF characters)  
+
Диалоговое окно автоматически скопирует выделение (при условии, что оно не слишком велико и не содержит символов CR/LF) в поле редактирования поиска и выполнит поиск с его помощью.
to the search edit box and do a search with that.  
 
  
You can type in the search edit box at the top.
+
Вы можете ввести текст в поле поиска вверху.
As you type, the search results will be more refined or expanded.
+
По мере ввода выводимые результаты поиска будут уточняться или расширяться.
  
Each match is displayed with the line contents, and the filename+lineno.
+
Каждое совпадение отображается с содержимым строки и именем исходного файла(номера строки).
  
 
[[File:lazarus_instantsearch_searching.png|Searching]]
 
[[File:lazarus_instantsearch_searching.png|Searching]]
  
Double click one of the lines to open the file at the selected location.
+
Дважды щелкните одну из строк, чтобы открыть файл в выбранном месте.
  
If you have too many matches, you can check or uncheck some of the source
+
Если у вас слишком много совпадений, вы можете отметить или снять отметку с некоторых исходных деревьев в верхней правой строке поиска.
trees in the top-right search bar.
 

Latest revision as of 17:17, 1 January 2023

English (en) русский (ru)

Введение

Пакет Instantsearch — это пакет для поиска в исходниках (или других исходниках текста).

Он обеспечивает механизм поиска по мере ввода. См. пункт меню 'View - Instantsearch'(Вид — Мгновенный поиск) (или Ctrl + Alt + F).

Он использует Manticore Search для предоставления возможностей поиска. Поиск Manticore создает индекс исходных файлов, который затем используется для предоставления вам возможностей поиска.

Установка

Установка ManticoreSearch

Прежде чем вы сможете использовать Lazarus InstantSearch, у вас должен быть установлен Manticore Search. Его можно установить локально или на другом компьютере.

Чтобы задать возможность поиска посредством Manticore, см. инструкции на [1]

Установка InstantSearch

Используя меню пакетов, установите пакет lazinstantsearch. Вам нужно будет перекомпилировать IDE.

Настройка InstantSearch

После установки пакета, прежде чем вы сможете использовать Instantsearch, его необходимо настроить: как минимум указать местоположение поисковой системы manticore.

Используя Tools - options, выберите элемент 'Instant Search' в группе параметров "Environment".

Настройка

Настройка выполняется с помощью элемента 'Instant Search'(Мгновенный поиск) в группе параметров "Environment".

Options

Вы должны настроить как минимум следующие вещи:

  • Протокол - MySQL или HTTP
  • Версия клиента MySQL - если вы выбрали протокол MySQL.

Вы можете оставить имя хоста и порт пустыми, если вы установились на локальный компьютер с настройками по умолчанию.

Проверьте соединение с помощью кнопки 'Test connection' (Проверить соединение).

Если с подключением все в порядке, задайте имя используемого индекса и с помощью кнопки 'Create Index'(Создать индекс) создайте таблицу, используемую для хранения поискового индекса.

Если индекс уже существует, вы будете предупреждены об этом.

Когда индекс будет создан (или уже создан), диалоговое окно конфигурации проверит, какие исходные деревья существуют (обычно их нет), и предложит начать индексирование. Это делается в фоновом режиме.

Настройка исходных деревьев

По умолчанию InstantSearch настраивает 4 исходных дерева:

  • RTL : Источники RTL для FPC.
  • FCL : исходники пакетов FPC.
  • Компилятор : исходники компилятора FPC
  • LCL : Исходники lazarus LCL.

Вы можете определить любое количество деревьев поиска, используя кнопки на панели инструментов. Вы можете использовать кнопки для обновления индексов исходного дерева.

Light bulb  Примечание: когда вы измените исходный каталог FPC или повторно просканируете его, деревья RTL/FCL/Compiler будут переиндексированы.


Source tree definitions

4 дерева настраиваются и индексируются автоматически, а когда это происходит, в окне сообщений появляется сообщение.

Индексация текущего (активного) проекта.

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

  • Помечаем проект как индексируемый. Это можно сделать с помощью команды ``Mark project as indexable`` (Отметить проект как индексируемый).
покажется элемент вплывающего меню в инспекторе проектов или ниже меню 'Project' в главном меню.
  • Тут же индексируем проект. Проект автоматически индексируется, когда вы
пометите его как индексируемый.
вручную проиндексируете проект в любое время, используя пункт меню проекта в главном меню,
или используете элемент всплывающего меню.

Поиск

Для поиска откройте окно 'Instant search'(Мгновенный поиск) в разделе 'View'(Вид) (или нажмите Ctrl + Alt + F)

Если мгновенный поиск не был настроен, вы получите предупреждение, и IDE предложит открыть диалоговое окно настройки.

Диалоговое окно автоматически скопирует выделение (при условии, что оно не слишком велико и не содержит символов CR/LF) в поле редактирования поиска и выполнит поиск с его помощью.

Вы можете ввести текст в поле поиска вверху. По мере ввода выводимые результаты поиска будут уточняться или расширяться.

Каждое совпадение отображается с содержимым строки и именем исходного файла(номера строки).

Searching

Дважды щелкните одну из строк, чтобы открыть файл в выбранном месте.

Если у вас слишком много совпадений, вы можете отметить или снять отметку с некоторых исходных деревьев в верхней правой строке поиска.