Skip to content

italia/developers-italia-searchyll

 
 

Repository files navigation

This repository is a fork of https://github.com/omc/searchyll used for indexing the developers.italia.it website. All the changes were contributed upstream, so when all our pull requests are merged we can get rid of this fork.

Searchyll

Search for Jekyll apps. A plugin for indexing your pages into a search engine.

Currently supports Elasticsearch, we're also considering modular support for Apache Solr in a future release.

Installation

Add this line to your application's Gemfile:

gem 'searchyll'

In your Jekyll Gemfile:

gems:
  - searchyll

Configuration

elasticsearch:
  url: "http://localhost:9200/"     # Required. Supports auth and SSL: https://user:pass@someurl.com
                                    # Can also read URLs stored in environment variable named
                                    # BONSAI_URL and ELASTICSEARCH_URL.
  number_of_shards: 1               # Optional. Default is 1 primary shard.
  number_of_replicas: 1             # Optional. Default is 1 replica.
  index_name: "jekyll"              # Optional. Default is "jekyll".
  default_type: "post"              # Optional. Default type is "post".
  custom_settings: _es_settings.yml # Optional. No default. Relative to your src folder
  custom_mappings: _es_mappings.yml # Optional. No default. Relative to your src folder
  ignore:                           # Optional. No default.
    - /news/*

ES Auth

Elasticsearch authentication can be provided both by passing user and password as URI parameter:

url: https://user:pass@someurl.com

Or by easily setting those ENV variables:

ELASTICSEARCH_URL=http://localhost:9200/
ELASTICSEARCH_USER=elastic
ELASTICSEARCH_PASS=changeme

Custom Settings File Example

It should be written to be plugged into the settings slot of a create index call

analysis:
  analyzer:
    stop_analyzer:
      type: stop
      stopwords: _english_
index:
  number_of_shards: 1
  number_of_replicas: 0

Custom Mappings File Example

It should be written to be plugged into the mappings.[type] slot of a create index call

properties:
  field1:
    type: text

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/omc/searchyll

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Ruby 99.4%
  • Shell 0.6%