2. **Create** a feature branch (`git checkout -b feature/amazing-feature`)
3. **Commit** your changes (`git commit -m 'Add amazing feature'`)
4. **Push** to the branch (`git push origin feature/amazing-feature`)
5. **Open** a Pull Request

### Development Setup

```bash
# Clone the repository
git clone https://github.com/codelibs/fess-crawler.git
cd fess-crawler

# Build the project
mvn clean install

# Run tests

5. Ensure all tests pass: `mvn test`
6. Check license headers: `mvn license:format`
7. Commit changes: `git commit -m 'Add amazing feature'`
8. Push to branch: `git push origin feature/amazing-feature`
9. Open a Pull Request

### Code Style

- Use Eclipse formatter configuration (`src/config/eclipse/formatter/java.xml`)
- Follow existing naming conventions
- Add comprehensive JavaDoc for public APIs

      <match value="GIF89a" type="string" offset="0"/>
    </magic>
    <glob pattern="*.gif"/>
  </mime-type>
  <mime-type type="image/avif">
    <!-- According to https://github.com/libvips/libvips/pull/1657
      older avif used to use the the heif 'ftypmif1' as well -->
    <_comment>AV1 Image File</_comment>
    <acronym>AVIF</acronym>

        OpenSearchUrlQueue urlQueue = waitingQueue.poll();
        if (urlQueue != null) {
            if (crawlingQueue.size() > maxCrawlingQueueSize) {
                crawlingQueue.poll();
            }
            crawlingQueue.add(urlQueue);
            return urlQueue;
        }

        synchronized (queueHolder) {
            urlQueue = waitingQueue.poll();
            if (urlQueue == null) {

        synchronized (Deferred.this) {
            if (response != null || error != null) {
                return;
            }
            response = r;

            executeCallbacks = new ArrayList<>(doneCallbacks.size());
            Consumer<RESPONSE> callback;
            while ((callback = doneCallbacks.poll()) != null) {
                executeCallbacks.add(callback);
            }
        }

        convertedTexts.add(text);

        for (final ReadingConverter converter : converters) {
            String s;
            while ((s = queue.poll()) != null && convertedTexts.size() <= getMaxReadingNum()) {
                final List<String> results = converter.convert(s, field, lang);
                convertedTexts.addAll(results);
            }

                if (isValid(urlQueue)) {
                    ResponseData responseData = null;
                    log(logHelper, LogType.START_CRAWLING, crawlerContext, urlQueue);
                    try {
                        final CrawlerClient client = getClient(urlQueue.getUrl());
                        if (client == null) {

                    }
                }
                exception = null;
                break;
            } catch (final Exception e) {
                exception = new SuggesterException(e);
                scrollId = null;
            }
        }

        docCount.getAndAdd(queue.size());

        if (exception != null) {
            throw exception;
        }
    }

    /**

        @Override
        public boolean match(ResponseData responseData) {
            if (responseData == null) {
                return false;
            }

            // Check URL condition
            String urlCondition = conditions.get("url");
            if (urlCondition != null && responseData.getUrl() != null) {
                if (!responseData.getUrl().matches(urlCondition)) {
                    return false;

            String[] alphabets;
            if (i + 1 < text.length() && convertMap.get(text.substring(i, i + 2)) != null) {
                alphabets = convertMap.get(text.substring(i, i + 2));
                i += 2;
            } else {
                if (convertMap.get(text.substring(i, i + 1)) != null) {
                    alphabets = convertMap.get(text.substring(i, i + 1));
                } else {