Make sure that you have Ruby and Bundler installed on your machine. For platform specific instructions see the following subsections:
You can use this shell script to turn your OS X laptop into an awesome web development machine.
You can use this shell script to turn your laptop into an awesome web development machine.
You can use the Vagrant or Docker options.
Install Vagrant on your machine.
# This step will download and start the machine
$ vagrant up
# Here you can access the machine terminal
$ vagrant ssh
# Find out the ruby version
$ ruby -v
# Edit the file `.ruby-version` on epages-docs folder with your favourite editor and update with your version
$ vi /vagrant/.ruby-versionAfter this run the Rake tasks
If you don't like to bootstrap your machine you can also run a Docker container for development by invoking a single command only. The container will be pulled from our registry. Requirement: Install Docker Engine first.
# Build and run container with default rake task (eq. build `_site` and serve via jekyll)
$ docker build -t epages-docs -f Dockerfile.ruby .
$ docker run --rm --volume=$(pwd):/usr/src/epages-docs -p 4000:4000 -it epages-docs dev
# On Linux
$ echo "Open in browser: http://127.0.0.1:4000/"
# On Mac (with one active docker machine)
$ open http://$(docker-machine ip `docker-machine active`):4000# build nginx and elasticsearch docker image
$ ./build.sh master "$(echo "${DOCKER_HOST}" | sed -E 's/tcp:\/\/([^:]+):([0-9]+)/\1/'):9200"
$ docker-compose up -d- By appending arguments after the image name at the listed
docker runcommands, you may execute other rake tasks (e.g.rake test,rake build,rake serveor in short:test,build,serve) as well as connect (e.g.bash) into the pseudo-terminal inside the container and do whatever you want. - When running the container with a mounted host dir the
_sitedir will be created on the host with docker access rights (user ids from the inside the container). You may sanitise this withsudo chown -R $USER:$USER _siteafterwards or just remove it as rootsudo rm _site. docker pull/runof containers from our registry works without login inside our DMZ. From the outside you first need to rundocker loginaccordingly.- Caution: For keeping things simple we run all commands inside the ruby container as root. In a production environment you would have to serve the jekyll site with user only privileges of course.
# install dependencies
$ bundle
# run a local server with auto rebuilding
$ rake
# check for dead links and other bad stuff
$ rake test
# build the page
$ rake build
# compare status of RAML files from epages-docs with epagesj
$ rake ramlupThis project comprises different licenses. The editorial content in the folders
apps/,blog/,soap/andassets/images/
is licensed under CC-BY-4.0.
The logos in the folder assets/logos/ may not be shared or adapted.
The different fonts in the assets/fonts/ folder are licensed under their own respective licenses.
All other content is licensed under MIT.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent