About INET Showcases
====================

This repository is normally checked out as a submodule of the
INET Framework repository. In addition to the showcase simulations
themselves (NED files, ini files and all), this repository also
contains a GitHub Pages based web site in the docs/ folder that
is made available online at https://inet.omnetpp.org/inet-showcases.

Web pages in the repo are in Markdown format (.md). One way to view
them in the browser is to install a Markdown plugin into the browser;
there are such plugins both for Chrome and for Firefox. Another way
is to run the Jekyll-based GitHub Pages infrastructure on your local
system, and connect to it from your browser -- this is the recommended
way if you'd like to contribute.

To install a local GitHub Pages development environment:

First, make sure you have a working Docker environment. If you are
on Ubuntu, DO NOT INSTALL Docker from the default repository, as it
is out of date. Rather, follow the instructions on docker.com,
https://docs.docker.com/engine/installation/linux/docker-ce/ubuntu/

Then, add yourself into the docker group. That will allow you to run
docker commands without sudo. (Replace YOU with your login name.)
Note that you may need to log out and log in again for the change to
take effect.

$ sudo usermod -a -G docker YOU

Then, pull the preconfigured GitHub Pages docker image:

$ docker pull madduci/docker-github-pages

Then run the jekyll server with the following command 

$ ./start_local_server

Open your browser on http://localhost:4000/inet-showcases/

In case of problems, contact us.

--
Andras Varga


