loklak_search

The loklak_search creates a website using the loklak server as a data source. The goal is to get a search site, that offers timeline search as well as custom media search, account and geolocation search.

In order to run the service you can use the API of http://api.loklak.org or install your own loklak server data storage engine. loklak_server is a server application which collects messages from various social media tweet sources, including twitter. The server contains a search index and a peer-to-peer index sharing interface. All messages are stored in an elasticsearch index.

The site of this repo is deployed on the GitHub gh-pages branch and automatically deployed here: http://loklak.net

Communication

Please join our mailing list to discuss questions regarding the project: https://groups.google.com/forum/#!forum/loklak

Our chat channel is on gitter here: https://gitter.im/loklak/loklak

Technology Stack

Components

HTML - Structure of the web page generated.
CSS - Styling options and details ofthe web page.
Javascript(JSON) - Used to store information for deploying the application such as dependencies.
Angular2 - Structure for deployment of the web page.

Services and Dependencies

Bower - The goal is to use Bower to manage front-end dependencies in future.

Requirements

Angular-cli
node --version >= 6
npm --version >= 3

Installation

First we will need to install angular-cli by using the following command:

$ npm install -g angular-cli

After installing anular-cli we need to install our required node modules, so we will do that by using the following command:

$ npm install

How to deploy?

Running on localhost:

Step 1: Fork loklak_search repository and clone it to your desktop
Step 2: Then cd into that cloned folder
Step 3: Deploy locally by running this :$ ng serve

For deploying with Github Pages:

With these very simple steps you can have loklak_search deployed:

Step 1: Fork loklak_search repository and clone it to your desktop
Step 2: Then checkout to your master branch $ git checkout master
Step 3: Deploy running this : $ ng github-pages:deploy --message "Optional commit message" --base-href="/loklak_search/"
Step 4: Visit https://yourusername.github.io/loklak_search and you should see the search running
Step 5: As you search you might see that that it cant find anything, to resolve this, on search you will see there is a red shield on search bar, click on it and allow to load scripts
Step 6: Reload and you will have a function loklak search page deployed with github pages.

Loklak Server

See here to run your own https://github.com/loklak/loklak_server (recommended), and change apiUrl in config accordingly. Last resource, or for production is `http://api.loklak.org

Contributions, Bug Reports, Feature Requests

This is an Open Source project and we would be happy to see contributors who report bugs and file feature requests submitting pull requests as well. Please report issues in the GitHub tracker.

Branch Policy

We have the following branches

master All development goes on in the master branch. If you're making a contribution, you are supposed to make a pull request to master. PRs to the branch must pass a build check and a unit-test check on Travis
gh-pages This contains the autogenerated code of the master branch that is generated by Travis.

License

This project is currently licensed under the The MIT License (MIT). A copy of LICENSE.md should be present along with the source code. To obtain the software under a different license, please contact FOSSASIA.

oanarosca / loklak_search