This repository contains the documentation of the elastic.io iPaaS platform. Visit the doc.elastic.io to see it live.
- Fork this repo
- Write your articles, change existing ones
- Create a pull request back to this repo
- Wait for review approval by contributors
- Enjoy the new docs
If you are first-time user, do the following steps
- Clone
git clone https://github.com/elasticio/elasticio.github.io
- Init the submodule by executing
git submodule update --init
- Start your Jekyll app locally if you want to see the docs
If you are returning user, perform the following steps:
git checkout master
git pull --rebease origin master
git checkout -b {MY_BRANCH}
- Update submodule
git submodule update --update
- The last step will create changes to the
docs
folder. Please commit them to your branch git push origin {MY_BRANCH}
- Go to GitHub and create a PR from
MY_BRANCH
tomaster
. - Go through review
- Merge the content to
master
- Enjoy the content on https://docs.elastic.io
To provide a white-labeled documentation to your customers, please follow the following steps:
- Fork this repository
- Customize variables used in documentation pages
- Customize the styles
- Customize your Algolia configuration in the _config.yml file (application_id, index_name and search_only_api_key) or delete them if you don't need search
- Customize
CNAME
file (OPTIONAL: This is only required if documentation hosted on GitHub, but not necessary if documentation hosted on servers) - DO NOT edit any content to avoid merging conflicts
- Pull changes from the original repository regularly so that your docs are up-to-date
As a part of white-labelling you must take care of your own configuration to build the search statistics. To do so, create an Algolia account and use your own keys in the setup as explained here.
-
Find
application_id
andsearch_only_api_key
in “API Keys” section: -
Now you can Customize your Algolia configuration in the
_config.yml
file
If you don't have the jekyll/jekyll
Docker image on your machine yet,
install it once.
docker pull jekyll/jekyll
Once you have jekyll/jekyll
image locally, execute the following
command from the root folder of this repo:
./start.sh
If you are on a Windows machine just copy the command from the start.sh file and adjust it with Windows specific commands.
If your see the following output in the terminal, the docs are up and running:
No active host found
Error getting IP address: Host is not running
Configuration file: /srv/jekyll/_config.yml
Configuration file: /srv/jekyll/_config.yml
Source: /srv/jekyll
Destination: /srv/jekyll/_site
Incremental build: disabled. Enable with --incremental
Generating...
done in 0.672 seconds.
Auto-regeneration: enabled for '/srv/jekyll'
Configuration file: /srv/jekyll/_config.yml
Server address: http://0.0.0.0:4000/
Server running... press ctrl-c to stop.
The docs are available now at http://localhost:4000/.