README 1.6 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546
  1. About INET Showcases
  2. ====================
  3. This repository is normally checked out as a submodule of the
  4. INET Framework repository. In addition to the showcase simulations
  5. themselves (NED files, ini files and all), this repository also
  6. contains a GitHub Pages based web site in the docs/ folder that
  7. is made available online at https://inet.omnetpp.org/inet-showcases.
  8. Web pages in the repo are in Markdown format (.md). One way to view
  9. them in the browser is to install a Markdown plugin into the browser;
  10. there are such plugins both for Chrome and for Firefox. Another way
  11. is to run the Jekyll-based GitHub Pages infrastructure on your local
  12. system, and connect to it from your browser -- this is the recommended
  13. way if you'd like to contribute.
  14. To install a local GitHub Pages development environment:
  15. First, make sure you have a working Docker environment. If you are
  16. on Ubuntu, DO NOT INSTALL Docker from the default repository, as it
  17. is out of date. Rather, follow the instructions on docker.com,
  18. https://docs.docker.com/engine/installation/linux/docker-ce/ubuntu/
  19. Then, add yourself into the docker group. That will allow you to run
  20. docker commands without sudo. (Replace YOU with your login name.)
  21. Note that you may need to log out and log in again for the change to
  22. take effect.
  23. $ sudo usermod -a -G docker YOU
  24. Then, pull the preconfigured GitHub Pages docker image:
  25. $ docker pull madduci/docker-github-pages
  26. Then run the jekyll server with the following command
  27. $ ./start_local_server
  28. Open your browser on http://localhost:4000/inet-showcases/
  29. In case of problems, contact us.
  30. --
  31. Andras Varga